如何让Zephyr自动填充镜像大小以解决TI芯片UniFlash烧录报错？

问题重现 #

[ERROR] CORTEX_M0P: Flash Programmer: Error in image size. Length of block is 24973, but it should be divisible by 8 since Flash Programmer writes in 64-bits

切换到TI G3519 Launchpad平台后，Zephyr编译出的二进制用UniFlash下载时一直报上面的错。之前编译STM32完全正常，自己写的Python脚本填充HEX文件对齐8字节在旧项目能用，但现在不管用；而且手动查了镜像的最高内存地址对应大小是57991，和报错里的24973对不上，搞不清是Zephyr编译的问题还是UniFlash的锅。

解决方案 #

1. 让Zephyr编译时自动对齐镜像大小（不用imgtool签名） #

Zephyr构建系统可以通过配置或改链接脚本来实现自动填充：

• 修改链接脚本：找到TI G3519对应的链接脚本（一般在boards/ti/launchxl_g3519/目录下的linker.ld），在.text段或者最后一个段的末尾添加对齐指令，强制镜像大小对齐到8字节：

  . = ALIGN(8);
  PROVIDE(_end = .);
  

  链接器会自动在镜像末尾填0，保证总长度是8的倍数。
• 使用构建配置选项：在prj.conf里加下面几行配置，开启镜像对齐：

  CONFIG_IMAGE_FILLER=y
  CONFIG_IMAGE_FILLER_VALUE=0x00
  CONFIG_IMAGE_ALIGNMENT=8
  

  这样Zephyr构建时会自动把镜像填充到指定的对齐大小。

2. 排查报错中大小不符的问题 #

报错里的24973是UniFlash读取的某块大小，不是整个镜像的总大小：

• 检查UniFlash下载配置：确认选的是正确的镜像文件（.bin或.hex），有没有开启“分块下载”或者“只下载已使用区域”这类选项。有时候UniFlash会把镜像拆成块，某块没对齐就会报错。
• 验证Zephyr生成的镜像：用arm-none-eabi-size查看镜像的实际大小：

  arm-none-eabi-size build/zephyr/zephyr.elf
  

  再用wc -c查看bin文件的字节数：

  wc -c build/zephyr/zephyr.bin
  

  如果总大小已经是8的倍数，那问题大概率在UniFlash的配置上。

3. 修复Python填充脚本失效的问题 #

之前的脚本现在没用，可能是当前项目的HEX文件结构不一样（比如多段分布，或者段地址更复杂）：

• 修改脚本，遍历HEX的所有段，确保每个段末尾都对齐到8字节，别只看总内存占用。
• 或者直接处理bin文件更简单：算一下bin文件的长度，如果length % 8 != 0，就往文件末尾填8 - (length % 8)个0字节。

4. 确认UniFlash兼容性 #

检查UniFlash版本是否支持G3519的64位写入模式，或者试试切换到32位写入模式（如果UniFlash有这个选项），绕开8字节对齐的要求。

总结 #

优先尝试Zephyr的CONFIG_IMAGE_ALIGNMENT配置或者修改链接脚本，这是最靠谱的方式。如果还不行，就排查UniFlash的配置或版本，同时确认镜像实际大小是不是真的没对齐。

内容的提问来源于stack exchange，提问作者Christopher Theriault