OpenEmber 架构概览
OpenEmber 当前采用清晰的四层模型(依赖自上而下),便于扩展与长期维护:
- Application Layer — 可执行入口与编排(产品应用、系统节点、可选服务、示例、工具)
- Middleware Layer — 通信与核心运行时(Link、消息协议、节点生命周期、调度、参数、服务等)
- Components Layer — 跨模块复用组件(日志、算法、序列化、容器、配置解析等)
- Platform Layer — 操作系统抽象与平台 I/O(线程、定时器、socket、UART、GPIO、I2C 等)
Application 在逻辑上是一层;仓库里按职责拆成多个顶层目录,而不是额外架构层:
| 目录 | 角色 |
|---|---|
apps/ | 产品或用户项目入口(框架自带节点不放这里;turtle_demo 见 Turtle Demo;规划中的巡游小车 / 智慧农业站见 Rover Demo、Agri Station Demo;smart_device_demo 保留为最小产品入口参考) |
system/ | OpenEmber 自带、偏必需的系统节点 |
services/ | 可选 runtime 服务 |
examples/ | 示例与参考实现 |
tools/ | 开发、调试、运维工具 |
其下各层目录大致对应 communication/、core/、components/、platform/。另有 third_party/、configs/ 等工程辅助目录。
在 menuconfig 中,顶层菜单按工程使用体验做了收敛:
Build / Toolchain
Application Layer
Middleware Layer
Components Layer
Platform Layer
Third party
Tests
其中 Application Layer 聚合 apps/、system/、services/、examples/、tools/。
Middleware Layer 聚合通信与核心运行时配置,例如 Communication、Core Runtime。
产品工程与框架的边界
可以直接在 OpenEmber 源码树中开发,也可以由独立产品仓拥有顶层 CMake、Kconfig、应用、服务与型号配置,通过 add_subdirectory(openember) 引用框架。独立模式下,上表目录描述框架仓本身,产品拥有自己的 apps/、packages/、modules/ 和 products/。依赖方向为产品 → 框架公开接口,框架不依赖某个产品的驱动或业务。
第三种规划模式为安装 SDK 后开发:产品通过 find_package(OpenEmber) 使用已安装的公共头文件和库,独立构建,无需嵌入框架源码。当前继续推荐软链加源码一起编译;SDK 安装与导出能力暂不实施。
选择方式与操作步骤见 创建你的第一个产品。
依赖方向
Application(apps / system / services / examples / tools)
↓
middleware(communication / core)
↓
components
↓
platform
↓
操作系统(Linux 等)
上层可依赖下层,避免反向依赖,便于单独测试与替换实现(例如更换传输后端或 HAL 后端)。
组件层常用能力包括日志(Logging)、Algorithm、Thread Pool 等;通信层见 OpenEmber Link。
检测与响应的职责
设备反馈检测、行为响应和动作执行分别建模。检测模块报告可解释的状态与事件,产品策略根据当前动作、控制权和能力决定提示、降级、恢复或请求故障锁存;单一倾角、温度或误差阈值不直接绑定所有产品的统一响应。底层能力与授权等独立约束继续执行,详见检测、响应与恢复。
设计思想(摘要)
- 可扩展:插件化模块与 Kconfig 裁剪,适配不同产品与算力。
- 依赖管理:
OPENEMBER_THIRD_PARTY_MODE等选项支持 FETCH / VENDOR / SYSTEM,兼顾离线与企业构建。 - 通信抽象:OpenEmber Link 提供稳定的 Topic、Service、Liveliness 和消息编解码语义,底层传输实现对应用隐藏。
更完整的分层说明见上游 分层设计文档 与 Application 层设计指导;通信层见 OpenEmber Link。