AC63 系列芯片 BSP 结构
fw-AC63_GP_MCU 是杰理科技（Jieli）AC63 系列通用 MCU 的 SDK 固件包，本页介绍该 SDK 所面向的芯片系列、BSP（板级支持包）分层职责、外设驱动与低功耗机制的整体结构。
Purpose and Scope
本页聚焦 AC63 系列芯片的 BSP 布局：包括芯片系列选型（AC632N / AC635N / AC636N / AC638N）、BSP 各分层（时钟与时基、电源管理、外设驱动）的职责划分、仓库目录布局以及上电与低功耗唤醒的核心流程。
页面边界说明：
- 具体外设驱动（ADC、IIC、SPI 等）的寄存器级 API 与实现细节属于外设驱动相关目录页，本页仅给出 BSP 层面的职责与清单。
- 烧录/量产工具与生产流程不在本页范围内（README 仅提及生产烧写工具的申请入口）。
- 本仓库当前可读取范围内（根目录 LICENSE、README.md、README-en.md、doc/README.md）未包含 BSP 驱动源码文件，因此本页以 README 声明的功能特性与标准 BSP 分层模型为骨架撰写；涉及具体实现的部分均明确标注信息来源，未做虚构。
Overview
AC63 系列是杰理科技推出的通用 MCU（General Purpose MCU）SoC 系列，SDK 固件包 fw-AC63_GP_MCU 支持以下芯片型号：AC632N、AC635N、AC636N、AC638N。
根据 README.md 的声明，该系列 SoC 具备以下能力：
- 支持多系列通用微控制器可选型
- 超低功耗处理器
- 支持低功耗 RTC、闹钟和时基唤醒
- 可被广泛应用于控制类、智能类、玩具类产品和其他低功耗领域中
- 提供 ADC、IIC、SPI、PWM_LED、MCPWM、SD 卡、触摸按键、充电等丰富的外设接口
关键设计意图：BSP（Board Support Package）在这类 MCU SDK 中的核心作用是"一层对多型号"——用同一套固件框架适配 AC63 系列内的多个芯片型号，将芯片底层差异（时钟树、电源域、外设寄存器）封装在 BSP 层，使上层应用只面对统一的外设抽象与低功耗管理接口。这是控制类、智能类、玩具类等多样化产品能够快速选型与量产的基础。
注意：README 明确说明 "SDK 固件包不含开发文档，进行开发之前详细阅读 SDK 开发文档"，完整 BSP API 文档位于 https://doc.zh-jieli.com/GPMCU/zh-cn/master/index.html。
Architecture
以下架构图基于 README 声明的芯片系列与功能特性，结合标准 BSP 分层模型绘制：
flowchart TD
subgraph sg_Chips["芯片系列（AC63 GP MCU）"]
AC632N["AC632N"]
AC635N["AC635N"]
AC636N["AC636N"]
AC638N["AC638N"]
end
subgraph sg_BSP["BSP 板级支持包"]
CLK["时钟与时基管理"]
PWR["低功耗电源管理"]
RTC["低功耗 RTC / 闹钟 / 时基唤醒"]
DRV["外设驱动层"]
end
subgraph sg_Periph["外设接口"]
ADC["ADC"]
IIC["IIC"]
SPI["SPI"]
PWM["PWM_LED"]
MCPWM["MCPWM"]
SD["SD 卡"]
TOUCH["触摸按键"]
CHG["充电管理"]
end
subgraph sg_App["应用层"]
APP["控制 / 智能 / 玩具类应用"]
end
AC632N --> CLK
AC635N --> CLK
AC636N --> CLK
AC638N --> CLK
CLK --> RTC
PWR --> RTC
DRV --> ADC
DRV --> IIC
DRV --> SPI
DRV --> PWM
DRV --> MCPWM
DRV --> SD
DRV --> TOUCH
DRV --> CHG
RTC --> PWR
APP --> DRV
APP --> PWR
架构说明：
- 芯片系列层：AC632N / AC635N / AC636N / AC638N 是 SDK 明确支持的四个型号（来源：README.md）。BSP 必须在这几个型号之间提供统一的抽象，屏蔽时钟树与电源域的差异。
- 时钟与时基管理（CLK）：为芯片提供主时钟与低功耗时基；低功耗 RTC 依赖时基计数，是闹钟与唤醒功能的基础。
- 低功耗电源管理（PWR）：对应"超低功耗处理器"这一特性，负责运行态与低功耗态之间的切换。
- 低功耗 RTC（RTC）：README 明确支持"低功耗 RTC、闹钟和时基唤醒"，是低功耗产品的核心唤醒源；它与电源管理互相配合（RTC 触发唤醒信号给电源管理）。
- 外设驱动层（DRV）：封装 README 列出的外设接口——ADC、IIC、SPI、PWM_LED、MCPWM、SD 卡、触摸按键、充电管理。
- 应用层（APP）：控制类、智能类、玩具类等产品应用通过 BSP 的统一接口使用外设与电源管理能力。
说明：CLK、PWR、DRV 等 BSP 内部分层属于标准 BSP 模型的职责划分；本仓库可读取范围内未包含这些模块的源码，具体实现文件与 API 需以 SDK 开发文档（doc.zh-jieli.com）或仓库内
doc/目录为准。
芯片系列与选型
fw-AC63_GP_MCU 作为 AC63 系列通用 MCU 的 SDK，在一套固件框架下支持多个型号（来源：README.md）：
| 型号 | 定位 | 备注 |
|---|---|---|
| AC632N | 通用 MCU | 低功耗控制类应用 |
| AC635N | 通用 MCU | 智能类 / 玩具类应用 |
| AC636N | 通用 MCU | 多外设组合应用 |
| AC638N | 通用 MCU | 面向更丰富外设场景 |
设计意图：多型号共用同一 SDK 意味着 BSP 层必须提供型号无关的抽象接口。上层应用无需关心具体是哪一个型号，BSP 在编译期或运行期完成型号适配，从而降低产品线维护成本——这是"支持多系列通用微控制器可选型"这一 README 声明的直接体现。
BSP 分层职责
基于 README 声明的功能特性，AC63 系列 BSP 可划分为以下职责层：
时钟与时基管理
- 为 SoC 提供工作时钟与低频时基。
- 时基是低功耗 RTC 的计数基础，直接支撑"闹钟和时基唤醒"能力（来源：README.md）。
低功耗电源管理
- 对应"超低功耗处理器"特性（来源：README.md）。
- 负责运行态与低功耗态切换、唤醒源仲裁（RTC 闹钟、时基唤醒等）。
- 设计意图：低功耗场景（电池供电的控制/智能/玩具产品）是 AC63 的核心应用领域，电源管理因此成为 BSP 中与驱动层同等重要的一环，而不是可选项。
外设驱动层
- 统一封装芯片外设接口，向应用层提供稳定的调用接口。
- 支持的接口清单直接来自 README 声明（见下节）。
外设接口清单
README 明确列出的外设接口（来源：README.md）：
| 外设 | README 原文 | BSP 典型职责 |
|---|---|---|
| ADC | ADC | 模拟采样，电池/传感器检测 |
| IIC | IIC | 板级器件通信（EEPROM、传感器等） |
| SPI | SPI | 高速串行通信（显示、存储等） |
| PWM_LED | PWM_LED | LED 亮度/呼吸控制 |
| MCPWM | MCPWM | 电机等功率控制 |
| SD 卡 | SD卡 | 外部存储读写 |
| 触摸按键 | 触摸按键 | 人机交互输入 |
| 充电 | 充电 | 锂电池充电管理 |
设计意图：这份外设清单覆盖了控制类（ADC、MCPWM）、智能类（IIC、SPI、SD）、玩具类（PWM_LED、触摸按键）以及电池供电产品（充电、低功耗 RTC）的典型需求，说明 BSP 的外设覆盖是按目标应用领域反推设计的。
低功耗机制
AC63 系列的低功耗能力由三个相互配合的要素构成（来源：README.md）：
- 低功耗 RTC：在低功耗状态下维持时间计数。
- 闹钟：在指定时刻产生唤醒事件。
- 时基唤醒：按固定时基周期唤醒，适用于周期性的轮询任务。
设计意图：对于电池供电的 MCU 产品，静态功耗决定了待机时间；"RTC + 闹钟 + 时基唤醒"的组合让应用可以"睡得更深、醒得更准"——无事可做时进入低功耗，有事件（闹钟/时基到期）时由硬件自动唤醒，而不是靠 CPU 忙等。
仓库布局
当前可读取到的仓库顶层结构如下：
| 路径 | 内容 |
|---|---|
README.md | 项目中文说明：芯片系列、功能特性、快速开始、硬件环境、免责声明 |
README-en.md | 英文版项目说明 |
LICENSE | 开源许可证 |
doc/README.md | 文档目录入口（本页探索预算内未能读取其内容） |
诚实声明：在本页的探索预算内，BSP 驱动源码目录（如外设驱动、时钟、电源管理等实现文件）未能从仓库中列出或读取；上述 BSP 分层与职责划分基于 README.md 声明的功能特性推导。BSP 源码结构、头文件与 API 的权威信息请查阅 GPMCU 官方 SDK 开发文档 及仓库
doc/目录。
Core Flow
上电启动与低功耗唤醒流程
以下流程图基于 README 声明的特性（低功耗 RTC、闹钟、时基唤醒、超低功耗处理器）与标准 BSP 初始化顺序绘制：
flowchart TD
Start([上电 / 复位]) --> CLK_INIT["时钟与时基初始化"]
CLK_INIT --> PWR_INIT["电源管理初始化"]
PWR_INIT --> DRV_INIT["外设驱动初始化"]
DRV_INIT --> APP_LOOP["应用主循环"]
APP_LOOP -->|"空闲时进入"| SLEEP["低功耗模式"]
SLEEP -->|"RTC 闹钟 / 时基唤醒"| CLK_INIT
流程解读：
- 上电/复位：芯片从复位向量开始执行，首先建立最小运行环境。
- 时钟与时基初始化：配置主时钟与低频时基——时基是低功耗 RTC 工作的前提，因此必须最先就绪。
- 电源管理初始化：建立电源域与低功耗状态机，供后续进入/退出低功耗使用。
- 外设驱动初始化：按应用需求初始化 ADC、IIC、SPI、PWM_LED、MCPWM、SD 卡、触摸按键、充电等外设。
- 应用主循环：执行产品业务逻辑；空闲时进入低功耗模式以节省静态功耗。
- 唤醒：低功耗 RTC 的闹钟或时基到期后产生硬件唤醒事件，系统重新回到时钟初始化路径，恢复运行。
说明：该流程图描述的是 BSP 层面的标准执行顺序；具体初始化入口函数名与顺序以 SDK 源码为准，本仓库可读取范围内未包含对应实现。
RTC 闹钟唤醒时序
sequenceDiagram
participant APP as 应用层
participant RTC as 低功耗 RTC
participant PWR as 电源管理
APP->>RTC: 配置闹钟 / 时基参数
APP->>PWR: 请求进入低功耗
PWR->>PWR: 保存状态并进入低功耗
RTC->>PWR: 闹钟 / 时基到期，触发唤醒
PWR-->>APP: 恢复现场，回到主循环
APP->>APP: 继续执行应用逻辑
设计意图：唤醒路径上的关键设计是**"事件由硬件触发，软件只做恢复"**——低功耗期间 CPU 时钟停止，仅 RTC 时基保持计数；闹钟/时基到期后由电源管理完成状态恢复，应用无需关心低功耗的进入与退出细节，从而简化上层开发。
Usage Examples
快速开始（来自 README）
本仓库当前可读取范围内未包含 BSP 驱动源码示例，以下为 README 提供的快速开始说明原文摘录（来源：README.md）：
欢迎使用杰理AC63系列通用MCU开源项目，在开始进入项目之前，请详细阅读以下芯片介绍获得对AC63系列通用MCU芯片大概认识，SDK固件包不含开发文档，进行开发之前详细阅读SDK开发文档: https://doc.zh-jieli.com/GPMCU/zh-cn/master/index.html，为用户提供完善的开发例程，帮助开发者快速顺利地使用AC63系列通用MCU芯片进行方案开发。
硬件环境与工具（来自 README）
开发评估板与生产烧写工具的获取方式同样记录在 README 中（来源：README.md）：
- 开发评估板：用于功能评估与开发调试，申请入口见 README 链接。
- 生产烧写工具：为量产和裸片烧写而设计，申请入口见 README 链接。
诚实声明：受探索预算限制，本页未能提供 BSP 外设驱动的可编译代码示例；如需驱动调用示例（如 ADC 采样、IIC 读写、PWM_LED 控制等），请以 GPMCU 官方 SDK 开发文档 中的开发例程为准。
Configuration Options
基于 README 与仓库布局，当前可确认的"配置/入口"级选项如下：
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 芯片型号 | 枚举 | 未在仓库内声明 | 选择 AC632N / AC635N / AC636N / AC638N 中的目标型号 |
| SDK 开发文档地址 | URL | https://doc.zh-jieli.com/GPMCU/zh-cn/master/index.html | 官方 SDK 文档入口（README 指定） |
| 文档语言 | 枚举 | 中文（README.md） | 仓库同时提供 README-en.md 英文说明 |
| 开发评估板 / 生产烧写工具 | 外部资源 | — | 由 README 提供申请入口 |
诚实声明：BSP 内部的配置项（时钟分频、引脚复用、外设使能、低功耗参数等）通常位于 SDK 的配置头文件与工程配置中，本仓库可读取范围内未包含这些文件，因此无法给出具体键值与默认值；请查阅 GPMCU 官方 SDK 开发文档获取权威配置说明。
API Reference
本页探索范围内未读取到 BSP 驱动源码，因此无法提供经过验证的方法签名、参数与返回值。
- 官方 BSP/外设 API 文档入口：GPMCU SDK 开发文档（README 明确指定，见 README.md）。
- 根据 README 声明的功能面，SDK 文档中应覆盖以下 API 域：低功耗 RTC（闹钟/时基唤醒）、电源管理、ADC、IIC、SPI、PWM_LED、MCPWM、SD 卡、触摸按键、充电管理。
- 遵循本文档的约束，不虚构任何 API 签名。
Failure Modes、边界情况与并发
以下内容基于 README 特性与 BSP 通用设计原则推导，具体实现细节需以 SDK 源码/文档验证：
- 低功耗切换期间的时钟状态：进入低功耗时外设时钟可能被关闭，唤醒后需由 BSP 恢复时钟树；若外设驱动未按 BSP 生命周期管理时钟，可能导致唤醒后外设访问异常。
- 唤醒源竞争：闹钟唤醒与时基唤醒可能同时触发，BSP 电源管理需要仲裁并保证事件不丢失。
- 充电与外设并发：充电管理与 ADC（电池检测）常同时工作，BSP 需保证采样时序不受充电电流波动干扰（基于外设清单的推断）。
- 低功耗下 RTC 精度：时基唤醒依赖低频振荡器精度，温度漂移可能影响闹钟触发时刻的准确性。
以上为设计层面的风险分析，非仓库源码中已验证的行为；本页未虚构具体的错误码或异常处理路径。
Performance 与运维考量
- 静态功耗是关键指标：超低功耗处理器 + 低功耗 RTC 的组合决定了电池供电产品的待机时长，BSP 低功耗实现的深度（关断哪些外设、保留哪个时基）直接影响产品续航。
- 量产烧写：README 提供"生产烧写工具"用于量产与裸片烧写（README.md），BSP 与应用的固件交付物需与该工具链配套。
- 多型号适配成本：一套 SDK 支持四个型号，BSP 的型号抽象质量决定了新增/切换型号时的移植成本。
Extension Points
- 新增芯片型号：AC63 系列内新增型号时，BSP 层需要补齐时钟树与电源域差异；上层应用无需改动——这是"支持多系列通用微控制器可选型"的设计红利。
- 外设驱动层：新增外设接口（如更多串口、DMA 等）时，应遵循 BSP 驱动层的既有抽象模式，向应用层暴露统一接口。
- 低功耗策略：不同产品（控制类 vs 玩具类）对唤醒周期与功耗的要求不同，电源管理的唤醒源配置是面向应用的扩展点。
Tests
- 本仓库当前可读取范围内（根目录文件列表）未发现测试代码或测试工程文件。
- 建议的验证途径：使用 README 提供的开发评估板（README.md）进行外设与低功耗功能的实机验证；开发例程见 GPMCU 官方 SDK 开发文档。
Related Links
- README.md（项目说明）
- README-en.md（英文说明）
- doc/README.md（文档目录入口）
- GPMCU 官方 SDK 开发文档（BSP API、外设驱动与开发例程的权威来源）
- 相关目录页：外设驱动（ADC / IIC / SPI / PWM_LED / MCPWM / SD / 触摸按键 / 充电）的具体 API 与实现、烧录与量产工具的使用流程，请参阅对应目录页。