文档与规格书

本文介绍 fw-AC79_AIoT_SDK（杰理 AC791N 系列 AIoT 多媒体 SoC 固件开发包）配套的文档资源与芯片规格书体系，涵盖在线文档中心、仓库本地数据手册、参考原理图、芯片选型表、开发工具文档、SDK 版本历史、蓝牙/WiFi 认证资料以及 FAQ 支持渠道，帮助开发者快速定位所需资料并建立"文档驱动"的开发流程。

Purpose and Scope

本文档面向使用 AC791N 系列芯片（AC7911B / AC7912A / AC7913A / AC7915A / AC7915B / AC7916A）进行产品开发的软硬件工程师，系统梳理该 SDK 可获得的全部文档与规格书资源及其用途：

• 在线文档中心：官方 AC79 开发文档（含模块示例、FAQ、版本历史）
• 本地数据手册：仓库 doc/datasheet/ 下的各芯片型号 Datasheet PDF 与选型表
• 参考原理图：各方案的 SCH/PDF 参考设计
• 开发工具文档：编译工具链、烧录工具、量产工具的使用说明
• 认证资料：蓝牙 QDID 与 Wi-Fi 联盟认证信息
• 分支与版本策略：如何选择稳定版本或最新特性分支

以下主题不在本页范围内，请参见对应分类页：工程结构（apps/、cpu/、include_lib/ 等）见「工程结构」页；编译命令与烧录流程见「编译指南」「烧录与升级」页；板级配置见「配置说明」页。

Overview

AC791N 是一款低成本、高集成度的 WiFi 802.11b/g/n + 双模蓝牙（BR/EDR + BLE，V2.1 ~ V5.0） 音视频多媒体 SoC，内部集成主频 320MHz 的双核浮点 DSP、音频 ADC/DAC、视频 ISC 与 RGB 推屏等资源，可一站式实现 WiFi 音箱、故事机、IP Camera、扫码盒等 AIoT 产品。由于该 SDK 为 Release 代码包，固件包本身不含开发文档，开发前必须配合官方在线文档中心与仓库内置的规格书使用——这正是本页的核心价值：把分散的资料入口汇总成一个可快速检索的索引。

关键事实（源自 README.md）：

• 本仓库为 SDK Release 版本代码及示例工程，需配合对应平台的库文件（*.a）编译
• 引用了 lwIP、mbedTLS、FreeRTOS 等开源项目
• 仓库内 doc/ 目录存放数据手册（datasheet/AC791N规格书）与资料（stuff）
• 仓库内 docs/ 目录为在线文档源（rst 格式）
• 官方文档地址：https://doc.zh-jieli.com/AC79/zh-cn/release_v1.2.0/index.html

Architecture

下图展示 SDK 文档与规格书资源的整体构成及它们与开发流程的关系：

flowchart TD
    subgraph sg_Online["在线文档中心（doc.zh-jieli.com/AC79）"]
        O1["AC79 开发文档（入口）"]
        O2["模块示例文档"]
        O3["SDK 版本历史"]
        O4["FAQ 常见问题"]
    end

    subgraph sg_Local["仓库本地资料（doc/datasheet/）"]
        L1["芯片数据手册 PDF"]
        L2["参考原理图 SCH / PDF"]
        L3["芯片选型表 XLSX"]
    end

    subgraph sg_Tools["工具文档（doc.zh-jieli.com/Tools）"]
        T1["编译工具链文档"]
        T2["USB 升级工具文档"]
        T3["生产烧写工具文档"]
    end

    subgraph sg_Dev["开发流程"]
        D1["确定芯片型号"]
        D2["硬件设计 / 选择方案工程"]
        D3["编译、烧录与调试"]
    end

    O1 --> D1
    L1 --> D1
    L3 --> D1
    O2 --> D2
    L2 --> D2
    T1 --> D3
    T2 --> D3
    T3 --> D3
    O3 -.->|"版本比对/升级决策"| D1
    O4 -.->|"问题排查"| D3

架构说明：

• 在线文档中心是最高优先级入口，包含所有模块的开发说明（蓝牙、WiFi、音频、视频、UI、升级等），与 SDK 版本一一对应（release_v1.2.0）；
• 仓库本地资料随代码一起发布，保证离线可用，其中数据手册按芯片型号分文件提供，参考原理图按产品方案分目录提供；
• 工具文档独立于 SDK 文档中心（Tools 站点），覆盖编译环境搭建与烧录工具使用；
• 四条虚线/实线链路对应典型的"先查规格书选型 → 参考原理图设计 → 按文档编译调试"开发路径，若中途遇到问题则回溯到 FAQ 与版本历史。

在线文档中心

官方文档中心是 AC79 系列开发的第一手资料源，与当前分支（release/AC79NN_SDK_V1.2.0）对应的文档版本为 release_v1.2.0。README 中给出的入口如下（见 README.md 资源链接表）：

开发工具文档

工具文档位于独立的 Tools 文档站，README「环境搭建」一节给出了三个关键工具入口（见 README.md 安装工具链）：

本地数据手册（doc/datasheet/）

仓库根目录下的 doc/ 目录随 Release 一起发布，保证资料离线可用。README 工程结构明确标注了其作用（见 README.md 工程结构）：

├── doc/                      # 数据手册(datasheet/AC791N规格书) 与资料(stuff)
├── docs/                     # 在线文档源（rst）

doc/datasheet/AC791N规格书/ 目录下按 datasheet/（数据手册）与 schematic/（参考原理图）两个子目录组织资料，另有芯片选型表 Excel。

芯片数据手册清单

以下 PDF 数据手册按芯片型号提供电气特性、引脚定义、封装等规格（存放于 doc/datasheet/AC791N规格书/datasheet/）：

芯片平台与内核规格

README「支持的芯片与平台」汇总了 wl82 平台各型号与片上资源（见 README.md 芯片系列）：

参考原理图（schematic/）

doc/datasheet/AC791N规格书/schematic/ 目录按产品方案组织参考设计，每个方案同时提供 PDF（阅读用）与 SCH（EDA 工程，可编辑）两种格式。当前仓库收录的方案包括：

使用建议：硬件设计时应优先选择与目标芯片型号 + 麦克风接法（单端/差分）最接近的参考原理图作为起点，再结合对应型号 Datasheet 核对引脚与供电。

认证资料

SDK 内置的蓝牙协议栈与 WiFi 已通过官方认证，相关认证信息是产品送测与宣传的重要依据（见 README.md 认证信息）：

蓝牙官方认证

经典蓝牙 LMP / 低功耗蓝牙 Link Layer 与 Host 协议栈支持蓝牙 5.0 与 5.1：

WiFi 官方认证

已完成 Wi-Fi 联盟互操作性测试（含 WPA/WPA2-Personal 安全认证、B/G/N 连通性测试）：

射频关键指标（摘自规格书能力总览）

Core Flow：文档驱动的开发流程

flowchart TD
    Start([开始产品开发]) --> Step1["阅读在线文档中心<br/>了解 SDK 架构与方案"]
    Step1 --> Step2{"确定目标芯片型号"}
    Step2 -->|"AC7911B / AC7912A / AC7913A<br/>AC7915A / AC7916A 等"| Step3["查阅对应型号 Datasheet<br/>（doc/datasheet/）"]
    Step3 --> Step4["选择最接近的参考原理图<br/>（schematic/）设计硬件"]
    Step4 --> Step5["按方案工程编译固件<br/>（apps/ + 工具链文档）"]
    Step5 --> Step6{"编译/调试遇到问题？"}
    Step6 -->|"是"| Step7["查询 FAQ / 版本历史<br/>或反馈 Gitee Issues"]
    Step7 --> Step5
    Step6 -->|"否"| Step8["烧录验证 / 产品送测<br/>（依据认证资料）"]
    Step8 --> Finish([量产])

流程要点：

1. 选型阶段：先用在线文档中心了解平台能力，再用 AC791N选型表231122.xlsx 与各型号 Datasheet 锁定芯片；
2. 硬件阶段：以 schematic/ 下的参考原理图为模板，注意麦克风接法（单端/差分）与 IPC/音箱等方案的差异；
3. 软件阶段：按 README 编译指南 + 工具链文档搭建环境，make <target> 编译对应方案；
4. 问题闭环：优先查 FAQ 与版本历史，未解决则通过钉钉技术支持群或 Gitee Issues 反馈。

分支与版本策略

README「版本与分支说明」给出了明确的选版建议（见 README.md 版本与分支说明）：

设计意图：Gitee 仓库时常更新，master 分支可能包含未充分验证的新特性；量产项目应锁定稳定 Release 分支，并对照「SDK 版本历史」评估升级收益与风险。

Usage Examples

以下示例摘自 README，展示了文档/规格书相关资源的实际使用方式。

示例 1：克隆仓库并查看本地资料

git clone https://gitee.com/Jieli-Tech/fw-AC79_AIoT_SDK.git
cd fw-AC79_AIoT_SDK
# 本地数据手册位于 doc/datasheet/AC791N规格书/

Source: README.md

示例 2：按方案选择应用工程

SDK 根目录
├── apps/wifi_camera/          # WiFi 摄像头方案
├── apps/wifi_ipc/             # WiFi IPC 网络摄像机方案
├── apps/wifi_story_machine/   # WiFi 故事机方案
├── apps/scan_box/             # 扫码盒方案
└── apps/demo/                 # 11 个功能 demo（ble/wifi/edr/ui/uvc/video/audio…）

Source: README.md

示例 3：验证编译工具链是否安装成功

# 验证工具链是否安装成功
clang --version

Source: README.md

注意事项与常见陷阱

基于 README「常见问题」与「免责声明」部分整理的文档使用要点：

资源与支持渠道

Related Links

• README.md（SDK 总览与全部文档入口）
• AC791N 数据手册目录（本地）
• AC791N 参考原理图目录（本地）
• AC791N 选型表（本地）
• 在线文档中心：AC79 开发文档 · FAQ
• 工程结构 / 编译指南 / 烧录与升级 / 配置说明等主题，请参见开发者资源分类下对应页面