system/arm/orangepi.rst

1 Orange Pi PC (``orangepi-pc``)
5 based embedded computer with mainline support in both U-Boot
6 and Linux. The board comes with a Quad Core Cortex-A7 @ 1.3GHz,
7 1GiB RAM, 100Mbit ethernet, USB, SD/MMC, USB, HDMI and
15  * SMP (Quad Core Cortex-A7)
20  * Timer device (re-used from Allwinner A10)
24  * USB 2.0 interfaces
36 - Graphical output via HDMI, GPU and/or the Display Engine
37 - Audio output
38 - Hardware Watchdog
41 for a complete list of unimplemented I/O devices: ``./hw/arm/allwinner-h3.c``
46 The Orange Pi PC machine can start using the standard -kernel functionality
49 based SoC, which loads the bootloader from a SD card, specified via the -sd argument
50 to qemu-system-arm.
52 Machine-specific options
55 The following machine-specific options are supported:
57 - allwinner-rtc.base-year=YYYY
60   and uses a default base year value which can be overridden using the 'base-year' property.
65 - allwinner-sid.identifier=abcd1122-a000-b000-c000-12345678ffff
68   For example, U-Boot uses it to determine a unique MAC address.
70 The above machine-specific options can be specified in qemu-system-arm
71 via the '-global' argument, for example:
73 .. code-block:: bash
75   $ qemu-system-arm -M orangepi-pc -sd mycard.img \
76        -global allwinner-rtc.base-year=2000
85 .. code-block:: bash
87   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make mrproper
88   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make sunxi_defconfig
90 To be able to use USB storage, you need to manually enable the corresponding
93 .. code-block:: bash
95   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make menuconfig
99   Device Drivers > USB support > USB Mass Storage support
103 .. code-block:: bash
105   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make
109 .. code-block:: bash
111   $ qemu-system-arm -M orangepi-pc -nic user -nographic \
112       -kernel /path/to/linux/arch/arm/boot/zImage \
113       -append 'console=ttyS0,115200' \
114       -dtb /path/to/linux/arch/arm/boot/dts/sun8i-h3-orangepi-pc.dtb
127    https://www.armbian.com/orange-pi-pc/
133 done with the ``qemu-img`` command. It is recommended to only increase the image size
138 .. code-block:: bash
140   $ qemu-img resize Armbian_19.11.3_Orangepipc_bionic_current_5.3.9.img 1G
142 You can choose to attach the selected image either as an SD card or as USB mass storage.
143 For example, to boot using the Orange Pi PC Debian image on SD card, simply add the -sd
146 .. code-block:: bash
148   $ qemu-system-arm -M orangepi-pc -nic user -nographic \
149       -kernel /path/to/linux/arch/arm/boot/zImage \
150       -append 'console=ttyS0,115200 root=/dev/mmcblk0p2' \
151       -dtb /path/to/linux/arch/arm/boot/dts/sun8i-h3-orangepi-pc.dtb \
152       -sd OrangePi_pc_debian_stretch_server_linux5.3.5_v1.0.img
154 To attach the image as an USB mass storage device to the machine,
157 .. code-block:: bash
159   -drive if=none,id=stick,file=myimage.img \
160   -device usb-storage,bus=usb-bus.0,drive=stick
162 Instead of providing a custom Linux kernel via the -kernel command you may also
164 a real board would do using the BootROM. Simply pass the selected image via the -sd
165 argument and remove the -kernel, -append, -dbt and -initrd arguments:
167 .. code-block:: bash
169   $ qemu-system-arm -M orangepi-pc -nic user -nographic \
170        -sd Armbian_19.11.3_Orangepipc_buster_current_5.3.9.img
176 give the following kernel parameters via U-Boot (or via -append):
178 .. code-block:: bash
182 Running U-Boot
185 U-Boot mainline can be build and configured using the orangepi_pc_defconfig
187 for development/testing to select the following configuration setting in U-Boot:
191 To start U-Boot using the Orange Pi PC machine, provide the
192 u-boot binary to the -kernel argument:
194 .. code-block:: bash
196   $ qemu-system-arm -M orangepi-pc -nic user -nographic \
197       -kernel /path/to/uboot/u-boot -sd disk.img
199 Use the following U-boot commands to load and boot a Linux kernel from SD card:
201 .. code-block:: bash
205   => ext2load mmc 0 0x43000000 sun8i-h3-orangepi-pc.dtb
206   => bootz 0x42000000 - 0x43000000
214 For the Orange Pi PC machine, get the 'evbarm-earmv7hf' based image from:
216   https://archive.netbsd.org/pub/NetBSD-archive/NetBSD-9.0/evbarm-earmv7hf/binary/gzimg/armv7.img.gz
218 The image requires manually installing U-Boot in the image. Build U-Boot with
220 Next, unzip the NetBSD image and write the U-Boot binary including SPL using:
222 .. code-block:: bash
225   $ dd if=/path/to/u-boot-sunxi-with-spl.bin of=armv7.img bs=1024 seek=8 conv=notrunc
231 .. code-block:: bash
233   $ qemu-img resize armv7.img 2G
237 .. code-block:: bash
239   $ qemu-system-arm -M orangepi-pc -nic user -nographic \
240         -sd armv7.img -global allwinner-rtc.base-year=2000
242 At the U-Boot stage, interrupt the automatic boot process by pressing a key
245 .. code-block:: bash
248   => setenv kernel netbsd-GENERIC.ub
249   => setenv fdtfile dtb/sun8i-h3-orangepi-pc.dtb
250 …d mmc 0:1 ${fdt_addr_r} ${fdtfile}; fdt addr ${fdt_addr_r}; bootm ${kernel_addr_r} - ${fdt_addr_r}'
262 .. code-block:: bash
265     pyvenv/bin/meson test --suite thorough func-arm-arm_orangepi