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 开发的目标 |