AN758x U-Boot

U-Boot for Airoha AN7581/AN7583 with a bilingual Web recovery interface.

面向 Airoha AN7581/AN7583 的 U-Boot，集成中英文 Web 恢复页面。

Hold Reset about one second after power-on to enter Web recovery.

上电约一秒后按住 Reset，即可进入 Web 恢复页面。

Supported devices / 支持机型

Target / 构建目标	Device / 设备	SoC	Storage / 存储
hg5382a	FiberHome HG5382A	AN7581	Parallel NAND
hg5585f-ct	FiberHome HG5585F CT	AN7581	Parallel NAND
hg5585f-cu	FiberHome HG5585F CU	AN7581	Parallel NAND
hm2004-du	H3C HM2004-DU	AN7581	SPI NAND
xg2010g	Gemtek XG2010G	AN7581	SPI NAND
xr1710g	Gemtek XR1710G	AN7581	SPI NAND
zn504xg-d	ZNXT ZN504XG-D	AN7581	SPI NAND
zn515xg-d	ZNXT ZN515XG-D	AN7581	SPI NAND
ung00a	UnionMan UNG00A	AN7581	SPI NAND
xg-040g-md	Nokia XG-040G-MD	AN7581	SPI NAND
xg-040g-tf	Nokia XG-040G-TF	AN7581	SPI NAND
xg-040g-mf	Nokia XG-040G-MF	AN7583	SPI NAND

Build / 构建

export CROSS_COMPILE=/path/to/aarch64-linux-musl-
export ARM32_CROSS_COMPILE=/path/to/arm-none-eabi-
export MBEDTLS_DIR=/path/to/mbedtls-3.4.1
export BUILD_JOBS=$(nproc)

./scripts/build-an758x.sh hg5585f-ct

Artifacts are written to output/<target>/ / 产物位于 output/<target>/

Installation / 刷入

Automatic / 自动刷机

Run AN758x-Stock2UBI from the stock system. Back up the needed partitions, then upload *-preloader.bin or *-firstblock.bin together with *-bl31-u-boot.fip. The tool writes the recovery bootloader and reboots.
在原厂系统中运行 AN758x-Stock2UBI， 备份需要保留的分区，然后上传 *-preloader.bin 或 *-firstblock.bin，以及 *-bl31-u-boot.fip。工具写入恢复引导后自动重启。

Manual / 手动刷机

1. Back up every MTD partition and UBI volume.
   备份全部 MTD 分区和 UBI 卷。

2. Write one BL2 image at the beginning of NAND:
   在 NAND 开头写入以下一种 BL2 镜像：

   • Write *-firstblock.bin from NAND offset 0x0.
     从 NAND 0x0 偏移写入 *-firstblock.bin。
   • Leave the first 0x800 bytes erased and write *-preloader.bin from NAND offset 0x800.
     保持前 0x800 字节为擦除态，从 NAND 0x800 偏移写入 *-preloader.bin。

3. Boot the device. When BL2 requests a FIP, press x and send *-bl31-u-boot.fip through XMODEM.
   启动设备；BL2 请求 FIP 时按 x，通过 XMODEM 发送 *-bl31-u-boot.fip，临时进入 U-Boot。

With either method, connect Ethernet and open http://192.168.0.1/ (the first boot may take about one minute). For the first installation, select Rebuild UBI / 重建 UBI, then write *-bl31-u-boot.fip, restore the board-data volumes, upload the sysupgrade image, and select Boot system / 启动系统.
通过以上任一方法进入 U-Boot 后，连接网线并打开 http://192.168.0.1/（首次启动 可能需要约一分钟）。首次安装选择 重建 UBI，随后写入 *-bl31-u-boot.fip、 恢复板级数据卷、上传 sysupgrade 镜像，最后选择 启动系统。

Subsequent upgrades use Install system / 刷写系统 directly.

后续升级直接使用 刷写系统。

TF-A sources / TF-A 来源

• Ansuel/atf-airoha
• mkshevetskiy/atf-airoha
• Yuzhii0718/atf-airoha