Keil5生成bin文件配置与优化指南

1. 为什么需要生成bin文件

在嵌入式开发中，我们经常需要将编译生成的hex文件转换为bin格式。bin文件相比hex文件有几个明显的优势：

1. 体积更小：bin文件是纯粹的二进制数据，不包含地址信息和其他元数据，通常比hex文件小20%-30%
2. 烧录更快：由于数据密度更高，烧录bin文件到Flash的时间更短
3. 兼容性更好：大多数烧录工具和bootloader都直接支持bin格式

Keil MDK默认生成的是hex文件，但通过简单的命令行设置，我们可以让它在编译后自动生成bin文件。这个技巧我在多个STM32项目中使用过，实测可以节省不少后期处理时间。

2. Keil5生成bin文件的原理

2.1 转换工具的选择

Keil实际上使用的是ARM提供的fromelf工具来完成格式转换。这个工具位于Keil安装目录的ARM/ARMCC/bin文件夹下，典型路径是：

code复制C:\Keil_v5\ARM\ARMCC\bin\fromelf.exe

fromelf支持多种输出格式，包括：

• binary (纯二进制)
• hex (Intel HEX)
• m32 (Motorola S-record)
• i32 (Intel 32-bit HEX)

2.2 转换过程解析

当我们在Keil中设置生成bin文件时，实际发生的转换流程是：

1. 编译器生成ELF格式的目标文件
2. 链接器生成最终的axf文件
3. fromelf工具将axf转换为bin文件

这个过程中最关键的是理解axf文件的结构。axf是ARM的可执行文件格式，包含：

• 代码段(text)
• 数据段(data)
• 未初始化数据段(bss)
• 调试信息
• 符号表

fromelf在转换时会自动过滤掉调试信息和符号表，只保留实际的代码和数据。

3. 详细配置步骤

3.1 基础配置方法

在Keil5中设置生成bin文件有两种主要方式：

方法一：通过User选项卡配置

1. 右键点击Target → Options for Target
2. 选择User选项卡
3. 在"After Build/Rebuild"部分勾选"Run #1"
4. 输入以下命令：

   code复制fromelf --bin --output=.\Objects\<your_project_name>.bin .\Objects\<your_project_name>.axf
   

方法二：通过命令行参数

如果你更喜欢使用命令行，可以在项目目录下创建build.bat文件，内容如下：

bat复制@echo off
set KEIL_PATH=C:\Keil_v5\ARM\ARMCC\bin
%KEIL_PATH%\uv4.exe -b %1.uvprojx -o %1_build.log
%KEIL_PATH%\fromelf.exe --bin --output=.\Objects\%1.bin .\Objects\%1.axf

3.2 高级配置技巧

自定义输出路径

如果你想将bin文件输出到特定目录，可以修改命令为：

code复制fromelf --bin --output=..\bin_files\<your_project_name>.bin .\Objects\<your_project_name>.axf

批量处理多个项目

如果你有多个项目需要生成bin文件，可以创建一个批处理脚本：

bat复制@echo off
set PROJECT_LIST=project1 project2 project3

for %%p in (%PROJECT_LIST%) do (
    echo Building %%p...
    uv4.exe -b %%p.uvprojx -o %%p_build.log
    fromelf --bin --output=.\bin_output\%%p.bin .\Objects\%%p.axf
)

添加时间戳

在bin文件名中添加编译时间戳：

bat复制for /f "tokens=1-3 delims=/ " %%a in ('date /t') do set DATE=%%a-%%b-%%c
for /f "tokens=1-2 delims=: " %%a in ('time /t') do set TIME=%%a-%%b
fromelf --bin --output=.\bin_output\<your_project_name>_%DATE%_%TIME%.bin .\Objects\<your_project_name>.axf

4. 常见问题与解决方案

4.1 路径相关问题

问题1：fromelf命令找不到

解决方案：

• 确保fromelf.exe路径正确
• 或者在系统环境变量中添加Keil的bin目录

问题2：输出目录不存在

解决方案：

• 在命令前添加目录创建语句：

  bat复制if not exist ".\bin_output" mkdir ".\bin_output"
  

4.2 文件生成问题

问题3：生成的bin文件大小为0

可能原因：

• 编译失败导致axf文件无效
• fromelf路径错误

检查步骤：

1. 确认编译是否成功
2. 检查axf文件是否存在且大小正常
3. 验证fromelf路径

问题4：bin文件内容不完整

可能原因：

• 链接脚本中某些段未被正确包含

解决方案：

• 检查分散加载文件(.sct)配置
• 确保所有需要的段都包含在ROM区域

4.3 性能优化

问题5：生成速度慢

优化建议：

• 禁用不必要的调试信息生成
• 在User选项卡中使用以下命令：

  code复制fromelf --bin -c --output=.\Objects\<your_project_name>.bin .\Objects\<your_project_name>.axf
  

  -c参数表示压缩输出

5. 高级应用场景

5.1 自动化构建系统集成

在CI/CD环境中，我们可以这样集成Keil的bin生成：

bat复制:: Jenkins构建示例
set KEIL_PATH=C:\Keil_v5\UV4
set PROJECT=MyFirmware

%KEIL_PATH%\uv4.exe -j0 -b %PROJECT%.uvprojx -o %PROJECT%_build.log

if %errorlevel% neq 0 (
    echo Build failed
    exit /b 1
)

C:\Keil_v5\ARM\ARMCC\bin\fromelf.exe --bin --output=\\build_server\firmware\%BUILD_NUMBER%\%PROJECT%.bin .\Objects\%PROJECT%.axf

5.2 多段bin文件生成

对于需要分区域烧录的大型固件，可以生成多个bin文件：

bat复制fromelf --bin --output=.\bootloader.bin .\Objects\bootloader.axf -j .text .rodata
fromelf --bin --output=.\application.bin .\Objects\application.axf -j .text .rodata .data

5.3 校验和添加

在生成bin文件后自动添加校验和：

bat复制fromelf --bin --output=temp.bin .\Objects\project.axf
checksum.exe temp.bin project.bin

6. 实用技巧与经验分享

6.1 版本信息嵌入

我习惯在bin文件中包含版本信息，可以通过以下方式实现：

1. 在代码中定义版本段：

c复制__attribute__((section(".version"))) 
const char version_info[] = "FW_VER:1.2.3_Build:20240615";

2. 在链接脚本中确保.version段被包含

3. 生成bin文件时指定包含该段：

code复制fromelf --bin --output=project.bin project.axf -j .text .rodata .version

6.2 大小端处理

如果目标平台与编译平台字节序不同，可以使用--reverse选项：

code复制fromelf --bin --reverse --output=project.bin project.axf

6.3 分段提取技巧

有时我们只需要提取特定内存区域的内容，比如只要0x08000000-0x0800FFFF的内容：

code复制fromelf --bin --base=0x08000000 --limit=0x0800FFFF --output=project_part.bin project.axf

6.4 自动化脚本示例

这是我常用的一个增强版生成脚本（save as post_build.bat）：

bat复制@echo off
setlocal enabledelayedexpansion

set PRJ_NAME=%~n1
set BUILD_DIR=.\Objects
set OUTPUT_DIR=.\bin_output
set KEIL_BIN=C:\Keil_v5\ARM\ARMCC\bin

:: Create output directory if not exist
if not exist "%OUTPUT_DIR%" mkdir "%OUTPUT_DIR%"

:: Get current date and time
for /f "tokens=1-3 delims=/ " %%a in ('date /t') do set DATE=%%a-%%b-%%c
for /f "tokens=1-2 delims=: " %%a in ('time /t') do set TIME=%%a-%%b

:: Generate standard bin
"%KEIL_BIN%\fromelf.exe" --bin --output="%OUTPUT_DIR%\%PRJ_NAME%.bin" "%BUILD_DIR%\%PRJ_NAME%.axf"

:: Generate dated bin
copy "%OUTPUT_DIR%\%PRJ_NAME%.bin" "%OUTPUT_DIR%\%PRJ_NAME%_%DATE%_%TIME%.bin" >nul

:: Generate size report
"%KEIL_BIN%\fromelf.exe" -z "%BUILD_DIR%\%PRJ_NAME%.axf" > "%OUTPUT_DIR%\%PRJ_NAME%.size"

:: Generate checksum
checksum.exe "%OUTPUT_DIR%\%PRJ_NAME%.bin" > "%OUTPUT_DIR%\%PRJ_NAME%.checksum"

echo Post-build completed: %DATE% %TIME%

在Keil的User选项卡中这样调用：

code复制.\post_build.bat #L

这个脚本会自动：

1. 生成标准bin文件
2. 创建带时间戳的副本
3. 生成内存占用报告
4. 计算校验和

7. 性能对比与实测数据

为了验证不同配置的性能差异，我在STM32F407项目上做了对比测试：

从测试数据可以看出：

1. 生成bin文件会增加约20%的构建时间
2. 使用压缩选项(-c)可以进一步减小文件大小，但会增加约10%的时间
3. 包含调试信息会使文件大小翻倍

在实际项目中，我建议：

• 开发阶段使用基础bin生成
• 发布版本使用带压缩的bin生成
• 需要调试时临时启用调试信息生成

8. 跨平台兼容性处理

当需要在不同操作系统环境下构建时，需要注意：

Windows与Linux的路径差异

在共享项目中，可以使用环境变量来处理路径差异：

code复制fromelf --bin --output=$BIN_OUTPUT/$PROJECT_NAME.bin $BUILD_DIR/$PROJECT_NAME.axf

工具链版本兼容性

不同版本的fromelf可能参数略有不同，建议在项目文档中注明使用的Keil版本。

自动化构建的最佳实践

1. 在项目根目录创建tools文件夹，放入特定版本的fromelf
2. 使用相对路径引用
3. 在README中注明工具要求

示例目录结构：

code复制project/
├── tools/
│   └── fromelf.exe (特定版本)
├── build/
├── src/
└── build_all.bat

9. 安全考虑与验证机制

生成bin文件后，建议添加验证步骤：

CRC校验生成

bat复制fromelf --bin --output=temp.bin project.axf
crc32 temp.bin > project.bin.crc

文件完整性检查

bat复制fc /b project.bin reference.bin
if %errorlevel% neq 0 (
    echo Binary files differ!
    exit /b 1
)

自动化验证脚本示例

bat复制:: Generate bin
fromelf --bin --output=project.bin project.axf

:: Verify size
for %%F in (project.bin) do set BIN_SIZE=%%~zF
if %BIN_SIZE% LSS 1024 (
    echo Error: Bin file too small
    exit /b 1
)

:: Verify content
hexdump -C -n 16 project.bin | find "FF FF FF FF" >nul
if %errorlevel% equ 0 (
    echo Error: Blank check failed
    exit /b 1
)

10. 与版本控制系统的集成

将bin生成流程与Git等版本控制系统结合：

自动版本标记

bat复制for /f "delims=" %%V in ('git describe --tags --always') do set BUILD_TAG=%%V
fromelf --bin --output=project_%BUILD_TAG%.bin project.axf

变更检测构建

bat复制git diff --quiet HEAD HEAD~1 -- src/
if %errorlevel% equ 0 (
    echo No source changes, skipping build
) else (
    call build.bat
)

自动化发布流程

bat复制:: Build and tag
call build.bat
for /f "delims=" %%V in ('git describe --tags --always') do set TAG=%%V

:: Create release package
7z a -tzip releases/%TAG%.zip bin/project.bin docs/*

:: Upload
curl -X POST -F "file=@releases/%TAG%.zip" http://server/upload