# fw-AC82N_GP-MCU_SDK **Repository Path**: Jieli-Tech/AC82N ## Basic Information - **Project Name**: fw-AC82N_GP-MCU_SDK - **Description**: AC82N系列 SoC 芯片支持以下特性 · 工作电压：2.1V~5.5V · 主频最高可达160MHz 的32bit CPU，片上集成40K字节SRAM，16K字节ICache - **Primary Language**: C - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 8 - **Forks**: 5 - **Created**: 2023-08-08 - **Last Updated**: 2026-08-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # fw-AC82N_GP-MCU_SDK

**杰理 AC82N 系列通用 MCU SDK 固件程序** [English](./README-en.md) · [文档中心](https://doc.zh-jieli.com/AC82/zh-cn/master/index.html) · [SDK 版本历史](https://doc.zh-jieli.com/AC82/zh-cn/master/other/version/index.html) · [报告问题](https://gitee.com/Jieli-Tech/AC82N/issues)

--- ## 目录 - [一、概述](#一概述) - [二、支持的芯片与平台](#二支持的芯片与平台) - [三、环境搭建](#三环境搭建) - [四、快速开始](#四快速开始) - [五、工程结构](#五工程结构) - [六、应用与示例](#六应用与示例) - [七、编译指南](#七编译指南) - [八、烧录与升级](#八烧录与升级) - [九、配置说明](#九配置说明) - [十、常见问题](#十常见问题) - [十一、社区与支持](#十一社区与支持) - [十二、免责声明](#十二免责声明) --- ## 一、概述 `fw-AC82N_GP-MCU_SDK` 是杰理科技为 AC82N 系列芯片提供的通用 MCU SDK 开发包。AC82N 系列定位为**无蓝牙功能**的通用 MCU SoC，主要面向以下应用场景： | 应用类型 | 典型产品 | |---------|---------| | **高精度测量** | 体脂秤、传感器采集、精密仪器仪表、血压计、耳温枪 | | **低功耗产品** | 电池供电设备、便携式仪器、RTC 闹钟唤醒应用 | ### 核心特性 - **24位高精度 HADC**：有效精度最高可达 19bit - **高速 SARADC**：采样率可达 1Msps - **超低功耗处理器**：适用于电池供电场景 - **低功耗 RTC**：支持闹钟和唤醒功能 - **丰富的片上外设**：HADC、SARADC、IIC、SPI、MCPWM、UART、USB、触摸按键等 - **支持 APA 播报** 本仓库包含 SDK Release 版本代码及示例工程，需配合对应命名规则的库文件 (`lib.a`) 进行编译。 --- ## 二、支持的芯片与平台 ### 2.1 SoC 系列 | 芯片平台 | 芯片型号 | 应用领域 | |---------|---------|---------| | **cd09** | AC822B / AC823B / AC825A / AC826B | 高精度测量 / 智能控制 / 低功耗产品 | > 芯片型号/规格书/原理图资料请查阅：[doc/原理图&硬件资料](https://gitee.com/Jieli-Tech/AC82N/tree/master/doc/%E5%8E%9F%E7%90%86%E5%9B%BE&%E7%A1%AC%E4%BB%B6%E8%B5%84%E6%96%99) --- ## 三、环境搭建 ### 3.1 前提条件 | 系统 | 说明 | |------|------| | **Windows** | ✅ 推荐使用 Code::Blocks IDE 编译 | | **Linux** | ✅ 支持 Makefile 命令行编译 | | **macOS** | ⚠️ 需自行配置交叉编译工具链 | ### 3.2 安装编译工具链 1. 下载并安装 **杰理编译工具链**：[下载链接](https://doc.zh-jieli.com/Tools/zh-cn/dev_tools/dev_env/index.html) 2. Linux 用户可从此处下载：[pkgman.jieliapp.com](http://pkgman.jieliapp.com/doc/all) - 下载后解压到 `/opt/jieli` 目录 - 确保 `/opt/jieli/pi32/bin/clang` 存在 3. 安装完成后验证： ```bash # 验证工具链是否安装成功 clang --version ``` ### 3.3 安装烧录工具 | 工具 | 用途 | 获取方式 | |------|------|---------| | **USB 升级工具** | 将固件烧录到目标板 | [申请链接](https://item.taobao.com/item.htm?id=620295020803) · [使用文档](https://doc.zh-jieli.com/Tools/zh-cn/dev_tools/forced_upgrade/index.html) | | **生产烧写工具** | 量产/裸片烧写 | **代理商处** · [使用文档](https://doc.zh-jieli.com/Tools/zh-cn/mass_prod_tools/burner_1tuo2/index.html) | --- ## 四、快速开始 ### 4.1 克隆仓库 ```bash git clone https://gitee.com/Jieli-Tech/AC82N.git cd AC82N/sdk ``` ### 4.2 工程入口 AC82N SDK 包含一个统一的 GP MCU 应用工程，入口位于： ``` sdk/ ├── apps/gp_mcu/ # GP MCU 主应用入口 ├── cpu/demo/ # 外设示例代码 │ ├── hadc_demo.c # 高精度 ADC 示例 │ ├── gpadc_demo.c # 通用 ADC 示例 │ ├── uart_demo.c # UART 示例 │ ├── spi_demo.c # SPI 示例 │ ├── iic_demo.c # IIC 示例 │ ├── mcpwm_demo.c # MCPWM 示例 │ ├── rtc_demo.c # RTC 示例 │ ├── gptimer_demo.c # 通用定时器示例 │ └── ... └── AC82N_gp_mcu.cbp # Code::Blocks 工程文件 ``` ### 4.3 编译并烧录 **方式一：Code::Blocks（推荐 Windows 用户）** 1. 双击打开 `AC82N_gp_mcu.cbp` 工程文件 2. 点击 **Build → Build**（Ctrl+F9） 3. 编译成功后，使用 USB 升级工具烧录生成的固件文件 **方式二：Makefile 命令行** ```bash # Windows 用户双击 tools/make_prompt.bat 打开命令行环境 # Linux/macOS 用户 cd sdk 根目录 make all -j`nproc` ``` > **提示**：编译完成后会生成 `cpu/cd09/tools/sdk.elf`，烧录脚本会自动调用。 **方式三：VS Code 编译** 仓库已预配置 VS Code 任务，按 `Ctrl+Shift+B` 即可选择 `all` / `clean` 编译目标。 --- ## 五、工程结构 ``` fw-AC82N_GP-MCU_SDK/ ├── apps/ # 应用层代码 │ ├── common/ # 公共模块（跨工程共享） │ │ ├── at_char/ # AT 指令处理 │ │ ├── battery/ # 电池电量检测 │ │ ├── cJSON/ # JSON 解析库 │ │ ├── debug/ # 调试工具 │ │ ├── decode/ # 解码模块 │ │ ├── device/ # 外设驱动（按键、USB device/host） │ │ ├── eeprom/ # EEPROM 读写 │ │ ├── font/ # 字库 │ │ ├── lcd/ # LCD 驱动 │ │ ├── sin_generator/ # 正弦波发生器 │ │ ├── ui/ # UI 控件 │ │ ├── ui_platform/ # UI 平台层 │ │ └── update/ # 固件升级 │ └── gp_mcu/ # 📌 GP MCU 主应用入口 │ └── include/ # 应用头文件 ├── cpu/ # CPU 相关代码与库文件 │ ├── cd09/ # cd09 芯片平台 │ │ ├── hadc/ # 高精度 ADC 驱动 │ │ ├── liba/ # 预编译库文件 (.a) │ │ ├── power/ # 电源管理 │ │ ├── segment_code_lcd/ # 段码 LCD 驱动 │ │ └── tools/ # 链接脚本 / 下载脚本 │ ├── components/ # 通用组件（红外编解码等） │ ├── demo/ # 外设示例代码 │ ├── gpio.c # GPIO 驱动 │ ├── iic_api.c # IIC 硬件接口 │ └── iic_soft.c # 软件模拟 IIC ├── include_lib/ # 头文件 │ ├── driver/ # 驱动头文件（cpu / device） │ ├── system/ # 系统头文件（device / fs / generic） │ ├── ui_platform/ # UI 平台头文件 │ └── update/ # 升级模块头文件 ├── tools/ # 编译工具与脚本 │ ├── make_prompt.bat # Windows 编译命令行入口 │ └── utils/ # 工具集（make、rm 等） ├── UBOOT工程/ # UBOOT 工程（独立编译） ├── UI工程/ # UI 工程（独立编译） ├── Makefile # 顶层 Makefile（统一编译入口） ├── AC82N_gp_mcu.cbp # Code::Blocks 工程文件 └── .vscode/ # VS Code 配置（tasks.json） ``` ### 5.1 关键目录说明 | 目录 | 作用 | |------|------| | `apps/gp_mcu/` | **GP MCU 主应用入口**：应用主函数、配置入口 | | `cpu/demo/` | **外设示例**：可直接参考的 HADC/UART/SPI/IIC/MCPWM/RTC 等示例代码 | | `cpu/*/liba/` | **预编译库**：`*.a` 静态库文件 | | `cpu/*/tools/` | **烧录/链接工具**：下载脚本、链接脚本 | | `apps/common/` | **公共模块**：AT 指令、电池检测、USB、UI 等模块 | --- ## 六、应用与示例 ### 6.1 GP MCU 应用 (`apps/gp_mcu/`) | 项目 | 说明 | |------|------| | **适用场景** | 高精度测量、智能控制、低功耗设备 | | **关键外设** | 24位 HADC、1Msps SARADC、IIC、SPI、MCPWM、UART、USB、触摸按键、RTC | | **参考文档** | [AC82 开发文档](https://doc.zh-jieli.com/AC82/zh-cn/master/index.html) | ### 6.2 外设示例 (`cpu/demo/`) SDK 提供了丰富的外设驱动示例代码： | 示例文件 | 外设/功能 | |---------|---------| | `hadc_demo.c` | 24位高精度 ADC | | `gpadc_demo.c` | 通用 SARADC | | `uart_demo.c` | UART 通信 | | `spi_demo.c` | SPI 通信 | | `iic_demo.c` | IIC 通信 | | `mcpwm_demo.c` | MCPWM | | `rtc_demo.c` | 低功耗 RTC 闹钟/唤醒 | | `gptimer_demo.c` | 通用定时器 | | `segment_code_lcd_demo.c` | 段码 LCD 显示 | | `sin_generator_demo.c` | 正弦波发生器 | | `norflash_demo.c` | NorFlash 读写 | | `voice_demo.c` | APA 音频播报 | --- ## 七、编译指南 ### 7.1 编译命令速查表以下命令在 SDK 根目录下执行： | 目标 | 芯片 | 说明 | 命令 | |------|------|------|------| | **全部** | cd09 | 编译并下载 | `make all` | | **清理** | cd09 | 清理编译产物 | `make clean` | | **详细编译** | cd09 | 显示详细编译过程 | `make all VERBOSE=1` | ### 7.2 Linux 编译注意事项 ```bash # 确保文件描述符限制足够大（链接阶段需要打开大量文件） ulimit -n 8096 # 进入 SDK 根目录执行编译 make all -j`nproc` ``` ### 7.3 常见编译错误 | 错误提示 | 解决方法 | |---------|---------| | `clang: command not found` | 未安装杰理编译工具链，或环境变量未配置 | | `Too many open files` | Linux 下执行 `ulimit -n 8096` 增加文件描述符限制 | | `cannot find -lxxx` | 缺少对应的 `.a` 库文件，检查 `cpu/cd09/liba/` 目录 | | `make: command not found` | Windows 下使用 `tools/make_prompt.bat` 打开编译命令环境 | --- ## 八、烧录与升级 ### 8.1 首次烧录 1. **连接硬件**：将开发板通过 USB 或 UART 连接到 PC 2. **进入编程模式**：按住开发板上的烧录按键，然后复位或重新上电 3. **打开 USB 升级工具**：启动 `isd_download.exe` 4. **选择固件**：选择编译生成的固件文件 5. **开始烧录**：点击下载按钮，等待烧录完成 > **注意**：烧录前请确保 USB 升级工具正确连接且目标板已进入编程模式。 ### 8.2 OTA 升级支持自定义双备份固件升级，详见：[升级模块文档](https://doc.zh-jieli.com/AC82/zh-cn/master/module_example/system/update/index.html) --- ## 九、配置说明 ### 9.1 板级配置 - **引脚映射**：UART / SPI / IIC / GPIO 等外设的引脚分配 - **外设使能**：开启或关闭特定外设模块 - **时钟配置**：CPU 频率、外设时钟源 ### 9.2 功能裁剪通过配置文件可以灵活裁剪 SDK 功能，减小固件体积，调整各模块的功能开关和内存配置。 --- ## 十、常见问题 ### 10.1 开发流程相关 **Q: 如何创建一个新的工程？** A: 基于现有的 `apps/gp_mcu/` 和 `cpu/demo/` 示例进行修改，配置对应的引脚和外设即可。 **Q: 如何添加新的外设驱动？** A: 参考 `cpu/demo/` 中的示例代码，按照现有驱动框架添加新的驱动文件。 ### 10.2 编译相关 **Q: Windows 下编译报错 `make` 不是有效命令？** A: 使用 `tools/make_prompt.bat` 进入预配置的命令行环境，该脚本已设置好所有环境变量和 `make` 的路径。 **Q: 如何加快编译速度？** A: 使用 `-j` 参数进行并行编译，如 `make all -j4`。 ### 10.3 调试技巧 - **串口日志**：可通过 UART 输出调试日志 - **GPIO Debug**：利用空闲 GPIO 输出调试波形，测量时序 --- ## 十一、社区与支持 ### 技术交流 | 平台 | 群号/链接 | 状态 | |------|-----------|------| | **钉钉技术交流群** | `42090002468` | ✅ 可加入 | ### 资源链接 | 资源 | 链接 | |------|------| | 📖 **在线文档中心** | [doc.zh-jieli.com/AC82](https://doc.zh-jieli.com/AC82/zh-cn/master/index.html) | | 📚 **SDK 版本历史** | [版本发布记录](https://doc.zh-jieli.com/AC82/zh-cn/master/other/version/index.html) | | 📄 **芯片规格书/原理图** | [SoC 数据手册扼要](https://gitee.com/Jieli-Tech/AC82N/tree/master/doc/%E5%8E%9F%E7%90%86%E5%9B%BE&%E7%A1%AC%E4%BB%B6%E8%B5%84%E6%96%99) | | 🛒 **开发板/烧录工具购买** | [杰理官方店铺](https://shop321455197.taobao.com/) | | 🐛 **问题反馈** | [Gitee Issues](https://gitee.com/Jieli-Tech/AC82N/issues) | --- ## 十二、免责声明 `fw-AC82N_GP-MCU_SDK` 支持 AC82N 系列芯片开发。AC82N 系列芯片支持通用 MCU 常见应用，可作为开发、评估、样品及量产使用，对应 SDK 版本请见 [branch](https://gitee.com/Jieli-Tech/AC82N)。 ---