ypc
/
RTU
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
RTU/mimo/plan/libcom_decode合并计划.md

4.0 KiB
Raw Blame History

libcom_decode 模块合并计划

目标: 将 libcom_channel(488行) + libcom_scan(192行) 合并为 libcom_decode，按功能拆分文件，整合为一个 app 线程

涉及文件: ~15个

新模块结构

src/system/libcom_decode/
├── inc/
│   └── .gitkeep
└── src/
    ├── decode_channel_mgr.cpp   # 通道管理：参数配置、创建、启动、状态回调
    ├── decode_frame_codec.cpp   # ICP66 帧解码：协议转换、环形缓冲
    ├── decode_data_router.cpp   # 数据路由：recv 分发、send 转发
    └── decode_main.cpp          # app 线程入口：事件循环

文件功能划分

decode_channel_mgr.cpp (~150行)

  • g_tcp_para[3] / g_uart_para[1] / g_channel_para[4] 参数配置
  • com_channel_create() → comm_create + register callbacks
  • com_channel_start() → pthread_create per channel
  • com_start() → comm_connect 入口
  • com_channel_state_cb() → 状态回调，通知 self_ptl
  • com_channel_interface_get() → 供外部查询接口标识符

decode_frame_codec.cpp (~120行)

  • g_rx 环形缓冲区 + put_rx_data / get_rx_data
  • crc_check_sum()
  • icp66_search_frame() → 帧头+CRC+帧尾检测
  • icp66_to_icp67() → 协议头转换
  • icp66_search_first_head()
  • icp66_frame_decode() → 帧解码主循环

decode_data_router.cpp (~130行)

  • com_recv_data() → 协议识别 + 路由到 iec/self_ptl
  • com_scan_send_data_to_app() → 消息入队 + 事件通知
  • com_channel_recv_cb() → 接收回调：透传/协议解析/直接投递
  • com_send_data() → 下行发送

decode_main.cpp (~80行)

  • app_com_decode_init1() → com_channel_create + com_channel_start
  • app_com_decode_init2() → return 0
  • app_com_decode() → 事件循环： 
    wait EV_TIMER1|TIMER2|TIMER3|EV_COM_RX_IEC|EV_COM_RX_SELF_PTL
→ TIMER1/2: 空操作
→ TIMER3: run_cnt++
→ EV_COM_RX_IEC/EV_COM_RX_SELF_PTL: com_send_data()

外部接口变更

mySystem.h 枚举

// 旧
ENUM_APP_COMM = 2,        // 删除
ENUM_APP_COM_SCAN = 3,    // 删除
ENUM_APP_IEC = 4,         // → 3
ENUM_APP_SELF_PTL = 5,    // → 4
ENUM_APP_WEB_SERVER = 6,  // → 5
ENUM_APP_IEC61850M = 7,   // → 6
ENUM_APP_IEC61850S = 8,   // → 7
ENUM_APP_MAX = 9          // → 8

// 新
ENUM_APP_COM_DECODE = 2,  // 新增
ENUM_APP_IEC = 3,
...
ENUM_APP_MAX = 8

mySystem.h extern 声明

  • 删除: app_com_channel_init1/2, app_com_channel
  • 删除: app_com_scan_init1/2, app_com_scan
  • 删除: com_recv_data（不再对外暴露）
  • 新增: app_com_decode_init1, app_com_decode_init2, app_com_decode
  • 保留: com_channel_interface_get

所有引用 ENUM_APP_* 的文件需要更新

影响:

  • self_ptl.cpp: ENUM_APP_COM_SCAN → ENUM_APP_COM_DECODE
  • iec.cpp: ENUM_APP_COM_SCAN → ENUM_APP_COM_DECODE
  • app_sys.cpp: g_vec_app 替换两个条目为一个

编译系统变更

Makefile

  • 删除: release/src/system/libcom_channel/makefile
  • 删除: release/src/system/libcom_scan/makefile
  • 新增: release/src/system/libcom_decode/makefile
  • 更新: release/src/system/makefile（子目录列表）
  • 更新: release/src/system/RTU/makefile（链接库：-lcom_channel -lcom_scan → -lcom_decode）

Task 分解

T1: 创建新模块目录和文件

  • 创建 src/system/libcom_decode/ 目录结构
  • 创建 4 个源文件（从两个旧文件拆出）
  • 创建 makefile

T2: 更新 mySystem.h

  • 修改 enum_app 枚举值
  • 替换 extern 声明

T3: 更新 app_sys.cpp

  • 替换 g_vec_app 中两个条目为一个

T4: 更新所有引用 ENUM_APP_COM_SCAN 的文件

  • self_ptl.cpp, iec.cpp 中的 ENUM_APP_COM_SCAN → ENUM_APP_COM_DECODE

T5: 更新编译系统

  • 修改父级 makefile 和 RTU 链接 makefile

T6: 更新 .gitignore（如有需要）

T7: 编译验证 + 更新文档

验证

步骤 命令 预期
全量编译 ./release/build.sh Build complete，零错误零警告