杰理 SDK 文档中心
首页
首页
  • 概述与入门

    • 项目概述与芯片平台
    • 环境搭建与工具链安装
    • 编译与烧录指南
    • 工程结构总览
  • 应用层与公共模块

    • GP MCU 主应用入口
    • AT 指令与调试模块
    • 电池检测与电源管理
    • EEPROM 与参数存储
    • 按键与 USB 设备驱动
    • 音频解码与 APA 语音播报
  • 外设驱动与示例

    • 高精度 ADC(HADC)
    • 通用 ADC 与定时器
    • UART / SPI / IIC 通信外设
    • MCPWM 与电机控制
    • RTC 与低功耗唤醒
    • 段码 LCD 驱动
    • NOR Flash 与红外编解码组件
  • 显示与 UI 系统

    • LCD 驱动与字库引擎
    • UI 平台与控件绘制
    • UI 工程与资源生成工具
  • 系统底层与芯片平台

    • cd09 芯片平台与预编译库
    • GPIO 与 IIC 底层驱动
    • 系统文件系统与设备模型
  • 启动引导与固件升级

    • UBOOT 引导工程
    • 固件升级机制
  • 开发工具与资源

    • 编译脚本与命令行工具
    • 音频文件转换工具
    • 硬件资料与文档资源

硬件资料与文档资源

本页汇总 fw-AC82N_GP-MCU_SDK 仓库中 doc/ 目录下提供的全部硬件资料与文档资源,包括 AC82N 系列芯片规格书、最小系统参考设计、应用参考原理图、开发板使用手册及 SDK 发布版本信息,是硬件选型、原理图设计和开发板调试的权威参考入口。

Purpose and Scope

本页覆盖仓库 doc/ 目录中的硬件设计相关文档资源:

  • 芯片规格书(Datasheet):AC822B / AC823B / AC825A / AC826B 四款芯片的数据手册;
  • 最小系统参考设计:芯片上电、时钟、复位、调试口的最小电路;
  • 应用参考原理图:体脂秤、血压计、血氧仪等典型产品的完整参考电路;
  • 开发板资料:AC82N 开发指南、开发板使用手册及 AC820 TOP 布局图;
  • 发布版本信息:SDK 各版本的功能与修复记录。

不在本页范围(由兄弟页面或外部文档中心覆盖):

  • doc/软件工具/ 下的 unicode 字库工具 等软件工具属于"软件工具"专题;
  • SDK 编译、烧录、配置的完整说明请见 README 及杰理文档中心(见 Related Links);
  • 各外设驱动(HADC、SARADC、UART、SPI 等)的软件接口请参考 SDK 源码与 cpu/demo/ 示例。

Overview

AC82N 系列是杰理科技推出的无蓝牙功能通用 MCU SoC,基于 cd09 平台,包含 AC822B、AC823B、AC825A、AC826B 四款型号,面向高精度测量(体脂秤、血压计、血氧仪、耳温枪、精密仪器仪表)与低功耗产品(电池供电设备、便携式仪器、RTC 闹钟唤醒应用)两大场景。核心特性包括 24 位高精度 HADC(有效精度最高 19bit)、1Msps 高速 SARADC、超低功耗处理器与低功耗 RTC、以及 HADC / SARADC / IIC / SPI / MCPWM / UART / USB / 触摸按键等丰富片上外设,并支持 APA 播报。

硬件资料在 SDK 开发流程中扮演**"从芯片到产品"的桥梁**角色:

  1. 选型:根据应用场景(体脂秤 / 血压计 / 血氧仪 / 低功耗设备)确定芯片型号;
  2. 最小系统:依据芯片规格书与最小系统参考设计搭建可运行的硬件底板;
  3. 参考设计:对照应用参考原理图复用成熟的外围电路(HADC 前端、传感器接口、电源管理等);
  4. 开发板验证:使用 AC82N 开发板先跑通 SDK 固件,再迁移到自研硬件;
  5. 量产:依据规格书的电气参数与封装信息完成 PCB 布局与生产。

这些资料全部以 PDF 形式存放于仓库 doc/原理图&硬件资料/ 目录,随 SDK 一起版本化管理,保证文档与固件代码同步演进。

Architecture

资料目录组织

仓库文档目录采用"根目录 + 硬件资料 + 软件工具"的三段式组织,硬件资料内部再按"规格书 / 最小系统 / 应用原理图 / 开发板"分类:

flowchart TD
    subgraph sg_Doc["doc/ 文档目录"]
        subgraph sg_Root["doc/ 根目录"]
            VER["AC82N_GP_MCU_SDK_发布版本信息.pdf"]
        end
        subgraph sg_HW["doc/原理图&硬件资料/"]
            DS["芯片规格书 Datasheet"]
            MIN["最小系统参考"]
            APP["应用参考原理图"]
            DEV["开发板资料"]
        end
        subgraph sg_TOOL["doc/软件工具/"]
            TOOL["字库工具等软件工具"]
        end
    end
    VER -->|"版本配套关系"| DS
    VER -->|"版本配套关系"| DEV
    DS -->|"芯片引脚/电气约束"| MIN
    MIN -->|"最小电路基础"| APP
    APP -->|"外围电路复用"| DEV
    TOOL -.->|"兄弟页面"| DS

设计意图:将硬件资料按设计阶段(规格 → 最小系统 → 应用电路 → 开发板)分层存放,使开发者能按"自底向上"的顺序逐级查阅;版本信息文档独立于硬件资料目录,便于在 SDK 升级时快速核对固件与参考设计的配套关系。

芯片型号与应用场景映射

四款芯片同属 cd09 平台,但参考设计覆盖不同的典型产品,资料目录中的原理图即按此映射组织:

flowchart LR
    subgraph sg_SOC["cd09 平台芯片"]
        A822B["AC822B"]
        A823B["AC823B"]
        A825A["AC825A"]
        A826B["AC826B"]
    end
    subgraph sg_APP["典型应用"]
        SCALE["体脂秤<br/>四极/八极"]
        BP["血压计"]
        SPO2["血氧仪"]
        LOWP["低功耗测量设备"]
    end
    A822B -->|"四极体脂秤原理图"| SCALE
    A822B -->|"血压计原理图"| BP
    A823B -->|"八极体脂秤原理图"| SCALE
    A825A -->|"血压计原理图"| BP
    A826B -->|"血氧仪参考原理图"| SPO2
    A822B --> LOWP
    A823B --> LOWP

设计意图:同一芯片平台共享 SDK 与编译工具链(统一 make 目标 cd09),不同型号差异主要体现在封装、引脚数与外设组合上;按应用提供参考原理图,使医疗测量类产品(体脂秤、血压计、血氧仪)可直接复用经过验证的高精度模拟前端电路,显著缩短硬件设计周期。

硬件资料清单

以下为仓库 doc/ 目录下与硬件设计直接相关的全部文档资源。文件名即资料版本,如 V1.3 表示该文档的版本号,SDK 升级时需核对版本配套关系:

芯片规格书(Datasheet)

文件版本对应芯片说明
AC822B Datasheet V1.3.pdfV1.3AC822B芯片电气参数、引脚定义、封装信息、外设规格
AC823B Datasheet V1.3.pdfV1.3AC823B芯片电气参数、引脚定义、封装信息、外设规格
AC825A Datasheet V1.2.pdfV1.2AC825A芯片电气参数、引脚定义、封装信息、外设规格
AC826B Datasheet V1.2.pdfV1.2AC826B芯片电气参数、引脚定义、封装信息、外设规格

最小系统参考设计

文件版本对应芯片说明
AC822B最小系统 V1.0.pdfV1.0AC822B上电、时钟、复位、烧录口等最小可运行电路
AC823B最小系统 V1.0.pdfV1.0AC823B上电、时钟、复位、烧录口等最小可运行电路

应用参考原理图

文件版本对应芯片应用场景
AC822B四极体脂秤原理图 V1.1.pdfV1.1AC822B四极体脂秤(HADC 高精度测量)
AC823B八极体脂秤原理图 V1.1.pdfV1.1AC823B八极体脂秤(多电极阻抗测量)
AC822B血压计原理图 V1.0.pdfV1.0AC822B血压计(气压泵/传感器采集)
AC825A血压计原理图 V1.0.pdfV1.0AC825A血压计(气压泵/传感器采集)
AC826B 血氧仪参考原理图.pdf—AC826B血氧仪(光电容积脉搏波采集)

开发板资料

文件版本说明
AC82N Develop V1.1.pdfV1.1AC82N 系列开发指南:开发板资源、外设布局、调试口定义
AC82N开发板使用手册20230919.pdf2023-09-19开发板使用手册:按键、指示灯、烧录入口、接口说明
AC820 TOP V1.1.pdfV1.1AC820 顶层布局图(开发板 PCB 顶层视图)

版本发布信息

文件说明
AC82N_GP_MCU_SDK_发布版本信息.pdf记录 SDK 各发布版本的功能新增、缺陷修复与配套库文件要求

所有硬件资料以 PDF 格式随仓库版本管理,链接均指向 master 分支。文件名中的空格在 URL 中以 %20 编码。

各类资料详解

芯片规格书(Datasheet)

规格书是硬件设计的第一手依据,涵盖以下关键内容:

  • 电气参数:工作电压范围、GPIO 驱动能力、HADC/SARADC 精度指标、功耗数据(对电池供电产品尤其关键);
  • 引脚定义:各封装下的引脚功能复用表(GPIO / 外设 / 电源 / 调试口),是引脚映射配置(README 第 9.1 节所述"引脚映射")的硬件依据;
  • 封装信息:封装尺寸、焊盘布局,供 PCB 设计使用;
  • 外设规格:HADC(24 位、有效精度最高 19bit)、SARADC(1Msps)、IIC、SPI、MCPWM、UART、USB、触摸按键、RTC 等模块的电气与时序要求。

设计意图:SDK 代码中的引脚复用配置(cpu/cd09/ 下的板级配置)必须与规格书的引脚定义一一对应,任何引脚冲突都会导致外设无法工作,因此硬件设计阶段必须先以规格书为准完成引脚分配。

最小系统参考设计

最小系统原理图给出芯片能够运行固件的最小电路:电源去耦、时钟(晶振/内部 RC)、复位电路、烧录/调试口。它是所有应用设计的公共基础——应用参考原理图正是在最小系统之上叠加了传感器前端、显示、按键等外围。

典型复用路径:新项目硬件设计时,先按对应型号的最小系统搭建核心电路,再按产品类型(体脂秤/血压计/血氧仪)参考应用原理图补齐外围,最后对照规格书核对电气参数。

应用参考原理图

应用原理图是可直接复制的完整产品级参考设计,按芯片 × 应用组合提供:

  • 体脂秤:四极(AC822B)与八极(AC823B)两种电极方案,重点展示 HADC 高精度阻抗测量前端与电极驱动电路;
  • 血压计:AC822B 与 AC825A 两个平台,包含气压泵驱动、压力传感器采集、显示与按键电路;
  • 血氧仪:AC826B 平台,包含光电容积脉搏波(PPG)传感器前端与信号调理电路。

设计意图:医疗测量类产品的模拟前端(微弱信号采集、抗干扰、精度校准)是硬件设计中最易出错的部分。提供按应用组织的完整参考原理图,可以让 SDK 的测量类示例(如 cpu/demo/hadc_demo.c)在真实电路上直接验证,实现"软硬同步联调"。

开发板资料

开发板资料面向 SDK 评估与调试 阶段:

  • AC82N Develop V1.1:开发指南,说明开发板的资源布局与各外设的引出方式;
  • AC82N开发板使用手册:实操手册,包括按键功能、指示灯、烧录入口(进入编程模式的方法)与接口定义,与 README 第 8 节"烧录与升级"直接配套;
  • AC820 TOP V1.1:顶层 PCB 视图,便于对照实物定位器件。

设计意图:开发板是 SDK 固件的默认运行目标,README 中"连接硬件→进入编程模式→烧录"的流程(见下文 Core Flow)全部依赖开发板使用手册提供的硬件操作细节。

硬件开发工作流

以下流程图展示了从资料查阅到固件烧录的完整硬件开发路径,资料库中的每一类文档都在对应环节被消费:

flowchart TD
    Start([硬件开发启动]) --> SEL{"应用场景?"}
    SEL -->|"体脂秤"| DS1["查阅 AC822B/AC823B 规格书"]
    SEL -->|"血压计"| DS2["查阅 AC822B/AC825A 规格书"]
    SEL -->|"血氧仪"| DS3["查阅 AC826B 规格书"]
    DS1 --> MIN["搭建最小系统<br/>参考最小系统原理图"]
    DS2 --> MIN
    DS3 --> MIN
    MIN --> APP["补齐应用外围<br/>参考应用原理图"]
    APP --> BRD["开发板验证<br/>AC82N 开发板使用手册"]
    BRD --> COMP["编译固件 make all"]
    COMP --> FLASH{"烧录成功?"}
    FLASH -->|"否"| DBG["对照 Develop 指南检查<br/>引脚/电源/烧录口"]
    DBG --> COMP
    FLASH -->|"是"| RUN["运行与调试<br/>cpu/demo 示例验证外设"]
    RUN --> End([产品化])

Core Flow:硬件联调与烧录流程

以开发板为核心,硬件资料与 SDK 工具链的配合流程如下。此流程对应 README「八、烧录与升级」一节,开发板使用手册提供其中硬件操作的具体细节:

sequenceDiagram
    participant DEV as 开发者
    participant DOC as 硬件资料库
    participant BRD as 开发板
    participant PC as PC 工具链

    DEV->>DOC: 查阅规格书/最小系统/应用原理图
    DOC-->>DEV: 引脚定义与电路参考
    DEV->>PC: 编译固件 (make all)
    PC-->>DEV: 生成固件文件
    DEV->>BRD: USB/UART 连接开发板
    DEV->>BRD: 按住烧录按键并复位/上电<br/>进入编程模式
    DEV->>PC: 启动 isd_download.exe 升级工具
    PC->>BRD: 选择固件并下载
    BRD-->>DEV: 烧录完成,运行固件
    DEV->>PC: 使用 cpu/demo 示例验证外设

关键步骤说明:

  1. 连接硬件:将开发板通过 USB 或 UART 连接到 PC(接口位置见开发板使用手册);
  2. 进入编程模式:按住开发板上的烧录按键,然后复位或重新上电——这是 USB 升级工具能够识别目标板的必要条件;
  3. 打开 USB 升级工具:启动 isd_download.exe;
  4. 选择固件:选择 make all 编译生成的固件文件;
  5. 开始烧录:点击下载按钮等待完成;烧录前需确保升级工具正确连接且目标板已进入编程模式。

Usage Examples

以下示例均提取自仓库 README,展示硬件资料如何融入实际开发操作。

克隆仓库并定位 SDK 工程

git clone https://gitee.com/Jieli-Tech/AC82N.git
cd AC82N/sdk

Source: README.md

SDK 含统一的 GP MCU 应用工程,入口为 sdk/apps/gp_mcu/,外设示例位于 sdk/cpu/demo/(含 hadc_demo.c、uart_demo.c、spi_demo.c 等),这些示例的运行前提是硬件电路与参考原理图一致。

验证编译工具链环境

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

Source: README.md

工具链安装到 /opt/jieli 后,需确保 /opt/jieli/pi32/bin/clang 存在(Linux 场景),这是硬件联调前必须先完成的软件环境准备。

编译固件

# 进入 SDK 根目录执行编译(cd09 平台)
make all -j`nproc`

Source: README.md

编译产物即烧录工具所需的固件文件;若链接阶段报 Too many open files,需先执行 ulimit -n 8096。

首次烧录操作序列

  1. 连接硬件:将开发板通过 USB 或 UART 连接到 PC
  2. 进入编程模式:按住开发板上的烧录按键,然后复位或重新上电
  3. 打开 USB 升级工具:启动 isd_download.exe
  4. 选择固件:选择编译生成的固件文件
  5. 开始烧录:点击下载按钮,等待烧录完成

Source: README.md

Configuration Options

硬件资料对应 SDK 中的板级配置(README「九、配置说明」),硬件设计阶段确定的引脚分配将在此映射为软件配置:

配置项说明硬件依据
引脚映射UART / SPI / IIC / GPIO 等外设的引脚分配芯片规格书引脚定义 + 参考原理图
外设使能开启或关闭特定外设模块最小系统与应用原理图的外设用量
时钟配置CPU 频率、外设时钟源规格书时钟树与电气参数
功能裁剪通过配置文件裁剪 SDK 功能、减小固件体积产品功能需求(如是否启用 APA 播报)

设计意图:硬件资料与软件配置是同一张"引脚复用表"的两面——规格书定义硬件侧的复用能力,板级配置定义软件侧的占用,二者必须严格一致,否则会出现外设无法工作或引脚冲突等问题。

Failure Modes & Edge Cases

硬件资料使用过程中常见的失败模式及对策(依据 README「常见问题」与「烧录与升级」章节整理):

失败模式现象根因与对策
烧录失败升级工具无法识别目标板未正确进入编程模式——需按住开发板烧录按键后复位/重新上电;对照开发板使用手册确认烧录口与按键位置
外设不工作示例程序运行但外设无响应引脚映射与规格书不一致;核对板级配置与参考原理图的引脚分配
芯片型号混淆固件在目标板上运行异常cd09 平台下四款芯片共享 SDK,但封装/引脚不同,必须按型号选择对应的最小系统与应用原理图
版本不配套编译链接报 cannot find -lxxxSDK 需配合对应命名规则的库文件(lib.a),检查 cpu/cd09/liba/ 目录及发布版本信息文档
模拟前端精度不足体脂秤/血压计测量值漂移未严格复刻参考原理图中的 HADC 前端与电源去耦;应基于应用参考原理图修改而非从零设计

边界情况:

  • 文件名包含非断行空格(如 AC822B Datasheet V1.3.pdf 中 Datasheet 前为 \u00A0),在文件系统中与普通空格等价,但 URL 链接中均以 %20 编码,避免复制路径出错;
  • 血氧仪参考原理图未标注版本号,以其在目录中的时间戳/内容为准,设计时建议向杰理 FAE 确认最新版本;
  • 开发板资料(AC82N开发板使用手册20230919)以日期命名,2023-09-19 之后的 SDK 版本若涉及开发板改版,以发布版本信息文档中的说明为准。

并发/一致性说明:硬件资料为静态 PDF,不存在并发访问问题;但资料与固件代码在仓库中共同演进,升级 SDK 时必须同步核对配套硬件资料版本,避免使用旧版原理图配合新版固件导致引脚/时序不匹配。

Performance & Operational Notes

  • 测量性能基准:HADC 有效精度最高 19bit(24 位 ADC),SARADC 采样率 1Msps——这些指标在规格书中给出,实际产品性能取决于参考原理图的模拟前端与 PCB 布局(电源去耦、走线屏蔽);
  • 低功耗设计:超低功耗处理器与低功耗 RTC(闹钟唤醒)是电池供电产品的关键指标,规格书中的功耗数据是低功耗方案选型的依据;
  • 烧录操作:烧录前务必确认目标板已进入编程模式,USB 升级工具(isd_download.exe)与生产烧写工具使用不同的烧录路径——量产裸片烧写需向代理商获取生产烧写工具;
  • OTA 升级:支持自定义双备份固件升级(详见升级模块文档),硬件需预留 OTA 所需存储与升级触发通路;
  • 文档获取:除仓库内 PDF 外,杰理文档中心(doc.zh-jieli.com/AC82)提供按模块组织的在线文档,与仓库资料互为补充。

Extension Points

硬件资料的扩展路径与 SDK 的软硬件扩展能力对应:

  • 新增产品形态:基于最接近的参考原理图修改外围(如四极改八极体脂秤、增加显示/按键),再对照规格书核对新增引脚的复用冲突;
  • 新增外设驱动:参考 cpu/demo/ 中的示例代码(hadc_demo.c、uart_demo.c、spi_demo.c 等),按现有驱动框架添加新驱动文件——驱动所操作的寄存器地址与外设行为需以规格书为准;
  • 创建新工程:基于 apps/gp_mcu/ 与 cpu/demo/ 示例修改,配置对应的引脚和外设(README 常见问题第 10.1 节);
  • 硬件资料补充:若自行设计并验证了新的应用电路(如耳温枪、传感器采集节点),可参照仓库内原理图的命名规范(芯片型号+应用名+版本号)提交回仓库,形成社区共享。

Related Links

  • README.md(仓库总览与开发流程)
  • README-en.md(英文版总览)
  • doc/原理图&硬件资料/(硬件资料目录)
  • doc/软件工具/(字库工具等软件工具,兄弟页面主题)
  • 杰理文档中心(AC82 在线文档)
  • SDK 版本历史
  • USB 升级工具使用文档
  • 开发板/烧录工具购买(杰理官方店铺)
Prev
音频文件转换工具