快速入门

概述

Ameba 开发平台提供开箱即用的开发体验,配套完整的 SDK、丰富的示例代码和完善的开发生态,助力开发者高效实现产品原型与量产落地。

本节介绍如何搭建 Ameba 硬件开发的软件环境,内容涵盖 SDK 获取、开发环境配置、工程编译、固件烧录以及串口日志监控等完整开发流程,帮助开发者快速走通从环境准备到固件运行的各个环节。

准备工作

硬件要求

  • 开发主机:Windows 10/11 或 Linux (Ubuntu 22.04+)

  • 磁盘空间:至少 5 GB

  • Ameba 开发板:目标硬件平台,用于应用程序开发、固件下载和功能验证

  • USB 数据线:Type-C 接口,用于连接开发主机与开发板

软件要求

  • Git:版本 2.0 或更高,用于 SDK 克隆和版本管理

  • SDK:Ameba FreeRTOS 软件开发工具包,提供外设驱动、库文件、编译脚本和开发辅助工具等

  • 文本编辑器:如 VS Code 等代码编辑器

  • USB 驱动:USB 转串口驱动(如需要)

硬件指南

下图展示了 Ameba 开发板与开发主机的连接方式。在开发主机上完成代码的编写和编译后,通过 USB Type-C 数据线将编译生成的固件下载到 Ameba 开发板,并可通过串口监控程序运行状态。

../../_images/sdk_quick_start_diagram.png

硬件连接示意图

有关 Ameba SoC 开发板(EVB)的使用方法,请观看官方教学视频: Ameba SoC EVB 用法

具体型号开发板的详细用户指南请访问: EVB User Guide

环境搭建

请根据所使用的芯片型号,参考对应的环境配置指南完成工具链安装等配置工作。

下载 SDK

在开始之前,请确保已安装 Git 版本管理工具,用于后续 SDK 的获取与版本管理。

编译工程

下载 SDK 后,可参考 开发流程 开始您的应用开发。

下载固件

根据您的开发方式,Ameba 提供了不同的固件烧录解决方案。

如果您使用命令行工具进行开发,可根据烧录需求选择:

  • 单设备烧录:使用 Flash 烧写工具 为单台设备烧录固件,适用于开发调试阶段、单设备固件升级等场景。

  • 批量烧录:使用 Flash 批量烧写工具 同时为多台设备烧录,适用于生产环境批量烧录、固件批量升级等场景。

日志监控

根据您的开发方式,Ameba 提供了不同的串口调试方案。

使用 Log 工具 实现串口通信和日志查看。