system/arm/bananapi_m2u.rst

1 Banana Pi BPI-M2U (``bpim2u``)
4 Banana Pi BPI-M2 Ultra is a quad-core mini single board computer built with
6 has onboard WiFi and BT. On the ports side, the BPI-M2 Ultra has 2 USB A
15  * SMP (Quad Core Cortex-A7)
19  * Timer device (re-used from Allwinner A10)
35 - Graphical output via HDMI, GPU and/or the Display Engine
36 - Audio output
37 - Real Time Clock
40 for a complete list of unimplemented I/O devices: ``./hw/arm/allwinner-r40.c``
45 The Banana Pi M2U machine can start using the standard -kernel functionality
46 for loading a Linux kernel or ELF executable. Additionally, the Banana Pi M2U
48 based SoC, which loads the bootloader from a SD card, specified via the -sd
49 argument to qemu-system-arm.
51 Running mainline Linux
54 To build a Linux mainline kernel that can be booted by the Banana Pi M2U machine,
57 .. code-block:: bash
59   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make mrproper
60   $ ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make sunxi_defconfig
62 To boot the newly build linux kernel in QEMU with the Banana Pi M2U machine, use:
64 .. code-block:: bash
66   $ qemu-system-arm -M bpim2u -nographic \
67       -kernel /path/to/linux/arch/arm/boot/zImage \
68       -append 'console=ttyS0,115200' \
69       -dtb /path/to/linux/arch/arm/boot/dts/sun8i-r40-bananapi-m2-ultra.dtb
84 done with the ``qemu-img`` command. It is recommended to only increase the image size
89 .. code-block:: bash
91   $ qemu-img resize \
92     openwrt-22.03.3-sunxi-cortexa7-sinovoip_bananapi-m2-ultra-ext4-sdcard.img \
95 Instead of providing a custom Linux kernel via the -kernel command you may also
97 a real board would do using the BootROM. Simply pass the selected image via the -sd
98 argument and remove the -kernel, -append, -dbt and -initrd arguments:
100 .. code-block:: bash
102   $ qemu-system-arm -M bpim2u -nic user -nographic \
103     -sd openwrt-22.03.3-sunxi-cortexa7-sinovoip_bananapi-m2-ultra-ext4-sdcard.img
105 Running U-Boot
108 U-Boot mainline can be build and configured using the Bananapi_M2_Ultra_defconfig
109 using similar commands as describe above for Linux. Note that it is recommended
110 for development/testing to select the following configuration setting in U-Boot:
114 The BootROM of allwinner R40 loading u-boot from the 8KiB offset of sdcard.
117 .. code-block:: bash
120   $ dd if=u-boot-sunxi-with-spl.bin of=sd.img bs=1k seek=8 conv=notrunc
124 .. code-block:: bash
126   $ qemu-system-arm -M bpim2u -nographic -sd sd.img
135 .. code-block:: bash
137   $ cd qemu-build-dir
139     pyvenv/bin/meson test --suite thorough func-arm-arm_bpim2u