Changes

Orange Pi Zero 3

810 bytes added, 09:39, 18 July 2023

no edit summary

|-

| Onboard storage

| TF micro SD card slot, 16MB SPI Flash

|-

| Ethernet

== Prepare the required accessories ==

# TF micro SD card, a high-speed SanDisk card of class 10 or above with a minimum capacity of 8GB

::[[File:zero3-img7.png]]

|-

|

<big>'''Using other brands of TF micro SD cards (non-SanDisk TF micro SD cards), as shown in the picture below (including but not limited to these cards), some friends have reported that there will be problems during the system startup process, such as the system is stuck halfway through startup, Or the reboot command cannot be used normally, and it was finally resolved after changing the SanDisk TF micro SD card. So if you use a non-SanDisk TF micro SD card and find that there is a problem with the system startup or use, please replace the SanDisk TF micro SD card and then test.'''</big>

[[File:zero3-img8.png|180px]][[File:zero3-img9.png|195px]][[File:zero3-img10.png|198px]][[File:zero3-img11-1.png|190px]]

'''Current feedback is that there are some TF micro SD cards that have problems starting on Orange Pi Zero 3'''

<big>'''In addition, the TF micro SD card that can be used normally on other types of development boards does not guarantee that it can be started normally on Orange Pi Zero 3, please pay special attention to this point.'''</big>

|}

<li>TF micro SD card reader, used to read and write TF micro SD card</li>

[[File:zero3-img12.png]]

== Method of burning Linux image to TF micro SD card based on Windows PC ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

=== How to use balenaEtcher to burn Linux image ===

# First prepare a TF micro SD card with a capacity of 8GB or more. The transmission speed of the TF micro SD card must be '''class 10 or above'''. It is recommended to use a TF micro SD card of SanDisk and other brands# Then use the card reader to insert the TF micro SD card into the computer

# 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 1GB

# Then download the burning software of Linux image——'''balenaEtcher,''' the download address is

<li>First select the path of the Linux image file to be burned</li>

<li>Then select the drive letter of the TF micro SD card</li><li>Finally click Flash to start burning the Linux image to the TF micro SD card

[[File:zero3-img32.png]]

</li></ol>

</li>

<li>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 micro SD card</li>

[[File:zero3-img33.png]]

</ol>

<li>After burning the Linux image, balenaEtcher will also verify the image burned to the TF micro SD 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.</li>

[[File:zero3-img34.png]]

</ol>

<li>After successful burning, the display interface of balenaEtcher is as shown in the figure below. If the green indicator icon is displayed, it means that the image burning is successful. At this time, you can exit balenaEtcher, and then pull out the TF micro SD card and insert it into the TF micro SD card slot of the development board. .</li>

<li>First prepare a TF micro SD card with a capacity of 8GB or more. The transmission speed of the TF micro SD card must be '''class 10 or above'''. It is recommended to use a TF micro SD card of SanDisk and other brands</li><li>Then use the card reader to insert the TF micro SD card into the computer</li><li>Then format the TF micro SD card

<li>'''SD Card Formatter''' can be used to format the TF micro SD card. The download link is</li>

{| class="wikitable" style="width:800px;"

<li>After downloading, unzip and install directly, and then open the software</li>

<li>If only a TF micro SD card is inserted into the computer, the drive letter of the TF micro SD card will be displayed in the " '''Select card''' " column. If multiple USB storage devices are inserted into the computer, you can select the corresponding drive letter of the TF micro SD card through the drop-down box</li>

</ol>

<li>After formatting the TF micro SD card, the message shown in the figure below will pop up, click OK</li>

[[File:zero3-img38.png]]

<li>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 1GB</li>

<li>Use Win32Diskimager to burn the Linux image to the TF micro SD card

<li>The download page of Win32Diskimager is</li>

<li>a) First select the path of the image file</li>

<li>b) Then confirm that the drive letter of the TF micro SD card is consistent with that displayed in the "'''Device'''" column</li>

<li>c) Finally click "'''Write'''" to start burning</li>

</li></ol>

<li>After the image writing is completed, click the "'''Exit'''" button to exit, and then you can pull out the TF micro SD card and insert it into the development board to start</li></ol>

</li></ol>

== Method of burning Linux image to TF micro SD card based on Ubuntu PC ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|}

# First prepare a TF micro SD card with a capacity of 8GB or more. The transmission speed of the TF micro SD card must be '''class 10 or above'''. It is recommended to use a TF micro SD card of SanDisk and other brands# Then use the card reader to insert the TF micro SD card into the computer

# Download the balenaEtcher software, the download address is

</ol>

<li>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 micro SD card. '''If it prompts that the checksum does not match''', it means there is a problem with the downloaded image, please try to download again</li>

{| class="wikitable" style="width:800px;"

<li>First select the path of the Linux image file to be burned</li>

<li>Then select the drive letter of the TF micro SD card</li><li>Finally click Flash to start burning the Linux image to the TF micro SD card</li>

</li></ol>

<li>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 micro SD card</li>

[[File:zero3-img42.png]]

</ol>

<li>After burning the Linux image, balenaEtcher will also verify the image burned into the TF micro SD 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</li>

[[File:zero3-img43.png]]

</ol>

<li>After successful burning, the display interface of balenaEtcher is as shown in the figure below. If a green indicator icon is displayed, it means that the image burning is successful. At this time, you can exit balenaEtcher, and then pull out the TF micro SD card and insert it into the TF micro SD card slot of the development board for use</li>

[[File:zero3-img44.png]]

== How to burn Android image to TF micro SD card ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''The Android image of the development board can only be burned into the TF micro SD card under the Windows platform using the PhoenixCard software, and the version of the PhoenixCard software must be PhonixCard-4.2.8.'''

'''Please do not use software for burning Linux images, such as Win32Diskimager or balenaEtcher, to burn Android images.'''

'''In addition, the PhoenixCard software does not have versions for Linux and Mac platforms, so it is impossible to burn Android images to TF micro SD cards under Linux and Mac platforms.'''</big>

|}

<li>If not installed '''Microsoft Visual C++ 2008 Redistrbutable - x86''', Using PhoenixCard to format TF micro SD card or burn Android image will prompt the following error</li>

</ol>

<li>Then prepare a TF micro SD card with 8GB or larger capacity. The transmission speed of the TF micro SD card must be '''class 10 or above'''. It is recommended to use a TF micro SD card of SanDisk and other brands</li><li>Then use the card reader to insert the TF micro SD card into the computer</li>

<li>Download the Android image and PhoenixCard programming tool from the [http://www.orangepi.online/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi data download page''']. '''Please ensure that the version of the PhonenixCrad tool is PhonixCard-4.2.8.''' Please do not use the PhonixCard software version lower than 4.2.8 to burn the Android image. There may be problems with the Android image flashed by this version of the PhonixCard tool</li>

</ol>

<li>After opening PhoenixCard, if the TF micro SD card is recognized normally, the drive letter and capacity of the TF micro SD card will be displayed in the middle list. '''Please make sure that the displayed drive letter is consistent with the drive letter of the TF micro SD card you want to burn'''. If there is no display, you can try to unplug the TF micro SD card, or click the "'''Refresh Drive Letter'''" button in PhoenixCard</li>

[[File:zero3-img52-1.png]]

</ol>

<li>After confirming the drive letter, format the TF micro SD card first, and click the "'''Recover Card'''" button in PhoenixCard (if the "'''Recover Card'''" button is gray and cannot be pressed, you can first click the "'''Refresh Drive Letter'''" button)</li>

|-

|

<big>'''If there is a problem with formatting, please try to unplug and insert the TF micro SD card and then test again. If the problem still exists after re-plugging and inserting the TF micro SD card, you can restart the Windows computer or try another computer.'''</big>

|}

</ol>

<li>Then start to write the Android image into the TF micro SD card

<li>First select the path of the Android image in the "'''Firmware'''" column</li>

</li></ol>

<li>After burning, the display of PhoenixCard is as shown in the figure below. At this time, click the "'''Close'''" button to exit PhoenixCard, and then you can pull out the TF micro SD card from the computer and insert it into the development board to start</li>

|-

|

<big>'''After burning the Android system, the TF micro SD card can only see a 128 MB partition in Windows, and the displayed partition is as shown in the figure below (some computers may pop up more than 20 disk partitions, but only the 128 MB partition can be opened. partition), please note that this is normal, please do not think that the TF micro SD card is burned out. The reason for this is that the Android system has a total of more than 20 partitions, but most of them cannot be recognized normally in the Windows system. At this point, please safely unplug the TF micro SD card and insert it into the development board to start it.'''</big>

[[File:zero3-img56.png|center]]

<big>'''After the Android system starts, use the following command to see the twenty or so partitions in the TF micro SD card:'''</big>

[[File:zero3-img57.png|center]]

<big>'''Use the df -h command to see that the 16GB TF micro SD card has about 11 GB of space available after burning the Android system (more than 20 partitions will not be mounted to the Android system, focus on these to the partition).'''</big>

[[File:zero3-img58.png|center]]

[[File:zero3-img59-1.png]]

There is a tiny linux system programmed into SPI Flash by default, which is mainly used to prove that the development board can start normally. When you get the development board, you don't need to burn the system into the TF micro SD card, you only need to connect the Type-C power supply to the development board to start the micro linux system in the SPI Flash. The main functions of this system are:

Due to the limited functions of the tiny linux system in SPI Flash, if you want to use all the functions of the development board normally, please burn the linux image or Android image to the TF micro SD card, and then use it.

== Start the Orange Pi development board ==

# Insert the TF micro SD card with the burned image into the TF micro SD card slot of the Orange Pi development board

# The development board has a Micro HDMI interface, and the development board can be connected to a TV or HDMI display through a Micro HDMI to HDMI cable

# If you have purchased a 13pin expansion board, you can plug the 13pin expansion board into the 13pin interface of the development board

| style="text-align: center;"| '''OK'''

|-

| style="text-align: center;"| '''TF micro SD card start'''

| style="text-align: center;"| '''OK'''

<big>'''The two LED lights on the development board are controlled by software.'''

'''When you get the development board, you may find that even if the TF micro SD card with the system programmed is not inserted into the development board, the two LED lights will be on after the development board is connected to the power supply. This is because the 16MB on the development board SPI Flash will burn a miniature linux system by default when leaving the factory. This system will light up the red light during the u-boot startup phase. After entering the kernel, it will turn off the red light and set the green light to flash.'''

'''If the linux system in the SPI Flash is cleared, then the two LED lights on the development board will not light up after the power is turned on without inserting the TF micro SD card with the system programmed'''</big>

|}

== Instructions for operating the rootfs partition capacity of the linux system in the TF micro SD card ==

=== The first startup will automatically expand the capacity of the rootfs partition in the TF micro SD card ===

<li>After burning the Linux image of the development board into the TF micro SD card, you can check the capacity usage of the TF micro SD card on the '''Ubuntu computer''', the steps are as follows:

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''Note that this step does not affect the automatic expansion of the Linux system of the development board. Here I just want to explain how to check the capacity of the TF micro SD card after burning the Linux image on the TF micro SD card.'''</big>

|}

</ol>

<li>After opening gparted, you can select the TF micro SD card in the upper right corner, and then you can see the usage of the TF micro SD card capacity</li>

[[File:zero3-img91.png]]

</ol>

<li>The figure above shows the situation of the TF micro SD card after burning the Linux desktop version system. It can be seen that although the total capacity of the TF micro SD card is 16GB (displayed as 14.84GiB in GParted), the rootfs partition (/dev/ sdc1) actually allocated only 4.05GiB, leaving 10.79GiB unallocated</li></ol>

</li></ol>

<li>Then you can insert the TF micro SD card that has burned the Linux system into the development board to start. When the TF micro SD card starts the Linux system for the first time, it will call the '''orangepi-resize-filesystem''' script automatically through the systemd service '''orangepi-resize-filesystem.service''' The expansion of the rootfs partition, '''so there is no need to manually expand the capacity'''</li><li>After logging in to the system, you can use the '''df -h''' command to check the size of the rootfs. If it is consistent with the actual capacity of the TF micro SD card, it means that the automatic expansion is running correctly.

{| class="wikitable" style="width:800px;"

</li></ol>

<li>After starting the Linux system for the first time, we can also remove the TF micro SD card from the development board and reinsert it into the '''Ubuntu computer''', and then use gparted to check the status of the TF micro SD card again, as shown in the figure below, the rootfs partition (/dev/ The capacity of sdc1) has been expanded to 14.69GiB</li>

[[File:zero3-img92.png]]

=== The method of prohibiting automatic expansion of the capacity of the rootfs partition in the TF micro SD card ===

# First burn the linux image of the development board to the TF micro SD card on the '''Ubuntu computer''' (Windows not available), '''and then re-plug and insert the TF micro SD card'''# Then the Ubuntu computer will automatically mount the partition of the TF micro SD card. If the automatic mounting is normal, use the ls command to see the following output

::{| class="wikitable" style="width:800px;"

</ol>

<li>Then enter the root directory of the linux system in the TF micro SD card and create a new file named '''.no_rootfs_resize'''</li>

{| class="wikitable" style="width:800px;"

</ol>

<li>Then you can uninstall the TF micro SD card, and then pull out the TF micro SD card and insert it into the development board to start. When the linux system starts, when the file'''.no_rootfs_resize''' is detected in the '''/root''' directory, the rootfs will not be automatically expanded.</li><li>After entering the Linux system after prohibiting automatic expansion of rootfs, you can see that the total capacity of the rootfs partition is only 4GB (the image of the desktop version is tested here), which is much smaller than the actual capacity of the TF micro SD card, indicating that the automatic expansion of rootfs is prohibited.</li>

{| class="wikitable" style="width:800px;"

</ol>

<li>If you need to re-expand the capacity of the rootfs partition in the TF micro SD card, just execute the following command, and then restart the Linux system of the development board.</li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|}

After restarting, enter the Linux system of the development board again, and you can see that the rootfs partition has been expanded to the actual capacity of the TF micro SD card

{| class="wikitable" style="width:800px;"

=== The method of manually expanding the capacity of the rootfs partition in the TF micro SD card ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''If the total capacity of the TF micro SD card is large, such as 128GB, you do not want the rootfs partition of the Linux system to use all the capacity of the TF micro SD card, but only want to allocate a part of the capacity, such as 16GB, to the Linux system, and then the remaining capacity of the TF micro SD card can be used for other use. Then you can use the content introduced in this section to manually expand the capacity of the rootfs partition in TF.'''</big>

|}

# First burn the linux image of the development board to the TF micro SD card on the '''Ubuntu computer''' (Windows not available), '''and then re-plug and insert the TF micro SD card'''# Then the Ubuntu computer will automatically mount the partition of the TF micro SD card. If the automatic mounting is normal, use the ls command to see the following output

::{| class="wikitable" style="width:800px;"

</ol>

<li>Then enter the root directory of the linux system in the TF micro SD card and create a new file named '''.no_rootfs_resize'''</li>

{| class="wikitable" style="width:800px;"

</ol>

<li>After opening gparted, you can select the TF micro SD card in the upper right corner, and then you can see the usage of the TF micro SD card capacity. The figure below shows the situation of the TF micro SD card after burning the Linux desktop version system. It can be seen that although the total capacity of the TF micro SD card is 16GB (displayed as 14.84GiB in GParted), the rootfs partition (/dev/sdc1) Only 4.05GiB were actually allocated, leaving 10.79GiB unallocated</li>

[[File:zero3-img91.png]]

</ol>

<li>Click the right mouse button again to see the operation options shown in the figure below. If the TF micro SD card has been mounted, first you need to Umount the rootfs partition of the TF micro SD card</li>

[[File:zero3-img94.png]]

</ol>

<li>Then you can pull out the TF micro SD card, insert it into the development board and start it up. After entering the Linux system of the development board, if you can see that the size of the rootfs partition is the same as the size set before, it means manual Expansion succeeded</li>

{| class="wikitable" style="width:800px;"

=== How to reduce the capacity of the rootfs partition in the TF micro SD card ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''After configuring the application program or other development environment in the Linux system of the TF micro SD card, if you want to back up the Linux system in the TF micro SD card, you can use the method in this section to reduce the size of the rootfs partition first, and then start the backup.'''</big>

|}

# First insert the TF micro SD card you want to operate in the '''Ubuntu computer''' (Windows not available)

# Then install the gparted software on the Ubuntu computer

</ol>

<li>After opening gparted, you can select the TF micro SD card in the upper right corner, and then you can see the usage of the TF micro SD card capacity</li>

[[File:zero3-img102.png]]

</ol>

<li>Click the right mouse button again to see the operation options shown in the figure below. If the TF micro SD card has been mounted, first you need to Umount the rootfs partition of the TF micro SD card</li>

[[File:zero3-img104.png]]

</ol>

<li>Then you can pull out the TF micro SD card, insert it into the development board and start it up. After entering the Linux system of the development board, if you can use the '''df -h''' command to see that the size of the rootfs partition is the same as the size set before, it means that the size has been reduced. capacity success</li>

{| class="wikitable" style="width:800px;"

<big>'''To use the method in this section, you first need to prepare a Linux system machine. For example, a computer or a virtual machine with Ubuntu system installed.'''

'''Why do you need a Linux system machine, because the root file system of the development board Linux system burned in the TF micro SD card is in ext4 format, and the Linux system machine can mount it normally, and then modify the configuration files in it.'''</big>

|}

<li>First burn the Linux image of the development board you want to use into the TF micro SD card, and then use a card reader to insert the TF micro SD card that has burned the Linux image of the development board into a machine with a Linux system (such as a machine with an Ubuntu system installed computer, the following uses Ubuntu computer as an example to demonstrate)</li><li>When the TF micro SD card is inserted into the Ubuntu computer, the Ubuntu computer will generally automatically mount the partition of the Linux root file system in the TF micro SD card. You can know from the following command that '''/media/test/opi_root''' is the Linux root file in the TF micro SD card The path where the system is mounted

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>Then enter the '''/boot''' directory of the Linux system burned in the TF micro SD card

{| class="wikitable" style="width:800px;"

|-

</li></ol>

</li>

<li>After modifying the orangepi_first_run.txt file, you can exit the /boot directory of the development board Linux system in the TF micro SD card, uninstall the TF micro SD card, and then insert the TF micro SD card into the development board to start</li>

<li>If you have not set a static IP address, you still need to check the IP address through the background of the router. If you have set a static IP address, you can ping the set static IP address on the computer. If you can ping, it means that the system has started normally, and The network has also been set correctly, and then you can use the set IP address ssh to remotely log in to the Linux system of the development board

Admin

Bureaucrats, Administrators

8,367

edits

Wiki-Orange Pi β

Changes

Orange Pi Zero 3

Wiki-Orange Pi ^β