fw-AD24N_GP-MCU_SDK

杰理 AD24N 系列通用 MCU SDK 固件程序

一、概述

fw-AD24N_GP-MCU_SDK 是杰理科技为 AD24N 系列芯片提供的通用 MCU SDK 开发包。本系列芯片主要面向以下应用场景：

应用类型	典型产品
语音玩具	故事机、学习机、语音遥控玩具、MIDI 乐器、声控灯
小音箱	音乐播放器、扩音器
通用 MCU	智能控制、传感器采集、通用外设应用

核心特性

双发射 DSP：32bit 双发射 DSP @ 240MHz
音频解码：支持 .a/.b/.e、.f1a/.f1b/.f1c、UMP3 等多种格式解码播放
MIDI 播放：支持 MIDI 合成与播放
三路解码：支持 .a/.b/.e + .f1a/.f1b/.f1c + .f1a/.f1b/.f1c 三路音频同时解码播放
变速变调：支持音频变速变调播放（需系统时钟 100MHz 以上）
硬件重采样：内置硬件 SRC
内置音频编解码：16bit DAC + 16bit ADC，支持 8K–96K 采样率
Class-D 功放：直驱喇叭
音效算法：ANS 降噪、变速、ECHO 混响、vo_pitch 变调、voice_changer 变声、PCM EQ
低功耗：关机功耗低至 2µA+，休眠 19µA+
多种存储：支持内置/外置 FLASH
I2S 接口：部分型号支持数字音频输入输出

本仓库包含 SDK Release 版本代码及示例工程，需配合对应命名规则的库文件 (lib.a) 进行编译。

二、支持的芯片与平台

2.1 SoC 系列

芯片系列	应用领域
AD242A	语音玩具 / 音频播放（SOP16）
AD245A	语音玩具 / 通用 MCU（QSOP24，支持 I2S）
AD246A	语音玩具 / 通用 MCU（QFN32，GPIO 最多，支持 I2S）
AD248A	语音玩具 / 声控灯（SOP8，无 DAC，最小封装）
AD248B	语音玩具 / 声控灯（SOP8，无 Class-D）

芯片型号/规格书/原理图资料请查阅：doc/ 目录

2.2 MCU 软硬件参数差异

三、环境搭建

3.1 前提条件

系统	说明
Windows	推荐使用 Code::Blocks IDE 编译
Linux	Makefile 命令行编译（需要重写 download_bat.c 脚本适配 Linux 环境）
macOS	需自行配置交叉编译工具链

3.2 安装编译工具链

下载并安装 杰理编译工具链：下载链接
Linux 用户可从此处下载：pkgman.jieliapp.com
- 下载后解压到 /opt/jieli 目录
- 确保 /opt/jieli/pi32/bin/clang 存在
安装完成后验证：

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

3.3 安装烧录工具

工具	用途	获取方式
USB 升级工具	将固件烧录到目标板	申请链接 · 使用文档
生产烧写工具	量产/裸片烧写	代理商处 · 使用文档

3.4 音频工具

打包、音频文件转换、MIDI 等通用音频工具：下载链接提取码：3jey

四、快速开始

4.1 克隆仓库

git clone https://github.com/Jieli-Tech/AD24N.git
cd AD24N/sdk

4.2 工程入口

SDK 包含以下应用工程，位于 sdk/ 根目录：

工程文件	芯片	应用类型
`AD24N_voice_toy.cbp`	AD24N 全系列	语音玩具
`AD24N_voice_enhanced.cbp`	AD24N 全系列	扩音器

4.3 应用代码入口

sdk/app/src/
├── voice_toy/          # 语音玩具应用
├── voice_func/         # 语音功能模块
└── voice_enhanced/     # 扩音器应用

4.4 编译并烧录

方式一：Code::Blocks（推荐 Windows 用户）

双击打开对应的 .cbp 工程文件
点击 Build → Build（Ctrl+F9）
编译成功后，使用 USB 升级工具烧录生成的固件

方式二：Makefile 命令行

# Windows 用户
双击 sdk/make_prompt.bat 打开命令行环境

# 编译语音玩具
make ad24n_voice_toy -j4

# 编译语音增强
make ad24n_voice_enhanced -j4

💡 提示：编译前请确保 USB 升级工具正确连接且目标板已进入编程模式。

方式三：VS Code 编译

仓库已预配置 VS Code 任务，按 Ctrl+Shift+B 即可选择编译目标。

五、工程结构

fw-AD24N/
├── sdk/                           # SDK 主目录
│   ├── app/                       # 应用层代码
│   │   ├── src/                   #   应用入口源码
│   │   │   ├── voice_toy/         #     语音玩具应用
│   │   │   ├── voice_func/        #     语音功能模块
│   │   │   └── voice_enhanced/    #     扩音器应用
│   │   ├── bsp/                   #   板级支持包（BSP）
│   │   └── post_build/            #   编译后处理脚本与工具
│   ├── include_lib/               # 头文件与预编译库
│   │   ├── cpu/                   #   CPU 平台头文件
│   │   ├── decoder/               #   解码器 API 头文件
│   │   ├── encoder/               #   编码器 API 头文件
│   │   ├── audio/                 #   音频 API 头文件
│   │   ├── device/                #   设备驱动头文件
│   │   ├── dev_mg/                #   设备管理头文件
│   │   ├── common/                #   公共头文件
│   │   ├── fs/                    #   文件系统头文件
│   │   ├── msg/                   #   消息机制
│   │   ├── ans/                   #   ANS 降噪
│   │   ├── vo_changer/            #   变声算法
│   │   ├── vo_pitch/              #   变调算法
│   │   ├── update/                #   固件升级
│   │   └── liba/                  #   预编译库 (.a)
│   ├── tools/                     # 编译工具与脚本
│   │   ├── make_prompt.bat        #   Windows 编译命令行入口
│   │   └── utils/                 #   工具集（make、rm 等）
│   ├── Makefile                   # 顶层 Makefile
│   └── *.cbp                      # Code::Blocks 工程文件
├── doc/                           # 文档
│   ├── ad24n硬件文档/              #   硬件文档（规格书/原理图/开发板资料）
│   ├── stuff/                     #   杂项（钉钉群、烧录工具文档等）
│   ├── AD24N_SDK手册_v1.3.pdf     #   SDK 手册
│   ├── AD24N_SDK_发布版本信息.pdf  #   SDK 发布版本信息
│   ├── AD24N用户手册V1.2.pdf       #   芯片用户手册
│   └── 杰理科技32位AD系列语音MCU选型表.pdf  # 芯片选型表
└── README.md                      # 本文件

六、应用与示例

6.1 语音玩具应用 (`app/src/voice_toy/`)

功能	说明
音乐播放	本地/外置 FLASH 文件播放
MIDI 演奏	MIDI 合成与播放
录音	音频编码录音
LINEIN	线路输入
扩音	扩音/喊话
USB Device	USB 从设备

6.2 扩音器应用 (`app/src/voice_enhanced/`)

功能	说明
增强音效	高级音效处理与增强方案
多模式切换	支持多种工作模式灵活切换

适用领域：语音玩具、故事机、学习机、MIDI 乐器、声控灯等。

七、编译指南

7.1 编译命令速查表

以下命令在 sdk/ 目录下执行：

目标	命令
语音玩具	`make ad24n_voice_toy -j4`
语音增强	`make ad24n_voice_enhanced -j4`
编译全部	`make all`
清理全部	`make clean`

7.2 Code::Blocks 编译（推荐 Windows 用户）

确保已安装杰理编译工具链
双击对应的 .cbp 工程文件打开 Code::Blocks
点击 Build → Build（Ctrl+F9）
编译成功后在 post_build/ 目录下生成固件

7.3 Makefile 编译

# Windows 用户
双击 sdk/make_prompt.bat 打开命令行环境
make ad24n_voice_toy -j4

# Linux 用户（需要自行修改download_bat.c文件适配Linux）
cd sdk
make ad24n_voice_toy -j`nproc`

7.4 常见编译错误

错误提示	解决方法
`clang: command not found`	未安装杰理编译工具链，或环境变量未配置
`cannot find -lxxx`	缺少对应的 `.a` 库文件，检查 `include_lib/liba/` 目录
`make: command not found`	Windows 下使用 `tools/make_prompt.bat` 打开编译命令环境
链接错误	检查 Makefile target 是否匹配当前芯片型号

八、烧录与升级

8.1 首次烧录

连接硬件：将开发板通过 USB 或者 USB 升级工具 连接到 PC
进入编程模式：
- 方式一（USB）：按住开发板上的烧录按键，然后复位或重新上电
- 方式二（USB/UART）：通过 USB 升级工具进入编程模式
打开 USB 升级工具：启动烧录上位机
选择固件：选择编译生成的固件文件
开始烧录：点击下载按钮，等待烧录完成

注意：烧录前请确保 USB 升级工具正确连接且目标板已进入编程模式。关于 ISD_CONFIG.INI 配置详见 ISD 配置说明。

8.2 生产烧写

量产场景请使用杰理生产烧写工具（一拖二 / 一拖八），支持裸片烧写。详见一拖二烧写器使用说明 · 一拖八烧写器使用说明

8.3 OTA 升级

支持双备份固件升级（dual_bank）。

九、配置说明

编辑 sdk/app/src/<应用>/app_config.h 可配置目标应用的功能开关
通过 Makefile target 选择不同的应用类型和芯片型号

十、常见问题

10.1 开发流程相关

Q: 如何创建一个新的工程？ A: 基于现有的 .cbp 工程和 app/src/ 中的应用代码进行修改，配置对应用例即可。

Q: 如何切换不同的芯片型号？ A: 在配置中选择对应的芯片型号，SDK 已为全系列预配置了统一的编译入口。

10.2 编译相关

Q: Windows 下编译报错 make 不是有效命令？ A: 使用 sdk/make_prompt.bat 进入预配置的命令行环境，该脚本已设置好所有环境变量和 make 的路径。

Q: 如何加快编译速度？ A: 使用 -j 参数进行并行编译，如 make -j4（数字为并行任务数）。

10.3 调试技巧

串口日志：可通过 UART 输出调试日志
GPIO Debug：利用空闲 GPIO 输出调试波形，测量时序

十一、社区与支持

技术交流

平台	群号/链接	状态
钉钉技术交流群	见群二维码	✅ 可加入

资源链接

资源	链接
📖 在线文档中心	doc.zh-jieli.com/AD24
📚 SDK 版本历史	SDK 发布版本信息
🔧 SDK 快速入门	SDK 手册
📖 芯片用户手册	AD24N 用户手册
📄 芯片选型	选型表
🎬 视频教程	Bilibili 主页
🎵 MIDI 开发手册	MIDI 应用开发文档
📦 FAE 支持	FAE 支持仓库
🛒 开发板/烧录工具购买	杰理官方店铺
🐛 问题反馈	Github Issues

十二、免责声明

fw-AD24N_GP-MCU_SDK 支持 AD24N 系列芯片开发。本系列芯片支持通用 MCU 常见应用，可作为开发、评估、样品及量产使用，对应 SDK 版本请见 SDK 版本历史。

Name		Name	Last commit message	Last commit date
doc		doc
sdk		sdk
AD24N_SDK_发布版本信息.pdf		AD24N_SDK_发布版本信息.pdf
LICENSE		LICENSE
README-en.md		README-en.md
README.md		README.md
jl_ad_chip.png		jl_ad_chip.png

Latest commit

History

Folders and files

Repository files navigation