Shenzhen Xunlong Software Orange Pi Zero 2w Manuale utente

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

Orange Pi Zero 2w

User Manual

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

1. Basic features of Orange Pi Zero 2w...............................................................................1

1.1. What is Orange Pi Zero 2w ................................................................................................. 1

1.2. Usage of Orange Pi Zero 2w ............................................................................................. 1

1.3. Who is Orange Pi Zero 2w designed for?........................................................................ 1

1.4. Hardware features of Orange Pi Zero 2w ........................................................................... 2

1.5. Top view and bottom view of Orange Pi Zero 2w ...............................................................3

1.6. Orange Pi Zero 2w interface details ....................................................................................4

1.7. Orange Pi Zero 2w 24pin expansion board interface details..............................................5

2. Introduction to the use of development boards............................................... 7

2.1. Prepare necessary accessories ........................................................................................... 7

2.2. Download the development board image and related information................................ 11

2.3. Method of burning Linux image to TF card based on Windows PC ................................. 12

2.3.1. How to burn Linux image using balenaEtcher...................................... 12

2.3.2. How to burn Linux image using Win32Diskimager..............................16

2.4. Method to burn Linux image to TF card based on Ubuntu PC ......................................... 19

2.5. Method of burning Android image to TF card ..................................................................23

2.6. Instructions for using micro-linux system in onboard SPI Flash ....................................... 30

2.7. Start the Orange Pie development board .........................................................................31

2.8. How to use the debugging serial port .............................................................................. 32

2.8.1. Debug serial port connection instructions ............................................. 32

2.8.2. How to use the debugging serial port on Ubuntu platform................... 34

2.8.3. How to use the debugging serial port on Windows platform................ 36

2.9. Instructions for using the 5v pin in the 40pin interface of the development board for

power supply .............................................................................................................................. 39

3. Debian/Ubuntu Server and Xfce desktop system usage instructions............................ 41

3.1. Supported linux image types and kernel versions ............................................................41

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

3.2. Linux kernel driver adaptation situation .......................................................................... 42

3.3. Linux command format description in this manual ..........................................................43

3.4. Linux system login instructions .........................................................................................45

3.4.1. Linux system default login account and password................................45

3.4.2. How to set up automatic login of Linux system terminal..................... 46

3.4.3. Instructions for automatic login of Linux desktop version system....... 46

3.4.4. Setting method for automatic login of root user in Linux desktop system48

3.4.5. How to disable the desktop in Linux desktop system........................... 48

3.5. Onboard LED light test instructions ..................................................................................49

3.6. Operation instructions for rootfs partition capacity of Linux system in TF card .............. 51

3.6.1. The first startup will automatically expand the capacity of the rootfs

partition in the TF card........................................................................................51

3.6.2. Method to prohibit automatic expansion of rootfs partition capacity in

TF card.................................................................................................................53

3.6.3. Method to manually expand the capacity of rootfs partition in TF card54

3.6.4. Method to reduce the capacity of rootfs partition in TF card................60

3.7. 24Pin expansion board interface pin description .............................................................64

3.8. How to use the two LRADC buttons on the 24pin expansion board ................................66

3.9. Network connection test .................................................................................................. 71

3.9.1. Ethernet port test....................................................................................71

3.9.2. WIFI connection test............................................................................. 73

3.9.3. Method to create WIFI hotspot through create_ap................................82

3.9.4. How to set a static IP address ................................................................ 89

3.9.5. How to set up the Linux system to automatically connect to the network

for the first time...................................................................................................97

3.10. SSH remote login development board ......................................................................... 102

3.10.1. SSH remote login development board under Ubuntu........................102

3.10.2. SSH remote login development board under Windows.................... 103

3.11. HDMI test ......................................................................................................................105

3.11.1. HDMI display test............................................................................. 105

3.11.2. HDMI to VGA display test................................................................106

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

3.11.3. How to set HDMI resolution in Linux5.4 system............................. 107

3.11.4. How to modify the width and height of Framebuffer in Linux5.4

system................................................................................................................108

3.11.5. Framebuffer cursor setting.................................................................109

3.12. How to use Bluetooth ...................................................................................................110

3.12.1. Testing method for desktop image.....................................................110

3.12.2. How to use server version image.......................................................113

3.13. USB interface test ......................................................................................................... 116

3.13.1. USB interface extension description ................................................. 116

3.13.2. How to set USB0 to HOST mode......................................................117

3.13.3. Connect USB mouse or keyboard to test...........................................119

3.13.4. Connect USB storage device for testing ............................................119

3.13.5. USB Ethernet card test...................................................................... 120

3.13.6. USB camera test................................................................................ 121

3.14. Audio test ......................................................................................................................124

3.14.1. How to play audio using the command line ...................................... 124

3.14.2. Test audio methods on desktop systems ............................................125

3.15. Infrared reception test ..................................................................................................127

3.16. Temperature sensor ......................................................................................................129

3.16.1. How to check the temperature in linux5.4 system............................ 129

3.16.2. How to check the temperature in linux6.1 system............................ 130

3.17. 40 Pin Interface pin description ....................................................................................131

3.18. How to install wiringOP ................................................................................................ 132

3.19. 40pin interface GPIO, I2C, UART, SPI and PWM testing ............................................... 134

3.19.1. 40pin GPIO port test..........................................................................134

3.19.2. How to set the pull-down resistor of 40 Pin GPIO port.................... 135

3.19.3. 40pin SPI test.....................................................................................136

3.19.4. 40pin I2C test.................................................................................... 139

3.19.5. 40pin UART test................................................................................143

3.19.6. PWM test method ..............................................................................146

3.20. How to install and use wiringOP-Python ......................................................................150

3.20.1. How to install wiringOP-Python....................................................... 157

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

3.20.2. 40pin GPIO port test..........................................................................159

3.20.3. 40pin SPI test.....................................................................................162

3.20.4. 40pin I2C test.................................................................................... 165

3.20.5. 40pin UART test................................................................................169

3.21. Hardware watchdog test .............................................................................................. 173

3.22. Check the chipid of H618 chip ......................................................................................174

3.23. Python related instructions .......................................................................................... 174

3.23.1. How to compile and install Python source code............................... 174

3.23.2. How to replace pip source in Python.................................................175

3.24. How to install Docker ....................................................................................................176

3.25. How to install Home Assistant ......................................................................................177

3.25.1. Installation via docker....................................................................... 177

3.25.2. Installation via python ....................................................................... 181

3.26. OpenCV installation method ........................................................................................ 183

3.26.1. Use apt to install OpenCV.................................................................183

3.27. Set up the Chinese environment and install the Chinese input method ..................... 183

3.27.1. Debian system installation method....................................................183

3.27.2. Installation method of Ubuntu 20.04 system.....................................190

3.27.3. Installation method of Ubuntu 22.04 system.....................................194

3.28. How to remotely log in to the Linux system desktop ................................................... 200

3.28.1. Remote login using NoMachine........................................................200

3.28.2. Remote login using VNC.................................................................. 204

3.29. QT installation method ................................................................................................. 206

3.30. ROS installation method ............................................................................................... 214

3.30.1. How to install ROS 1 Noetic on Ubuntu20.04..................................214

3.30.2. How to install ROS 2 Galactic on Ubuntu20.04............................... 218

3.30.3. How to install ROS 2 Humble on Ubuntu22.04................................221

3.31. How to install kernel header files ................................................................................. 223

3.32. Testing of some programming languages supported by Linux system .........................225

3.32.1. Debian Bullseye system.................................................................... 225

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

3.32.2. Debian Bookworm system................................................................ 227

3.32.3. Ubuntu Focal system......................................................................... 228

3.32.4. Ubuntu Jammy system...................................................................... 230

3.33. Method of uploading files to the development board Linux system........................... 232

3.33.1. Method to upload files to the development board Linux system in

Ubuntu PC......................................................................................................... 232

3.33.2. Method to upload files from Windows PC to development board Linux

system................................................................................................................236

3.34. Instructions for using the logo on and off the machine ............................................... 241

3.35. How to turn on the power button in Linux5.4 ............................................................. 241

3.36. How to shut down and restart the development board .............................................. 243

4. Linux SDK——orangepi-build usage instructions..................................................... 244

4.1. Compilation system requirements ................................................................................. 244

4.2. Obtain the source code of linux sdk ............................................................................... 246

4.2.1. Download orangepi-build from github................................................246

4.2.2. Download the cross-compilation tool chain........................................ 248

4.2.3. orangepi-build complete directory structure description.....................250

4.3. Compile u-boot ...............................................................................................................251

4.4. Compile the linux kernel .................................................................................................255

4.5. Compile rootfs ................................................................................................................ 259

4.6. Compile linux image ....................................................................................................... 263

5. Instructions for using the Orange Pi OS Arch system.................................................268

5.1. Orange Pi OS Arch system function adaptation status................................................... 268

5.2. Orange Pi OS Arch System User Guide Instructions ....................................................... 269

5.3. How to set DT overlays ................................................................................................... 274

5.4. How to install software ...................................................................................................276

6. Android 12 TV system usage instructions...................................................................277

6.1. Supported Android versions ........................................................................................... 277

6.2. Android 12 TV function adaptation status ..................................................................... 277

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

6.3. Onboard LED light display instructions ...........................................................................278

6.4. How to return to the previous interface in Android.......................................................278

6.5. How to use ADB .............................................................................................................. 279

6.5.1. Use network connection adb debugging ..............................................279

6.5.2. Use data cable to connect adb debugging............................................280

6.6. View how to set HDMI display resolution ...................................................................... 280

6.6.1. HDMI to VGA display test..................................................................282

6.7. WI-FI connection method ...............................................................................................283

6.8. How to use WI-FI hotspot ...............................................................................................285

6.9. How to check the IP address of the Ethernet port.........................................................287

6.10. Bluetooth connection method ..................................................................................... 289

6.11. How to set USB0 to HOST mode ...................................................................................292

6.12. How to use USB camera............................................................................................... 293

6.13. Android system ROOT description ................................................................................294

6.14. How to use MiracastReceiver to cast the mobile phone screen to the development

board .........................................................................................................................................296

6.15. Method of turning on and off the machine through buttons or infrared remote control299

6.16. 40pin interface GPIO, UART, SPI test ............................................................................ 301

6.16.1. 40pin GPIO port test method.............................................................301

6.16.2. 40pin UART test method...................................................................304

6.16.3. 40pin SPI test method........................................................................307

6.16.4. 40pin I2C test method....................................................................... 310

6.16.5. 40pin PWM test .................................................................................315

7. How to compile Android 12 source code.................................................................... 318

7.1. Download the source code of Android 12 ......................................................................318

7.2. Compile the source code of Android 12 .........................................................................320

8. Appendix......................................................................................................................322

8.1. User manual update history ........................................................................................... 322

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

8.2. Image update history ......................................................................................................322

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

www.orangepi.cn 1www.xunlong.tv

1. Basic features of Orange Pi Zero 2w

1.1. What is Orange Pi Zero 2w

Orange Pi is an open source single-board card computer, a new generation of arm64

development board, which can run operating systems such as Android TV 12, Ubuntu and

Debian. The Orange Pi Zero 2w development board uses the Allwinner H618

system-on-chip, and can optionally have 1GB or 1.5GB or 2GB or 4GB LPDDR4

memory.

1.2. Usage of Orange Pi Zero 2w

We can use it to achieve:

A small Linux desktop computer

A small Linux network server

Install the Klipper host computer to control the 3D printer

Android TV TV box

Of course, there are more functions. Relying on a powerful ecosystem and a

variety of expansion accessories, Orange Pi can help users easily achieve delivery

from ideas to prototypes to mass production. It is an ideal choice for makers,

dreamers, and hobbyists. An ideal creative platform for readers.

1.3. Who is Orange Pi Zero 2w designed for?

The Orange Pi development board is not only a consumer product, but also designed

for anyone who wants to use technology to create and innovate. It's a simple, fun, and

practical tool you can use to shape the world around you.

range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd

www.orangepi.cn 2www.xunlong.tv

1.4. Hardware features of Orange Pi Zero 2w

Introduction to hardware features

CPU

Allwinner H618 quad-core 64-bit 1.5GHz high-performance

Cortex-A53 processor

GPU

Mali G31 MP2

Supports OpenGL ES 1.0/2.0/3.2、OpenCL 2.0

Memory

1GB/1.5GB/2GB/4GB LPDDR4 (shared with GPU)

Onboard storage

TF card slot, 16MB SPI Flash

WIFI+BT

•20U5622 chip, supports IEEE 802.11 a/b/g/n/ac, BT5.0

Video Output

•Mini HDMI 2.0 interface

Audio Output

•Mini HDMI output

Power Supply

Type-C 5V/2A

USB 2.0 port

Type-C USB2.0 x 2

40pinexpansion

interface

Used to expand GPIO, UART, I2C, SPI, PWM

24pinexpansion

interface

Used to expand USB2.0 x 2, 100M Ethernet, infrared

reception, audio output, TV-OUT output, power on/off

button, LRADC button x 2

LED Light

Power light and status light

Supported OS

Android 12 TV ，Debian11 ，Debian12 ，Ubuntu22.04 ，

Ubuntu20.04，Orange Pi OS（Arch）etc.

Appearance specifications introduction

PCB Size

30mm x 65mm x 1.2mm

Weight

12.5g

range Pi™ is a registered trademark of Shenzhen Xunlong Software Co., Ltd.

Indice

Altri manuali Shenzhen Xunlong Software Computer a scheda singola

Shenzhen Xunlong Software

Shenzhen Xunlong Software Orange Pi Plus Manuale utente

Shenzhen Xunlong Software

Shenzhen Xunlong Software Orange Pi 5 Manuale utente

Manuali Computer a scheda singola popolari di altre marche

WIN Enterprises

WIN Enterprises PL-80910 Manuale utente

AXIOMTEK

AXIOMTEK SBC81206 Series Manuale utente

Embest

Embest SOM-PH8800 Manuale utente

SeaLevel

SeaLevel SBC-R9 Manuale utente

SMART Embedded Computing

SMART Embedded Computing ATCA-8310 Manuale utente

WinSystems

WinSystems PPM-LX800-G Manuale utente

GIGAIPC

GIGAIPC QBiX-PPC Series Manuale utente

OLIMEX

OLIMEX A10S-OLinuXino-MICRO Manuale utente

Commell

Commell FS-978 Manuale utente

GIGAIPC

GIGAIPC QBiP-8665A/ Manuale utente

VersaLogic

VersaLogic Python EBX-11 Manuale utente

Micro Computer Specialists

Micro Computer Specialists IRV-3702 Manuale utente

CompuLab

CompuLab SB-A510 Manuale utente

Boser

Boser HS-7321 Manuale utente

Premier Farnell

Premier Farnell Embest SBC8530 Manuale utente

MicroSys Electronics

MicroSys Electronics miriac SBC-LS1043A2 Manuale utente

Aaeon

Aaeon UP Manuale utente

Portwell

Portwell WUX Series Manuale utente