开发文档与认证信息

本文档汇总 fw-AC630N_BT_SDK 仓库中面向开发者的文档资源、构建指引、AT 协议资料以及蓝牙认证（Qualification）信息，帮助开发者快速上手 AC630/1N 系列芯片的蓝牙开发。

Purpose and Scope

本页面覆盖以下内容：

• SDK 的定位、组成与仓库文档布局（README.md、doc/ 目录）
• 开发环境搭建与构建方式（JL Toolchain、Codeblock、Makefile）
• 可构建示例工程（SPP_LE、HID、Mesh）
• AT 协议开发资料（HEX 指令格式与示例）
• 芯片型号参数速查（AC6311A / AC6313A / AC6318A / AC6319A）
• 蓝牙认证信息（Bluetooth 5.0、QDID 134104）

以下主题属于其他目录页面的范围，本页面不做展开：

• 各示例工程的源码级实现细节（SPP_LE / HID / Mesh 应用源码）
• Zephyr RTOS 内核与子系统本身的机制
• 具体外设驱动与 BLE 协议栈源码分析

Overview

fw-AC630N_BT_SDK 是杰理科技（Jieli）为 AC630/1N 系列蓝牙芯片提供的通用蓝牙 SDK 固件仓库。它基于开源项目 Zephyr RTOS，并在其上增加了杰理自有的源码扩展、子系统与库。仓库本身必须与 lib.a 预编译库以及其他遵循相同命名约定的仓库配合，才能构建出仓库内提供的示例工程并使用附加子系统。

SDK 面向的开发场景包括蓝牙防丢器、Beacon、蓝牙 HID、蓝牙透传（SPP + LE）等，芯片内置 Classic（SDP/RFCOMM/SPP）与 LE（ATT/SM/HOGP/Mesh）双模协议栈，支持 SmartReady v5.0 与 1Mbps/2Mbps/Coded PHY。

对于开发者而言，本仓库中的文档是入门的核心入口：README.md 提供工具链、构建与认证信息的概览；doc/README.md 提供芯片选型参数与 SDK 发布/介绍 PDF；doc/蓝牙AT协议/ 提供 AT 指令协议说明与 HEX 指令示例。

Architecture

下图展示了仓库文档资源、SDK 组成与构建流程之间的关系：

flowchart TD
    subgraph sg_Repo["fw-AC630N_BT_SDK 仓库"]
        subgraph sg_Docs["文档资源"]
            README["README.md<br/>工具链/构建/认证"]
            DocReadme["doc/README.md<br/>芯片参数/SDK 发布信息"]
            ATPDF["doc/蓝牙AT协议/<br/>蓝牙AT协议.pdf + cmd_sample.txt"]
            SDKPDF["doc/AC630N_bt_data_transfer_sdk介绍.pdf<br/>SDK 发布版本信息.pdf"]
        end
        subgraph sg_Src["SDK 源码组成"]
            Zephyr["Zephyr RTOS 开源基线"]
            Jieli["杰理源码扩展/子系统/库"]
            LibA["lib.a 预编译库"]
        end
        subgraph sg_Apps["可构建示例工程"]
            SPPLE["apps/spp_and_le"]
            HID["apps/hid"]
            Mesh["apps/mesh"]
        end
        subgraph sg_Build["构建工具"]
            Toolchain["JL Toolchain"]
            CBP["Codeblock (.cbp)"]
            Make["Makefile + app_cfg"]
        end
    end

    README -->|"指引"| DocReadme
    DocReadme -->|"发布"| SDKPDF
    README --> ATPDF
    Zephyr --> Jieli
    Jieli --> LibA
    Jieli --> SPPLE
    Jieli --> HID
    Jieli --> Mesh
    Toolchain --> CBP
    Toolchain --> Make
    SPPLE --> CBP
    HID --> CBP
    Mesh --> CBP
    SPPLE --> Make
    HID --> Make
    Mesh --> Make
    CBP -->|"产出固件"| FW["目标固件"]
    Make -->|"产出固件"| FW

图中的核心设计意图：SDK 采用「开源内核基线 + 厂商私有扩展 + 预编译库」的分层组合模式，应用工程与内核解耦，开发者只需在 apps/app_cfg 中选择目标工程，即可通过 Codeblock 或 Makefile 两种方式构建。文档资源则独立组织在 doc/ 目录下，与源码分离，便于版本化维护。

各组成部分说明：

开发环境与工具链

工具链获取

SDK 使用杰理提供的 JL Toolchain 进行编译。README 中给出了工具链的获取方式（百度网盘链接，提取码 ukgx），并要求在开始开发前先完成构建环境搭建：

how to get the JL Toolchain and setup the build enviroment,see below

• Lastest：(https://pan.baidu.com/s/1f5pK7ZaBNnvbflD-7R22zA) 提取码: ukgx

来源：README.md

设计意图：将工具链与 SDK 源码分离存放，可以避免仓库体积膨胀，同时允许工具链独立迭代升级；开发者只需在首次搭建环境时获取一次。

两种构建方式

SDK 同时支持 Codeblock 与 Makefile 两种构建方式，README 中给出了明确指引：

SDK support Codeblock & Make to build to project,make sure you already setup the enviroment

* Codeblock build : enter the project directory and find the `.cbp`,double click and build.

* Makefile build : `apps/app_cfg` select the target you want to build,double click the `make_prompt` and excute `make`

来源：README.md

• Codeblock 方式：进入目标工程目录，找到对应的 .cbp 工程文件，双击后直接构建。适合图形化开发与单步调试。
• Makefile 方式：在 apps/app_cfg 中选择要构建的目标，双击 make_prompt 进入命令行环境后执行 make。适合命令行批量构建与 CI 集成。

两种方式的本质差异在于构建前端（IDE 工程文件 vs. Makefile 脚本），底层使用的都是同一套 JL Toolchain 工具链。

可构建示例工程

README 中列出了三个可构建的应用工程，覆盖了 SDK 的主要能力域：

来源：README.md

开发板获取

开发板可通过官方淘宝店铺申请/购买，入口见 README 的 EV Board 章节：

• 开发板申请入口：(https://shop321455197.taobao.com/?spm=a230r.7195193.1997079397.2.2a6d391d3n5udo)

来源：README.md

开发流程总览

下图展示了从获取 SDK 到产出固件的典型开发流程：

flowchart TD
    Start([开始开发]) --> Step1["获取 JL Toolchain<br/>（百度网盘 提取码 ukgx）"]
    Step1 --> Step2["获取 SDK 仓库<br/>fw-AC630N_BT_SDK + lib.a + 同名仓库"]
    Step2 --> Step3{"选择构建方式"}
    Step3 -->|"Codeblock"| Step4["进入工程目录<br/>双击 .cbp 构建"]
    Step3 -->|"Makefile"| Step5["apps/app_cfg 选择目标<br/>执行 make"]
    Step4 --> Step6{"构建成功?"}
    Step5 --> Step6
    Step6 -->|"否"| Step7["检查工具链环境<br/>检查 lib.a 依赖"]
    Step7 --> Step4
    Step6 -->|"是"| Step8["烧录固件到<br/>AC630/1N 开发板"]
    Step8 --> Step9["参考 doc/蓝牙AT协议<br/>验证透传指令"]
    Step9 --> Step10["产品化：申请认证<br/>（QDID 134104）"]
    Step10 --> EndNode([完成开发])

流程设计要点：构建失败时优先排查工具链环境与 lib.a 依赖是否齐全——这是 README 明确强调的前提条件；认证信息（QDID）在开发早期就应确认，因为它决定了产品能否合法使用 Bluetooth 5.0 协议栈的声明。

AT 协议开发资料

资料构成

doc/蓝牙AT协议/ 目录是透传类应用（SPP/LE）的核心开发参考资料，包含：

指令格式与示例

cmd_sample.txt 中的指令采用 HEX 字节流格式，典型结构为「命令字 + 参数长度 + 参数内容」。以下是初始化阶段的指令示例：

//-----初始化 示例-------
SET_VISIBILITY
01 02 01 00

SET_EDR_ADDR
01 00 06 66 55 44 33 22 11

SET_BLE_ADDR
01 01 06 99 55 44 33 22 11

SET_EDR_NAME
01 03 0f 61 74 5F 63 6F 6D 5F 74 65 73 74 5F 73 70 70

SET_BLE_NAME
01 04 0f 61 74 5F 63 6F 6D 5F 74 65 73 74 5F 62 6C 65

SET_ADV_DATA
01 2d 07 02 01 06 03 03 30 AF

来源：cmd_sample.txt

以 SET_EDR_NAME 为例拆解字节含义：01 为命令组标识，03 为子命令（EDR 名称设置），0f 为名称长度（15 字节），随后为 ASCII 编码的 at_com_test_spp。同样地，SET_BLE_NAME 将 BLE 广播名称设置为 at_com_test_ble，SET_ADV_DATA 设置广播数据（Flags + Service UUID 30 AF）。

数据收发阶段示例（SPP 与 BLE 通道）：

//-----数据收发命令 示例-------
SET_SEND_SPP_DATA
01 05 0A 41 54 5F 4D 58 5F 31 32 33 34

SET_SEND_BLE_DATA
01 09 0A 08 00 41 54 5F 4D 58 5F 30 30

SET_SEND_DATA
01 0A 08 41 54 5F 4D 58 5F 38 38

EDR_DISCONNECT
01 11 00

BLE_DISCONNECT
01 12 00

来源：cmd_sample.txt

查询与控制类指令（状态查询、设备名/地址读取、休眠控制）：

//-----查询命令示例-------
STATUS_REQUEST
01 0B 00

SET_EDR_COD(CLASS OF DEVICE)
01 15 03 04 04 24   //01 15 03 00 00 00

ENTER_SLEEP_MODE
01 27 00

GET_EDR_ADDR
01 34 00

GET_BLE_ADDR
01 35 00

GET_EDR_NAME
01 36 00

GET_BLE_NAME
01 37 00

来源：cmd_sample.txt

设计意图：AT 指令集将底层协议栈操作（广播、连接、数据传输、休眠）封装为统一的字节流接口，使上位机/串口调试工具无需关心蓝牙协议细节即可完成全链路验证，这也是透传 SDK 类产品常见的调试与集成方式。

芯片型号参数速查

doc/README.md 的 630/1N Brief 章节给出了四个芯片型号的关键参数，供选型参考：

来源：doc/README.md

选型要点：AC6311A/AC6313A 内置 250mA 充电管理并支持 LDO/DCDC 双电源模式，适合电池供电的防丢器、可穿戴类产品；AC6318A/AC6319A 无内置充电，工作电压上限 3.6V，适合由外部电源供电的场景。四款芯片的协议栈与 Flash/RAM 配置一致，应用层代码可在型号间复用。

认证信息（Bluetooth Qualification）

README 的 Certification 章节声明了 SDK 所实现的蓝牙协议栈规格与认证状态：

Bluetooth Classic LMP / LE Link Layer protocol stack implementing Bluetooth 5.0 specification

• QDID 134104

来源：README.md

要点解读：

• 协议栈范围：Bluetooth Classic LMP（Link Manager Protocol）与 LE Link Layer，实现 Bluetooth 5.0 规范。
• QDID（Qualified Design ID）134104：该 QDID 可在 Bluetooth SIG Launch Studio 的 Listing Details 88799 中查询，代表该设计已通过蓝牙资格认证（Bluetooth Qualification）。产品若使用该 SDK 的协议栈，可以基于此 QDID 走声明（Declaration）流程，从而复用认证成果、降低认证成本。
• 认证的意义：蓝牙产品上市前必须完成资格认证，QDID 复用是官方认可的合规路径，这也是 README 将认证信息与 SDK 一起发布的原因——它直接关系到开发者能否将固件产品化。

开发状态免责声明

README 末尾的 Disclaimer 明确了 SDK 当前的支持边界：

AC630N_BT_SDK supports development with AC630/1N series devices. AC630/1N Series devices (which are pre-production) and Bluetooth Mesh protocols are supported for development in v0.2.0 for prototyping and evaluation. Support for production and deployment in end products is coming soon.

来源：README.md

这意味着：v0.2.0 阶段芯片处于 pre-production 状态，蓝牙 Mesh 协议仅支持原型验证与评估用途，尚不承诺可直接量产。开发者应据此规划产品上市节奏，并与杰理官方确认量产支持状态。

使用示例

示例 1：通过串口执行 AT 指令完成设备初始化

以下片段展示了使用 AT 指令初始化设备的完整字节序列，可直接通过串口调试工具（如文档中的 com_sample.png 所示环境）逐条发送：

// 1. 设置经典蓝牙(EDR)地址: 66 55 44 33 22 11
01 00 06 66 55 44 33 22 11
// 2. 设置 BLE 地址: 99 55 44 33 22 11
01 01 06 99 55 44 33 22 11
// 3. 设置 EDR 名称: at_com_test_spp (ASCII, 15 字节)
01 03 0f 61 74 5F 63 6F 6D 5F 74 65 73 74 5F 73 70 70
// 4. 设置 BLE 名称: at_com_test_ble
01 04 0f 61 74 5F 63 6F 6D 5F 74 65 73 74 5F 62 6C 65
// 5. 设置广播数据: Flags + Service UUID 30 AF
01 2d 07 02 01 06 03 03 30 AF
// 6. 打开可见性（可被发现/连接）
01 02 01 07

来源：cmd_sample.txt

示例 2：SPP 与 BLE 数据透传

初始化完成后，可分别通过 SPP 与 BLE 通道发送透传数据，BLE 通道的数据带有 handle 参数（08 00 表示目标句柄）：

// SPP 通道发送: "AT_MX_1234"
01 05 0A 41 54 5F 4D 58 5F 31 32 33 34
// SPP 通道发送: "AT_MX_1999"
01 05 0A 41 54 5F 4D 58 5F 31 39 39 39
// BLE 通道发送: "AT_MX_00" (handle=0x0008)
01 09 0A 08 00 41 54 5F 4D 58 5F 30 30
// BLE 通道发送: "AT_MX_11" (handle=0x000d)
01 09 0A 0d 00 41 54 5F 4D 58 5F 31 31
// 通用数据通道发送: "AT_MX_88"
01 0A 08 41 54 5F 4D 58 5F 38 38

来源：cmd_sample.txt

示例 3：构建示例工程

按 README 指引选择构建方式（以 Makefile 为例）：

# 1. 进入 apps/app_cfg 选择目标工程（如 spp_and_le）
# 2. 双击 make_prompt 打开构建命令行
# 3. 执行 make 编译
make
# 4. 产物固件烧录到 AC630/1N 开发板

来源：README.md

配置选项

注：以上为文档层面给出的配置入口；工程内部的宏开关、协议栈参数等编译期配置属于各应用工程页面的范围，本页面不展开。

边界情况、失败模式与注意事项

依据仓库文档可确认以下边界与风险点：

1. 预发布芯片状态：AC630/1N 系列芯片处于 pre-production 阶段，v0.2.0 仅支持原型验证与评估，产品量产部署支持"即将到来"（coming soon）。这是规划产品化时最重要的约束。
2. Mesh 协议评估性质：Bluetooth Mesh 协议在 v0.2.0 中仅用于 prototyping 与 evaluation，不适合直接用于量产产品。
3. 依赖完整性：SDK 必须与 lib.a 及遵循相同命名约定的仓库组合才能构建，缺少任一依赖都会导致构建失败——排错时优先检查这一项。
4. 工具链环境：README 明确要求先 setup 构建环境再开始开发；Codeblock 与 Makefile 两条路径共享同一工具链，环境变量配置错误会导致两种方式都失败。
5. AT 指令字节序：cmd_sample.txt 中 BLE 发送指令的 handle 参数为小端字节序（如 08 00），手动构造指令时需注意；SET_EDR_COD 注释中还给出了替代参数组合（01 15 03 00 00 00），说明同一指令存在多种合法参数。
6. 认证合规：产品使用 Bluetooth 5.0 协议栈时应基于 QDID 134104（Listing 88799）走声明流程，否则可能面临合规风险。

相关链接

• 仓库 README（工具链/构建/认证/免责声明）
• doc/README.md（630/1N Brief 芯片参数表）
• SDK 介绍文档 PDF
• SDK 发布版本信息 PDF
• 蓝牙AT协议说明 PDF
• AT 指令 HEX 示例
• 蓝牙 SIG 认证查询（QDID 134104）
• 关联页面：示例工程实现细节见「SPP_LE 应用」「HID 应用」「Mesh 应用」等目录页面