④ 杰理 SDK 获取研究报告¶

研究时间：2026-05-17 | 信息来源：杰理官网 + Gitee + 官方文档

关键发现¶

🔴 AC7002 特殊说明¶

Gitee 上没有 AC7002 的公开仓库。 杰理 Gitee 组织介绍中提到"发布 AC700N 系列"，但 SDK 本身可能： - 需要联系代理商获取（常见做法：签 NDA 后给百度网盘链接） - 或随开发板附送（淘宝卖家常附带 SDK + 工具链）

采购开发板时务必确认： "是否附带 AC7002 的 SDK、文档、烧录工具"

✅ 已有公开资源（可立即使用）¶

1. 杰理 Gitee 组织¶

• 地址： https://gitee.com/Jieli-Tech
• 成员： 5 人（官方）
• 最相关项目： fw-AC63_BT_SDK（通用蓝牙 SDK，AC63 系列）
• Stars: 230 | Forks: 122 | License: Apache-2.0
• C 语言 85.8%, Lua 12.3%, Makefile 1.8%
• 可参考其工程结构（apps/cpu/include_lib/sdk_tools 等目录组织）

2. 官方工具文档¶

• 地址： https://doc.zh-jieli.com/Tools/zh-cn/index.html
• 内容：
• 开发环境安装（Windows: Code::Blocks + 工具链）
• SDK 编译及下载（支持 Code::Blocks / Makefile / VSCode）
• 工具链说明
• 量产工具（一拖二/一拖八烧录器、蓝牙测试盒）
• TWS 配对地址分析工具

3. 开发环境信息¶

4. SDK 下载链接¶

📋 需通过代理商确认的事项¶

🚀 推荐行动路径¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

第 1 步 ── 淘宝下单时问："AC7002 开发板带不带 SDK？"
      ↓
第 2 步 ── 拿到 SDK 后：
           ├── 解压看目录结构（参考 AC63 SDK 的 apps/cpu/include_lib）
           ├── 找到 jl_hal_*.h 头文件（硬件抽象层）
           └── 对比我们的 mock_hal.h → 逐个替换成真实现
      ↓
第 3 步 ── 搭建编译环境：
           ├── Windows: 装 Code::Blocks + 工具链 → 打开 .cbp 工程
           └── Linux:   用 Makefile 编译（不能下载）
      ↓
第 4 步 ── 用 tests/test_runner 的测试用例验证真实硬件
           ├── 烧录点灯例程
           ├── 跑 BLE 广播
           └── 验证状态机转换

💡 等 SDK 期间可以做的事¶

• ✅ mock_hal + 状态机测试（已完成，9 个测试全部通过）
• ✅ BLE 协议文档（已在 docs/ble-protocol.md）
• ⏳ 编译环境搭建（先装 Code::Blocks + 工具链到 Windows 机器）
• ⏳ AC63 SDK 研究（看 Gitee 上 AC63 的工程结构，为 AC7002 做准备）