Ameba Rust 解决方案

Ameba Rust 解决方案
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 所有权模型带来的编译期内存安全。

特性

双核 Wi-Fi SoC 架构

Rust 应用运行在应用核上,底层 Wi-Fi 协议处理与无线通信由网络核上的 Realtek 预编译固件完成,不占用应用核资源,两核经 IPC 通信。开发者不必移植 Wi-Fi 协议即可获得完整的无线连接能力。

完整的 Rust 应用软件栈

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 中完成。

标准 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 异步运行时

基于 Embassy 的协作式异步调度,Wi-Fi 事件、网络通信、传感器采集等逻辑可以各自写成独立的异步任务,不需要 RTOS 线程和各自的任务栈,节省内存开销,并发逻辑也更直观。对时序要求简单的场景,驱动同样提供阻塞模式。

Rust 原生工具链

ameba-generate 一步生成应用项目(可选芯片、Embassy、Wi-Fi 等选项),cargo xtask 与 ameba-flash 完成编译、打包、烧录和串口日志监控。整个开发流程统一在 cargo 中,便于本地开发与 CI 集成。

编译期安全保障

Rust 的所有权模型与借用检查器在编译期消除悬垂指针、数据竞争等内存问题。SDK 将这种保障延伸到硬件访问:PAC 由芯片 SVD 生成强类型寄存器访问器,GPIO 模式、Timer 模式以及 I2C/SPI/UART 的阻塞/异步模式都编码在类型中,误用在编译期即被拦截,减少上板调试时间。

架构

Ameba Rust SDK 软件架构

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 可以在对应层级直接接入。

开发资源

图标资源名称链接
快速入门 查看
Rust 开发指南 查看
GitHub 源代码(ameba-rust) 查看
联系我们 查看


推荐 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