SDK 简介

Ameba Rust SDK 是 Realtek 官方针对 Ameba 系列芯片的 Rust 嵌入式固件开发套件。SDK 以 Embassy 异步运行时为基础,采用 no_std 设计,面向对内存效率和类型安全有较高要求的 IoT 应用场景。

支持的芯片[ RTL8721F ]

SDK 定位

Ameba Rust SDK 遵循 Rust 嵌入式生态的标准接口与惯例,因此基于该 SDK 编写的驱动和应用能够自然地 与更广泛的 Rust 嵌入式生态互通。在这些标准接口之下,驱动通过 svd2rust 生成的 PAC 和 FFI 调用 芯片 ROM 中固化的 C 函数访问硬件。

在使用 ROM FFI 的地方,这一设计的优势是与 Realtek 硬件生态深度集成、零额外 Flash 占用,代价是 存在少量 unsafe 代码。

整个开发流程只需要 Rust 工具链:链接使用 rust-lld,固件打包与串口烧录由 SDK 自带的 ameba-flash 工具完成。 应用运行所依赖的预编译 Bootloader 和 Wi-Fi 核固件随 Rust SDK 一同提供。

主要特性

  • Embassy 异步运行时:协作式调度,无 RTOS 线程切换开销,适合事件驱动型应用

  • embedded-hal 1.0 兼容:GPIO、I2C、SPI、UART、Timer 等外设均实现标准 trait,可复用社区驱动

  • 零开销 ROM FFI:对调用芯片 ROM 固化 C 函数的底层操作,链接时直接解析为固定地址跳转,无额外开销

  • Wi-Fi 支持:WHC IPC 双核通信,支持 STA 连接(Open / WPA2-PSK)、SoftAP,并提供 embassy-net 驱动,应用可自行创建 TCP/UDP socket(DHCP、TCP、UDP 及其上层协议,如 MQTT)

  • OTA:基于 HTTP 的双分区(A/B)应用固件升级,分区选择和签名校验由 Bootloader 完成

  • 纯 Rust 工具链:仅使用 stable Rust,打包与串口烧录由 SDK 自带的 ameba-flash 工具完成

  • 严格 no_std:无堆分配器,内存占用可预期,适合 SRAM 受限场景

固件组成

Ameba 芯片的完整固件由三部分组成,Rust SDK 仅开放 App 固件的开发:

固件

来源

说明

Bootloader 固件

预编译,随 Rust SDK 提供

不对用户开放开发

Wi-Fi 核固件

预编译,随 Rust SDK 提供

不对用户开放开发

App 固件

Rust SDK 编译产出

Rust 开发的目标