Connecting

面向嵌入式系统的通信中间件及配套工具链开源项目。

Connecting 是一套面向嵌入式开发的调试工具链。它通过 设备描述包（DCM） 机制，让上位机自动识别设备的能力（变量、服务、事件），无需为每款设备手动编写调试界面。

• 一句话价值：连接设备，即刻调试。不写上位机代码，不改设备固件逻辑。
• 提供跨芯片平台的预编译通信中间件库、板卡示例工程、设备信息提取工具与上位机调试工具，帮助开发者快速集成稳定可靠的嵌入式通信能力，降低从裸机到 RTOS、从 Cortex-M 到 C2000 的移植成本。

什么是 Connecting

嵌入式开发中，调试环节往往存在重复劳动。Connecting 把"为设备写调试代码"这件事，变成"导入一个描述文件"。

为什么需要 Connecting

核心功能

如何工作

嵌入式工程（含中间件）
        ↓
   编译 + 提取工具
        ↓
  设备描述包（DCM）
        ↓
   Connecting 上位机
        ↓
  自动生成调试界面：波形 + 变量 + 服务

三个核心环节：

1. 集成中间件：在设备工程中嵌入 Connecting 中间件（预编译库 + 头文件）
2. 提取描述包：编译后运行提取工具，生成 DCM 文件
3. 导入调试：上位机导入 DCM，自动生成调试界面，开始调试

我们的组件

仓库导航

命名规范：板卡仓库名格式 demo-<芯片>-<板卡>-<业务类型>，业务类型段为 baremetal / rtos / app-<名称>。

快速开始

1. 获取示例工程（含中间件子模块）：

   git clone --recursive https://gitee.com/connecting_repo/connecting_demos.git
   cd connecting_demos/demo-stm32f407-alientek-discovery-baremetal
2. 下载中间件预编译库（在各 demo 工程内）：

   setup_libs.bat armcc-m4
3. 编译烧录：使用 Keil 打开工程，编译并烧录到开发板。
4. 设备信息提取：编译后运行提取工具生成 DCM，参见 info-extractor 文档。
5. 启动上位机联调：打开 Connecting Host Tool，导入 DCM 文件，开始调试。参见 connecting-host-tool。

以上任一步都需要细节？完整带命令的工作流见 QUICK_START.md，排错与高频疑问见 faq.md。

快速导航（按角色）

不知道从哪看起？根据你的身份选一条路径：

不确定自己属于哪类？默认从「快速开始」走一遍，跑通即理解全貌。 完整工作流步骤见 QUICK_START.md，高频问题见 faq.md。

已支持平台

架构总览

connecting_repo/（组织）
│
├── connecting-docs/          ← 文档枢纽（你在这里看到的导航）
│
├── connecting_demos/         ← 集合层（子模块指针）
│   └── demo-stm32f407-...-baremetal/  → 子模块引用 connecting_middleware
│
├── connecting_middleware/    ← 基础层（库 + 头 + 配置）
│
├── info-extractor/           ← 工具层（提取工具）
└── connecting-host-tool/     ← 工具层（上位机）

中间件以预编译库形式从 Gitee Release 分发（不进 git），demo 通过子模块引用头文件与配置，编译前用 setup_libs.bat 拉取对应平台的库。

许可证

各仓库采用不同许可证，详见对应仓库 LICENSE 文件：

• 中间件 connecting_middleware：LGPL-3.0（库文件）
• 示例 connecting_demos / demo-*：MIT
• 文档 connecting-docs：MIT
• 上位机 connecting-host-tool：GPL-3.0 + 商业例外（开源免费版受 GPLv3 约束；商业用途需单独商业授权证书）
• 提取工具 info-extractor：专有（源码不公开，DCM 规范禁止修改后冒用）

上位机采用 GPLv3 + 商业例外双许可，明确区分「开源免费版」与「付费商业版」；外部代码贡献的版权与商业再授权条款见 CONTRIBUTING.md。