Scroll to navigation

u-boot-install-sunxi64(8) System Manager's Manual u-boot-install-sunxi64(8)

NAME

u-boot-install-sunxi64 - install u-boot+ATF for sunxi64 (Allwinner) devices

SYNOPSIS

u-boot-install-sunxi64 [-f] card-device-or-image-file

DESCRIPTION

This tool prepares a combined u-boot+ATF setup and writes it to the disk (or possibly a disk image), allowing the machine to boot. The u-bootage is written to an area between the partition table and the first partition; there is no check if it's large enough — some ancient fdisk tools used to reserve only 31KB there, which can result in data loss.

The device will usually be /dev/mmcblk0 for SD card, /dev/mmcblk1 for eMMC, /dev/sdX for USB SD card readers (be careful wrt your other disks!).

By default, the path where .dtb and .bin files are copied from is a subdirectory of /usr/lib/u-boot deduced from the current running system, but if the $TARGET environment variable is set, its contents are used instead.

OPTIONS

-f | --force
Skip partition table sanity checks. Usually, a MBR partition table is required (so u-boot has something to work with), but in rare setups you may put the data on another disk. Likewise, GPT partition tables are incompatible with the layout used on sunxi64 devices (spl is written at offset 16384 while GPT occupies bytes [512..33280) ) but this option lets you trample upon them anyway.

CAVEATS

It has been so far tested only on Pine64+. If appropriate DTBs are provided, it may work on Pinebook, SoPine, other A64 devices, or possibly even H5. Reports are welcome!
2018-03-17 u-boot