快速入门

本文档引导用户完成 Ameba Rust SDK 的环境搭建,并通过 Hello World 示例完成第一次编译、烧录与日志验证。

准备工作

硬件:

  • Ameba 开发板(RTL8721F EVB)

  • USB Type-C 数据线

  • 开发主机:Linux (Ubuntu 22.04+)、Windows 10/11 或 macOS (13 Ventura+,仅限 Apple Silicon / M 系列芯片),磁盘空间 ≥ 10 GB

软件:

  • Git 2.0+

  • VS Code 或其他代码编辑器

  • USB 转串口驱动(若开发主机未自动识别)

硬件连接

用 USB Type-C 数据线连接开发板与开发主机,既用于烧录固件,也用于串口日志。

../_images/sdk_quick_start_diagram.png

开发板详细用户指南:EVB User Guide

下载 SDK

完整的开发环境需要 Rust SDK 和 ameba-rtos SDK 两个仓库。

  • Rust SDK 包含固件源码与编译工具;

  • ameba-rtos SDK 提供预编译的 Bootloader 和 WiFi 核固件,以及打包脚本。

SDK 下载

环境搭建

完成 Rust 工具链安装及 ameba-rtos 编译环境配置,包括 rustup、nightly 工具链和 ARM 裸机工具链。

开发环境搭建

编译工程

环境搭建完成后,在 Rust SDK 根目录执行以下命令编译 Hello World 示例:

$ cargo xtask build-amebagreen2 --sdk <workdir>/ameba-rtos

编译成功后,烧录文件生成于 build/amebagreen2/app.bin

Hello World 示例

下载固件

使用 ImageTool 将 build/amebagreen2/app.bin 烧录到开发板。

Image Tool

日志监控

烧录完成后,用串口工具连接开发板,波特率设置为 1500000,复位后可查看运行日志。

Hello World 预期输出:

main:enter
main:time_driver_ok
Hello World
Hello World
...

Log 工具