# App/ — 应用层 > **自研代码**(非 CubeMX 生成、非第三方库)。本目录是项目的**应用层**:任务编排、业务逻辑、 > 日志与配置引擎、工具函数。所有文件遵循 `docs/代码规范/嵌入式C语言代码规范_V1.0.md`。 ## 职责 `Src/main.c`(CubeMX 初始化)→ `app_main_init`(本目录 `app/app_main.c`)→ `osKernelStart` → 6 个 FreeRTOS 任务(见 `task/`)。**`osKernelStart` 之前全是内核启动前代码,禁止调用任何 FreeRTOS/CMSIS-RTOS API**(本条与「就绪屏障位必须 `osFlagsNoClear`」的理由 → `docs/子系统设计/控制台单写者日志设计.md` §2.5 与 `docs/架构设计/项目启动顺序管理.md`)。 ## 目录结构(按职责分层) | 目录 | 内容 | README | |---|---|---| | `app/` | **应用入口与全局**:`app_main.c/h`(初始化入口)、`app_cfg.h`(裁剪决策占位说明,当前无宏)、`sys_events.h`(就绪事件) | [`app/README.md`](app/README.md) | | `cfg/` | **配置引擎**:`/config.ini` 解析 + 原子持久化(旧二进制档已废弃,2026-10-10) | [`cfg/README.md`](cfg/README.md) | | `sync/` | **时间同步任务**:`time_sync.c/h` | [`sync/README.md`](sync/README.md) | | `algo/` | **采集与算法层**:语义取数 + 有效性判定 + 采样环/相量/测频 + 定值模型 + 保护元件框架 | [`algo/README.md`](algo/README.md)(索引);设计 → `docs/算法/采集与算法层设计说明.md` | | `log/` | **日志子系统**:syslog(NAND)+ 控制台单写者日志 | [`log/README.md`](log/README.md) | | `task/` | **FreeRTOS 任务实现**(6 个任务) | [`task/README.md`](task/README.md) | | `util/` | **通用工具**:CRC / 环形缓冲 / 墙钟时间 | [`util/README.md`](util/README.md) | | `iec60870/` | **通信协议**:IEC 60870-5-104 只维护一个——vendor 子树(`common/` `104/` `examples/`)+ 我方适配层 `104_port/`(core/source/net_mcu/dtu_table/comm) | [`iec60870/IMPORT.md`](iec60870/IMPORT.md)(来源、补丁与验证边界);结构见本文末节 | ## 关键约束 - **配置引擎单任务收敛**:`cfg/` 为静态态、属主是 defaultTask;UI 保存请求经 `SYS_EVT_CFG_SAVE` 事件唤醒,netTask/uiTask **不得直接触碰**配置引擎 - **syslog 唯一写者**:`/log/*` 只由 defaultTask 写入 - 新增任务/缓冲/栈前**必须先核算 RAM 余量**(`docs/内存管理/`) ## 通信协议:`iec60870/` 结构 **104 只维护一个实现**(2026-11-18 由 `App/protocol/` 迁入,该中间层目录已删除)。 `iec60870/` 分两类内容,改动时先认清自己在哪一侧: | 子目录 | 属于 | 内容 | 能否就地改 | |---|---|---|---| | `common/` `104/` `104/business/` `examples/` | **vendor 子树**(IEC60870-Slave 产品子集) | `common/`:ASDU/信息对象/时间编解码与 Slave 主体;`104/`:Link/Connection/TcpServer/SendManager 等 APCI 传输;`104/business/`:总召、命令、对时、文件服务等业务状态机;`examples/`:DTU 点表 profile | 有来源哈希与补丁清单约束 → 见 [`iec60870/IMPORT.md`](iec60870/IMPORT.md),改动须登记 | | `104_port/` | **我方适配层**(11 个文件) | `iec104_core`(装配共享核心)、`iec104_source`(数据/模拟动作/参数 RAM/虚拟墙钟)、`iec104_net_mcu`(CH395F 网络后端)、`iec104_dtu_table`(标准 DTU 点表)、`iec104_comm`(`[comm]` 段) | 可改;设计口径 → `docs/子系统设计/IEC104上行设计说明.md` | ## 相关文档 - 架构全景:`docs/架构设计/项目架构总览.md` - 启动顺序:`docs/架构设计/项目启动顺序管理.md` - 配置引擎:`docs/子系统设计/配置文件设计.md` - 日志:`docs/子系统设计/控制台单写者日志设计.md`、`docs/子系统设计/运行与自检记录设计.md`