X19S 模块使用 FlashTools 升级时保留用户配置的方法

X19S 模块使用 FlashTools 升级时保留用户配置的方法摘要本文介绍 YM310_X19S.U62EC716E模块使用 FlashTools 进行本地升级时如何避免擦除用户文件和应用配置。实现该目标需要同时完成两项设置将erallum的擦除范围限制在CP_SYSTEM和SYSTEM/AP固件区从烧录清单中删除、注释或取消勾选PKGFLXFS/fs.bin。只完成其中一项仍可能造成用户文件系统被擦除或覆盖。本文基于当前 SDK 的YM310_X19S.U62配置和 FlashTools V4.1.19。使用其他 SDK、工程配置或工具版本时应以实际构建生成的mem_map.txt、ec716e_format.json.bin和 FlashTools 烧录列表为准。1. 适用范围本文适用于当前 SDK 中的YM310_X19S.U62模块。该模块使用 EC716E 下载链路FlashTools 工程路径、EC716E 格式文件和 SDK 的 U62 分区参数应保持一致。项目本方案适用值说明模块/BSPYM310_X19S.U62映射到 EC716E 下载配置AP 固件长度0x22B000未启用PRO_SUPPORT_TTS_ROM文件系统区0xAA9000 / 0xD4000绝对地址/长度用于保存用户文件和应用配置升级工具FlashTools V4.1.19其他版本需重新确认临时配置文件的位置TTS 版本注意事项若工程启用了PRO_SUPPORT_TTS_ROMAP 长度变为0x25B000文件系统起始地址变为0xAD9000。此时不能直接使用本文的0x22B000需要根据当前构建生成的mem_map.txt和 FlashTools 烧录列表重新核对地址。2. 当前 SDK 分区配置2.1 X19S/U62 关键分区EC716E 的 AP Flash XIP 基址为0x800000。格式文件中的erallum设置了offst_flag1因此begin表示相对于 XIP 基址的偏移地址FlashTools 界面显示的是绝对烧录地址。镜像偏移地址绝对地址长度结束地址不含升级策略BOOTLOADER0x0030000x8030000x120000x815000按发布包选择CP_SYSTEM0x01A0000x81A0000x640000x87E000升级SYSTEM/AP0x07E0000x87E0000x22B0000xAA9000升级PKGFLXFS0x2A90000xAA90000xD40000xB7D000保留不烧录2.2 默认升级可能丢失配置的原因当前 EC716E 构建脚本检测到fs.img、FS_PATH或FS_DIR后会生成INPUT_FS_ARGS并在普通升级包生成命令中加入PKGFLXFS镜像。FlashTools 解析binpkg后临时配置中会生成[pkgflx0]工具界面也会出现bindtypePKGFLXFS的fs.bin烧录项。该项目处于勾选状态时升级过程会使用新的文件系统镜像覆盖设备中的原有内容。此外范围过大的erallum会扩大Erase All (User Mode)的擦除范围。为避免擦除从0xAA9000开始的文件系统需要将erallum限制在 CP 和 AP 两个固件区域。仅关闭Erase All不能保证用户配置安全。只要PKGFLXFS/fs.bin仍在烧录清单中且处于选中状态原文件系统仍可能被覆盖。3. 配置修改方法3.1 修改 erallum仅擦除 CP 和 AP先备份本次 X19S 非 TTS 构建生成的ec716e_format.json.bin然后将其中的erallum替换为以下两段erallum:[{stor_type:ap_flash,offst_flag:1,begin:0x1a000,length:0x64000},{stor_type:ap_flash,offst_flag:1,begin:0x7e000,length:0x22b000}]第一段对应CP_SYSTEM第二段对应SYSTEM/AP。两个区域连续且 AP 区域结束位置正好是文件系统的起始偏移0x2A9000。地址计算如下0x1A000 0x64000 0x7E000 0x7E000 0x22B000 0x2A9000 0x800000 0x2A9000 0xAA9000其中0x800000是 AP Flash XIP 基址最终得到文件系统绝对起始地址0xAA9000。图 1erallum擦除范围修改示例3.2 删除或注释 PKGFLXFS 烧录项FlashTools 加载ycom_716e.binpkg后会生成或展开Tmp_config.ini。不同版本工具的临时文件位置可能不同。执行下载前删除或完整注释[pkgflx0]段; 升级时需要保留用户配置应删除或整段注释以下内容 ; [pkgflx0] ; filepath ...\pkgimg_gen\ycom_716e_images\fs.bin ; burnaddr 0x2a9000 ; storage_type ap_flash ; bindtype PKGFLXFS若 FlashTools 重新加载升级包后自动生成该配置段需要再次删除或注释。Tmp_config.ini中的burnaddr0x2A9000是相对 AP Flash XIP 基址的偏移地址FlashTools 列表中的0xAA9000是绝对地址两者指向同一个文件系统分区。图 2Tmp_config.ini中需要删除或注释的[pkgflx0]段3.3 配置文件位置层级文件或位置SDK 源配置bsp\EC7XX\kernel\PLAT\project\download\ec716e\ec716e_format.json.bin构建产物out\EC7XX_YM310_X19S.U62_project\...\ec716e_format.json.binFlashTools 临时配置Tmp_config.ini或解包临时目录FlashTools 界面bindtypePKGFLXFS对应行4. FlashTools 下载前检查开始升级前确认以下项目CP_SYSTEM和SYSTEM/AP固件项已勾选PKGFLXFS或fs.bin烧录项已取消勾选Erase All (User Mode)未勾选Erase NVM未勾选当前地址与本次构建生成的mem_map.txt一致修改配置后重新加载升级包时再次检查PKGFLXFS是否被自动加入。图 3取消PKGFLXFS并保持Erase All和Erase NVM关闭5. 升级后验证升级完成并重启模块后建议执行以下验证检查模块版本确认 CP 和 AP 固件已更新检查升级前保存的用户文件、参数和应用配置是否仍然存在进行一次断电重启确认配置能够正常加载重新执行写入、读取测试确认文件系统功能正常对量产升级包进行抽样验证避免工具或构建脚本重新加入fs.bin。6. 结论X19S 模块升级时保留用户配置需要同时限制擦除范围并排除文件系统镜像erallum仅保留 CP_SYSTEM SYSTEM/AP 烧录清单取消 PKGFLXFS/fs.bin FlashTools关闭 Erase All (User Mode) 和 Erase NVM三个条件确认无误后再执行固件下载。