全志AI985开发板OpenWrt OTA升级实战：从分区表配置到swupdate打包的完整避坑指南-平芜编程栈

全志AI985开发板OpenWrt OTA升级实战：从分区表配置到swupdate打包的完整避坑指南

在物联网设备快速迭代的今天，OTA（Over-The-Air）升级已成为嵌入式开发的标配能力。全志AI985作为面向智能边缘计算的高性能开发板，其OpenWrt系统的OTA实现却暗藏不少"技术雷区"。本文将带您穿越AB系统分区配置、swupdate集成、应用打包的完整战场，特别针对分区表配置异常、升级包体积爆炸、应用更新失效三大典型问题提供工业级解决方案。

1. 环境准备与分区架构设计

1.1 开发环境初始化

全志Tina Linux SDK的环境配置是后续所有操作的基础。建议使用Ubuntu 20.04 LTS系统，并确保已安装以下依赖：

sudo apt-get install -y build-essential subversion git-core libncurses5-dev zlib1g-dev gawk flex quilt libssl-dev

关键目录结构说明：

device/config/chips/ai985/：芯片级配置文件
target/ai985/ai985-evb/：板级定制文件
out/ai985/evb/pack_out/：固件输出目录

提示：建议在SDK根目录创建build.log记录所有make操作，便于后续排查问题。

1.2 AB系统分区表深度配置

sys_partition.fex的分区设计直接影响OTA的可靠性。以下是经过生产验证的配置模板：

[partition] name = bootA size = 56320 downloadfile = "boot.fex" user_type = 0x8000 [partition] name = bootB size = 56320 downloadfile = "boot.fex" user_type = 0x8000 [partition] name = rootfsA size = 1048576 downloadfile = "rootfs.fex" user_type = 0x8000 [partition] name = rootfsB size = 1048576 downloadfile = "rootfs.fex" user_type = 0x8000 [partition] name = appA size = 1048576 downloadfile = "app.fex" user_type = 0x8000 [partition] name = appB size = 1048576 downloadfile = "app.fex" user_type = 0x8000

关键参数解析：

size：单位是扇区（512字节），建议rootfs保留至少50%冗余空间
user_type：0x8000表示该分区参与OTA升级
app分区：专用于业务应用，与系统解耦

1.3 环境变量动态切换机制

env-5.15.cfg需要新增以下变量实现AB切换：

boot_partition=bootA root_partition=rootfsA app_partition=appA

升级时的切换逻辑通过fw_setenv命令动态修改这些变量值。建议增加校验机制：

# 在rc.local中添加 if ! fw_printenv boot_partition &>/dev/null; then fw_setenv boot_partition bootA fi

2. swupdate集成与配置优化

2.1 编译系统集成

执行make menuconfig时，除了选择Allwinner->System->swupdate，还需注意：

CONFIG_PACKAGE_swupdate=y CONFIG_PACKAGE_swupdate-www=y CONFIG_PACKAGE_libconfig=y

常见编译问题解决：

若出现openssl依赖错误，需确认CONFIG_OPENSSL_ENGINE已启用
libubootenv版本冲突时，建议使用SDK自带版本

2.2 升级策略文件精讲

sw-description-ab是OTA的核心大脑，典型配置如下：

now_A_next_B_emmc = { images: ( { filename = "kernel.gz"; device = "/dev/by-name/bootB"; installed-directly = true; compressed = "zlib"; }, { filename = "rootfs.gz"; device = "/dev/by-name/rootfsB"; installed-directly = true; compressed = "zlib"; } ); scripts: ( { filename = "update_script.sh"; type = "shellscript"; } ); writenv_now_A_next_B: { env: ( { name = "boot_partition"; value = "bootB"; }, { name = "root_partition"; value = "rootfsB"; } ); }; };

关键陷阱规避：

installed-directly：必须为true才能直接写入裸设备
compressed：与实际压缩格式严格一致
writenv：确保与rc.local中的挂载逻辑匹配

2.3 升级包压缩实战

原始固件体积优化前后对比：

文件类型	原始大小(MB)	压缩后大小(MB)	压缩率
boot.fex	28.1	9.8	65%
rootfs.fex	512.0	180.2	64.8%
app.fex	256.0	85.3	66.7%

压缩操作集成到打包流程：

# 在do_finish()中添加 gzip -k -f $CFG_TOP_DIR/out/ai985/evb/pack_out/app.fex gzip -k -f $CFG_TOP_DIR/out/ai985/evb/pack_out/boot.fex gzip -k -f $CFG_TOP_DIR/out/ai985/evb/pack_out/rootfs.fex

3. 应用打包与更新验证

3.1 应用打包深度优化

make_app_res()函数改造要点：

function make_app_res() { local APP_PART_NAME=appA local APP_PART_FILE_PATH="$CFG_TOP_DIR/out/ai985/evb/openwrt/build_dir/target/--/.pkgdir/--/mnt/app" # 增加文件系统检查 if [ ! -d "$APP_PART_FILE_PATH" ]; then mkdir -p "$APP_PART_FILE_PATH" chmod 755 "$APP_PART_FILE_PATH" fi # 精确计算分区大小 local APP_PART_SIZE_IN_SECTOR=$(parser_mbr sunxi_mbr_tmp_app.fex get_size_by_name ${APP_PART_NAME}) let APP_PART_SIZE_IN_K=$APP_PART_SIZE_IN_SECTOR/2 # 带日志的打包过程 echo "[$(date)] Packing app partition with size ${APP_PART_SIZE_IN_K}KB" >> /tmp/ota_pack.log ${TINA_TOOLS_PATH}/make_ext4fs -l ${APP_PART_SIZE_IN_K}k -b 1024 -m 0 -j 1024 \ ${LICHEE_PACK_OUT_DIR}/${APP_PART_DOWNLOAD_FILE} ${APP_PART_FILE_PATH} }

常见打包异常处理：

size计算为0：检查sys_partition_tmp_app.fex的DOS格式转换
ext4创建失败：确认APP_PART_FILE_PATH存在且可写

3.2 升级验证全流程

完整的验证步骤应包含：

# 1. 生成升级包 swupdate_pack_swu -ab # 2. 传输升级包 adb push openwrt_ai985_evb-ab.swu /mnt/UDISK/ # 3. 执行升级（A→B） swupdate_cmd.sh -i /mnt/UDISK/openwrt_ai985_evb-ab.swu -e stable,now_A_next_B_emmc # 4. 验证项检查 fw_printenv -n boot_partition # 应输出bootB mount | grep '/dev/by-name/appB' # 确认挂载成功 md5sum /usr/bin/your_app # 对比新旧版本哈希

验证要点清单：

[ ] 环境变量是否正确更新
[ ] 所有目标分区是否正常挂载
[ ] 应用二进制是否完整更新
[ ] 系统日志有无错误信息（logread）

4. 典型问题排查手册

4.1 升级后应用未更新

现象：版本号未变，日志显示旧版本时间戳
根因：OverlayFS缓存导致
解决方案：

在rc.local中强制清理：

fw_setenv parts_clean rootfs_data:UDISK rm -rf /overlay/upper/usr/bin/*

或者在sw-description-ab中添加预处理脚本：

scripts: ( { filename = "pre_install.sh"; type = "shellscript"; } )

4.2 升级包验签失败

错误日志：

[ERROR] : SWUPDATE failed : Image invalid or corrupted

处理步骤：

检查swupdate编译配置：

CONFIG_SIGNED_IMAGES=y CONFIG_SIGALG="sha256,rsa2048"

重新生成密钥对：

openssl genrsa -out priv.pem 2048 openssl rsa -in priv.pem -out pub.pem -pubout

打包时加入签名：

swupdate_pack_swu -ab -k priv.pem

4.3 空间不足导致升级中断

预防措施：

在打包阶段检查分区大小：

# 在make_app_res()中添加 AVAILABLE_SPACE=$(df -k /mnt/app | awk 'NR==2{print $4}') if [ $AVAILABLE_SPACE -lt $APP_PART_SIZE_IN_K ]; then echo "Error: Insufficient space in app partition" >&2 exit 1 fi

实现差分升级：

{ "filename": "rootfs.delta", "type": "delta", "device": "/dev/by-name/rootfsB", "installed-directly": true, "compressed": "zlib" }

在实际项目中，我们曾遇到AB系统切换后网络接口丢失的情况，最终发现是/etc/config/network未纳入版本管理。现在的标准做法是在打包脚本中加入配置文件备份机制：

# 在pack阶段自动备份关键配置 cp $APP_PART_FILE_PATH/etc/config/network $APP_PART_FILE_PATH/etc/config/network.bak

全志AI985开发板OpenWrt OTA升级实战：从分区表配置到swupdate打包的完整避坑指南