orangepi-build
Orange Pi's build system for kernels, U-Boot, root filesystems and complete OS images.
software
Knowledge about orangepi-build
- Build your own Orange Pi OS image with orangepi-build (non-interactive, for many devices)procedure · unverified · orangepi-build compiles U-Boot, the kernel, a root filesystem or a complete flashable image for Allwinner, Rockchip and RISC-V Orange Pi boards. It runs on an Ubuntu 22.04 host, and every menu choice can be passed as KEY=value on the command line for reproducible builds.
- Enable I2C, SPI, UART and custom device-tree overlays on Orange Pi OS: /boot/orangepiEnv.txtprocedure · unverified · On Orange Pi's Debian/Ubuntu images the boot script reads /boot/orangepiEnv.txt. List kernel-provided overlays in overlays=, add your own .dts with orangepi-add-overlay (goes to user_overlays=), and reboot. Never edit the boot script directly.
- Orange Pi 5-series serial console: 1,500,000 baud on ttyS2, and where the debug UART isprocedure · unverified · When an RK3588 Orange Pi doesn't boot, the debug UART shows why. Orange Pi's RK3588 boot script puts the kernel console on ttyS2 at 1500000 baud. The debug UART is a 3-pin header on the 5, 5B and 5 Plus and part of the 40-pin header on the 5 Max and 5 Pro.
- Run an Orange Pi from NVMe or eMMC instead of the SD card: nand-sata-install and SPI flash bootprocedure · unverified · Orange Pi images include nand-sata-install, which moves a running system from the SD card to eMMC, SATA, USB or NVMe and can put the bootloader into SPI flash ('Boot from SPI – system on SATA, USB or NVMe'). Most RK3588 Orange Pis have SPI NOR flash; on the 5 Pro it is empty by default and shares the choice with the eMMC socket.