4. RA工业控制软件工程结构

RA系列MCU（以RA6M5、RA4M2等Cortex-M33/M4内核为例）的工业控制软件，其工程结构不是"能编译通过"就算合格，而是要让启动、异常响应、内存分配、堆栈使用和中断调度在量产环境下可预测、可验证。本章围绕七个相互咬合的工程要素展开：启动流程、向量表、链接脚本、内存布局、堆栈规划、中断优先级分组与工程目录组织。它们共同决定了一个固件从复位到进入主循环、再到响应外部事件的完整行为边界。

一、启动流程：从复位向量到main()

RA芯片上电或复位后，硬件从向量表偏移0x00处取出初始MSP（主堆栈指针），从0x04处取出Reset_Handler入口地址。RA的启动代码通常由FSP（Flexible Software Package）生成的startup.c与system.c承担，其顺序为：设置MSP→使能FPU（若使用）→初始化.data段（从Flash拷贝到RAM）→清零.bss段→调用SystemInit()配置时钟（如将HOCO 20MHz经PLL倍频至200MHz）→调用C运行时初始化→进入main()。工业控制中，时钟配置错误会导致UART波特率、CAN位定时、ADC采样周期全部偏移，因此SystemInit()的返回值与时钟寄存器（SCKSCR、PLLCCR）应在启动后立即校验。

二、向量表与VTOR重定位

Cortex-M的向量表默认位于0x00000000，但RA的Flash起始地址为0x00000000（代码Flash），因此复位向量天然可用。当工程需要Bootloader+App双区结构时，App的向量表需重定位到如0x00010000，通过设置SCB->VTOR = 0x00010000实现。向量表前16项为内核异常（NMI、HardFault、MemManage、BusFault、UsageFault、SVC、PendSV、SysTick），其后为外设中断（如ICU的IRQ0~IRQ15、DMAC、GPT、SCI等）。每个向量项为4字节地址，必须4字节对齐。工业现场中，HardFault处理函数应记录SCB->CFSR、HFSR与压栈的PC/LR，写入非易失存储，便于事后定位是总线错误还是非法指令。

三、链接脚本与内存布局

RA的链接脚本（.ld）定义MEMORY区域与SECTIONS分配。典型RA6M5资源为：Code Flash 1MB（0x00000000~0x000FFFFF）、Data Flash 8KB（0x40100000）、SRAM 512KB（0x20000000~0x2007FFFF）。链接脚本中需明确：.text与.rodata放入FLASH，.data的加载地址在FLASH、运行地址在RAM，.bss在RAM中清零，.stack与.heap的边界。工业控制常将关键变量（如PID积分项、故障标志）放入带ECC的RAM区或Data Flash，需在链接脚本中单独划分段并指定属性。

四、堆栈规划：MSP与PSP的分工

Cortex-M支持双堆栈：MSP用于异常处理和启动阶段，PSP用于线程模式（RTOS任务）。工业控制中，若使用FreeRTOS，每个任务创建时分配独立PSP栈空间，任务切换时由PendSV保存/恢复上下文。堆栈大小的估算不能凭经验，而应基于最坏调用路径：例如一个CAN接收任务，其调用链为CAN_ISR→xQueueSendFromISR→任务唤醒→协议解析→PID计算→PWM输出，需统计每层局部变量、寄存器压栈和函数调用开销。建议在栈顶和栈底填充0xA5A5A5A5魔数，运行一段时间后检查未被覆盖的最大深度，作为调整依据。MSP建议不小于2KB，每个任务PSP建议不小于1KB，并预留20%余量。

五、中断优先级分组与NVIC配置

Cortex-M的NVIC支持优先级分组，RA默认使用NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4)，即4位全部用于抢占优先级，无子优先级。工业控制中，优先级分配应遵循"安全>实时>通信>人机"原则：例如急停输入IRQ优先级设为0（最高），电机控制PWM周期中断设为1，CAN接收设为2，UART调试设为5。注意FreeRTOS的configMAX_SYSCALL_INTERRUPT_PRIORITY（通常为5）以下的ISR才能调用FromISR系列API，高于该阈值的ISR不得调用RTOS API。优先级数值越小，优先级越高，配置时需在R_ICU_IRQ_Open()或NVIC_SetPriority()中显式指定，避免默认值0导致所有中断同级。

六、工程目录组织

一个可维护的RA工业控制工程目录建议如下：src/存放应用层（app_main.c、ctrl_pid.c、comm_can.c）；hal/存放FSP配置生成的hal_entry.c与ra_gen/；bsp/存放板级初始化与时钟配置；config/存放链接脚本.ld、FSP配置configuration.xml；test/存放单元测试与硬件在环脚本；docs/存放内存映射表与中断优先级分配表。目录划分的核心原则是：应用代码不直接操作寄存器，外设访问统一经HAL层；链接脚本与向量表配置集中管理，不散落在多个文件中。

以上七个要素并非孤立配置项，而是相互约束的整体：链接脚本决定内存布局，内存布局决定堆栈边界，堆栈边界影响中断嵌套深度，中断优先级分组又反过来约束RTOS API的可用范围。在RA工业控制项目中，建议在工程初期就输出一份《内存与中断分配表》，将Flash/RAM地址、各段大小、MSP/PSP边界、每个中断的优先级与处理函数一一列明，作为后续代码评审和量产固件校验的基线。