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,
15  * SMP (Quad Core Cortex-A7)
20  * Timer device (re-used from Allwinner A10)
29  * Watchdog timer
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
93 .. code-block:: bash
95   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make menuconfig
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
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
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://cdn.netbsd.org/pub/NetBSD/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
224   $ gunzip armv7.img.gz
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
264   $ AVOCADO_ALLOW_LARGE_STORAGE=yes avocado --show=app,console run \
265      -t machine:orangepi-pc tests/avocado/boot_linux_console.py