SDK 快速启动
概述
Ameba 开发平台提供开箱即用的开发体验,配套完整 SDK、丰富示例代码和完善的开发生态,助力开发者高效实现产品原型与量产落地。
本节介绍如何搭建 Ameba 硬件开发的软件环境,内容涵盖 SDK 获取、开发环境配置、工程编译、固件烧录以及串口日志监控等完整开发流程,帮助开发者快速完成从环境准备到固件运行。
准备工作
硬件要求
在开始开发之前,请准备以下硬件设备:
PC 主机:支持 Windows 或 Linux 操作系统
Ameba 系列开发板:目标硬件平台,用于应用程序开发、固件烧录和功能验证
USB 数据线:Type-C 接口,用于连接 PC 与开发板
软件要求
SDK:Ameba FreeRTOS 软件开发工具包,提供外设驱动、库文件、编译脚本和开发辅助工具等
Toolchain:交叉编译工具链,用于代码编译
文本编辑器:如 VS Code 等代码编辑器
驱动程序:USB 转串口驱动(如需要)
SDK 快速启动流程图
硬件指南
有关 Ameba SoC 开发板(EVB)的使用方法,请观看官方教学视频: Ameba SoC EVB 用法
具体型号开发板的详细用户指南请访问: EVB User Guide
环境搭建
根据所使用的芯片型号,参考对应的环境配置指南完成工具链安装等工作。
芯片集成了独立的 Cadence HiFi5 DSP 核心,专为高效处理音频算法、语音识别、AI 推理等计算密集型任务而设计。
SDK 开发环境搭建(必选) :无论是否涉及 DSP 开发,MCU 开发环境始终为必选项。MCU 固件负责系统初始化、DSP 固件加载至内存、硬件资源管理,并最终生成可烧录的完整固件。
DSP 开发环境搭建(可选) :用于开发运行在 DSP 核心上的信号处理算法固件,基于 Cadence Xtensa Xplorer IDE 进行编译和调试。
备注
需要搭建:需要开发或修改 DSP 算法固件。
无需搭建:仅使用 MCU 功能,或使用预编译的 DSP 固件库。
芯片集成了独立的 Cadence HiFi5 DSP 核心,专为高效处理音频算法、语音识别、AI 推理等计算密集型任务而设计。
SDK 开发环境搭建(必选) :无论是否涉及 DSP 开发,MCU 开发环境始终为必选项。MCU 固件负责系统初始化、DSP 固件加载至内存、硬件资源管理,并最终生成可烧录的完整固件。
DSP 开发环境搭建(可选) :用于开发运行在 DSP 核心上的信号处理算法固件,基于 Cadence Xtensa Xplorer IDE 进行编译和调试。
备注
需要搭建:需要开发或修改 DSP 算法固件。
无需搭建:仅使用 MCU 功能,或使用预编译的 DSP 固件库。
芯片采用 CA32 + KM4 + KM0 三核异构架构,支持两种开发模式:
模式一:FreeRTOS 开发 — 三核心均运行 FreeRTOS 系统
模式二:Linux 开发 — CA32 运行 Linux,KM4/KM0 运行 FreeRTOS
根据您选择的开发模式,请参考相应的环境搭建指南:
FreeRTOS 开发: 搭建 FreeRTOS SDK 开发环境
Linux 开发: 搭建 Linux SDK 开发环境
获取 SDK
在开始之前,请确保已安装 Git 版本管理工具,用于后续 SDK 的获取与版本管理。
本芯片支持两种平台开发,请根据您的开发场景下载其中一种 SDK 即可。
FreeRTOS 开发: 下载 FreeRTOS SDK
Linux 开发: 下载 Linux SDK
编译工程
下载 SDK 后,可参考 创建外部工程 开始您的应用开发。
下载固件
根据您的开发方式,Ameba 提供了不同的固件烧录解决方案。
方式一: CLI 开发
如果您使用命令行工具进行开发,可根据烧录需求选择:
单设备烧录
使用 Flash 烧写工具 为单台设备烧录固件,适用开发调试阶段,单设备固件升级等场景。
批量烧录
使用 Flash 批量烧写工具 同时为多台设备烧录,适用生产环境批量烧录、固件批量升级等场景。
方式二: VS Code 开发
使用 VS Code 固件下载功能 在 IDE 内一键完成烧录。
日志监控
根据您的开发方式,Ameba 提供了不同的串口调试方案。
方式一: CLI 开发
使用 Log 工具 实现串口通信和日志查看。
方式二: VS Code 开发
使用 VS Code 串口监控 在 IDE 内完成串口调试与日志查看。