RTU_ALL_AI — C/C++ 嵌入式通讯装置工程，100% AI 编写

Go to file

ypc 44419ec729 docs: 创建完整 API 参考文档（9 个文档, 1005 行）目录结构: docs/public/ 镜像 src/public/, 每个模块一个 API-xxx.md 文档内容: 模块概述+数据结构+接口详细说明+使用示例+依赖关系覆盖模块: - docs/README.md (总索引, 依赖关系图) - myBase.h (公共宏/字节序/数据类型常量) - liblist (11 API, 侵入式链表, 含完整代码示例) - liblog (17 API, 异步日志, 消息池+批量+文件轮转) - libfunc (65 函数, 7 大分类, 分组文档) - libmd5 (4 API, RFC 1321, 流式计算示例) - libtask (21 API, 定时器+事件+消息队列, 三个独立示例) - libcJSON (开源库, 解析/生成全流程示例) - libmy_xxhash (开源库, XXH32/XXH64 快速哈希) 文档规范已存入 /memories/doc-spec.md		2026-07-07 15:16:17 +08:00
docs	docs: 创建完整 API 参考文档（9 个文档, 1005 行）	2026-07-07 15:16:17 +08:00
release	[重构] libtask 完整重写 + 全项目注释中文化	2026-07-07 15:01:13 +08:00
src/public	chore: 删除旧的 myTask.cpp（已替换为 myTask.c）	2026-07-07 15:01:20 +08:00
.gitignore	Initial commit: add .gitignore	2026-07-07 10:40:53 +08:00
PLAN.md	[PLAN] v2.0 放宽纯C限制：C接口强制+C++内部实现灵活；新增单模块开发流程、CHANGELOG、COMPLETION 质量保证机制	2026-07-07 11:11:39 +08:00
SPEC.md	docs: SPEC v1.2 — 区分自研/开源库 + 补全 5 个自研模块详细 API 分析	2026-07-07 14:35:56 +08:00

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	定时器 + 事件 + 消息队列
libcJSON	API-libcJSON.md	纯 C (开源库)	JSON 解析/生成
libmy_xxhash	API-libmy_xxhash.md	纯 C (开源库)	xxHash 快速哈希

模块依赖关系图

                    ┌──────────┐
                    │ myBase.h │  (颜色/大小端/类型常量)
                    └────┬─────┘
          ┌──────────────┼──────────────┐
          ▼              ▼              ▼
     ┌─────────┐   ┌─────────┐   ┌──────────┐
     │ liblist │   │ libfunc │   │  libmd5  │
     │ (链表)  │   │ (65函数)│   │  (MD5)   │
     └────┬────┘   └────┬────┘   └──────────┘
          │              │
          ▼              ▼
     ┌─────────────────────────┐
     │         liblog          │  (异步日志，依赖
     │  (消息池+批量+文件轮转) │   liblist + libfunc)
     └─────────────────────────┘

     ┌──────────┐   ┌──────────────┐
     │ libcJSON │   │ libmy_xxhash │  (开源库，直接使用)
     └──────────┘   └──────────────┘

     ┌────────────────────────────────┐
     │            libtask             │  (事件/定时器/消息队列)
     │   (timerfd + epoll + pthread)  │
     └────────────────────────────────┘

构建与编译

cd release
./build.sh          # x86 本地编译
./build.sh arm      # ARM 交叉编译

编码规范

详见项目内存 /memories/code-style.md：

一行一语句，{} 独占行，} 后空行，return 前空行
运算符前后空格（a + b, x << 8），逗号分号后空格
结构体 stru_ 前缀，枚举 enum_ 前缀
注释使用 UTF-8 中文

docs/README.md Unescape Escape

RTU_ALL_AI API 参考文档

文档索引

基础公共库 (public/)

模块依赖关系图

构建与编译

编码规范

docs/README.md