Ameba Rust 解决方案
双核芯片搭配 Rust,安全高效开发联网应用
概览
Ameba Rust SDK 是 Realtek 官方为 Ameba 双核 Wi-Fi SoC 推出的 Rust 固件开发套件。Rust 运行在应用核上,网络核运行 Realtek 预编译的 Wi-Fi 固件,两核通过 IPC 通信。在此基础上,SDK 以 Rust crate 的形式提供从外设驱动、Wi-Fi 连接与 TCP/IP 网络到 Flash 存储和 OTA 升级的完整应用侧软件栈,开发者可以全程使用 Rust 完成联网产品的固件开发。
SDK 采用严格的 no_std 设计,遵循 embedded-hal、embedded-io、embedded-storage 等 Rust 嵌入式标准接口,可以直接复用社区驱动与库,同时具备 Rust 所有权模型带来的编译期内存安全。
特性
Rust 应用运行在应用核上,底层 Wi-Fi 协议处理与无线通信由网络核上的 Realtek 预编译固件完成,不占用应用核资源,两核经 IPC 通信。开发者不必移植 Wi-Fi 协议即可获得完整的无线连接能力。
HAL 覆盖 GPIO、UART、SPI、I2C、ADC、DMA、PWM、CAN、以太网、SD Host、RTC、看门狗、TRNG、温度传感器等外设。Wi-Fi 支持 STA 与 SoftAP 模式及 WPA2/WPA3 加密,配合 smoltcp / embassy-net 提供 TCP、UDP 与 DHCP。另有 NOR Flash 存储与 A/B 双分区 OTA 升级(支持 HTTP 下载),从硬件控制到联网升级都能在 Rust 中完成。
GPIO、I2C、SPI、PWM 与延时实现 embedded-hal / embedded-hal-async,UART 实现 embedded-io / embedded-io-async,Flash 存储实现 embedded-storage,Wi-Fi 实现 embassy-net-driver。社区中的传感器、显示屏驱动以及 embassy-net 生态的 HTTP、MQTT 等网络库可以直接接入,减少重复开发。ADC、DMA、CAN、RTC 等其余外设提供 Ameba 专属的 Rust API。
基于 Embassy 的协作式异步调度,Wi-Fi 事件、网络通信、传感器采集等逻辑可以各自写成独立的异步任务,不需要 RTOS 线程和各自的任务栈,节省内存开销,并发逻辑也更直观。对时序要求简单的场景,驱动同样提供阻塞模式。
ameba-generate 一步生成应用项目(可选芯片、Embassy、Wi-Fi 等选项),cargo xtask 与 ameba-flash 完成编译、打包、烧录和串口日志监控。整个开发流程统一在 cargo 中,便于本地开发与 CI 集成。
Rust 的所有权模型与借用检查器在编译期消除悬垂指针、数据竞争等内存问题。SDK 将这种保障延伸到硬件访问:PAC 由芯片 SVD 生成强类型寄存器访问器,GPIO 模式、Timer 模式以及 I2C/SPI/UART 的阻塞/异步模式都编码在类型中,误用在编译期即被拦截,减少上板调试时间。
架构
Rust SDK 开放应用核上的 App 固件供开发,Bootloader 与网络核的 Wi-Fi 固件为 ameba-rtos 预编译产物。
App 固件按 crate 分层:底层是 PAC 与 ROM FFI(ameba-rom-sys),HAL(ameba-hal)同时基于两者提供外设驱动,Wi-Fi(ameba-wifi)、存储(ameba-storage)与 OTA(ameba-ota)位于其上。应用另需链接启动 crate ameba-rt。
各 crate 按需引入,不使用 Wi-Fi 或 OTA 的项目无需链接相关代码,固件体积更可控。需要精细控制时可以绕过 HAL 直接操作 PAC 寄存器。分层方式与 Rust 嵌入式生态的惯例一致,社区 crate 可以在对应层级直接接入。
推荐 IC 型号
| 功能 | 筛选 | RTL8720F | RTL8721F | RTL8721Dx | RTL8720E | RTL8710E | RTL8726E | RTL8713E | RTL8730E | RTL872xD | RTL8735B |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 应用处理器 | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-A | Cortex-M | Cortex-M | |
| DSP | N | N | N | N | N | Y | Y | N | N | N | |
| ISP | N | N | N | N | N | N | N | N | N | Y | |
| Arm TrustZone | Y | Y | Y | Y | N | Y | N | Y | Y | Y | |
| 双频 | N | Y | Y | N | N | N | N | Y | Y | Y | |
| Wi-Fi 6 | Y | Y | N | Y | Y | Y | Y | Y | N | N | |
| R-MESH | Y | Y | Y | N | N | N | N | N | N | N | |
| 超低功耗 | Y | Y | Y | N | N | N | N | N | Y | Y | |
| 以太网 | N | Y | N | N | N | N | N | N | N | N | |
| BT 双模 | N | N | N | N | N | Y | Y | Y | N | N | |
| HMI | N | Y | Y | Y | N | Y | Y | Y | N | N | |
| Audio ADC | N | N | N | N | N | Y | Y | Y | Y | Y | |
| Audio DAC | N | N | N | N | N | Y | Y | Y | Y | Y | |
| SDIO Host | N | Y | N | N | N | N | N | N | N | N | |
| SD/EMMC Host | N | Y | N | N | N | N | N | Y | Y | Y | |
| USB | N | Y | Y | N | N | N | N | Y | Y | Y | |
| BT 独立天线 | N | N | N | N | N | N | N | Y | N | N | |
| CAN | N | Y | N | N | N | N | N | N | N | N |



