STM32从零到量产开发：四路继电器工业控制模块开发 -上位机 Program.cs 应用程序入口设计说明

STM32从零到量产开发：四路继电器工业控制模块开发 -上位机 Program.cs 应用程序入口设计说明

1. 模块概述

本文件是 P02 上位机应用程序的唯一入口点（Program.cs），负责启动引导、命令行参数解析、双模式运行切换及线程模型初始化。

核心功能：

• 启动引导 ：初始化 WinForms 应用上下文，创建 MainForm 实例
• 命令行参数解析 ：支持 --selftest 参数及可选串口端口号
• 双模式切换：正常 GUI 交互模式 vs 自测试无头模式（Headless）
• 跨线程管控：在自测试模式下关闭非法跨线程调用检查，提升测试效率

---

2. 启动流程

2.1 正常模式（默认）

解析命令行参数 → 初始化 WinForms 样式 → 创建 MainForm → Application.Run(form) → 进入消息循环

• 不传递 --selftest 参数时，进入标准 WinForms 消息循环
• 用户通过 GUI 与从机设备交互

2.2 自测试模式（Headless）

解析 --selftest + 端口号 → 初始化 WinForms 样式 → 创建 MainForm → 设置 SelfTest 属性 → 关闭跨线程检查 → 异步执行 RunSelfTest() → 等待完成 → Environment.Exit(0)

• 传递 --selftest [COM port] 参数时，跳过 GUI 消息循环
• 直接以无头方式执行 MainForm.RunSelfTest() 异步任务
• 测试完成后自动退出进程

---

3. 命令行参数解析

参数	说明	示例
--selftest	启用自测试模式（无头运行）	--selftest
--selftest COMx	指定自测试使用的串口端口	--selftest COM3

解析逻辑：

• 遍历 args 数组，查找 --selftest 标记
• 若 --selftest 后紧跟非 -- 开头的参数，则将其作为端口号（如 COM3）
• 端口号默认值为 "COM3"
• 防御性设计：通过 StartsWith("--") 判断避免将其他参数误识别为端口号

调用示例：

P02HostPC.exe                          # 正常 GUI 模式，默认 COM3
P02HostPC.exe --selftest               # 自测试模式，默认 COM3
P02HostPC.exe --selftest COM5          # 自测试模式，指定 COM5

---

4. 双模式运行详解

4.1 正常交互模式

项目	说明
执行路径	Application.Run(form)
GUI 状态	正常显示主窗口
跨线程检查	启用（CheckForIllegalCrossThreadCalls 默认值）
适用场景	日常操作、人工联调

4.2 自测试模式（Headless）

项目	说明
执行路径	RunSelfTest().GetAwaiter().GetResult() + Environment.Exit(0)
GUI 状态	不显示任何窗口（无头运行）
跨线程检查	强制关闭（CheckForIllegalCrossThreadCalls = false）
端口配置	通过命令行参数指定，默认 COM3
适用场景	CI/CD 自动化测试、无人值守联调

---

5. 线程模型

5.1 STA 线程要求

• 主入口标注 [STAThread]，满足 WinForms 对单线程单元（STA）的强制要求
• 所有 WinForms 控件创建和消息循环必须在 STA 线程上执行

5.2 跨线程调用管控

模式	CheckForIllegalCrossThreadCalls	说明
正常模式	true（默认）	捕获 GUI 控件跨线程访问异常，便于开发调试
自测试模式	false	关闭检查，避免自测试中后台线程更新 UI 时抛出异常中断测试流程

设计说明：自测试模式下关闭跨线程检查是一种务实的工程取舍------测试代码本身应保证线程安全，关闭检查可避免因非关键 UI 更新异常掩盖真正的测试失败。

---

6. 关键设计亮点

亮点	说明
无 GUI 依赖的单元测试入口	通过 --selftest 参数实现无头运行，支持自动化测试框架集成
灵活串口配置	命令行参数动态指定串口，无需修改代码即可切换测试目标设备
防御性参数解析	StartsWith("--") 防止端口号参数被误识别，支持未来扩展更多参数
异步任务安全等待	使用 .GetAwaiter().GetResult() 同步等待异步测试完成，避免主线程提前退出
MainForm 协作契约	通过 SelfTestMode、SelfTestPort、SelfTestHeadless 三个属性与 MainForm 通信，解耦入口与业务逻辑
进程可控退出	测试完成后调用 Environment.Exit(0) 确保进程干净退出，不残留后台线程

---

7. 依赖关系

依赖模块	依赖方式	说明
MainForm	直接实例化	应用程序主窗口，承载所有业务逻辑
System.Windows.Forms	命名空间引用	WinForms 框架基础
System.Threading.Tasks	using 引用	异步任务（RunSelfTest 返回 Task）
IWDG 等 BSP 层	间接依赖	通过 MainForm 内部调用，Program.cs 不直接接触

---

8. 设计总结

设计维度	具体措施
启动可靠性	[STAThread] 确保 STA 线程环境，WinForms 正常初始化
测试友好性	--selftest 无头模式 + 端口动态配置，支持 CI/CD 集成
参数安全性	防御性解析 + 默认值兜底，避免非法参数导致崩溃
线程安全性	正常模式开启跨线程检查，测试模式关闭以保证流程完整
进程管理	测试完成后主动 Environment.Exit(0)，避免僵尸进程
关注点分离	入口层仅负责启动引导，业务逻辑全部委托给 MainForm

该入口设计充分体现了工业上位机软件对"日常交互"与"自动化测试"双场景的兼顾，通过简洁的命令行参数实现模式切换，是 WinForms 应用程序入口的标准实践。

`/**

---

• @file modbus_rtu.h
• @brief Modbus RTU 从站协议栈
• @details 提供 Modbus RTU 从站接口：初始化、主循环轮询、故障安全检测、从站地址查询、

       帧/异常计数与接收中断回调。支持功能码 01/02/03/04/05/06/0F/10/17。

       字节序：数据/地址大端(MSB 在前)，CRC 小端(LSB 在前)。

       业务关联（参数流向）：

         - 输入：stm32f1xx_it.c HAL_UART_RxCpltCallback → Modbus_RxByte（RS485 字节）；

         - 处理：main.c 主循环调用 Modbus_Poll + Modbus_CheckFailSafe；

         - 寄存器后端读写 FlashParam_Get/Save、BSP_ADC_*、BSP_DAC_*、BSP_Relay_*、BSP_LED_CommPulse；

         - 读取：RS232 Shell 经 Modbus_Get* 读取计数/地址。

---

*/

#ifndef __MODBUS_RTU_H

#define __MODBUS_RTU_H

#ifdef __cplusplus

extern "C" {

#endif

#include <stdint.h>

#include "usart.h"

/* ===================== 1. 常量 ===================== /
#define MODBUS_MAX_FRAME_LEN 256u / 最大帧长度（满足 Modbus 标准上限：

读 32 寄存器响应 67B / 写 32 寄存器请求 73B 均不溢出）/
#define MODBUS_MAX_REG_COUNT 32u / 单次最大读写寄存器数 /
#define MODBUS_BROADCAST_ADDR 0u / 广播地址 */

/* ===================== 2. 对外接口 ===================== */

/**

• @brief 初始化 Modbus RTU 从站

      配置 UART1 (RS485) 波特率、启动接收中断

• @param huart: USART1 句柄指针
• @param slave_addr: 初始从站地址
  */
  void Modbus_Init(UART_HandleTypeDef *huart, uint8_t slave_addr);

/**

• @brief 轮询处理（在主循环中持续调用）

      接收帧 → 解析 → 执行 → 发送响应 → RS485 方向切换

*/

void Modbus_Poll(void);

/**

• @brief 故障安全检测（主循环中调用，与 Modbus_Poll 配合）

      连续 fail_safe_sec 无有效帧 → 继电器全断 + FAULT 灯快闪

      收到任意有效帧 → 自动恢复

*/

void Modbus_CheckFailSafe(void);

/**

• @brief 查询故障安全是否已触发（断线/主站失联进入安全态）
• @retval 1=已触发(安全态) 0=正常
• @note 供应用层统一驱动 FAULT LED 使用，避免与报警指示互相覆盖
  */
  uint8_t Modbus_IsFailSafeActive(void);

/**

• @brief 设置从站地址（运行时修改，不自动保存 Flash）
  */
  void Modbus_SetSlaveAddr(uint8_t addr);

/**

• @brief 获取当前从站地址
  */
  uint8_t Modbus_GetSlaveAddr(void);

/**

• @brief 获取有效帧计数（诊断用）
  */
  uint32_t Modbus_GetFrameCount(void);

/**

• @brief 获取异常码计数（诊断用）
  */
  uint32_t Modbus_GetExceptionCount(void);

/**

• @brief 接收中断回调 --- 由 stm32f1xx_it.c 中 USART1 中断调用
• @param byte: 收到的单字节
  */
  void Modbus_RxByte(uint8_t byte);

#ifdef __cplusplus

}

#endif

#endif /* __MODBUS_RTU_H */

`