快速入门
本文档引导用户完成 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 数据线连接开发板与开发主机,既用于烧录固件,也用于串口日志。
开发板详细用户指南:EVB User Guide
下载 SDK
完整的开发环境需要 Rust SDK 和 ameba-rtos SDK 两个仓库。
Rust SDK 包含固件源码与编译工具;
ameba-rtos SDK 提供预编译的 Bootloader 和 WiFi 核固件,以及打包脚本。
环境搭建
完成 Rust 工具链安装及 ameba-rtos 编译环境配置,包括 rustup、nightly 工具链和 ARM 裸机工具链。
编译工程
环境搭建完成后,在 Rust SDK 根目录执行以下命令编译 Hello World 示例:
$ cargo xtask build-amebagreen2 --sdk <workdir>/ameba-rtos
编译成功后,烧录文件生成于 build/amebagreen2/app.bin。
下载固件
使用 ImageTool 将 build/amebagreen2/app.bin 烧录到开发板。
日志监控
烧录完成后,用串口工具连接开发板,波特率设置为 1500000,复位后可查看运行日志。
Hello World 预期输出:
main:enter
main:time_driver_ok
Hello World
Hello World
...