4. 嵌入式C代码生成实战

前三章我们已经完成了模型到代码的基本链路认知。本章进入真正的工程落地环节：以STM32F407（ARM Cortex-M4）为目标，把Simulink模型生成可读、可维护、可编译下载的嵌入式C代码。整个过程可以拆成四件事：配置代码生成器、安装硬件支持包、集成外设驱动、编译并下载到目标板。下面按实际工程顺序展开。

一、先明确目标与工具链

本节示例对象为STM32F407VGT6，主频168MHz，使用STM32CubeMX生成外设初始化代码，MATLAB/Simulink R2023b配合Embedded Coder与STM32-MAT/TARGET支持包，编译器采用ARM GCC。模型功能很简单：读取一个ADC采样值，做一阶低通滤波，再通过UART以115200bps发送滤波结果。这个例子足够小，但覆盖了“模型→C代码→外设→下载”的完整闭环。

二、配置代码生成器，让代码可读

在Simulink中打开Configuration Parameters，重点设置以下几项。Solver选择Fixed-step、discrete，固定步长设为0.001s，与后续定时器中断周期一致。Code Generation页中，System target file选择ert.tlc（Embedded Coder），Language选C。Report页勾选“Generate code generation report”，便于逐文件查看生成结果。

“可读性”的关键在Code Style页：勾选“Generate reusable code”和“Use operator precedence”之外，更重要的是把“Parentheses level”设为“Nominal”，避免生成大量冗余括号；勾选“Preserve expression order”让表达式顺序与模型一致；把“Maximum identifier length”设为31，符合C89习惯。Identifier格式建议用$R$S$M$N，即“根模型_子系统_模块_信号”，这样生成的变量名如adc_filter_LPF_states，一眼能看出归属。

另外，在Code Placement页把“File packaging format”设为“Modular”，每个子系统生成独立的.c/.h文件，而不是全部塞进一个文件。这样后续集成外设驱动时，只需在对应文件里替换接口，不会牵一发动全身。

三、安装并配置硬件支持包

在MATLAB的Add-Ons中搜索“Simulink Support Package for STM32”，安装后还需安装STM32CubeMX与STM32CubeProgrammer。安装完成后，在Simulink的Library Browser中会出现STM32外设模块库，包括GPIO、ADC、UART、TIM等。此时在Configuration Parameters的Hardware Implementation页，Hardware board选择“STM32F4xx Based”，并指定STM32CubeMX的安装路径。

支持包的作用是把模型中的外设模块映射到HAL库调用。例如模型里的ADC模块，会生成HAL_ADC_Start()与HAL_ADC_GetValue()的调用；UART模块会生成HAL_UART_Transmit()。如果不安装支持包，这些外设模块无法生成有效代码，只能生成空壳函数。

四、集成外设驱动：以ADC与UART为例

集成外设驱动的核心思路是“模型负责算法，CubeMX负责初始化，HAL负责底层”。具体做法：先在STM32CubeMX中配置PA0为ADC1_IN0、PA9/PA10为USART1，生成初始化代码MX_ADC1_Init()和MX_USART1_UART_Init()。然后在Simulink模型中，用STM32支持包的ADC模块读取通道0，用UART模块发送数据。

代码生成后，在生成的adc_filter.c中会看到类似下面的调用：

/* ADC采样 */
HAL_ADC_Start(&hadc1);
HAL_ADC_PollForConversion(&hadc1, 10);
adc_raw = HAL_ADC_GetValue(&hadc1);

/* 一阶低通滤波，alpha = 0.2 */
y = 0.2f * (float)adc_raw + 0.8f * y_prev;
y_prev = y;

/* UART发送 */
HAL_UART_Transmit(&huart1, (uint8_t*)&y, 4, 100);

这里要注意：模型中的滤波系数0.2和0.8会以常量形式出现在代码中，如果希望可调，应把它们设为Simulink.Parameter并配置为“可校准”，这样会生成extern变量，方便在main.c中修改。ADC的采样周期由模型步长0.001s决定，但实际HAL调用需要放在定时器中断中，因此还需在CubeMX中配置TIM2为1kHz中断，并在中断回调里调用生成的step函数。

五、编译与下载

代码生成完成后，Simulink会调用ARM GCC进行编译。若编译报错，常见原因是头文件路径未包含CubeMX生成的Core/Inc与Drivers/STM32F4xx_HAL_Driver/Inc。可在Configuration Parameters的Custom Code页的“Include directories”中补充这些路径。编译成功后生成.elf与.bin文件。

下载方式有两种：一是直接在Simulink中点击“Deploy to Hardware”，支持包会调用STM32CubeProgrammer通过ST-Link下载；二是手动用STM32CubeProgrammer打开.elf文件下载。下载后复位运行，用串口助手以115200bps接收数据，应能看到滤波后的数值在0~4095之间平滑变化，且比原始ADC值波动更小。若串口无输出，先检查USART1的波特率与时钟配置是否与CubeMX一致，再检查中断优先级是否被HAL库默认值覆盖。

六、常见问题与判断依据

实际工程中，最容易出问题的不是算法，而是“模型步长与硬件中断周期不一致”。如果模型步长0.001s，但TIM2中断实际是0.002s，滤波效果会明显偏差。判断方法：在UART输出中观察阶跃响应，若上升时间比理论值慢一倍，基本可确认中断周期不匹配。另一个常见问题是ADC采样值跳变剧烈，此时应检查ADC的采样时间是否足够，STM32F407在168MHz下，采样时间设为84周期（约0.5μs）通常足够，若设为3周期则可能因源阻抗过高导致采样不准。

最后强调一点：生成代码的可读性不是“好看”，而是“可维护”。当项目需要多人协作或后期修改时，清晰的变量命名、模块化文件结构、可校准参数，能显著降低维护成本。建议在项目初期就固定一套代码风格配置，并写入团队的开发规范中。