1.2. Purpose of Orange Pi 3B .....................1 1.3. Hardware Features of Orange Pi 3B ................... 2 1.4. Top view and bottom view of Orange Pi 3B ............... 4 1.5. Interface details of Orange Pi 3B ..................5 2. Introduction to the use of the development board ............7 2.1.
Page 3
2.9. How to burn Android image to SPIFlash+NVMe SSD ............94 2.10. Using RKDevTool to clear SPIFlash ................100 2.11. Start the Orange Pi development board ..............106 2.12. How to use the debugging serial port ................107 2.12.1. Connection instruction of debugging serial port ....... 107 2.12.2.
Page 4
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.7. SSH remote login development board; ................149 3.7.1. SSH remote login development board under Ubuntu ......149 3.7.2. SSH remote login development board under Windows ...... 150 3.8. The method of uploading files to the Linux system of the development board ....152 3.8.1.
Page 5
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.16.5. 40pin UART test ................192 3.16.6. PWM test method ................196 3.17. How to install and use wiringOP-Python ..............200 3.17.1. wiringOP-Python installation method ..........200 3.17.2. 40pin GPIO port test ................202 3.17.3.
Page 6
4.5. Compile rootfs ........................ 304 4.6. Compile Linux image .......................308 5. Instructions for using the Orange Pi OS Arch system ..........312 5.1. Orange Pi OS Arch system function adaptation ............. 312 5.2. Orange Pi OS Arch System User Guide Instructions ............313...
Page 7
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5.3. How to set DT overlays ....................319 5.4. Use of Raspberry Pi 5-inch screen ................. 321 5.4.1. How to assemble the Raspberry Pi 5-inch screen ....... 321 5.4.2.
Page 8
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8.1. User Manual Update History ..................357 8.2. Image Update History .....................357...
The AI accelerator NPU of Tops computing power can choose 2GB, 4GB or 8GB memory, and has up to 4K display processing capability. Orange Pi 3B brings out quite a lot of interfaces, including HDMI output, M.2 PCIe2.0x1, Gigabit Ethernet port, USB2.0, USB3.0 interface and 40pin expansion pin header, etc.
Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 1.3. Hardware Features of Orange Pi 3B Introduction to hardware features Master chip Rockchip RK3566 Quad-core 64-bit Cortex-A55 processor, 22nm advanced technology, main frequency up to 1.8GHz ·ARM Mali G52 2EE graphics processor ·Support OpenGL ES 1.1/2.0/3.2, OpenCL 2.0, Vulkan 1.1...
Page 11
Power Supply Type-C 5V3A Android11, Ubuntu22.04, Ubuntu20.04, Debian11, Debian12, Supported OS OpenHarmony 4.0 Beta1, Orange Pi OS (Arch), Orange Pi OS (OH) based on OpenHarmony and other operating systems. Introduction of Appearance Specifications PCB size 85mm x 56mm x 17mm weight range Pi™...
Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 1.5. Interface details of Orange Pi 3B...
Page 14
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The diameter of the four positioning holes is 2.7mm, and the diameter of the M.2 PICE device fixing hole is 2.9mm.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Introduction to the use of the development board 2.1. Prepare the required accessories 1) TF card, class 10 or above high-speed SanDisk card with a minimum capacity of 16GB (recommended 32GB or above) 2) TF card reader, used to burn the image into the TF card 3) Display with HDMI interface...
Page 16
Note, if you want to connect a 4K monitor, please make sure that the HDMI cable supports 4K video output. 5) Power adapter, Orange Pi 3B is recommended to use 5V/3A Type-C power supply for power supply 6) The mouse and keyboard of the USB interface, as long as the mouse and keyboard of...
Page 17
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) PCIe NVMe SSDs. The development board supports M.2 2230 and M.2 2242 SSDs, and M.2 2280 can also be supported, but it cannot be fixed with screws. Because the PCIe seat of the development board is relatively low, and the TF card slot next to the seat also has a part protruding.
Page 18
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) 5V cooling fan. As shown in the figure below, the development board has an interface for connecting the cooling fan, and the interface specification is 2pin 1.25mm pitch The fan on the development board can adjust the speed and switch through PWM.
Ubuntu22.04 PC Optional, used to compile Linux source code Windows PC For burning Android and Linux images 2.2. Download the image of the development board and related materials 1) The website for downloading the English version of materials is: http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and -support/Orange-Pi-3B.html...
Page 20
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) The information mainly includes Android source code: saved on Google Cloud Disk b. Linux source code: saved on Github User manual and schematic diagram: saved on Google Cloud Disk d.
Ubuntu image: saved on Google Cloud Disk g. Debian image: saved on Google Cloud Disk h. Orange Pi OS image: saved on Google Cloud Disk OpenHarmony image: saved on Google Cloud Disk 2.3. Method of burning Linux image to TF card based on...
Page 22
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then you can choose to download the Portable version of balenaEtcher software. The Portable version does not need to be installed, and you can use it by double-clicking to open it 7) If the downloaded version of balenaEtcher needs to be installed, please install it before using it.
Page 23
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Please select balenaEtcher, right-click, and select Run as administrator. 8) The specific steps to use balenaEtcher to burn the Linux image are as follows First select the path of the Linux image file to be burned b.
Page 24
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 10) After burning the Linux image, balenaEtcher will also verify the image burned into the TF card by default to ensure that there is no problem in the burning process. As shown in the figure below, a green progress bar indicates that the image has been burnt, and balenaEtcher is verifying the burnt image 11) After successful burning, the display interface of balenaEtcher is as shown in the...
3) Then download the Rockchip driver DriverAssitant_v5.12.zip and MiniLoader and the burning tool RKDevTool_Release_v3.15.zip from the Orange Pi data download page On the data download page of Orange Pi, first select the official tool, and then enter the following folder...
Page 26
4) Then download the Linux operating system image file compression package that you want to burn from the Orange Pi data download page, and then use the decompression software to decompress it. Among the decompressed files, the file ending with ".img" is the image file of the operating system , the size is generally more than 2GB 5) Then use the decompression software to decompress DriverAssitant_v5.12.zip, and...
Page 27
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) Then decompress RKDevTool_Release_v3.15.zip, this software does not need to be installed, just find RKDevTool in the decompressed folder and open it 8) After opening the RKDevTool burning tool, because the computer has not connected to the development board through the USB2.0 male-to-male data cable at this time, the lower left corner will prompt "No device found"...
Page 28
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. Make sure the TF card slot is not inserted into the TF card Then press and hold the MaskROM button on the development board, the position of the MaskROM button on the development board is shown in the figure below: d.
Page 29
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd g. Then place the mouse cursor in the area below h. Then click the right mouse button and the selection interface shown in the figure below will pop up Then select the import configuration option Then select the rk356x_linux_tfcard.cfg configuration file in the MiniLoader folder downloaded earlier, and click Open...
Page 30
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd k. Then click OK Then click the position shown in the figure below m. Then select MiniLoaderAll.bin in the MiniLoader folder downloaded earlier, and click to open...
Page 31
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd n. Then click the position shown in the figure below o. Then select the path of the Linux image you want to burn, and then click Open Before burning the image, it is recommended to rename the Linux image to be burned to orangepi.img or other shorter names, so that you can see the percentage value of the burning progress when burning the image.
Page 32
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd p. Then please check the mandatory write by address option q. Click the execute button again to start burning the Linux image to the tf card of the development board The display log after burning the Linux image is shown in the figure below...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd After burning the Linux image to the TF card, the Linux system will start automatically. How to use Win32Diskimager to burn Linux image 2.3.3. 1) First prepare a TF card with a capacity of 16GB or more. The transmission speed of the TF card must be class 10 or above.
Page 34
4) Download the Linux operating system image file compression package that you want to burn from the Orange Pi data download page, and then use the decompression software to decompress it. Among the decompressed files, the file ending with ".img" is...
Ubuntu PC Note that the Linux image mentioned here specifically refers to the images of Linux distributions such as Debian and Ubuntu downloaded from the Orange Pi data download page, and the Ubuntu PC refers to the personal computer with the Ubuntu system installed.
Page 36
6) Download the Linux operating system image file compression package that you want to burn from the Orange Pi data download page, and then use the decompression software to decompress it. Among the decompressed files, the file ending with ".img" is the image file of the operating system.
Page 37
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Orangepi3b_1.0.0_debian_bullseye_desktop_xfce_Linux5.10.160.7z Orangepi3b_1.0.0_debian_bullseye_desktop_xfce_Linux5.10.160.sha #checksum file Orangepi3b_1.0.0_debian_bullseye_desktop_xfce_Linux5.10.160.img #mirror file 7) After decompressing the image, you can first use the sha256sum -c *.sha command to calculate whether the checksum is correct. If the prompt is successful, it means that the downloaded image is correct, and you can safely burn it to the TF card.
Page 38
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 10) The interface displayed in the process of burning the Linux image by balenaEtcher is shown in the figure below, and the progress bar displays purple, indicating that the Linux image is being burned into the TF card 11) After burning the Linux image, balenaEtcher will also verify the image burned into the TF card by default to ensure that there is no problem in the burning process.
Note that all the following operations are performed on a Windows computer. Note that the Linux image mentioned here specifically refers to the images of Linux distributions such as Debian and Ubuntu downloaded from the Orange Pi data download page.
Page 40
3) Then download the Rockchip driver DriverAssitant_v5.12.zip and MiniLoader and the burning tool RKDevTool_Release_v3.15.zip from the Orange Pi data download page On the data download page of Orange Pi, first select the official tool, and then enter the following folder b. Then download all the files below...
Page 41
4) Then download the Linux operating system image file compression package that you want to burn from the Orange Pi data download page, and then use the decompression software to decompress it. Among the decompressed files, the file ending with ".img" is the image file of the operating system , the size is generally more than 2GB 5) Then use the decompression software to decompress DriverAssitant_v5.12.zip, and...
Page 42
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. After waiting for a period of time, a pop-up window will prompt "The driver is installed successfully", and then click the "OK" button. 7) Then decompress RKDevTool_Release_v3.15.zip, this software does not need to be installed, just find RKDevTool in the decompressed folder and open it 8) After opening the RKDevTool burning tool, because the computer has not connected to the development board through the USB2.0 male-to-male data cable at this time, the...
Page 43
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. Make sure that the development board is not inserted into the TF card and not connected to the power supply Then press and hold the MaskROM button on the development board, the position of the MaskROM button on the development board is shown in the figure below: d.
Page 44
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd g. Then click the right mouse button and the selection interface shown in the figure below will pop up h. Then select the import configuration option Then select the rk356x_linux_emmc.cfg configuration file in the MiniLoader folder downloaded earlier, and click Open...
Page 45
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then click OK k. Then click the position shown in the figure below Then select MiniLoaderAll.bin in the MiniLoader folder downloaded earlier, and then click to open...
Page 46
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd m. Then click the position shown in the figure below n. Then select the path of the Linux image you want to burn, and then click Open Before burning the image, it is recommended to rename the Linux image to be burned to orangepi.img or other shorter names, so that you can see the percentage value of the burning progress when burning the image.
Page 47
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd o. Then please check the option to force writing by address p. Click the execute button again to start burning the Linux image to the eMMC of the development board q.
Linux distributions such as Debian, Ubuntu, OpenWRT or OPi OS Arch downloaded from the Orange Pi data download page. 1) The development board reserves the expansion interface of the eMMC module. Before burning the system to the eMMC, you first need to purchase an eMMC module that matches the eMMC interface of the development board.
Page 49
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Linux image file (Debian, Ubuntu image or OPi Arch image downloaded from the official website) to the TF card. For the method of uploading the Linux image file to the the method of development board, please refer to the description in the section of uploading files to the development board Linux...
2.6. How to write Linux image to SPIFlash+NVMe SSD Note that the Linux image mentioned here specifically refers to the images of Linux distributions such as Debian and Ubuntu downloaded from the Orange Pi data download page. Note that all the following operations are performed on a Windows computer.
Page 51
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd PCIe3.0 and PCIe4.0 NVMe SSDs are also available, but the highest speed is only PCIe2.0x1. The M.2 2230 SSD is as follows b. The M.2 2242 SSD is as follows 2) Then insert the NVMe SSD into the M.2 PCIe interface of the development board and fix it 3) The position of the SPI Flash on the development board is shown in the figure below,...
Page 52
5) Then download the Rockchip driver DriverAssitant_v5.12.zip and MiniLoader and the burning tool RKDevTool_Release_v3.15.zip from the Orange Pi data download page On the data download page of Orange Pi, first select the official tool, and then enter the following folder b.
Page 53
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) After opening DriverInstall.exe, the steps to install the Rockchip driver are as follows Click the "Driver Installation" button b. After waiting for a period of time, a pop-up window will prompt "The driver is installed successfully", and then click the "OK"...
Page 54
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 11) Then start burning the Linux image to the SSD First, connect the development board to the Windows computer through the USB2.0 male-to-male data cable. The position of the USB2.0 programming interface of the development board is shown in the figure below b.
Page 55
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd MASKROM mode at this time, and the interface of the burning tool will prompt "found a MASKROM device" Then place the mouse cursor in the area below g. Then click the right mouse button and the selection interface shown in the figure below will pop up h.
Page 56
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd i. Then enter the MiniLoader folder downloaded earlier, then select the rk356x_linux_pcie.cfg configuration file, and click Open Then click OK k. Then click the position shown in the figure below...
Page 57
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select MiniLoaderAll.bin in the MiniLoader folder downloaded earlier, and then click to open m. Then click the position shown in the figure below n. Then enter the MiniLoader folder downloaded earlier, select rkspi_loader.img, and click Open...
Page 58
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd o. Then click the position shown in the figure below p. Then select the path of the Linux image you want to burn, and then click Open Before burning the image, it is recommended to rename the Linux image to be burned to orangepi.img or other shorter names, so that you can see the percentage value of the burning progress when burning the image.
Page 59
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd q. Then please check the option to force writing by address Click the Execute button again to start burning the Linux image to the SSD The log displayed after burning the Linux image is shown in the figure below...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd If there is a problem with burning, please clear the SPIFlash first and then try burning again. For the method of clearing SPIFlash, please refer to the description the method of using RKDevTool to clear SPIFlash.
Page 61
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) The position of SPI Flash on the development board is shown in the figure below, no other settings are required before starting to burn 4) Burning the Linux image to SPIFlash+NVMe SSD requires a TF card, so first you need to burn the Linux image to the TF card, and then use the TF card to start the development board to enter the Linux system.
Page 62
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then please wait patiently for the burning to complete. After the burning is completed, the display will be as follows (a Done will be displayed in the lower left corner): 6) Then upload the Linux image file (Debian or Ubuntu image downloaded from the official website) to the TF card.
Page 63
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd the instructions in the section on how to use the debugging serial port. 2. Use ssh to remotely log in to the Linux system, please refer to the instructions in the section of SSH remote login to the development board.
Page 64
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Note, if you upload a .7z or .xz or .gz Linux image compressed file, please remember to decompress it before using the dd command to burn. The detailed description of all parameters of the dd command and more usage can be viewed by executing the man dd command in the Linux system.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd /dev/nvme0n1p1 256M 90M 166M 36% /boot /dev/zram1 194M 15M 165M 9% /var/log tmpfs 769M 60K 769M 1% /run/user/1000 tmpfs 769M 48K 769M 1% /run/user/0 6) When the same system is programmed in the TF card and NVMe SSD, if both the TF card and NVMe SSD are inserted into the development board, then power on and start the development board, and u-boot will give priority to starting the system in the TF card.
Page 66
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) Then insert the NVMe SSD into the M.2 PCIe interface of the development board and fix it 3) The position of the SPI Flash on the development board is shown in the figure below, no other settings are required before starting the programming 4) Burning the Linux image to SPIFlash+NVMe SSD requires a TF card, so first you need to burn the Linux image to the TF card, and then use the TF card to start the...
Page 67
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd (rev 01) 6) The balenaEtcher has been pre-installed in the Linux image, and the opening method is as follows: If it is not pre-installed, for how to download and install the arm64 version of balenaEtcher, please refer to the instructions in the section on how to download and install the arm64 version of balenaEtcher.
Page 68
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. Then enter /usr/lib/Linux-u-boot-legacy-orangepi3b_1.x.x_arm64 directory, select rkspi_loader.img, and click Open to open The interface after opening rkspi_loader.img is as follows: d. Then click Select target Then click Show 2 hidden to open more options for storage devices...
Page 69
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select the device name of SPI Flash /dev/mtdblock0, and click Select g. Then click Flash h. Then click Yes, I'm sure...
Page 70
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then enter the password orangepi of the development board Linux system, and it will start burning the u-boot image into the SPI Flash The display of the burning process is as follows:...
Page 71
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd k. The display after burning is as follows: 9) The method of burning the Linux system in the TF card to the NVMe SSD (this method is equivalent to cloning the system in the TF card to the NVMe SSD) First click Clone drive...
Page 72
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. Then select the device name of the TF card /dev/mmcblk1 The interface after opening the TF card is as follows: d. Then click Select target Then click Show 2 hidden to open more options for storage devices...
Page 73
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select the device name of the NVMe SSD /dev/nvme0n1, and click Select g. Then click Flash h. Then click Yes, I'm sure...
Page 74
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then enter the password orangepi of the Linux system on the development board, and it will start burning the Linux image to the SSD The display of the burning process is as follows:...
Page 75
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd k. The display after burning is as follows: Then you need to expand the capacity of the rootfs partition in the NVMe SSD. The steps are as follows: a) Open GParted first, if the system does not have Gparted pre-installed, please use the apt command to install it orangepi@orangepi:~$ sudo apt-get install -y gparted...
Page 76
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd c) Then click Fix d) Then select NVMe SSD e) The display interface after selecting NVMe SSD is as follows:...
Page 77
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select the /dev/nvme0n1p2 partition, click the right button again, and then select Resize/Move g) Then drag the capacity to the maximum at the position shown in the figure below...
Page 78
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd h) Then click Resize/Move Then click the green in the position below √ Then click Apply k) Then click Close to close...
Page 79
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd m. At this point, you can use the sudo poweroff command to shut down. Then please pull out the TF card, and then short press the power button to turn on, then the Linux system in SPIFlash+NVMe SSD will be started.
2) You also need to prepare a good quality USB2.0 male-to-male data cable 3) Then download Rockchip driver DriverAssitant_v5.12.zip and burning tool RKDevTool_Release_v3.15.zip from Orange Pi's data download page 4) Then download the Android image from Orange Pi's download page.
Page 81
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) Then use the decompression software to decompress the compressed package of the downloaded Android image. Among the decompressed files, the file ending with ".img" is the Android image file, and the size is more than 1GB 6) Then use the decompression software to decompress DriverAssitant_v5.12.zip, and then find the DriverInstall.exe executable file in the decompressed folder and open it 7) After opening DriverInstall.exe, the steps to install the Rockchip driver are as...
Page 82
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Then decompress RKDevTool_Release_v3.15.zip, this software does not need to be installed, just find RKDevTool in the decompressed folder and open it 9) After opening the RKDevTool burning tool, because the computer has not connected to the development board through the USB2.0 male-to-male data cable at this time, the lower left corner will prompt "No device found"...
Page 83
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. Then make sure that the development board is not inserted into the TF card and not connected to the power supply Then press and hold the MaskROM button on the development board, the position of the MaskROM button on the development board is shown in the figure below: d.
Page 84
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd h. Then click the position shown in the figure below Then select MiniLoaderAll.bin in the MiniLoader folder downloaded earlier, and click to open Then click download...
Page 85
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd k. The display after downloading MiniLoaderAll.bin is shown in the figure below Then select the storage device as SD, and then click Switch Storage m. The display of successful switching is shown in the figure below...
Page 86
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd n. Then click the "Upgrade Firmware" column of the burning tool o. Then click the "Firmware" button to select the path of the Android image that needs to be burned p.
SDDiskTool tool is the latest v1.72. the Android11 image from the Orange Pi download page 4) Then download After opening the download link of the Android image, you can see the...
Page 88
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) Then use decompression software to decompress the compressed package of the downloaded Android image. Among the decompressed files, the file ending with ".img" is the Android image file, and the size is more than 1GB 6) Then use decompression software to decompress SDDiskTool_v1.72.zip, this software does not need to be installed, just find SD_Firmware_Tool.exe in the decompressed folder and open it...
Page 89
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) Then start to write the Android image to the TF card First check "SD Boot" in "Select Function Mode" b. Then select the path of the Android image in the "Select to upgrade firmware" column Finally click the "Start Create"...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2.8. How to burn Android image to eMMC Note, after burning the image into eMMC, if the test finds that it cannot be started, please clear the SPIFlash and try again. For the method of clearing SPIFlash, please refer to the method of using RKDevTool to clear SPIFlash.
Page 91
2) You also need to prepare a good quality USB2.0 male-to-male data cable 3) Then download Rockchip driver DriverAssitant_v5.12.zip and burning tool RKDevTool_Release_v3.15.zip from Orange Pi's data download page 4) Then download the Android image from Orange Pi's download page.
Page 92
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd downloaded Android image. Among the decompressed files, the file ending with ".img" is the Android image file, and the size is more than 1GB 6) Then use decompression software to decompress DriverAssitant_v5.12.zip, and then find the DriverInstall.exe executable file in the decompressed folder and open it 7) After opening DriverInstall.exe, the steps to install the Rockchip driver are as follows...
Page 93
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) After opening the RKDevTool burning tool, because the computer is not connected to the development board through the USB2.0 male-to-male data cable at this time, the lower left corner will prompt "No device found" 10) Then start burning the Android image into eMMC First, connect the development board to the Windows computer through the USB2.0 male-to-male data cable.
Page 94
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then connect the power supply of the Type-C interface to the development board If the previous steps are successful, the development board will enter the MASKROM mode at this time, and the interface of the burning tool will prompt "found a MASKROM device"...
Page 95
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd h. Select MiniLoaderAll.bin in the MiniLoader folder downloaded earlier, and click to open. Then click Download The display after downloading MiniLoaderAll.bin is shown in the figure below...
Page 96
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd k. Then select the storage device as EMMC, and then click Switch Storage The display of successful switching is shown in the figure below m. Then click the "Upgrade Firmware" column of the burning tool...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd n. Then click the "Firmware" button to select the path of the Android image that needs to be burned o. Finally, click the "Upgrade" button to start burning, and the log during the burning process is shown in the figure below.
Page 98
SDDiskTool tool is the latest v1.72 5) Then download the Android image from Orange Pi's download page After opening the download link of the Android image, you can see the following two types of Android images, please select the image in the TF card...
Page 99
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. After entering the TF card and eMMC boot image folder, you can see the following tow images, the difference between them is: a) The first image is dedicated to HDMI display and supports 4K display. If you don’t use LCD screen, please download the image without lcd b) If you want to use lcd screen, please choose image with lcd 6) Then use the decompression software to decompress the compressed package of the...
Page 100
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) After confirming the drive letter, you can format the TF card first, click the restore disk button in SDDiskTool, or use the SD Card Formatter mentioned above to format the TF card 10) Then start to write the Android image into the TF card First confirm that the displayed drive letter is the drive letter corresponding to...
Page 101
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 12) Then pull out the TF card from the computer and insert it into the development board. After the development board is powered on, it will automatically start burning the Android image in the TF card to the eMMC of the development board.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2.9. How to burn Android image to SPIFlash+NVMe SSD Note that all the following operations are performed on a Windows computer. 1) First, you need to prepare an NVMe SSD solid state drive The M.2 2230 SSD is as follows b.
Page 103
4) You also need to prepare a good quality USB2.0 male-to-male data cable 5) Then download Rockchip driver DriverAssitant_v5.12.zip and burning tool RKDevTool_Release_v3.15.zip from Orange Pi's data download page 6) Then download the image of Android11 After opening the download link of the Android image, you can see the...
Page 104
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd following two types of Android images, please select the image in the SPIFlash-NVME SSD boot image folder to download b. After entering the SPIFlash-NVME SSD boot image folder, you can see the following two images.
Page 105
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. After waiting for a period of time, a pop-up window will prompt "driver installed successfully", and then click the "OK" button. 9) Then decompress RKDevTool_Release_v3.15.zip, this software does not need to be installed, just find RKDevTool in the decompressed folder and open it 10) After opening the RKDevTool burning tool, because the computer is not connected to the development board through the USB2.0 male-to-male data cable at this time, the...
Page 106
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. Make sure that the development board is not inserted into the TF card and not connected to the power supply Then press and hold the MaskROM button on the development board, the position of the MaskROM button on the development board is shown in the figure below: d.
Page 107
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd g. Then click the "Firmware" button to select the Android image to be burned h. Finally, click the "Upgrade" button to start burning. The burning process is shown in the figure below. You can see that the firmware will be burned to SPIFlash first, and then burned to PCIE.
3) Then download the Rockchip driver DriverAssitant_v5.12.zip and MiniLoader and the burning tool RKDevTool_Release_v3.15.zip from the Orange Pi data download page On the download page of Orange Pi, first select the official tool, and then enter the following folder b. Then download all the files below...
Page 109
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Note that the "MiniLoader-things needed to burn the Linux image" folder is hereinafter referred to as the MiniLoader folder. 4) Then use decompression software to decompress DriverAssitant_v5.12.zip, and then find the DriverInstall.exe executable file in the decompressed folder and open it 5) After opening DriverInstall.exe, the steps to install the Rockchip driver are as follows Click the "Driver Installation"...
Page 110
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) After opening the RKDevTool burning tool, because the computer has not connected to the development board through the USB2.0 male-to-male data cable at this time, the lower left corner will prompt "No device found" 8) Then you can start to clear the content in SPI FLASH First, connect the development board to the Windows computer through the USB2.0 male-to-male data cable.
Page 111
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then connect the power supply of the Type-C interface to the development board, and power on, and then release the MaskROM button If the previous steps are successful, the development board will enter the MASKROM mode at this time, and the interface of the burning tool will prompt "found a MASKROM device"...
Page 112
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd h. Select MiniLoaderAll.bin in the MiniLoader folder you downloaded earlier, and click Open Then click Download The display after downloading MiniLoaderAll.bin is shown in the figure below...
Page 113
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd k. Then select the storage device as SPINOR Then click Switch Storage m. Then click Erase All to start erasing SPIFlash...
The display log after erasing SPIFlash is shown in the figure below 2.11. Start the Orange Pi development board 1) Insert the TF card with the burned image into the TF card slot of the Orange Pi development board. If the image of SPIFlash+NVMe SSD has been burnt, then there is no need to insert a TF card, just make sure that the NVMe SSD is inserted into the development board normally.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) The development board has an Ethernet port, which can be plugged into a network cable for Internet access. 5) Connect a high-quality power adapter with a 5V/3A USB Type-C interface. Remember not to plug in a power adapter with a voltage output greater than 5V, as this will burn out the development board.
Page 116
TX of the USB to TTL module is connected to the TX c. The of the development board 4) The schematic diagram of connecting the USB to TTL module to the computer and the Orange Pi development board is as follows...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The TX and RX of the serial port need to be cross-connected. If you don’t want to carefully distinguish the order of TX and RX, you can connect the TX and RX of the serial port casually first.
Page 118
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) First select the setting interface of the serial port 6) Then set the parameters of the serial port Set Serial line to connect toas /dev/ttyUSB0 ( (Modified to the corresponding node name, generally /dev/ttyUSB0)...
Page 119
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Set Flow control as None 7) After setting the setting interface of the serial port, return to the Session interface First select the Connection type as Serial b. Then click the Open button to connect to the serial port 8) After starting the development board, you can see the Log information output by the...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd system from the opened serial port terminal 2.12.3. How to use the debugging serial port on Windows platform There are many serial port debugging software that can be used under Windows, such as SecureCRT, MobaXterm, etc.
Page 121
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then choose to download the Home version d. Then select the Portable version. After downloading, you don’t need to install it, just open it and use it...
Page 122
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) After downloading, use decompression software to decompress the downloaded compressed package, you can get the executable software of MobaXterm, and then double-click to open 3) After opening the software, the steps to set up the serial port connection are as follows Open the session settings interface b.
Page 123
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) After clicking the "OK" button, you will enter the following interface. At this time, start the development board and you can see the output information of the serial port...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2.13. Instructions for using the 5v pin in the 40pin interface of the development board to supply power The power supply method we recommend for the development board is to use the 5V/3A Type C interface power cord to plug into the Type-C power interface of the development board for power supply.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3. Instructions for use of Ubuntu/Debian Server and Xfce desktop system The content of this chapter is written based on the images of the Linux server version and the xfce desktop version. 3.1.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The kernel driver is OK, 3A is not adjusted OV5647 Camera Edp Display Gigabit Ethernet port Network port status light headphone playback headphone recording LED Light watchdog test Chromium Hard solution video 3.3.
Page 127
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd root@orangepi:~$ The prompt indicates that this command is entered in the Linux system of the development board. The $ at the end of the prompt indicates that the current user of the system is a normal user. When executing a privileged command, you need to add sudo root@orangepi:~# The prompt indicates that this command is entered in the...
When the wrong password is prompted, or there is a problem with the ssh connection, please note that as long as you are using the Linux image provided by Orange Pi, please do not suspect that the above password is wrong, but look for other reasons.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd orangepi@orangepi:~$ sudo auto_login_cli.sh -d 4) Use the following command to set the orangepi user to automatically log in to the terminal again orangepi@orangepi:~$ sudo auto_login_cli.sh orangepi Instructions for automatic login of Linux desktop version 3.4.3.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The setting method of root user automatic login in Linux 3.4.4. desktop version system 1) Execute the following command to set the desktop system to automatically log in as the root user orangepi@orangepi:~$ sudo desktop_login.sh root 2) Then restart the system, and the root user will automatically log in to the desktop...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Execute the following command to set the desktop system to log in automatically with the orangepi user again orangepi@orangepi:~$ sudo desktop_login.sh orangepi The method of disabling the desktop in the Linux desktop 3.4.5.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) The method of setting the green light on and off and flashing is as follows Note that the following operations should be performed under the root user. First enter the setting directory of the green light root@orangepi:~# cd /sys/class/leds/status_led b.
Page 133
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd displayed, it is because sudo is not added. The correct command is:sudo ifconfig orangepi@orangepi:~$ ifconfig Command 'ifconfig' is available in the following places * /sbin/ifconfig * /usr/sbin/ifconfig The command could not be located because '/sbin:/usr/sbin' is not included in the PATH environment variable.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd assigns an IP address without any settings. 4) The command to test the network connectivity is as follows, the ping command can be interrupted through the shortcut key of Ctrl+C (Here is an uppercase I, not a lowercase L) orangepi@orangepi:~$ ping www.baidu.com -I eth0...
Page 135
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd If the development board is connected to the HDMI display, you can log in to the Linux system through the terminal displayed on the HDMI 2) First use the nmcli dev wifi command to scan the surrounding WIFI hotspots orangepi@orangepi:~$ nmcli dev wifi 3) Then use the nmcli command to connect to the scanned WIFI hotspot, where: a.
Page 136
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd command can be interrupted through the shortcut key Ctrl+C orangepi@orangepi:~$ ping www.orangepi.org -I wlan0 PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data. 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=2 ttl=52 time=41.3 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=3 ttl=52 time=44.9 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=4 ttl=52 time=45.6 ms...
Page 137
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Select Activate a connect and press Enter 5) Then you can see all the searched WIFI hotspots...
Page 138
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Select the WIFI hotspot you want to connect to, then use the Tab key to position the cursor on Activate and press Enter 7) Then a dialog box for entering a password will pop up, enter the corresponding password in Password and press Enter to start connecting to WIFI 8) After the WIFI connection is successful, a "*"...
Page 139
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) You can view the IP address of wifi through the ip addr show wlan0 command orangepi@orangepi:~$ ip addr show wlan0 11: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000 link/ether 24:8c:d3:aa:76:bb brd ff:ff:ff:ff:ff:ff inet 192.168.1.11/24 brd 192.168.1.255 scope global dynamic noprefixroute wlan0...
Page 140
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd --- www.orangepi.org ping statistics --- 5 packets transmitted, 5 received, 0% packet loss, time 4006ms rtt min/avg/max/mdev = 41.321/44.864/48.834/2.484 ms 3.6.2.3. Test method of desktop image 1) Click the network configuration icon in the upper right corner of the desktop (please do not connect the network cable when testing WIFI) 2) Click More networks in the pop-up drop-down box to see all scanned WIFI hotspots, and then select the WIFI hotspot you want to connect to.
Page 141
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then enter the password of the WIFI hotspot, and then click Connect to start connecting to WIFI 4) After connecting to WIFI, you can open the browser to check whether you can access the Internet.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd How to set a static IP address 3.6.3. Please do not set a static IP address by modifying the /etc/network/interfaces configuration file. 3.6.3.1. Use the nmtui command to set a static IP address 1) First run the nmtui command orangepi@orangepi:~$ nmtui 2) Then select Edit a connection and press Enter...
Page 143
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then select Edit with the Tab key and press the Enter key 5) Then use the Tab key to move the cursor to the <Automatic> position shown in the figure below to configure IPv4 6) Then press Enter, select Manual with the up and down arrow keys, and press Enter to confirm...
Page 144
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) The display after selection is shown in the figure below 8) Then move the cursor to the <Show>...
Page 145
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) Then press Enter, the following setting interface will pop up after entering 10) Then you can set the IP address (Addresses), gateway (Gateway) and DNS server address in the position shown in the figure below (there are many other setting options in yourself),Please set it according to your specific needs, the value it, please explore by set in the figure below is just an example...
Page 146
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd confirm 12) Then click<Back> to return to the previous selection interface 13) Then select Activate a connection, then move the cursor to<OK>, and finally click Enter...
Page 147
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 14) Then select the network interface that needs to be set, such as Wired connection 1, then move the cursor to<Deactivate>, and press Enter to disable Wired connection 1 15) Then please do not move the cursor, and then press the Enter key to re-enable Wired connection 1, so that the static IP address set earlier will take effect 16) Then you can exit nmtui through the<Back>...
Page 148
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 17) Then through ip addr show eth0, you can see that the IP address of the network port has changed to the static IP address set earlier orangepi@orangepi:~$ ip addr show eth0 3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP>...
Page 149
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd --- 192.168.1.47 ping statistics --- 5 packets transmitted, 5 received, 0% packet loss, time 4042ms rtt min/avg/max/mdev = 0.233/0.262/0.275/0.015 ms 3.6.3.2. Use the nmcli command to set a static IP address 1) If you want to set the static IP address of the network port, please insert the network cable into the development board first.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then restart the Linux system orangepi@orangepi:~$ sudo reboot 5) Then re-enter the Linux system and use the ip addr show eth0 command to see that the IP address has been set to the desired value orangepi@orangepi:~$ ip addr show eth0 3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP>...
Page 151
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Internet, usually eth0 * access-point-name:Hotspot name * passphrase:hotspot password 3.6.4.1. create_ap method to create WIFI hotspot in NAT mode 1)Enter the following command to create a WIFI hotspot with the name orangepi and password orangepi in NAT mode Note that in the following command, Debian12 needs to modify eth0 to end1.
Page 152
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4)The display after successful connection is as shown below 5)In NAT mode, the wireless device connected to the development board's hotspot requests an IP address from the development board's DHCP service, so there will be two different network segments.
Page 153
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6)If you want to specify a different network segment for the connected device, you can specify it through the -g parameter. For example, use the -g parameter to specify the network segment of the access point AP as 192.168.2.1.
Page 154
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Note that in the following command, Debian12 needs to modify eth0 to end1. orangepi@orangepi:~$ sudo create_ap -m nat wlan0 eth0 orangepi orangepi --freq-band 5 --no-virt 8)If you need to hide the SSID, you can specify the --hidden parameter. The specific command is as follows Note that in the following command, Debian12 needs to modify eth0 to end1.
Page 155
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd PID: 8372 Network Manager found, set wlan0 as unmanaged device... DONE Sharing Internet using method: bridge Create a bridge interface... br0 created. hostapd command-line interface: hostapd_cli -p /tmp/create_ap.wlan0.conf.hXrfLdof/hostapd_ctrl wlan0: interface state UNINITIALIZED->ENABLED 3)At this time, take out your mobile phone and find the WIFI hotspot named orangepi created by the development board in the searched WIFI list.
Page 156
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd inet6 fe80::938f:8776:5783:afa2 prefixlen 64 scopeid 0x20<link> ether 4a:a0:c8:25:42:82 txqueuelen 1000 (Ethernet) RX packets 25370 bytes 2709590 (2.7 MB) RX errors 0 dropped 50 overruns 0 frame 0 TX packets 3798 bytes 1519493 (1.5 MB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 device interrupt 83 The IP of the device connected to the WIFI hotspot is also assigned by the main...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd orangepi@orangepi:~$ sudo create_ap --no-virt -m bridge wlan0 eth0 orangepi orangepi --hidden At this time, the mobile phone cannot search for WIFI hotspots. You need to manually specify the WIFI hotspot name and enter the password to connect to the WIFI hotspot.
Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd If you are prompted to refuse the connection, as long as you are using the image provided by Orange Pi, please do not suspect that the password orangepi is wrong, but look for other reasons.
Page 159
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then you will be prompted to enter a password. The default passwords for root and orangepi users are orangepi Note that when entering the password, the specific content of the entered password will not be displayed on the screen, please do not think that there is any fault, just press Enter after inputting.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.8. The method of uploading files to the Linux system of the development board How to upload files to the development board Linux system in 3.8.1. Ubuntu PC 3.8.1.1.
Page 161
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd test@test:~$ scp dir_path orangepi@192.168.xx.xx:/home/orangepi/ 3) There are more usages of scp, please use the following command to view the man manual test@test:~$ man scp 3.8.1.2. How to upload files using filezilla 1) First install filezilla in Ubuntu PC test@test:~$ sudo apt install -y filezilla 2) Then use the following command to open filezilla...
Page 162
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) The method of connecting the development board is shown in the figure below 5) Then choose to save the password, and then click OK 6) Then choose to always trust this host, and then click OK 7) After the connection is successful, you can see the directory structure of the development board Linux file system on the right side of the filezilla software...
Page 163
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Then select the path to be uploaded to the development board on the right side of the filezilla software, and then select the file to be uploaded on the Ubuntu PC on the left side of the filezilla software, then click the right mouse button, and then click the upload option to start uploading the file to the development board.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd of the development board to view the uploaded file 10) The method of uploading a folder is the same as that of uploading a file, so I won’t go into details here The method of uploading files from Windows PC to the Linux 3.8.2.
Page 165
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd FileZilla_Server_1.5.1_win64-setup.exe During the installation process, please select Decline on the following installation interface, and then select Next> 3) The interface after filezilla is opened is as follows, and the display under the remote site on the right is empty 4) The method of connecting the development board is shown in the figure below:...
Page 166
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) Then choose to save the password, and then click OK 6) Then choose to always trust this host, and then click OK 7) After the connection is successful, you can see the directory structure of the development board Linux file system on the right side of the filezilla software...
Page 167
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Then select the path to be uploaded to the development board on the right side of the filezilla software, and then select the file to be uploaded on the Ubuntu PC on the left side of the filezilla software, then click the right mouse button, and then click the upload option to start uploading the file to the development board.
3.9. HDMI test HDMI display test 3.9.1. 1) Use HDMI to HDMI cable to connect Orange Pi development board and HDMI monitor 2) After starting the Linux system, if the HDMI monitor has image output, it means that the HDMI interface is in normal use...
Page 169
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. A VGA cable A monitor or TV that supports VGA interface 2) HDMI to VGA display test as shown below When using HDMI to VGA display, the development board and the Linux system of the development board do not need to make any settings, only the HDMI interface of the development board can display normally.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd converter, VGA cable and monitor. HDMI resolution setting method 3.9.3. 1) First open Display in Settings 2) Then you can see the current resolution of the system 3) Click the drop-down box of Resolution to see all resolutions currently supported by the monitor...
Page 171
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then select the resolution you want to set, and click Apply 5) After the new resolution is set, select Keep the configuration...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.10. How to use Bluetooth 3.10.1. Test method of desktop image 1) Click the Bluetooth icon in the upper right corner of the desktop. 2) Then select the adapter 3) If there is a prompt on the following interface, please select Yes...
Page 173
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then set Visibility Setting as Always visible in the Bluetooth adapter settings interface, and then close it 5) Then open the configuration interface of the Bluetooth device 6) Click Search to start scanning the surrounding Bluetooth device...
Page 174
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) Then select the Bluetooth device you want to connect to, and then click the right button of the mouse to pop up the operation interface for this Bluetooth device, select Pair to start pairing, and the demonstration here is to pair with an Android phone 8) When pairing, the pairing confirmation box will pop up in the upper right corner of the desktop.
The USB interface can be connected to a USB hub to expand the number of USB interfaces. 3.11.1. Connect the USB mouse or keyboard to test 1) Insert the USB interface keyboard into the USB interface of the Orange Pi development board...
(the mouse can only be used in the desktop version of the system) 3.11.2. Connect the USB storage device test 1) First insert the U disk or USB mobile hard disk into the USB interface of the Orange Pi development board...
Page 177
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd RTL8811 Support 2.4G +5G WIFI RTL8821CU Support 2.4G +5G WIFI Support BT 4.2 RTL8723BU test 3.11.3.1. 1) First insert the RTL8723BU wireless network card module into the USB interface of the development board 2) Then the Linux system will automatically load the RTL8723BU bluetooth and WIFI-related kernel modules, through the lsmod command, you can see that the...
Page 178
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd lmp_subver=8723 83.603894] Bluetooth: hci0: RTL: rom_version status=0 version=1 83.603920] Bluetooth: hci0: RTL: loading rtl_bt/rtl8723b_fw.bin 83.610108] Bluetooth: hci0: RTL: loading rtl_bt/rtl8723b_config.bin 83.611274] Bluetooth: hci0: RTL: cfg_sz 68, total sz 22564 83.658494] rtk_btusb: Realtek...
Page 179
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 5) Then you can see the USB Bluetooth device through the hciconfig command orangepi@orangepi:~$ sudo apt update && sudo apt install bluez orangepi@orangepi:~$ hciconfig hci0: Type: Primary Bus:...
Page 180
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) Please refer to the Bluetooth use method for Bluetooth test method, so I won't go into details here. RTL8811 test 3.11.3.2. 1) First insert the RTL8811 wireless network card module into the USB interface of the development board.
3.11.4. USB Camera Test 1) First, you need to prepare a USB camera that supports UVC protocol as shown in the figure below or similar, and then insert the USB camera into the USB port of the Orange Pi development board...
Page 182
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) In the desktop system, Cheese can be used to directly open the USB camera. The method of opening Cheese is shown in the figure below: The interface after Cheese turns on the USB camera is shown in the figure below: 4) How to test the USB camera using fswebcam Install fswebcam orangepi@orangepi:~$ sudo apt update...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd a) -d The option is used to specify the device node of the USB camera b) --no-banner Used to remove the watermark of photos c) -r The option is used to specify the resolution of the photo d) -S The option is used to set the number of previous frames to skip e) ./image.jpg The name and path for setting the generated photos orangepi@orangepi:~$ sudo fswebcam -d /dev/video0 \...
Page 184
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then select the audio.wav file, right click and select open with vlc to start playing 4) Methods to switch different audio equipment such as HDMI playback and headset playback First open the volume control interface b.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.12.2. How to play audio with commands Headphone interface play audio test 3.12.2.1. 1) First insert the headset into the headphone jack of the development board 2) Then you can check the sound card device supported by the Linux system through the aplay -l command.
HDMI Audio Play Test 3.12.2.2. 1) First use the HDMI to HDMI cable to connect the Orange PI development board to the TV (other HDMI displays need to ensure that the audio can be played) 2) Then check the sound card serial number of HDMI. From the output below, you can...
1) Orange Pi 3B Development board 40 Pin interface pins, please refer to the figure below 2) The function of the Orange Pi 3B development board 40 PIN interface pins is shown in the table below. Below is a complete pins of 40pin...
Page 188
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. The following form is a picture on the left half of the full table above, which can be seen clearly The following form is a picture on the right half of the top table above, which can be seen clearly...
3.15. How to install wiringOP Note that wiringOP has been pre-installed in the Linux image released by Orange Pi. Unless the code of wiringOP is updated, there is no need to re-download, compile and install, and use it directly. The storage path of the compiled wiringOP deb package in orangepi-build is: orangepi-build/external/cache/debs/arm64/wiringpi_x.xx.deb...
Page 190
-y git orangepi@orangepi:~$ git clone https://github.com/orangepi-xunlong/wiringOP.git -b next Note that Orange Pi 3B needs to download the code of the wiringOP next branch, please don't miss the parameter of -b next。 If there is a problem with the download code from GitHub, you can use the...
3.16.1. 40pin GPIO port test The Linux system released by Orange Pi has a pre-installed blink_all_gpio program, which will set all 28 GPIO ports in the 40pin to switch between high and low levels continuously.
Page 192
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The method of running blink_all_gpio program is shown below: orangepi@orangepi3b:~$ sudo blink_all_gpio #Remember to add sudo permissions [sudo] password for orangepi: #You need to enter password here 1) There are a total of 28 GPIO ports in the 40pins of the development board that can be used.
3.16.2. 40pin GPIO port pull-down resistance setting method Note that the 4 GPIO pins below Orange Pi 3B are invalid because there are 3.3V on the outside, so setting drop-down is invalid. Other pins can be set normally 1) Below the No.
6) Then enter the following command to read the level of the GPIO port, if the level is 0, the pull-down mode is set successfully root@orangepi:~/wiringOP# gpio read 3.16.3. 40pin SPI Test 1) From the schematic diagram of the 40PIN interface, the SPI available for Orange Pi 3B is spi3...
Page 195
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) In the linux system, the SPI in the 40 pin is closed by default, and it needs to be opened manually before it can be used. The detailed steps are as follows: First run orangepi-config, ordinary users remember to add sudo permission orangepi@orangepi:~$ sudo orangepi-config b.
Page 196
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select <Save> to save Then select <Back> g. Then select <Reboot> to restart the system to make the configuration take effect...
FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ..@..▒....▒. 3.16.4. 40pin I2C Test 1) From the table below, the I2C available for Orange Pi 3B is I2C2, I2C3, and I2C4 a total of three groups of I2C bus.
Page 198
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd As can be seen from the above table, i2c4_m0 and spi3_m0 are multiplexed pins, and both cannot be opened at the same time, and i2c3_m0 and uart3_m0 are also referenced.
Page 199
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then use the arrow keys on the keyboard to navigate to the position shown in the figure below, and then use the space to select the I2C configuration you want to open Then select <Save>...
3.16.5. 40pin UART test 1) As can be seen from the table below, the available uarts for Orange Pi 3B are uart2, uart3, uart7 and uart9, a total of four groups of uart buses, of which uart2 is the system’s...
Page 201
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd As can be seen from the above table, i2c3_m0 and uart3_m0 are pin-multiplexed, and both cannot be turned on at the same time. Please note that uart2_m0 is used as the debugging serial port of the system by default.
Page 202
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then use the arrow keys on the keyboard to navigate to the position shown in the figure below, and then use the space to select the UART configuration you want to open Then select <Save>...
Page 203
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd corresponding to uart under/dev orangepi@orangepi:~# ls /dev/ttyS* /dev/ttyS3 /dev/ttyS7 /dev/ttyS9 /dev/ttyS1 4) tThen start to test the uart interface, first use the DuPont line to short-circuit the rx and tx of the uart interface to be tested uart3 uart7...
5: -> 3.16.6. PWM test method 1) As can be seen from the table below, Orange Pi 3B has two pwm channels available pwm11 and pwm15 2) In the linux system, the PWM in the 40 pin is turned off by default, and it needs to be turned on manually before it can be used.
Page 205
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select Hardware d. Then use the arrow keys on the keyboard to navigate to the position shown in the figure below, and then use the space to select the PWM configuration you want to open Then select <Save>...
Page 206
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd g. Then select <Reboot> to restart the system to make the configuration take effect 3) After opening a pwm, there will be an extra pwmchipX in /sys/class/pwm/ (X is a specific number), for example, after opening pwm11, check the pwmchipX under /sys/class/pwm/ one becomes two orangepi@orangepi:~$ ls /sys/class/pwm/...
Page 207
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then use the following command to make pwm11 output a 50Hz square wave (please switch to the root user first, and then execute the following command) root@orangepi:~# echo 0 > /sys/class/pwm/pwmchip1/export root@orangepi:~# echo 20000000 >...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.17. How to install and use wiringOP-Python wiringOP-Python is the Python language version of wiringOP, which is used to operate the hardware resources of the development board, such as GPIO, I2C, SPI and UART, in the Python program.
Page 209
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then enter the following command. If there is a help information output, it means that Wiringop-Python is successfully installed. Press the q key to exit the interface of the help information root@orangepi:~/wiringOP-Python# python3 -c "import wiringpi;...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd # Do not make changes to this file unless you know what you are doing--modify # the SWIG interface file instead. CLASSES builtins.object GPIO Serial class GPIO(builtins.object) | GPIO(pinmode=0) >>>...
Page 211
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 1) The following takes pin 7 — the corresponding GPIO is GPIO4_C3 — the corresponding wPi number is 2—as an example to demonstrate how to set the high and low levels of the GPIO port 2) The steps to test directly with the command are as follows: First set the GPIO port to output mode, where the first parameter of the...
GPIO ports in the 40 pins of the development board to change continuously. root@orangepi:~/wiringOP-Python# cd examples root@orangepi:~/wiringOP-Python/examples# ls blink.py blink.py root@orangepi:~/wiringOP-Python/examples# python3 blink.py 3.17.3. 40pin SPI test 1) From the schematic diagram of the 40pin interface, the SPI available for Orange Pi 3B is spi3...
Page 213
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) In the linux system, the SPI in the 40 pin is closed by default, and it needs to be opened manually before it can be used. The detailed steps are as follows: First run orangepi-config, ordinary users remember to add sudo permission orangepi@orangepi:~$ sudo orangepi-config b.
Page 214
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select <Save> to save Then select <Back> g. Then select <Reboot> to restart the system to make the configuration take effect...
Page 215
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) First check whether there is a spidev3.0 device node in the Linux system. If it exists, it means that SPI3 has been set up and can be used directly orangepi@orangepi:~$ ls /dev/spidev3.0 /dev/spidev3.0 4) Then you can use the spidev_test.py program in the examples to test the loopback...
FF FF FF FF FF F0 0D |..@..| 3.17.4. 4.40pin I2C test 1) As can be seen from the table below, the available i2c for Orange Pi 3B is i2c2, i2c3 and i2c4, a total of three sets of i2c buses As can be seen from the above table, i2c4_m0 and spi3_m0 are multiplexed pins, and both cannot be opened at the same time.
Page 217
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then use the arrow keys on the keyboard to navigate to the position shown in the figure below, and then use the space to select the I2C configuration you want to open Then select <Save>...
Page 218
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) After starting the Linux system, first confirm that there is an i2c device node under /dev orangepi@orangepi:~# ls /dev/i2c-* /dev/i2c-2 /dev/i2c-3 /dev/i2c-4 /dev/i2c-0 /dev/i2c-6 4) Then connect a I2C device on the I2C pin of the 40PIN connector. Here is an example of the DS1307 RTC module.
3.17.5. 40pin's UART test 1) As can be seen from the table below, the available uarts for Orange Pi 3B are uart2, uart3, uart7 and uart9, a total of four groups of uart buses, of which uart2 is the system’s debugging serial port by default.
Page 220
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select Hardware d. Then use the arrow keys on the keyboard to navigate to the position shown in the figure below, and then use the space to select the UART configuration you want to open Then select <Save>to save Then select <Back>...
Page 221
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd g. Then select <Reboot>to restart the system to make the configuration take effect 3) After entering the Linux system, first confirm whether there is a device node corresponding to uart under /dev orangepi@orangepi:~# ls /dev/ttyS* /dev/ttyS1 /dev/ttyS3 /dev/ttyS7 /dev/ttyS9...
Out: 0: -> Out: 1: -> Out: 2: -> Out: 3: -> Out: 4:^C exit 3.18. Hardware watch the door dog test The watchdog_test program is pre-installed in the Linux system released by Orange Pi, which can be tested directly.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The method to run the watchdog_test program is as follows: The second parameter 10 indicates the counting time of the watchdog. If the dog is not fed within this time, the system will restart b.
Page 224
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd tcher-electron_1.7.9+5945ab1f_arm64.deb b. The download address of the AppImage version that does not need to be installed is as follows: https://github.com/Itai-Nelken/BalenaEtcher-arm/releases/download/v1.7.9/balenaE tcher-1.7.9+5945ab1f-arm64.AppImage 2) How to install and use the deb version of Balenaetcher: The deb version of balenaEtcher installation command is as follows: orangepi@orangepi:~$ sudo apt install -y \ --fix-broken ./balena-etcher-electron_1.7.9+5945ab1f_arm64.deb...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) How to use the AppImage version of balenaEtcher: First add permissions to Balenaetcher orangepi@orangepi:~/Desktop$ chmod +x balenaEtcher-1.7.9+5945ab1f-arm64.AppImage b. Then select the AppImage version balenaEtcher right-click the mouse, and then click Execute to open balenaEtcher 3.21.
Page 226
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) After restarting, you can see that the size of the /tmp space has become 2G. orangepi@orangepi:~$ df -h | grep "/tmp" 2.0G tmpfs 2.0G 1% /tmp 3) Then enter the following command in the Linux system to start the installation of the Bt-Panel orangepi@orangepi:~$ sudo install_bt_panel.sh 4) Then the Bt-Panel installation program reminds whether to install the Bt-Panel to the...
Page 227
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) At this time, enter the panel address displayed above in the browser to open the login interface of the Bt-Panel Linux panel, and then enter the username and password displayed in the corresponding position to log in to the Bt-Panel 7) After successfully logging into the Bt-Panel, the following welcome interface will pop up.
Page 228
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) After entering the Bt-Panel, you will first be prompted to bind an account on the official website of the Bt-Panel. If you do not have an account, you can go to the official website of the Bt-Panel (https://www.bt.cn) to register one 9) The final display interface is shown in the figure below.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Manual:http://docs.bt.cn Forum address:https://www.bt.cn/bbs GitHub Link:https://github.com/aaPanel/BaoTa 3.22. Set the Chinese environment and install Chinese input method Note that before installing the Chinese input method, please make sure that the Linux system used in the development board is the desktop version system。...
Page 230
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. After exiting the interface, the locale settings will be started. The output displayed by the command line is shown below orangepi@orangepi:~$ sudo dpkg-reconfigure locales Generating locales (this might take a while)... en_US.UTF-8...
Page 231
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then select Yes 5) Then select fcitx 6) Then select OK...
Page 232
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then restart the Linux system to make the configuration effective 8) Then open Fcitx configuration 9) Then click the + of the position shown in the figure below...
Page 233
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 10) Then search Google Pinyin and click OK 11) Then put Google Pinyin to the front...
Page 234
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 12) Then open the Geany editor to test the Chinese input method 13) The Chinese input method test is shown below...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 14) You can switch the Chinese and English input method through the Ctrl+Space shortcut 15) If the entire system is required as Chinese, the variables in /etc/default/locale can be set to zh_CN.UTF-8 orangepi@orangepi:~$ sudo vim /etc/default/locale # File generated by update-locale...
Page 236
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) Then find Chinese (China) option 3) Then use the left mouse button to select Chinese (China) and hold it down, and then drag it up to the beginning. The display is shown below:...
Page 237
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Note that this step is not easy to drag, please try more patiently。 4) Then select the Apply System-Wide to apply the Chinese settings to the entire system 5) Then set the Keyboard input method system to fcitx...
Page 238
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then restart the Linux system to make the configuration effective 7) After re-entering the system, please do not ask me again at the interface below, and then determine whether the standard folder should be updated as Chinese based on your preference.
Page 239
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) Then we can open the Geany to test Chinese input method , and the way to open is shown in the figure below 10) After opening Geany, the default is an English input method. We can switch into Chinese input method through the Ctrl+Space shortcut keys, and then we can enter Chinese...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.22.3. The installation method of ubuntu 22.04 system 1) First open Language Support 2) Then find Chinese (China) option...
Page 241
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then use the left mouse button to select Chinese (China) and hold it down, and then drag it up to the beginning. The display after dragging is shown in the figure below: Note that this step is not easy to drag, please try more patiently.
Page 242
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then restart the Linux system to make the configuration effective 6) After re-entering the system, please do not ask me again at the interface below, and then determine whether the standard folder should be updated as Chinese based on your preference 7) Then you can see that the desktop is displayed as Chinese...
Page 243
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Then open the Fcitx5 configuration program 9) Then choose to use Pinyin input method...
Page 244
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 10) The interface after the selection is shown below, then click OK 11) Then we can open the Geany to test Chinese input method, and the way to open is shown in the figure below...
Page 245
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 12) After opening Geany, it is still an English input method by default. We can switch into Chinese input methods through the Ctrl+Space shortcut keys, and then we can enter Chinese...
Orange Pi development board through NoMachine on a variety of devices. The following demonstrates how to remotely log in to the Linux system desktop of the Orange Pi development board through NoMachine in Windows. For installation methods on other platforms, please refer to the official documentation of NoMachine.
Page 247
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. In addition, you can also download the installation package to NoMachine in the official tools. First enter the remote login software-Nomachine folder Then download the ARM64 version of the DEB installation package Then upload the downloaded nomachine_x.x.x_x_arm64.deb to the Linux system of the development board.
Page 248
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd https://downloads.nomachine.com/download/?id=8 3) Then install nomachine in Windows. Please restart the computer after installation 4) Then open NoMachine in Window 5) After NoMachine starts, it will automatically scan other devices installed with NoMachine in the LAN.
Page 249
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) Then enter the username and password of the Linux system in the corresponding position in the figure below, and then click OK to start logging in 8) Then click OK in the next interface 9) Finally, you can see the desktop of the development board Linux system...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.23.2. Use VNC remote login Before operation, please make sure that the Windows computer and the development board are in the same LAN, and you can log in to the Ubuntu or Debian system of the development board through ssh.
Page 251
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Starting applications specified in /root/.vnc/xstartup Log file is /root/.vnc/orangepi3b:1.log 2) The steps to use the MobaXterm software to connect to the Linux system desktop of the development board are as follows: First click on Session, then select VNC, then fill in the IP address and port of the development board, and finally click OK to confirm b.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.24. Some programming language tests supported by Linux system 3.24.1. Debian Bullseye system 1) Debian Bullseye has a gcc compilation tool chain installed by default, which can directly compile C language programs in the Linux system of the development board The version of gcc is as follows orangepi@orangepi:~$ gcc --version gcc (Debian 10.2.1-6) 10.2.1 20210110...
Page 253
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd return 0; Then compile and run hello_world.c orangepi@orangepi:~$ gcc -o hello_world hello_world.c orangepi@orangepi:~$ ./hello_world Hello World! 2) Debian Bullseye has Python3 installed by default The specific version of Python is as follows orangepi@orangepi:~$ python3 Python 3.9.2 (default, Feb 28 2021, 17:03:44) [GCC 10.2.1 20210110] on linux...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then compile and run hello_world.java orangepi@orangepi:~$ javac hello_world.java orangepi@orangepi:~$ java hello_world Hello World! 3.24.2. Debian Bookworm system 1) Debian Bookworm is installed with a gcc compilation tool chain by default, which can directly compile C language programs in the Linux system of the development board The version of gcc is as follows orangepi@orangepi:~$ gcc --version...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Type "help", "copyright", "credits" or "license" for more information. >>> Use the Ctrl+D shortcut to exit python's interactive mode. b. Write the hello_world.py program in Python language orangepi@orangepi:~$ vim hello_world.py print('Hello World!') The result of running hello_world.py is as follows orangepi@orangepi:~$ python3 hello_world.py...
Page 256
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0 Copyright (C) 2019 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Java default You can use the following command to install openjdk-17 orangepi@orangepi:~$ sudo apt install -y openjdk-17-jdk b. After installation, you can check the version of Java orangepi@orangepi:~$ java --version openjdk 17.0.2 2022-01-18 OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.04) OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)
Page 258
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd int main(void) printf("Hello World!\n"); return 0; Then compile and run hello_world.c orangepi@orangepi:~$ gcc -o hello_world hello_world.c orangepi@orangepi:~$ ./hello_world Hello World! 2) Ubuntu jammy is installed with Python3 by default The specific version of Python3 is as follows orangepi@orangepi:~$ python3 3.10.4...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd public class hello_world public static void main(String[] args) System.out.println("Hello World!"); d. Then compile and run hello_world.java orangepi@orangepi:~$ javac hello_world.java orangepi@orangepi:~$ java hello_world Hello World! 3.25. QT installation method 1) Use the following script to install QT5 and QT Creator orangepi@orangepi:~$ install_qt.sh 2) The QT version number will be automatically printed after installation...
Page 260
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd ..QMake version 3.1 5.15.8 Using Qt version in /usr/lib/aarch64-linux-gnu 3) Then you can see the QT Creator launch icon in Applications QT Creator can also be opened using the following command orangepi@orangepi:~$ qtcreator During the startup of QT and QT applications, if the following error is displayed, ignore it.
Page 261
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) The QT Creator version is shown below The default version of QT Creator in Ubuntu20.04 is as follows b. The default version of QT Creator in Ubuntu22.04 is as follows The default version of QT Creator in Debian11 is as follows...
Page 262
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. The default version of QT Creator in Debian12 is as follows 6) Then set QT First open Help->About Plugins... b. Then remove the check box for ClangCodeModel...
Page 263
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Restart QT Creator after the Settings are complete d. Then make sure that QT Creator uses the GCC compiler, if the default is Clang, change it to GCC Debian12 Please skip this step.
Page 264
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) You can then open a sample code 8) Clicking on the example code will automatically open the corresponding instruction document, you can carefully read the instructions...
Page 265
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 9) Then click Configure Project 10) Then click the green triangle in the lower left corner to compile and run the sample code...
Page 266
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 11) After waiting for a period of time, the interface shown in the following figure will pop up, which indicates that QT can compile and run normally 12) Reference documents https://wiki.qt.io/Install_Qt_5_on_Ubuntu https://download.qt.io/archive/qtcreator https://download.qt.io/archive/qt...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.26. ROS Installation Method 3.26.1. How to install ROS 1 Noetic on Ubuntu 20.04 1) The current active version of ROS 1 is as follows, the recommended version is Noetic Ninjemys http://docs.ros.org https://wiki.ros.org/Distributions...
Page 268
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd http://wiki.ros.org/noetic/Installation 4) Then use the script below to install ros1 orangepi@orangepi3b:~$ install_ros.sh ros1 5) Before using the ROS tool, you first need to initialize rosdep, and then you can quickly install some system dependencies and some core components in ROS when compiling the source code Note that running the following command needs to ensure that the development...
Page 269
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd rosdep update orangepi@orangepi:~$ rosdep update reading in sources list data from /etc/ros/rosdep/sources.list.d Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/python.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml Query rosdistro index https://raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml Skip end-of-life distro "ardent" Skip end-of-life distro "bouncy"...
Page 270
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Then please keep the terminal window just opened at the top 9) At this time, press the direction keys on the keyboard to control the little turtle to move up, down, left, and right...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.26.2. How to install ROS 2 Galactic on Ubuntu 20.04 1) The current active version of ROS 2 is as follows, the recommended version is Galactic Geochelone...
Page 272
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd http://docs.ros.org http://docs.ros.org/en/galactic/Releases.html 2) The link to the official ROS 2 Galactic Geochelone installation documentation is as follows: docs.ros.org/en/galactic/Installation.html http://docs.ros.org/en/galactic/Installation/Ubuntu-Install-Debians.html 3) It is recommended to use Ubuntu20.04 in the official installation document of ROS 2 Galactic Geochelone, so please ensure that the system used by the development board is Ubuntu20.04 desktop version.
Page 273
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd -h, --help show this help message and exit Commands: action Various action related sub-commands Various rosbag related sub-commands component Various component related sub-commands daemon Various daemon related sub-commands doctor Check ROS setup and other potential issues interface Show information about ROS interfaces...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd orangepi@orangepi:~$ ros2 run rviz2 rviz2 8) For the usage of ROS, please refer to the documentation of ROS 2 http://docs.ros.org/en/galactic/Tutorials.html 3.26.3. How to install ROS 2 Humble on Ubuntu 22.04 1) Use the install_ros.sh script to install ros2 orangepi@orangepi:~$ install_ros.sh ros2 2) The install_ros.sh script will automatically run the ros2 -h command after installing...
Page 275
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd daemon Various daemon related sub-commands doctor Check ROS setup and other potential issues interface Show information about ROS interfaces launch Run a launch file lifecycle Various lifecycle related sub-commands multicast Various multicast related sub-commands node Various node related sub-commands...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) Reference documents http://docs.ros.org/en/humble/index.html http://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html 3.27. How to install kernel header files 1) The Linux image released by OPi comes with the deb package of the kernel header file by default, and the storage location is /opt/ orangepi@orangepi:~$ ls /opt/linux-headers* /opt/linux-headers-legacy-rockchip-rk356x_x.x.x_arm64.deb...
Page 277
4) Then you can write a hello kernel module to test the kernel header file First write the code of the hello kernel module, as follows: orangepi@orangepi:~$ vim hello.c #include <linux/init.h> #include <linux/module.h> static int hello_init(void) printk("Hello Orange Pi -- init\n"); return 0; static void hello_exit(void) printk("Hello Orange Pi -- exit\n"); return; module_init(hello_init);...
Page 278
[ 2871.893988] Hello Orange Pi -- init g. Use the rmmod command to uninstall the hello.ko kernel module orangepi@orangepi:~$ sudo rmmod hello orangepi@orangepi:~$ dmesg | grep "Hello" [ 2871.893988] Hello Orange Pi -- init [ 3173.800892] Hello Orange Pi -- exit...
15pin MIPI cable 2) Then connect the 15pin MIPI cable to the Raspberry PI 5-inch screen in the way shown below (note the orientation of the insulation surface) 3) Finally connect to the LCD interface of the Orange Pi 3B development board...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.28.2. Open the Raspberry PI 5-inch screen configuration method 1) The Linux image does not open the 5-inch screen of the Raspberry PI by default. If you need to use the 5-inch screen of the Raspberry PI, you need to open it manually. 2) The steps to open the mipi lcd configuration are as follows: First run orangepi-config, ordinary users remember to add sudo permission orangepi@orangepi:~$ sudo orangepi-config...
Page 281
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d. Then use the arrow keys of the keyboard to navigate to raspi-7inch-touchscreen, and then use the space to select Then select <Save> to save Then select <Back>...
Page 282
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd g. Then select <Reboot> to restart the system for the configuration to take effect above settings will eventually configuration overlays=raspi-7inch-touchscreen to /boot/orangepiEnv.txt. After setting, you can check it first. If this configuration does not exist, then there is a problem with the settings.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.28.3. The method of server version image rotation display direction 1) Add extraargs=fbcon=rotate:the direction to rotate in /boot/orangepiEnv.txt This line configuration can set the direction displayed by the server version of the Linux system, where the number after fbcon=rotate: can be set as: a.
Page 284
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) Then select the direction you want to rotate in Rotation None: no rotation b. Left: rotate left 90 degrees Inverted: Flip up and down, which is equivalent to rotating 180 degrees d.
Page 285
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) At this point, the screen display has been rotated, and then close the Display program 6) The above steps will only select the display direction, and will not rotate the direction of the touch.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd differently for different directions. 7) Touch rotation reference https://wiki.ubuntu.com/X/InputCoordinateTransformation 3.29. How to use the eDP screen 3.29.1. Assembly method of eDP screen 1) Currently only one eDP screen is compatible, including the following accessories: 0.5 pitch 30pin single-head cable in the same direction b.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) Connect the 30pin eDP interface of the screen and the eDP interface of the development board with a 30pin single-head cable in the same direction 3.29.2. How to open the eDP screen configuration Note that the method described below is only applicable to the adapted eDP screen.
Page 288
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 1) By default, the Linux image does not have the configuration to open the eDP screen. If you need to use the eDP screen, you need to open it manually. 2) The steps to open the eDP screen configuration are as follows: First run orangepi-config, ordinary users remember to add sudo permission orangepi@orangepi:~$ sudo orangepi-config...
Page 289
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Then select <Save> to save Then select <Back> g. Then select <Reboot> to restart the system to make the configuration take effect...
Page 290
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd The above settings will eventually add the configuration of overlays=edp /boot/orangepiEnv.txt. After setting, you can check it first. If this configuration does not exist, then there is a problem with the settings. If you find it troublesome to use orangepi-config, you can also use the vim editor to open /boot/orangepiEnv.txt, and then add the configuration of overlays=edp.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3.30. Instructions for using the switch logo 1) By default, the switch logo will only be displayed in the desktop version of the system 2) Set the bootlogo variable to false in /boot/orangepiEnv.txt to turn off the switch logo orangepi@orangepi:~$ vim /boot/orangepiEnv.txt verbosity=1 bootlogo=false...
Page 292
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2.1.6 and later. To solve this problem, we provide a zfs deb package that can be installed normally, official tool which can be downloaded from the of the development board. Open the official tool, and enter the zfs-related deb package folders used by Ubuntu and Debian systems.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd znvpair 61440 2 zfs,zcommon zavl 16384 1 zfs 221184 1 zfs 77824 6 zfs,icp,zzstd,znvpair,zcommon,zavl In Debian12, the default version of zfs is 2.1.11, so we can install zfs directly through the following command.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd the U disk 4) Then execute df -h to see that pool1 is mounted to the /pool1 directory orangepi@orangepi:~$ df -h Filesystem Size Used Avail Use% Mounted on tmpfs 1.6G 18M 1.6G...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 1073741824 bytes (1.1 GB, 1.0 GiB) copied, 5.04367 s, 213 MB/s 3) Then use the following command to copy 1000 random files of size 1G root@orangepi:/pool1$ for ((i=0; i<1000; i++)); do sudo cp test.1g $i.test.1g; done 4) Then use du -lh to see that there are currently 1002G of data in the pool, but in fact the size of the ZFS pool is only 504GB (the total capacity of SSD+U disk), which cannot hold such a large amount of data...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd directories into a tar package root@orangepi:/pool1$ sudo tar -cf text.tar /var/log/ /etc/ 5) At this time, you can see that the size of the text.tar file is still 27M, but it only occupies 9.47M in the ZFS pool, indicating that the file is compressed 3.32.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Short press the switch button on the development board after shutting down to start 4) The command to restart the Linux system is orangepi@orangepi:~$ sudo reboot 4. Linux SDK——orangepi-build instructions 4.1.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd starts). If the heat dissipation is not done well, it is prone to the error of file system runaway. Compile with the Ubuntu22.04 system of the development 4.1.1. board 1) The Linux SDK, namely orangepi-build, supports running on the Ubuntu 22.04...
-y git test@test:~$ git clone https://github.com/orangepi-xunlong/orangepi-build.git -b next Note that the Orange Pi 3B development board needs to download the source code of the next branch of orangepi-build. The above git clone command needs to...
Page 300
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Downloading the orangepi-build code through the git clone command does not require entering the user name and password of the github account (the same is true for downloading other codes in this manual), if the Ubuntu PC prompts the user to enter the github account after entering the git clone command The name and password are usually entered incorrectly in the address of the orangepi-build warehouse behind the git clone.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) orangepi-build will contain the following files and folders after downloading build.sh: Compile the startup script b. external: Contains the configuration files needed to compile the image, specific scripts, and the source code of some programs, etc.
Page 302
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) The image URL of the cross-compilation toolchain in China is the open source software image site of Tsinghua University https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/ 3) After toolchains is downloaded, it will contain multiple versions of cross-compilation toolchains, and the development board will only use two of them test@test:~/orangepi-build$ ls toolchains/ gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu...
Linux kernel, and the folder named orange-pi-5.10-rk35xx stores the kernel source code of the legacy branch of the RK3588/RK3588S/RK3566 series development boards. Please do not manually name the folder name of the kernel source code Modify, if modified, the kernel source code will be re-downloaded when the compilation system is running d.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd modify it manually, if it is modified, the u-boot source code will be re-downloaded when the compiling system is running j. userpatches: Store configuration files needed to compile scripts test@test:~/orangepi-build$ ls build.sh external...
Page 305
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd u-boot source code version [ o.k. ] Compiling u-boot [ v2017.09 ] b. The version of the cross-compilation toolchain [ o.k. ] Compiler version [ aarch64-linux-gnu-gcc 7.4.1 ] Path to the generated u-boot deb package [ o.k.
Page 306
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd └── u-boot ├── LICENSE ├── orangepi-3b-rk3566_defconfig └── platform_install.sh 3 directories, 6 files 7) When the orangepi-bulid compilation system compiles the u-boot source code, it will first synchronize the u-boot source code with the u-boot source code of the github server, so if you want to modify the u-boot source code, you first need to turn off the download and update function of the source code (This function needs to be fully compiled once u-boot, otherwise it will prompt that the source code of u-boot cannot be found.
Page 307
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd update the u-boot in the SPI Flash After pressing the Enter key, a Warning will pop up first g. Press the Enter key again to start updating u-boot, and the following information will be displayed after the update is completed h.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Compile the Linux kernel 4.4. 1) Run the build.sh script, remember to add sudo permission test@test:~/orangepi-build$ sudo ./build.sh 2) Select Kernel package,then enter 3) Then select the model of the development board 4) Then it will prompt whether to display the kernel configuration interface.
Page 309
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd you can directly modify the kernel configuration, save and exit after modification. Yes, after exiting, the kernel source code will be compiled If you do not need to modify the configuration options of the kernel, when running the build.sh script, pass in KERNEL_CONFIGURE=no to temporarily block the pop-up kernel configuration interface test@test:~/orangepi-build$ sudo ./build.sh KERNEL_CONFIGURE=no...
Page 310
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Part of the information prompted when compiling the kernel source code is as follows The version of the Linux kernel source code [ o.k. ] Compiling current kernel [ 5.10.160 ] b.
Page 311
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd modules test@test:~/orangepi-build$ ls output/debs/linux-* output/debs/linux-dtb-legacy-rockchip-rk356x_1.0.0_arm64.deb output/debs/linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb output/debs/linux-headers-legacy-rockchip-rk356x_1.0.0_arm64.deb 8) The files contained in the generated Linux-image deb package are as follows Use the following command to decompress the deb package test@test:~/orangepi-build$ cd output/debs test@test:~/orangepi_build/output/debs$ mkdir test test@test:~/orangepi_build/output/debs$ cp \...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd kernel source code, so if you want to modify the Linux kernel source code, you first need to turn off the update function of the source code (You need to fully compile the Linux kernel source code before turning off this function.
Page 313
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then select the model of the development board 4) Then select the type of rootfs 5) Then select the type of image Image with console interface (server) Indicates the image of the server version, which is relatively small b.
Page 314
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd the Standard version or the Minimal version. The pre-installed software of the Minimal version will be much less than that of the Standard version (please do not choose the Minimal version if there is no special requirement, because many things are not pre-installed by default.
Page 315
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Then it will start to compile rootfs, and some of the information prompted during compilation are as follows The type of rootfs [ o.k. ] local not found [ Creating new rootfs cache for jammy] b.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd generate Determine whether rootfs needs to be recompiled b. jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4.list lists the package names of all packages installed by rootfs test@test:~/orangepi-build$ ls external/cache/rootfs/ jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4 jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4.current jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4.list 10) If the required rootfs already exists under external/cache/rootfs, then compiling rootfs again will directly skip the compilation process and will not restart the compilation.
Page 317
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then select the type of rootfs 5) Then select the type of image Image with console interface (server) Indicates the image of the server version, which is relatively small b.
Page 318
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) If you are compiling the image of the desktop version, you also need to select the type of desktop environment. Currently, Ubuntu Jammy mainly maintains XFCE and Gnome desktops, Ubuntu Focal only maintains XFCE desktops, and Debian Bullseye mainly maintains XFCE and KDE desktops You can then select additional packages that need to be installed.
Page 319
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd a. Initialize the compilation environment of Ubuntu PC and install the software packages required for the compilation process b. Download the source code of u-boot and Linux kernel (if cached, only update the code) c.
Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5. Instructions for using the Orange Pi OS Arch system 5.1. Orange Pi OS Arch system function adaptation Function OPi OS Arch USB2.0x3 USB3.0x1 SPIFlash+M.2 NVMe SSD Boot OK,It needs to be pasted with SPI...
LED lights 5.2. Orange Pi OS Arch System User Guide Instructions First of all, please note that the OPi OS Arch system does not have a default orangepi user and password, so after burning and starting the system, it is impossible to log in remotely through the serial port and ssh directly (not even the root user).
Page 322
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b) First you need to choose the desired language c) After selecting the language, the user guide will immediately switch to the corresponding language interface, such as the Chinese display as shown below...
Page 323
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd d) Then select the area e) Then select the keyboard model...
Page 324
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd f) Then create a new user name and set a password g) Then make sure that there is no problem with the selection, and then click the install button...
Page 325
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd h) Then wait for the installation to complete i) After the installation is complete, you need to click the Finish button to restart the system...
Page 326
Otherwise, you need to manually close the Orange Pi Hello program every time you start At this point, you can use the newly created user name and password to log in to the...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5.3. How to set DT overlays MIPI screen, screen, multiplexing functions such I2C/SPI/UART/PWM in 40pin are disabled by default in the dts of the kernel, and the corresponding DT overlays need to be manually enabled to use. The method of opening DT overlays in OPi OS Arch system is as follows: 1) First open the /boot/extlinux/extlinux.conf configuration file [orangepi@orangepi-pc ~]$ sudo vim /boot/extlinux/extlinux.conf...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5.4. Use of Raspberry Pi 5-inch screen How to assemble the Raspberry Pi 5-inch screen 5.4.1. Please refer to the assembly method of the Raspberry Pi 5-inch screen (click the text in the blue part to jump to the corresponding position).
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd the corresponding position). How to open eDP screen configuration 5.5.2. The OPi OS Arch image does not enable the eDP screen configuration by default. If you want to use the eDP screen, you need to manually open it. The method to open the configuration is as follows: a.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd [orangepi@orangepi-pc ~]$ sudo pacman -Syy vim 6. Android 11 operating system instructions 6.1. Supported Android versions Android version Kernel version Android 11 Linux4.19 6.2. Android Function Adaptation Functions Android 11 USB2.0x3 USB3.0x1...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd adjusted Gigabit network port Network port status indicator Headphone playback Headphone recording LED Light 6.3. WIFI connection test method 1) First click enter Setting 2) Then select Network & internet 3) Then select Wi-Fi...
Page 333
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then turn on the Wi-Fi switch 5) After turning on Wi-Fi, if everything is normal, you can scan for nearby Wi-Fi hotspots 6) Then select the Wi-Fi you want to connect to, and the password input interface shown in the figure below will pop up...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7) Then use the keyboard to enter the password corresponding to Wi-Fi, and then use the mouse to click the Enter button in the virtual keyboard to start connecting to Wi-Fi 8) After the Wi-Fi connection is successful, the display is as shown in the figure below: 6.4.
Page 335
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) Then select Settings 3) Then select Network & internet 4) Then select Hotspot & tethering 5) Then select Wi-Fi hotspot...
Page 336
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then turn on the Wi-Fi hotspot, you can also see the name and password of the generated hotspot in the figure below, remember them, and use them when connecting to the hotspot (If you need to modify the name and password of the hotspot, you need to turn off the...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd to the display of your mobile phone). At this point, you can open a webpage on your mobile phone to see if you can access the Internet. If you can open the webpage normally, it means that the WI-FI Hotspot of the development board can be used normally.
Page 338
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) The searched Bluetooth devices will be displayed under Available devices 5) Then click the Bluetooth device you want to connect to start pairing. When the following interface pops up, please use the mouse to select the Pair option 6) The test here is the configuration process of the development board and the Bluetooth of the Android mobile phone.
Page 339
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd pairing process will start 7) After the pairing is completed, you can see the paired Bluetooth device as shown in the figure below 8) At this time, you can use the Bluetooth of your mobile phone to send a picture to the development board.
Both the display and touch of the Raspberry Pi 5-inch screen can be used. If you have problems with the screen test, please make sure that the screen you purchased is exactly the same as the screen that the Orange Pi is compatible with. The Orange Pi compatible screen is described in the...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6.7. How to use the eDP screen Please make sure that the image used is the following two versions of the image: OrangePi3B_RK3566_Android11_lcd_v1.x.x.img OrangePi3B_RK3566_Android11_spi-nvme_lcd_v1.x.x.img The eDP screen has no touch function. 1) Currently only one eDP screen is compatible, including the following accessories: 0.5 pitch 30pin single-head cable in the same direction...
Page 342
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd b. 15.6-inch eDP display with a resolution of 1920x1080 2) Connect the FPC end of the 30pin single-head codirectional cable to the eDP interface of the development board, and connect the other end to the eDP interface of the screen...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then connect the Type-C power supply to the board and power it on. After the system starts, you can see the screen display as shown in the figure below 6.8.
Page 344
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) The GPIO test interface is shown in the figure below. The two rows of CheckBox buttons on the left are in one-to-one correspondence with the 40pin pins. When the CheckBox button is checked, the corresponding GPIO pin will be set to OUT mode, and the pin level will be set to high level;...
Page 345
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) There are a total of 28 GPIO ports in the 40pins of the development board that can be used. The following uses pin 7 — the corresponding GPIO is GPIO4_A4 — the corresponding wPi serial number is 2—as an example to demonstrate how to set the high and low levels of the GPIO port.
Page 346
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then click the GPIO READALL button, you can see that the current pin 7 mode is OUT, and the pin level is high 7) Click the CheckBox button in the figure below again to cancel the check status. Pin 7 will be set to low level.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd OUT, and the pin level is low 40pin UART test 6.8.2. 1) UART7 and UART9 are enabled by default in Android. The position of the 40pin is shown in the figure below, and the corresponding device nodes are /dev/ttyS7 and /dev/ttyS9 respectively 2) First click on the wiringOP icon to open the wiringOP APP...
Page 348
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) The main interface of wiringOP APP is displayed as shown in the figure below, and then click the UART_TEST button to open the UART test interface 4) The serial port test interface of the APP is shown in the figure below 5) Take the test of UART7 as an example below, select the /dev/ttyS7 node in the selection box, enter the baud rate you want to set in the edit box, and then click the OPEN button to open the /dev/ttyS7 node.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then use Dupont wire to short the RXD and TXD pins of uart7 7) Then you can enter a character in the send edit box below, and click the SEND button to start sending 8) If everything is normal, the received string will be displayed in the receiving box 40pin SPI test...
Page 350
Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd Orange Pi 3B is spi3 2) Here, the SPI interface is tested through the w25q64 module. First, the w25q64 device is connected to the SPI3 interface 3) Then click the wiringOP icon to open the wiringOP APP...
Page 351
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 5) Then click the OPEN button to initialize the SPI 6) Then fill in the bytes that need to be sent, such as reading the ID information of w25q64, fill in the address 0x9f in data[0], and then click the TRANSFER button 7) Finally, the APP will display the read ID information...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) The MANUFACTURER ID of the w25q64 module is EFh, and the Device ID is 4017h, corresponding to the value read above (h stands for hexadecimal) 40pin PWM test 6.8.4.
Page 353
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then click the PWM_TEST button on the main interface of wiringOP to enter the PWM test interface 4) The base address corresponding to PWM11 is fe6f0030, here pwmchip0 shows fdd70020.pwm on the right, then you need to click the drop-down option to select other pwmchips until fe6f0030.pwm is displayed on the right 5) When the drop-down option selects pwmchip3, the corresponding base address of...
Page 354
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then confirm the PWM channel, the default is channel 0, and confirm the PWM cycle, the default configuration is 50000ns, converted to PWM frequency is 20KHz, you can modify it yourself, click the EXPORT button to export PWM11 7) Then drag the drag bar below to change the PWM duty cycle, and then check Enable to output the PWM waveform...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6.9. How to use ADB The method of USB OTG mode switching 6.9.1. The development board has 4 USB interfaces, among which the USB interface marked in red box in the figure below can support both Host mode and Device mode, and the other 3 USB interfaces only support Host mode.
Page 356
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 2) Then select About tablet 3) Then click the Build number menu bar several times with the mouse until the prompt You are now a developer! appears...
Page 357
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) Then click to return to the previous menu 5) Then select System...
Page 358
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 6) Then select Advanced 7) Then select Developer options in the expanded column...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 8) Finally find the USB OTG Mode Switch switch, turn on the switch to switch to Device mode, turn off the switch to switch to Host mode Use the data cable to connect to adb debugging 6.9.2.
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 3) Then connect the development board to the Ubuntu PC through the USB2.0 male-to-male data cable. The position of the USB OTG interface on the development board is shown in the figure below: 4) Then install the adb tool on the Ubuntu PC test@test:~$ sudo apt update test@test:~$ sudo apt -y install adb...
Page 361
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 1) Make sure that the service.adb.tcp.port of the Android system is set to port number 5555 console:/ # getprop | grep "adb.tcp" [service.adb.tcp.port]: [5555] 2) If service.adb.tcp.port is not set, you can use the following command to set the port number of network adb console:/ # setprop service.adb.tcp.port 5555 console:/ # stop adbd...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7. How to compile Android11 source code 7.1. Download the source code of Android 11 1) First download the Android 11 source code sub-volume compressed package from the Google network disk Google Drive 2) After downloading the sub-volume compression package of the Android 11 source...
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 7.2. Compile the source code of Android 11 1) First install the software packages required to compile the Android11 source code test@test:~$ sudo apt-get update test@test:~$ sudo apt-get install -y git gnupg flex bison gperf build-essential \ zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 libncurses5 \ lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache \ libgl1-mesa-dev libxml2-utils xsltproc unzip liblz4-tool...
Page 364
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd 4) After the compilation is complete, the following information will be printed ********rkImageMaker ver 2.1******** Generating new image, please wait... storage is spinor Writing head info... Writing boot file... Writing firmware...
2023-08-25 1. Added instructions for purchasing PCIe NVMe SSDs v1.3 2023-09-05 1. Instructions for using the Orange Pi OS Arch system v1.4 2023-09-21 1. Linux:How to create a WIFI hotspot through create_ap 8.2. Image Update History Date Update Notes 2023-08-17 Orangepi3b_1.0.0_ubuntu_focal_server_linux5.10.160.7z...
Page 366
range Pi User Manual Copyright reserved by Shenzhen Xunlong Software Co., Ltd * initial version 2023-08-24 OrangePi3B_RK3566_Android11_v1.0.1.tar.gz OrangePi3B_RK3566_Android11_lcd_v1.0.1.tar.gz OrangePi3B_RK3566_Android11_spi-nvme_v1.0.1.tar.gz OrangePi3B_RK3566_Android11_lcd_spi-nvme_v1.0.1.tar.gz * Support USB OTG mode switching function 2023-08-25 Opios-arch-aarch64-xfce-opi3b-23.08.1-linux5.10.160.img.xz * Solve the problem that the app store cannot be used 2023-09-21 Orangepi3b_1.0.2_ubuntu_focal_server_linux5.10.160.7z Orangepi3b_1.0.2_ubuntu_jammy_server_linux5.10.160.7z...
Need help?
Do you have a question about the Pi 3B and is the answer not in the manual?
Questions and answers