ypc
0133c2950f
## Bug 修复 (5项) 1. dc_async_timeout_check(): 持锁回调死锁 → 先收集回调列表,解锁后调用 2. dc_get_type_name(): static string 非线程安全 → thread_local buffer 3. dc_event: 三个事件队列无容量上限 → EVENT_QUEUE_MAX_SIZE=1024, 溢出丢弃最旧 4. dc_signal_out: 回路阻断 last_caller_module 多模块覆盖 → dirty_by_multi 标志 5. dc_change_out_check: 处理完后重置 dirty_by_multi ## 原工程功能补全 (只能加法) 6. dc_check_val_valid: 新增 12 种数值类型范围校验 (min/max), bool 0/1 校验 7. dc_check_ctrl_val_valid: C8/C32/C64/C128/STR 改用 strcmp (原memcmp会误判) 8. dc_internal_type_name: 新增线程安全 buffer 版类型名称查询 |
||
|---|---|---|
| config | ||
| docs | ||
| release | ||
| src | ||
| .gitignore | ||
| COMPLETION.md | ||
| PLAN.md | ||
| SPEC.md | ||
docs/README.md
RTU_ALL_AI API 参考文档
生成日期: 2026-07-07
项目: RTU_ALL_AI — C/C++ 嵌入式通讯装置示例工程
文档索引
基础公共库 (public/)
| 模块 | 文档 | 语言 | 说明 |
|---|---|---|---|
| myBase.h | API-myBase.md | C 头文件 | 公共宏、类型常量、字节序转换 |
| liblist | API-liblist.md | 纯 C 头文件 | 侵入式双向循环链表 |
| liblog | API-liblog.md | 纯 C | 异步日志系统 |
| libfunc | API-libfunc.md | 纯 C | 65 个基础工具函数 |
| libmd5 | API-libmd5.md | 纯 C | MD5 消息摘要 (RFC 1321) |
| libtask | API-libtask.md | 纯 C | 定时器 + 事件 + 消息队列 |
| libdatacenter | API-libdatacenter.md | C 接口+C++ 内部 | 信号数据中心（5种信号+事件队列） |
| libcJSON | API-libcJSON.md | 纯 C (开源库) | JSON 解析/生成 |
| libmy_xxhash | API-libmy_xxhash.md | 纯 C (开源库) | xxHash 快速哈希 |
| libxml | API-libxml.md | C 接口+C++ 内部 | XML 解析（C接口包裹 tinyxml2） |
| libcmd | API-libcmd.md | C 接口+C++ 内部 | 命令注册/补全 + 内置 linenoise |
| libcomm | API-libcomm.md | C 接口+C++ 内部 | TCP/UDP/UART 通讯抽象层 |
通讯与协议库 (protocol/)
| 模块 | 文档 | 语言 | 说明 |
|---|---|---|---|
| libmodbus | API-libmodbus.md | C (开源库) | Modbus 协议栈 v3.1.12 |
| lib60870 | API-lib60870.md | C (自研) | IEC 60870-5-101/103/104 协议栈 |
| libmongoose | API-libmongoose.md | C (MIT 开源) | HTTP/WebSocket 嵌入式网络库 v7.22 |
系统模块 (system/)
| 模块 | 文档 | 语言 | 说明 |
|---|---|---|---|
| RTU | API-RTU.md | C + C++ | 主程序入口、X-Macro 框架、模块生命周期 |
| libmodbus_m | API-libmodbus_m.md | C++ | Modbus 主站管理（通道/点表/轮询/写入） |
| libweb_server | API-libweb_server.md | C++ | Web 管理服务（HTTP + WebSocket 实时推送） |
┌──────────┐
│ myBase.h │ (颜色/大小端/类型常量)
└────┬─────┘
┌──────────────┼──────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌──────────┐
│ liblist │ │ libfunc │ │ libmd5 │
│ (链表) │ │ (65函数)│ │ (MD5) │
└────┬────┘ └────┬────┘ └──────────┘
│ │
▼ ▼
┌─────────────────────────┐
│ liblog │ (异步日志)
│ (消息池+批量+文件轮转) │
└─────────────────────────┘
┌──────────┐ ┌──────────────┐
│ libcJSON │ │ libmy_xxhash │ (开源库)
└──────────┘ └──────┬───────┘
│
┌─────────────────────┼─────────────────────┐
│ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│ │ libtask │ │ libxml │ │ libcmd │ │ (P2库提前实现
│ │ (事件/ │ │ (C接口+ │ │ (命令 │ │ 供datacenter
│ │ 定时器) │ │ tinyxml2)│ │ 框架) │ │ 依赖)
│ └──────────┘ └────┬─────┘ └────┬────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────────────────┐ │
│ │ libdatacenter │ │
│ │ (信号数据中心 5种信号类型) │ │
│ │ 依赖: libxml + libcmd │ │
│ │ + libmy_xxhash │ │
└──────────┴─────────────────────────────┘
┌──────────┐
│ myBase.h │
└────┬─────┘
│
▼
┌──────────────────┐
│ libcomm │ (通讯抽象层)
│ TCP/UDP/UART │ 阶段 2 首个模块
│ epoll 异步事件 │
└────┬───┬────┬────┘
│ │ │
┌──────────┼───┘ └──────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌────────────┐
│libmodbus │ │lib60870 │ ... │libweb_server│ (协议栈)
│ (Modbus) │ │(IEC104) │ │ (Web 管理) │
└──────────┘ └──────────┘ └────────────┘
构建与编译
cd release
./build.sh # x86 本地编译
./build.sh arm # ARM 交叉编译
编码规范
详见项目内存 /memories/code-style.md：
- 一行一语句，
{}独占行，}后空行，return前空行 - 运算符前后空格（
a + b,x << 8），逗号分号后空格 - 结构体
stru_前缀，枚举enum_前缀 - 注释使用 UTF-8 中文