立创开源项目实战基于ESP32与Xbox手柄的无线遥控气垫船设计与实现最近在立创开源硬件平台上看到一个挺有意思的项目——用ESP32和Xbox手柄做一个无线遥控气垫船。很多朋友觉得这种项目听起来很复杂既要懂硬件又要懂无线通信其实跟着步骤一步步来你会发现并没有想象中那么难。今天我就把自己做这个项目的经验整理出来手把手带你从零开始把ESP32的GPIO控制、PWM驱动、串口通信还有ESP-NOW无线通信这些知识点都串起来最终实现用游戏手柄遥控气垫船。这个教程特别适合有一定Arduino基础想进阶玩转ESP32的创客朋友。我会尽量把每个步骤都讲清楚包括我踩过的坑和调试技巧让你少走弯路。1. 项目准备与环境搭建做嵌入式项目第一步就是把开发环境搭好。这个项目我们用的是ESP32开发板编程环境推荐PlatformIO。它比Arduino IDE更专业库管理也更方便。1.1 创建PlatformIO工程打开PlatformIO点击New Project新建项目。在项目配置页面你需要填写几个关键信息Name给你的项目起个名字比如ESP32_HovercraftBoard选择你用的ESP32开发板型号常见的有ESP32 Dev ModuleFramework选择Arduino配置好后点击FinishPlatformIO会自动创建项目文件夹和基本的工程结构。注意PlatformIO默认的串口监视器波特率是9600但ESP32程序里我们常用115200。如果不改设置串口打印会显示乱码。解决方法很简单在项目根目录的platformio.ini配置文件里加上一行monitor_speed 1152001.2 第一个测试程序工程创建好后打开src/main.cpp文件PlatformIO已经生成了基本的Arduino框架代码。我们先写个简单的测试程序验证开发环境是否正常。void setup() { // 初始化串口设置波特率为115200 Serial.begin(115200); } void loop() { // 每隔1秒打印一次信息 Serial.println(My First PIO Project!); delay(1000); }点击左下角的编译按钮→图标如果没有错误再点击上传按钮→图标旁边的箭头。上传成功后打开串口监视器应该能看到每秒打印一次My First PIO Project!。如果串口显示乱码记得检查platformio.ini里是否加了monitor_speed 115200这一行。这个坑我刚开始用PlatformIO时就遇到过调了半天才发现是波特率不匹配。2. ESP32基础外设使用环境搭好了咱们先熟悉一下ESP32的几个基础外设操作这些都是后面控制气垫船电机的基础。2.1 GPIO引脚控制ESP32的GPIO通用输入输出引脚用起来和Arduino很像但底层机制更灵活。ESP32内部有个多路复用器可以灵活地把内部信号路由到任意GPIO引脚这让硬件设计时布线方便很多。先看一个简单的例子读取一个引脚的电平然后输出到另一个引脚。void setup() { // 初始化串口 Serial.begin(115200); // 初始化GPIO pinMode(2, OUTPUT); // 引脚2设置为输出模式可以接LED pinMode(4, INPUT); // 引脚4设置为输入模式可以接按钮 } void loop() { // 读取引脚4的电平然后设置到引脚2 digitalWrite(2, digitalRead(4)); }这段代码实现了最简单的电平传递引脚4的电平状态直接反映到引脚2上。实际接线时可以在引脚4接个按钮引脚2接个LED按下按钮LED就亮松开就灭。2.2 中断的使用上面的例子是在loop()里不断轮询引脚状态但实际项目中我们更常用中断来响应外部事件。ESP32支持每个GPIO引脚的外部中断。#include Arduino.h // 中断回调函数声明 void bt_callBack(void); void setup() { Serial.begin(115200); pinMode(2, OUTPUT); pinMode(4, INPUT); // 给引脚4绑定中断触发条件为电平变化 attachInterrupt(4, bt_callBack, CHANGE); } void loop() { // 主循环可以空着或者做其他事情 // 中断会独立处理引脚4的电平变化 } // 中断回调函数 void bt_callBack(void) { // 当中断触发时读取引脚4的电平并设置到引脚2 digitalWrite(2, digitalRead(4)); }这里用attachInterrupt()函数给引脚4绑定了中断触发条件是CHANGE电平变化。当中断触发时会自动调用bt_callBack()函数。中断的好处是不用一直轮询节省CPU资源响应也更及时。2.3 串口通信串口是嵌入式开发中最常用的调试和通信接口。ESP32有3个UART接口UART0、UART1、UART2都支持异步通信最高速度可达5Mbps。重要提示UART1的默认引脚是GPIO9和GPIO10这两个引脚通常用于连接外部Flash。如果你要用UART1一定要把引脚改到其他GPIO上否则会影响程序运行。下面是如何使用UART1在Arduino环境中是Serial1并把引脚改到26和27的例子#include Arduino.h int recData 0; // 用于存储接收到的数据 void setup() { // 初始化主串口UART0用于调试输出 Serial.begin(115200); // 初始化UART1波特率1152008位数据/无校验/1位停止位 // RX引脚改为26TX引脚改为27 Serial1.begin(115200, SERIAL_8N1, 26, 27); pinMode(2, OUTPUT); pinMode(4, INPUT); } void loop() { // 检查串口1是否有数据可读 if (Serial1.available() 0) { // 读取一个字节的数据 recData Serial1.read(); // 把接收到的数据以十六进制格式回传 Serial1.print(received: ); Serial1.println(recData, HEX); } }串口常用的几个函数available()返回接收缓冲区中的数据字节数read()从缓冲区读取一个字节print()/println()发送数据begin()初始化串口参数实际测试时可以用USB转TTL模块如CH340的RX接ESP32的27脚TXTX接26脚RX然后用串口助手发送数据就能看到回传的信息了。3. PWM控制与电机驱动气垫船需要控制电机的转速这就需要用到PWM脉冲宽度调制。ESP32的PWM系统比较特殊它叫LED PWM控制器虽然名字叫LED但其实可以用于各种需要PWM的场景。3.1 ESP32的PWM系统ESP32的PWM有16个通道分为两组8个高速通道8个低速通道这16个通道可以分配给几乎任意GPIO引脚少数只能输入的引脚除外。16个通道对应8个定时器每两个通道共享一个定时器这意味着最多可以输出8个不同频率的PWM信号。3.2 PWM配置三步法使用ESP32的PWM需要三个步骤第一步分配通道到GPIO引脚#define PWM1_Ch 0 // 使用PWM通道0 #define LED_GPIO 32 // PWM输出到32号引脚 ledcAttachPin(LED_GPIO, PWM1_Ch); // 把32号引脚绑定到通道0第二步设置频率和分辨率#define PWM1_Freq 50 // PWM频率设置为50Hz #define PWM1_Res 10 // 分辨率设置为10位 ledcSetup(PWM1_Ch, PWM1_Freq, PWM1_Res);分辨率决定了占空比的精度。10位分辨率意味着占空比范围是0-10232的10次方8位就是0-255。第三步设置占空比int dutyCycle 512; // 50%占空比1024的一半 ledcWrite(PWM1_Ch, dutyCycle);3.3 舵机控制实例气垫船的转向通常用舵机控制。舵机需要50Hz的PWM信号控制脉宽在0.5ms到2.5ms之间。下面是一个让舵机在0-180度之间来回转动的例子#include Arduino.h #define PWM1_Ch 0 // PWM通道0 #define LED_GPIO 32 // 输出引脚 #define PWM1_Res 10 // 10位分辨率 #define PWM1_Freq 50 // 50Hz频率 int PWM1_DutyCycle 0; void setup() { Serial.begin(115200); ledcAttachPin(LED_GPIO, PWM1_Ch); ledcSetup(PWM1_Ch, PWM1_Freq, PWM1_Res); } void loop() { // 从0度转到180度 while (PWM1_DutyCycle 127) { // 127对应2.5ms脉宽 ledcWrite(PWM1_Ch, PWM1_DutyCycle); delay(10); // 缓慢转动 } // 从180度转回0度 while (PWM1_DutyCycle 25) { // 25对应0.5ms脉宽 ledcWrite(PWM1_Ch, PWM1_DutyCycle--); delay(10); } }这里的关键是占空比的计算对于10位分辨率0-10230.5ms脉宽对应250.5/2010242.5ms脉宽对应1272.5/201024。实际调试时可能需要微调这些值因为不同舵机可能有差异。4. ESP-NOW无线通信气垫船需要无线控制这里我们选择ESP-NOW协议。这是乐鑫专门为ESP系列芯片开发的无线通信协议它有几个优点特别适合我们这个项目响应快不需要Wi-Fi连接过程上电就能通信距离远板载天线在空旷地带能达到200米以上低功耗比Wi-Fi更省电简单可靠无连接协议一个设备断电重启后能自动恢复通信4.1 ESP-NOW基础概念ESP-NOW有点像无线鼠标用的2.4GHz通信设备之间需要先配对配对成功后就可以直接通信了。它去掉了传统网络协议的一些复杂层只保留最基本的传输功能所以速度很快单次最多能传输250字节数据。ESP-NOW支持几种通信模式单向通信一个设备发一个或多个设备收双向通信设备之间互相收发数据多跳网络通过中间设备转发扩大通信范围4.2 获取设备MAC地址ESP-NOW通过MAC地址识别设备就像每个设备的身份证号。编程前需要先知道设备的MAC地址。#include WiFi.h void setup() { Serial.begin(115200); // 设置Wi-Fi为STA模式虽然不用连接Wi-Fi但ESP-NOW需要Wi-Fi底层支持 WiFi.mode(WIFI_MODE_STA); // 打印本机的MAC地址 Serial.print(MAC Address: ); Serial.println(WiFi.macAddress()); } void loop() { }运行这个程序在串口监视器里就能看到类似XX:XX:XX:XX:XX:XX的MAC地址记下来后面要用。提示如果编译时提示找不到WiFi.h需要在PlatformIO的库管理中搜索安装WiFi库。4.3 ESP-NOW基本通信流程ESP-NOW编程主要涉及几个关键函数初始化esp_now_init()- 初始化ESP-NOW调用前必须先初始化Wi-Fi添加配对设备esp_now_add_peer()- 添加要通信的设备的MAC地址发送数据esp_now_send()- 向配对设备发送数据注册回调函数esp_now_register_send_cb()- 发送完成后的回调esp_now_register_rcv_cb()- 接收到数据时的回调下面是一个简单的发送端代码框架#include esp_now.h #include WiFi.h // 接收端的MAC地址替换成你实际设备的地址 uint8_t broadcastAddress[] {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; // 发送数据回调函数 void OnDataSent(const uint8_t *mac_addr, esp_now_send_status_t status) { Serial.print(发送状态: ); Serial.println(status ESP_NOW_SEND_SUCCESS ? 成功 : 失败); } void setup() { Serial.begin(115200); // 设置Wi-Fi模式 WiFi.mode(WIFI_STA); // 初始化ESP-NOW if (esp_now_init() ! ESP_OK) { Serial.println(ESP-NOW初始化失败); return; } // 注册发送回调 esp_now_register_send_cb(OnDataSent); // 添加配对设备 esp_now_peer_info_t peerInfo; memcpy(peerInfo.peer_addr, broadcastAddress, 6); peerInfo.channel 0; peerInfo.encrypt false; if (esp_now_add_peer(peerInfo) ! ESP_OK) { Serial.println(添加配对设备失败); return; } } void loop() { // 准备要发送的数据 uint8_t data[] {0x01, 0x02, 0x03}; // 发送数据 esp_err_t result esp_now_send(broadcastAddress, data, sizeof(data)); if (result ESP_OK) { Serial.println(发送成功); } else { Serial.println(发送失败); } delay(1000); }接收端的代码类似主要是注册接收回调函数// 接收数据回调函数 void OnDataRecv(const uint8_t *mac, const uint8_t *incomingData, int len) { Serial.print(收到来自: ); for (int i 0; i 6; i) { Serial.print(mac[i], HEX); if (i 5) Serial.print(:); } Serial.println(); Serial.print(数据长度: ); Serial.println(len); Serial.print(数据内容: ); for (int i 0; i len; i) { Serial.print(incomingData[i], HEX); Serial.print( ); } Serial.println(); }在setup()中注册这个回调esp_now_register_recv_cb(OnDataRecv);5. Xbox手柄与ESP32整合最后一部分是把Xbox手柄的信号通过ESP-NOW发送给气垫船上的ESP32然后控制电机。Xbox手柄可以通过蓝牙连接但ESP32同时支持蓝牙和Wi-Fi我们可以用蓝牙接收手柄数据再用ESP-NOW转发。5.1 手柄数据处理思路Xbox手柄通过蓝牙发送的数据包含各个按键和摇杆的状态。我们需要通过蓝牙接收手柄数据解析出我们关心的控制信号比如左摇杆控制前进后退右摇杆控制转向把这些控制信号通过ESP-NOW发送给气垫船气垫船上的ESP32接收信号转换成PWM控制电机5.2 控制信号映射实际项目中我会这样映射控制信号手柄输入气垫船动作对应PWM通道左摇杆Y轴前进/后退电机1 PWM右摇杆X轴左转/右转舵机 PWMA键紧急停止所有电机停止B键低速模式降低PWM占空比发送的数据可以设计成一个简单的结构体struct ControlData { int8_t throttle; // 油门-100~100 int8_t steering; // 转向-100~100 bool emergencyStop; // 紧急停止 bool lowSpeedMode; // 低速模式 };这样每次只需要发送几个字节的数据完全在ESP-NOW的250字节限制内。5.3 实际项目中的调试技巧在做这个气垫船项目时我遇到了几个典型问题这里分享给大家问题1ESP-NOW通信不稳定现象近距离通信正常距离稍远就丢包解决在esp_now_add_peer()时设置peerInfo.channel为固定的Wi-Fi信道如1、6、11避免自动跳频问题2PWM控制电机有噪音现象电机转动时有高频噪音解决调整PWM频率。对于直流电机一般用1kHz-20kHz避开人耳能听到的频率范围20Hz-20kHz问题3手柄响应延迟现象按下手柄后气垫船反应慢解决优化代码结构把蓝牙接收和ESP-NOW发送放在不同任务中避免阻塞问题4电源干扰现象电机启动时ESP32会重启解决电机电源和ESP32电源分开加大的滤波电容或者在程序启动时延迟几秒再初始化电机实际做项目时我建议先用两个ESP32开发板测试无线通信再用一个ESP32测试PWM控制电机最后再把两部分整合。这样分段调试问题容易定位。这个基于ESP32和Xbox手柄的气垫船项目涉及的知识点比较多但拆开来看都是嵌入式开发的基础内容。掌握了GPIO控制、PWM输出、串口调试和无线通信你就能做出很多有趣的物联网项目了。实际做的时候可能会遇到各种小问题多查资料、多调试嵌入式开发就是这样一点点积累经验的。
立创开源项目实战：基于ESP32与Xbox手柄的无线遥控气垫船设计与实现
立创开源项目实战基于ESP32与Xbox手柄的无线遥控气垫船设计与实现最近在立创开源硬件平台上看到一个挺有意思的项目——用ESP32和Xbox手柄做一个无线遥控气垫船。很多朋友觉得这种项目听起来很复杂既要懂硬件又要懂无线通信其实跟着步骤一步步来你会发现并没有想象中那么难。今天我就把自己做这个项目的经验整理出来手把手带你从零开始把ESP32的GPIO控制、PWM驱动、串口通信还有ESP-NOW无线通信这些知识点都串起来最终实现用游戏手柄遥控气垫船。这个教程特别适合有一定Arduino基础想进阶玩转ESP32的创客朋友。我会尽量把每个步骤都讲清楚包括我踩过的坑和调试技巧让你少走弯路。1. 项目准备与环境搭建做嵌入式项目第一步就是把开发环境搭好。这个项目我们用的是ESP32开发板编程环境推荐PlatformIO。它比Arduino IDE更专业库管理也更方便。1.1 创建PlatformIO工程打开PlatformIO点击New Project新建项目。在项目配置页面你需要填写几个关键信息Name给你的项目起个名字比如ESP32_HovercraftBoard选择你用的ESP32开发板型号常见的有ESP32 Dev ModuleFramework选择Arduino配置好后点击FinishPlatformIO会自动创建项目文件夹和基本的工程结构。注意PlatformIO默认的串口监视器波特率是9600但ESP32程序里我们常用115200。如果不改设置串口打印会显示乱码。解决方法很简单在项目根目录的platformio.ini配置文件里加上一行monitor_speed 1152001.2 第一个测试程序工程创建好后打开src/main.cpp文件PlatformIO已经生成了基本的Arduino框架代码。我们先写个简单的测试程序验证开发环境是否正常。void setup() { // 初始化串口设置波特率为115200 Serial.begin(115200); } void loop() { // 每隔1秒打印一次信息 Serial.println(My First PIO Project!); delay(1000); }点击左下角的编译按钮→图标如果没有错误再点击上传按钮→图标旁边的箭头。上传成功后打开串口监视器应该能看到每秒打印一次My First PIO Project!。如果串口显示乱码记得检查platformio.ini里是否加了monitor_speed 115200这一行。这个坑我刚开始用PlatformIO时就遇到过调了半天才发现是波特率不匹配。2. ESP32基础外设使用环境搭好了咱们先熟悉一下ESP32的几个基础外设操作这些都是后面控制气垫船电机的基础。2.1 GPIO引脚控制ESP32的GPIO通用输入输出引脚用起来和Arduino很像但底层机制更灵活。ESP32内部有个多路复用器可以灵活地把内部信号路由到任意GPIO引脚这让硬件设计时布线方便很多。先看一个简单的例子读取一个引脚的电平然后输出到另一个引脚。void setup() { // 初始化串口 Serial.begin(115200); // 初始化GPIO pinMode(2, OUTPUT); // 引脚2设置为输出模式可以接LED pinMode(4, INPUT); // 引脚4设置为输入模式可以接按钮 } void loop() { // 读取引脚4的电平然后设置到引脚2 digitalWrite(2, digitalRead(4)); }这段代码实现了最简单的电平传递引脚4的电平状态直接反映到引脚2上。实际接线时可以在引脚4接个按钮引脚2接个LED按下按钮LED就亮松开就灭。2.2 中断的使用上面的例子是在loop()里不断轮询引脚状态但实际项目中我们更常用中断来响应外部事件。ESP32支持每个GPIO引脚的外部中断。#include Arduino.h // 中断回调函数声明 void bt_callBack(void); void setup() { Serial.begin(115200); pinMode(2, OUTPUT); pinMode(4, INPUT); // 给引脚4绑定中断触发条件为电平变化 attachInterrupt(4, bt_callBack, CHANGE); } void loop() { // 主循环可以空着或者做其他事情 // 中断会独立处理引脚4的电平变化 } // 中断回调函数 void bt_callBack(void) { // 当中断触发时读取引脚4的电平并设置到引脚2 digitalWrite(2, digitalRead(4)); }这里用attachInterrupt()函数给引脚4绑定了中断触发条件是CHANGE电平变化。当中断触发时会自动调用bt_callBack()函数。中断的好处是不用一直轮询节省CPU资源响应也更及时。2.3 串口通信串口是嵌入式开发中最常用的调试和通信接口。ESP32有3个UART接口UART0、UART1、UART2都支持异步通信最高速度可达5Mbps。重要提示UART1的默认引脚是GPIO9和GPIO10这两个引脚通常用于连接外部Flash。如果你要用UART1一定要把引脚改到其他GPIO上否则会影响程序运行。下面是如何使用UART1在Arduino环境中是Serial1并把引脚改到26和27的例子#include Arduino.h int recData 0; // 用于存储接收到的数据 void setup() { // 初始化主串口UART0用于调试输出 Serial.begin(115200); // 初始化UART1波特率1152008位数据/无校验/1位停止位 // RX引脚改为26TX引脚改为27 Serial1.begin(115200, SERIAL_8N1, 26, 27); pinMode(2, OUTPUT); pinMode(4, INPUT); } void loop() { // 检查串口1是否有数据可读 if (Serial1.available() 0) { // 读取一个字节的数据 recData Serial1.read(); // 把接收到的数据以十六进制格式回传 Serial1.print(received: ); Serial1.println(recData, HEX); } }串口常用的几个函数available()返回接收缓冲区中的数据字节数read()从缓冲区读取一个字节print()/println()发送数据begin()初始化串口参数实际测试时可以用USB转TTL模块如CH340的RX接ESP32的27脚TXTX接26脚RX然后用串口助手发送数据就能看到回传的信息了。3. PWM控制与电机驱动气垫船需要控制电机的转速这就需要用到PWM脉冲宽度调制。ESP32的PWM系统比较特殊它叫LED PWM控制器虽然名字叫LED但其实可以用于各种需要PWM的场景。3.1 ESP32的PWM系统ESP32的PWM有16个通道分为两组8个高速通道8个低速通道这16个通道可以分配给几乎任意GPIO引脚少数只能输入的引脚除外。16个通道对应8个定时器每两个通道共享一个定时器这意味着最多可以输出8个不同频率的PWM信号。3.2 PWM配置三步法使用ESP32的PWM需要三个步骤第一步分配通道到GPIO引脚#define PWM1_Ch 0 // 使用PWM通道0 #define LED_GPIO 32 // PWM输出到32号引脚 ledcAttachPin(LED_GPIO, PWM1_Ch); // 把32号引脚绑定到通道0第二步设置频率和分辨率#define PWM1_Freq 50 // PWM频率设置为50Hz #define PWM1_Res 10 // 分辨率设置为10位 ledcSetup(PWM1_Ch, PWM1_Freq, PWM1_Res);分辨率决定了占空比的精度。10位分辨率意味着占空比范围是0-10232的10次方8位就是0-255。第三步设置占空比int dutyCycle 512; // 50%占空比1024的一半 ledcWrite(PWM1_Ch, dutyCycle);3.3 舵机控制实例气垫船的转向通常用舵机控制。舵机需要50Hz的PWM信号控制脉宽在0.5ms到2.5ms之间。下面是一个让舵机在0-180度之间来回转动的例子#include Arduino.h #define PWM1_Ch 0 // PWM通道0 #define LED_GPIO 32 // 输出引脚 #define PWM1_Res 10 // 10位分辨率 #define PWM1_Freq 50 // 50Hz频率 int PWM1_DutyCycle 0; void setup() { Serial.begin(115200); ledcAttachPin(LED_GPIO, PWM1_Ch); ledcSetup(PWM1_Ch, PWM1_Freq, PWM1_Res); } void loop() { // 从0度转到180度 while (PWM1_DutyCycle 127) { // 127对应2.5ms脉宽 ledcWrite(PWM1_Ch, PWM1_DutyCycle); delay(10); // 缓慢转动 } // 从180度转回0度 while (PWM1_DutyCycle 25) { // 25对应0.5ms脉宽 ledcWrite(PWM1_Ch, PWM1_DutyCycle--); delay(10); } }这里的关键是占空比的计算对于10位分辨率0-10230.5ms脉宽对应250.5/2010242.5ms脉宽对应1272.5/201024。实际调试时可能需要微调这些值因为不同舵机可能有差异。4. ESP-NOW无线通信气垫船需要无线控制这里我们选择ESP-NOW协议。这是乐鑫专门为ESP系列芯片开发的无线通信协议它有几个优点特别适合我们这个项目响应快不需要Wi-Fi连接过程上电就能通信距离远板载天线在空旷地带能达到200米以上低功耗比Wi-Fi更省电简单可靠无连接协议一个设备断电重启后能自动恢复通信4.1 ESP-NOW基础概念ESP-NOW有点像无线鼠标用的2.4GHz通信设备之间需要先配对配对成功后就可以直接通信了。它去掉了传统网络协议的一些复杂层只保留最基本的传输功能所以速度很快单次最多能传输250字节数据。ESP-NOW支持几种通信模式单向通信一个设备发一个或多个设备收双向通信设备之间互相收发数据多跳网络通过中间设备转发扩大通信范围4.2 获取设备MAC地址ESP-NOW通过MAC地址识别设备就像每个设备的身份证号。编程前需要先知道设备的MAC地址。#include WiFi.h void setup() { Serial.begin(115200); // 设置Wi-Fi为STA模式虽然不用连接Wi-Fi但ESP-NOW需要Wi-Fi底层支持 WiFi.mode(WIFI_MODE_STA); // 打印本机的MAC地址 Serial.print(MAC Address: ); Serial.println(WiFi.macAddress()); } void loop() { }运行这个程序在串口监视器里就能看到类似XX:XX:XX:XX:XX:XX的MAC地址记下来后面要用。提示如果编译时提示找不到WiFi.h需要在PlatformIO的库管理中搜索安装WiFi库。4.3 ESP-NOW基本通信流程ESP-NOW编程主要涉及几个关键函数初始化esp_now_init()- 初始化ESP-NOW调用前必须先初始化Wi-Fi添加配对设备esp_now_add_peer()- 添加要通信的设备的MAC地址发送数据esp_now_send()- 向配对设备发送数据注册回调函数esp_now_register_send_cb()- 发送完成后的回调esp_now_register_rcv_cb()- 接收到数据时的回调下面是一个简单的发送端代码框架#include esp_now.h #include WiFi.h // 接收端的MAC地址替换成你实际设备的地址 uint8_t broadcastAddress[] {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; // 发送数据回调函数 void OnDataSent(const uint8_t *mac_addr, esp_now_send_status_t status) { Serial.print(发送状态: ); Serial.println(status ESP_NOW_SEND_SUCCESS ? 成功 : 失败); } void setup() { Serial.begin(115200); // 设置Wi-Fi模式 WiFi.mode(WIFI_STA); // 初始化ESP-NOW if (esp_now_init() ! ESP_OK) { Serial.println(ESP-NOW初始化失败); return; } // 注册发送回调 esp_now_register_send_cb(OnDataSent); // 添加配对设备 esp_now_peer_info_t peerInfo; memcpy(peerInfo.peer_addr, broadcastAddress, 6); peerInfo.channel 0; peerInfo.encrypt false; if (esp_now_add_peer(peerInfo) ! ESP_OK) { Serial.println(添加配对设备失败); return; } } void loop() { // 准备要发送的数据 uint8_t data[] {0x01, 0x02, 0x03}; // 发送数据 esp_err_t result esp_now_send(broadcastAddress, data, sizeof(data)); if (result ESP_OK) { Serial.println(发送成功); } else { Serial.println(发送失败); } delay(1000); }接收端的代码类似主要是注册接收回调函数// 接收数据回调函数 void OnDataRecv(const uint8_t *mac, const uint8_t *incomingData, int len) { Serial.print(收到来自: ); for (int i 0; i 6; i) { Serial.print(mac[i], HEX); if (i 5) Serial.print(:); } Serial.println(); Serial.print(数据长度: ); Serial.println(len); Serial.print(数据内容: ); for (int i 0; i len; i) { Serial.print(incomingData[i], HEX); Serial.print( ); } Serial.println(); }在setup()中注册这个回调esp_now_register_recv_cb(OnDataRecv);5. Xbox手柄与ESP32整合最后一部分是把Xbox手柄的信号通过ESP-NOW发送给气垫船上的ESP32然后控制电机。Xbox手柄可以通过蓝牙连接但ESP32同时支持蓝牙和Wi-Fi我们可以用蓝牙接收手柄数据再用ESP-NOW转发。5.1 手柄数据处理思路Xbox手柄通过蓝牙发送的数据包含各个按键和摇杆的状态。我们需要通过蓝牙接收手柄数据解析出我们关心的控制信号比如左摇杆控制前进后退右摇杆控制转向把这些控制信号通过ESP-NOW发送给气垫船气垫船上的ESP32接收信号转换成PWM控制电机5.2 控制信号映射实际项目中我会这样映射控制信号手柄输入气垫船动作对应PWM通道左摇杆Y轴前进/后退电机1 PWM右摇杆X轴左转/右转舵机 PWMA键紧急停止所有电机停止B键低速模式降低PWM占空比发送的数据可以设计成一个简单的结构体struct ControlData { int8_t throttle; // 油门-100~100 int8_t steering; // 转向-100~100 bool emergencyStop; // 紧急停止 bool lowSpeedMode; // 低速模式 };这样每次只需要发送几个字节的数据完全在ESP-NOW的250字节限制内。5.3 实际项目中的调试技巧在做这个气垫船项目时我遇到了几个典型问题这里分享给大家问题1ESP-NOW通信不稳定现象近距离通信正常距离稍远就丢包解决在esp_now_add_peer()时设置peerInfo.channel为固定的Wi-Fi信道如1、6、11避免自动跳频问题2PWM控制电机有噪音现象电机转动时有高频噪音解决调整PWM频率。对于直流电机一般用1kHz-20kHz避开人耳能听到的频率范围20Hz-20kHz问题3手柄响应延迟现象按下手柄后气垫船反应慢解决优化代码结构把蓝牙接收和ESP-NOW发送放在不同任务中避免阻塞问题4电源干扰现象电机启动时ESP32会重启解决电机电源和ESP32电源分开加大的滤波电容或者在程序启动时延迟几秒再初始化电机实际做项目时我建议先用两个ESP32开发板测试无线通信再用一个ESP32测试PWM控制电机最后再把两部分整合。这样分段调试问题容易定位。这个基于ESP32和Xbox手柄的气垫船项目涉及的知识点比较多但拆开来看都是嵌入式开发的基础内容。掌握了GPIO控制、PWM输出、串口调试和无线通信你就能做出很多有趣的物联网项目了。实际做的时候可能会遇到各种小问题多查资料、多调试嵌入式开发就是这样一点点积累经验的。
