Rust嵌入式开发实战：M5StickC Wi-Fi空调遥控器完整指南

用Rust在M5StickC上打造Wi-Fi空调遥控器：从零到一的物联网开发实战

你是否曾经遇到过这样的场景：炎热的夏天回到家，想要提前打开空调，却发现遥控器不知所踪？或者躺在床上准备睡觉时，才发现空调遥控器在房间的另一头？传统的红外遥控器虽然简单易用，但受限于视线距离和物理位置，确实存在不少使用痛点。

今天我们要介绍的项目，正是用Rust语言在M5StickC开发板上实现的一个Wi-Fi空调遥控器。这个项目不仅解决了传统遥控器的局限性，更展示了Rust在嵌入式领域的强大潜力。通过本文，你将学会如何将一个简单的想法转化为可落地的物联网项目，同时深入理解Rust在资源受限环境下的开发技巧。

1. 项目核心价值与技术选型考量

1.1 为什么选择这个技术栈？

这个项目最吸引人的地方在于其技术栈的选择：M5StickC + Rust + Wi-Fi + IR。这看似简单的组合背后，其实蕴含着深刻的技术考量。

M5StickC的优势：

• 小巧便携：尺寸仅比U盘稍大，便于安装在任意位置
• 集成度高：自带Wi-Fi、蓝牙、显示屏、按键和电池，开箱即用
• 成本低廉：相比传统物联网网关，价格更具优势

Rust语言的独特价值：

• 内存安全：在资源受限的嵌入式环境中，避免内存泄漏至关重要
• 零成本抽象：高性能的代码生成，不影响运行时效率
• 丰富的嵌入式生态：esp-rs项目为ESP32提供了完整的支持

1.2 实际应用场景分析

这个项目不仅仅是一个技术演示，更有着广泛的实际应用价值：

智能家居集成：通过Wi-Fi连接，可以轻松接入HomeAssistant、OpenHAB等智能家居平台远程控制：突破红外线的距离限制，实现真正的远程空调控制自动化场景：结合温度传感器，实现根据环境温度自动调节的智能空调系统

2. 硬件准备与环境搭建

2.1 所需硬件清单

在开始编码之前，我们需要准备以下硬件设备：

• M5StickC开发板（ESP32主控） × 1
• 红外发射模块 × 1（如VS1838B）
• 杜邦线若干
• USB Type-C数据线 × 1

硬件连接示意图：

M5StickC GPIO26 → 红外发射模块信号引脚 M5StickC 3.3V → 红外发射模块VCC M5StickC GND → 红外发射模块GND

2.2 Rust开发环境配置

Rust在嵌入式开发中的环境配置相对复杂，但遵循正确的步骤可以避免很多坑：

# 安装Rustup（Rust工具链管理器） curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # 添加ESP32目标支持 rustup target add riscv32imc-unknown-none-elf # 安装espflash工具用于烧录 cargo install espflash # 安装ldproxy用于链接 cargo install ldproxy

2.3 项目依赖配置

创建新的Rust项目并配置必要的依赖：

# Cargo.toml [package] name = "m5stickc-ac-remote" version = "0.1.0" edition = "2021" [dependencies] esp32c3-hal = { version = "0.5", features = ["rt"] } embedded-hal = "0.2" embedded-svc = "0.22" esp-wifi = "0.3" smoltcp = { version = "0.9", features = ["alloc"] } [build-dependencies] embuild = "0.30"

3. Wi-Fi连接实现

3.1 Wi-Fi配置与管理

在嵌入式设备中实现稳定的Wi-Fi连接是项目成功的关键。以下是核心的Wi-Fi连接代码：

// src/wifi.rs use embedded_svc::wifi::{AuthMethod, ClientConfiguration, Configuration}; use esp_wifi::wifi::WifiController; pub struct WiFiManager { controller: WifiController, } impl WiFiManager { pub fn new(controller: WifiController) -> Self { Self { controller } } pub async fn connect(&mut self, ssid: &str, password: &str) -> Result<(), esp_wifi::error::Error> { let client_config = Configuration::Client(ClientConfiguration { ssid: ssid.try_into().unwrap(), password: password.try_into().unwrap(), auth_method: AuthMethod::WPA2Personal, ..Default::default() }); self.controller.set_configuration(&client_config)?; self.controller.start().await?; self.controller.connect().await?; // 等待连接成功 while !self.controller.is_connected().await? { // 简单的延时等待 embedded_hal::delay::DelayNs::delay_ms(&mut embedded_hal::delay::Delay, 1000); } Ok(()) } }

3.2 网络状态监控

为了确保远程控制的可靠性，我们需要实时监控网络状态：

impl WiFiManager { pub async fn check_connection(&self) -> bool { match self.controller.is_connected().await { Ok(connected) => connected, Err(_) => false, } } pub async fn get_ip_address(&self) -> Option<[u8; 4]> { match self.controller.get_ip_info().await { Ok(info) => Some(info.ip.octets()), Err(_) => None, } } }

4. 红外信号处理核心

4.1 红外协议解析

空调红外协议通常比电视遥控器复杂得多，需要处理可变长度的信号。以下是通用的红外信号处理框架：

// src/infrared.rs use embedded_hal::digital::v2::OutputPin; pub struct InfraredSender<P: OutputPin> { pin: P, } impl<P: OutputPin> InfraredSender<P> { pub fn new(pin: P) -> Self { Self { pin } } // 发送红外信号的通用方法 pub fn send_raw(&mut self, data: &[u32]) -> Result<(), P::Error> { for &pulse in data { if pulse & 0x80000000 != 0 { // 发送载波 self.send_carrier(pulse & 0x7FFFFFFF)?; } else { // 发送静默期 embedded_hal::delay::DelayNs::delay_us(&mut embedded_hal::delay::Delay, pulse); } } Ok(()) } fn send_carrier(&mut self, duration_us: u32) -> Result<(), P::Error> { let half_period = 13; // 38kHz载波的半周期约13us let cycles = duration_us / (half_period * 2); for _ in 0..cycles { self.pin.set_high()?; embedded_hal::delay::DelayNs::delay_us(&mut embedded_hal::delay::Delay, half_period); self.pin.set_low()?; embedded_hal::delay::DelayNs::delay_us(&mut embedded_hal::delay::Delay, half_period); } Ok(()) } }

4.2 空调特定协议实现

不同品牌的空调使用不同的红外协议。以下是一个通用的空调协议实现示例：

impl<P: OutputPin> InfraredSender<P> { pub fn send_ac_command(&mut self, temperature: u8, mode: AcMode, fan_speed: FanSpeed) -> Result<(), P::Error> { let mut frame = [0u8; 8]; // 构建数据帧 frame[0] = 0x23; // 头字节 frame[1] = temperature; frame[2] = mode as u8; frame[3] = fan_speed as u8; // 计算校验和 frame[7] = frame[0..7].iter().fold(0u8, |acc, &x| acc.wrapping_add(x)); // 转换为红外信号 let ir_signal = self.encode_frame(&frame); self.send_raw(&ir_signal) } fn encode_frame(&self, frame: &[u8]) -> Vec<u32> { let mut result = Vec::new(); // 添加引导码 result.push(0x80000000 | 4500); // 4.5ms载波 result.push(4500); // 4.5ms静默 // 编码每个字节 for &byte in frame { for i in 0..8 { let bit = (byte >> (7 - i)) & 1; if bit == 1 { result.push(0x80000000 | 560); // 560us载波 result.push(1690); // 1.69ms静默 } else { result.push(0x80000000 | 560); // 560us载波 result.push(560); // 560us静默 } } } result } } pub enum AcMode { Cool = 0x01, Heat = 0x02, Dry = 0x03, Fan = 0x04, Auto = 0x05, } pub enum FanSpeed { Auto = 0x00, Low = 0x01, Medium = 0x02, High = 0x03, }

5. Web服务器实现

5.1 简单的HTTP服务器

为了实现远程控制，我们需要在设备上运行一个轻量级的Web服务器：

// src/web_server.rs use embedded_svc::http::Method; use embedded_svc::io::Read; use smoltcp::socket::TcpSocket; pub struct WebServer { socket: TcpSocket<'static>, } impl WebServer { pub fn new() -> Self { let socket = TcpSocket::new(...); Self { socket } } pub async fn handle_requests(&mut self) { loop { if let Ok(connection) = self.socket.accept().await { self.handle_connection(connection).await; } } } async fn handle_connection(&mut self, mut connection: TcpSocket<'static>) { let mut buffer = [0u8; 1024]; if let Ok(size) = connection.read(&mut buffer).await { let request = std::str::from_utf8(&buffer[..size]).unwrap_or(""); if request.starts_with("GET /ac/on") { self.send_response(&connection, "AC turned on").await; } else if request.starts_with("GET /ac/off") { self.send_response(&connection, "AC turned off").await; } else if request.starts_with("GET /ac/temp/") { // 解析温度参数 if let Some(temp_str) = request.strip_prefix("GET /ac/temp/") { if let Ok(temp) = temp_str.split_whitespace().next().unwrap_or("").parse::<u8>() { self.send_response(&connection, &format!("Temperature set to {}", temp)).await; } } } } } }

5.2 RESTful API设计

为了提供更好的用户体验，我们设计一套完整的RESTful API：

// API端点设计示例 impl WebServer { async fn handle_api_request(&mut self, path: &str, method: &str, body: Option<&str>) -> String { match (method, path) { ("GET", "/api/ac/status") => { // 返回空调状态 r#"{"power": "on", "temperature": 25, "mode": "cool"}"# } ("POST", "/api/ac/control") => { if let Some(body) = body { // 解析JSON控制命令 // 实现控制逻辑 r#"{"status": "success"}"# } else { r#"{"error": "missing body"}"# } } _ => r#"{"error": "not found"}"#, }.to_string() } }

6. 用户界面与交互设计

6.1 M5StickC显示屏控制

M5StickC自带的0.96英寸显示屏虽然小巧，但足够显示基本的控制界面：

// src/display.rs use embedded_graphics::{ mono_font::{MonoTextStyle, ascii::FONT_6X10}, pixelcolor::Rgb565, prelude::*, text::Text, }; pub struct DisplayManager { display: M5StickCDisplay, } impl DisplayManager { pub fn new(display: M5StickCDisplay) -> Self { Self { display } } pub fn show_ac_status(&mut self, temperature: u8, mode: &str, power: bool) -> Result<(), DisplayError> { self.display.clear(Rgb565::BLACK)?; let style = MonoTextStyle::new(&FONT_6X10, Rgb565::WHITE); // 显示温度 Text::new( &format!("Temp: {}°C", temperature), Point::new(10, 20), style, ).draw(&mut self.display)?; // 显示模式 Text::new( &format!("Mode: {}", mode), Point::new(10, 35), style, ).draw(&mut self.display)?; // 显示电源状态 let power_text = if power { "ON" } else { "OFF" }; Text::new( &format!("Power: {}", power_text), Point::new(10, 50), style, ).draw(&mut self.display)?; Ok(()) } }

6.2 物理按键处理

M5StickC的物理按键提供了本地控制的可能：

// src/buttons.rs use embedded_hal::digital::v2::InputPin; pub struct ButtonHandler<A: InputPin, B: InputPin> { button_a: A, button_b: B, } impl<A: InputPin, B: InputPin> ButtonHandler<A, B> { pub fn new(button_a: A, button_b: B) -> Self { Self { button_a, button_b } } pub fn check_buttons(&mut self) -> ButtonEvent { match (self.button_a.is_low(), self.button_b.is_low()) { (Ok(true), Ok(false)) => ButtonEvent::A pressed, (Ok(false), Ok(true)) => ButtonEvent::B pressed, (Ok(true), Ok(true)) => ButtonEvent::Both pressed, _ => ButtonEvent::None, } } } pub enum ButtonEvent { None, APressed, BPressed, BothPressed, }

7. 系统集成与主程序逻辑

7.1 主程序架构

将各个模块整合成一个完整的系统：

// src/main.rs mod wifi; mod infrared; mod web_server; mod display; mod buttons; use wifi::WiFiManager; use infrared::{InfraredSender, AcMode, FanSpeed}; use web_server::WebServer; use display::DisplayManager; use buttons::{ButtonHandler, ButtonEvent}; #[entry] fn main() -> ! { // 硬件初始化 let peripherals = Peripherals::take().unwrap(); // 初始化各个模块 let mut wifi_manager = WiFiManager::new(...); let mut ir_sender = InfraredSender::new(...); let mut display = DisplayManager::new(...); let mut buttons = ButtonHandler::new(...); let mut web_server = WebServer::new(); // 连接Wi-Fi wifi_manager.connect("YourSSID", "YourPassword").await.unwrap(); // 显示连接状态 display.show_wifi_status(true).unwrap(); loop { // 处理按钮事件 match buttons.check_buttons() { ButtonEvent::APressed => { ir_sender.send_ac_command(25, AcMode::Cool, FanSpeed::Auto).unwrap(); } ButtonEvent::BPressed => { // 关机命令 ir_sender.send_raw(&[0x80000000 | 4500, 4500, ...]).unwrap(); } _ => {} } // 处理网络请求 web_server.handle_requests().await; // 短暂延时，避免过度占用CPU embedded_hal::delay::DelayNs::delay_ms(&mut embedded_hal::delay::Delay, 100); } }

7.2 电源管理优化

考虑到M5StickC使用电池供电，电源管理至关重要：

impl DisplayManager { pub fn enable_power_save(&mut self) -> Result<(), DisplayError> { // 降低屏幕亮度 self.display.set_brightness(30)?; Ok(()) } pub fn turn_off_display(&mut self) -> Result<(), DisplayError> { self.display.clear(Rgb565::BLACK)?; // 实际项目中可能需要调用特定的关闭显示命令 Ok(()) } }

8. 常见问题与解决方案

8.1 编译与烧录问题

问题1：Rust编译器找不到ESP32目标

error: could not find specification for target `riscv32imc-unknown-none-elf`

解决方案：

rustup target add riscv32imc-unknown-none-elf

问题2：链接错误，缺少标准库

error: cannot find crate `core`

解决方案：确保在.cargo/config.toml中正确配置了目标：

# .cargo/config.toml [build] target = "riscv32imc-unknown-none-elf" [target.riscv32imc-unknown-none-elf] runner = "espflash --monitor"

8.2 红外信号问题

问题：空调不响应红外信号

排查步骤：

1. 检查红外发射管方向是否正确
2. 验证载波频率是否为38kHz
3. 使用手机摄像头检查红外发射管是否工作
4. 确认空调协议格式正确

调试技巧：

// 添加调试输出，验证信号发送 println!("Sending IR signal: {:?}", ir_signal);

8.3 Wi-Fi连接稳定性

问题：设备频繁断开Wi-Fi连接

解决方案：

1. 实现自动重连机制
2. 添加信号强度监控
3. 优化电源管理，避免因电量不足导致断开

impl WiFiManager { pub async fn ensure_connection(&mut self) -> bool { if !self.check_connection().await { log::warn!("Wi-Fi disconnected, attempting to reconnect"); self.connect(self.ssid, self.password).await.is_ok() } else { true } } }

9. 项目扩展与优化建议

9.1 功能扩展方向

温度自动化：添加温湿度传感器，实现基于环境温度的自动控制

pub struct TemperatureAutomation { target_temp: u8, hysteresis: u8, // 迟滞范围，避免频繁开关 } impl TemperatureAutomation { pub fn should_turn_on_ac(&self, current_temp: u8) -> bool { current_temp > self.target_temp + self.hysteresis } pub fn should_turn_off_ac(&self, current_temp: u8) -> bool { current_temp < self.target_temp - self.hysteresis } }

多设备支持：扩展支持多个空调设备或不同类型的红外设备语音控制集成：通过MQTT接入语音助手平台

9.2 性能优化建议

内存优化：在资源受限的环境中，合理管理内存使用

// 使用静态分配避免动态内存分配 static mut IR_BUFFER: [u32; 256] = [0; 256]; pub fn encode_to_static_buffer(frame: &[u8]) -> &'static [u32] { unsafe { // 编码到静态缓冲区 &IR_BUFFER[..encoded_length] } }

功耗优化：深度睡眠模式与唤醒机制

pub fn enter_deep_sleep(duration: u64) -> ! { // 配置唤醒定时器 esp32c3_hal::clock::sleep(duration); // 进入深度睡眠 loop {} }

这个项目展示了如何用Rust在资源受限的嵌入式设备上构建实用的物联网应用。通过结合Wi-Fi通信、红外信号处理和Web服务，我们实现了一个功能完整的智能空调遥控器。更重要的是，这个项目为理解Rust在嵌入式领域的应用提供了绝佳的实践案例。

在实际部署时，建议先从简单的功能开始，逐步添加复杂特性。同时，良好的错误处理和日志记录机制对于物联网设备的远程维护至关重要。希望这个项目能为你打开嵌入式Rust开发的大门，期待看到更多基于这个思路的创新应用。