ESP-NOW两块ESP32无线对话实操

2026-11-18 07:27:17 47阅读 所属项目:ESP32 开发板

手上两块 ESP32,想让它们互相说话,第一反应多半是连同一个路由器再走 MQTT。其实乐鑫早就塞了一条野路子进芯片里:ESP-NOW。不走路由器、不建热点、不配网,两块板子拿 MAC 地址直接对发数据,等待时间短到可以当遥控器用。这篇按 Random Nerd Tutorials 的入门教程把最小双向链路拆开讲一遍,代码逐字搬运,照抄能编。

ESP-NOW ESP32 无线通信教程

ESP-NOW 是个什么协议

先对齐口径。乐鑫官方文档对 ESP-NOW 的定义是:一个让多台设备不借助 Wi-Fi 就能互相通信的协议,走低功耗 2.4GHz 无线连接;通信前需要先配对,配对完成后连接是安全的点对点链路,不需要握手。翻译成人话:配一次对,之后 boards 之间就像存了对方的名片,掉电重启会自动续上,连接是持久的。

它支持加密和非加密的单播通信,也允许加密与非加密的 peer 混着用;载荷上限 250 字节;还能挂发送回调函数,告诉你这包到底发没发出去。想开加密的话,按乐鑫 API 文档的口径,每个加密 peer 要配 16 字节的 LMK 本地密钥,而且加密 peer 数量就吃上面那个 10/6 的配额;跑明文没这个限制,入门阶段先用 encrypt=false 把链路跑通,再考虑上锁。限制也要心里有数:Station 模式下加密 peer 最多 10 个,SoftAP 或 SoftAP+Station 模式最多 6 个;不加密的 peer 可以多挂,但总数(含加密的)要控制在 20 以内。所以它适合小包高频的控制指令和传感器读数,不是拿来传文件的。

ESP-NOW 两块 ESP32 单向通信示意图

组网上非常自由:一对一发数据、一个主机控多个从机做遥控器、多个节点往一个汇聚板灌传感器数据都行。而且 ESP-NOW 的文档里其实没有 master/slave 这种身份,每块板都可以同时当发送端和接收端,双向通信、甚至组个板间小网都没问题。底稿教程配套还有几篇进阶:两块板双向互发、一个发送端对多个接收端、一个接收端收多个发送端的数据,骨架都是本篇这一套,差别只在 peer 怎么加、回调里怎么分流。

先拿接收板的 MAC 地址

ESP-NOW 靠 MAC 地址找人,所以第一步是把接收板那块芯片的 MAC 读出来。每块 ESP32 出厂都带唯一 MAC,烧下面这段代码就能看:

/*
  Rui Santos & Sara Santos - Random Nerd Tutorials
  Complete project details at https://RandomNerdTutorials.com/get-change-esp32-esp8266-mac-address-arduino/
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.  
  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
*/
#include "WiFi.h"
#include "esp_wifi.h"

void readMacAddress(){
  uint8_t baseMac[6];
  esp_err_t ret = esp_wifi_get_mac(WIFI_IF_STA, baseMac);
  if (ret == ESP_OK) {
    Serial.printf("%02x:%02x:%02x:%02x:%02x:%02x\n",
                  baseMac[0], baseMac[1], baseMac[2],
                  baseMac[3], baseMac[4], baseMac[5]);
  } else {
    Serial.println("Failed to read MAC address");
  }
}

void setup(){
  Serial.begin(115200);

  WiFi.mode(WIFI_STA);
  WiFi.STA.begin();

  Serial.print("[DEFAULT] ESP32 Board MAC Address: ");
  readMacAddress();
}
 
void loop(){

}

烧完打开串口监视器,波特率 115200,按一下板子上的 RST/EN 键,MAC 就打出来了。教程配图里红框那行 30:AE:A4:07:0D:64 是底稿示例板的地址,你的必然不一样,抄下来待用。顺带一个冷知识:这个 MAC 不满意还能改,底稿作者专门写过一篇改 MAC 的教程,有些复刻场景(比如两块板要互为镜像)把地址设成一样反而省事。另外注意区分 STA 的 MAC 和 AP 的 MAC 是两个值,ESP-NOW 默认走 STA 这条,抄错口会导致永远配不上对。

ESP32 串口监视器读取 MAC 地址

发送端:配对、回调、把结构体丢过去

发送端固件要干四件事:初始化 ESP-NOW、注册发送回调、把接收板作为 peer 加进来、发数据。完整代码如下,注意 broadcastAddress 数组要换成你刚抄的 MAC:

/*
  Rui Santos & Sara Santos - Random Nerd Tutorials
  Complete project details at https://RandomNerdTutorials.com/esp-now-esp32-arduino-ide/
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.
  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
*/
#include "esp_now.h"
#include "WiFi.h"

// REPLACE WITH YOUR RECEIVER MAC Address
uint8_t broadcastAddress[] = {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF};

// Structure example to send data
// Must match the receiver structure
typedef struct struct_message {
  char a[32];
  int b;
  float c;
  bool d;
} struct_message;

// Create a struct_message called myData
struct_message myData;

esp_now_peer_info_t peerInfo;

// callback when data is sent
void OnDataSent(const uint8_t *mac_addr, esp_now_send_status_t status) {
  Serial.print("\r\nLast Packet Send Status:\t");
  Serial.println(status == ESP_NOW_SEND_SUCCESS ? "Delivery Success" : "Delivery Fail");
}
 
void setup() {
  // Init Serial Monitor
  Serial.begin(115200);
 
  // Set device as a Wi-Fi Station
  WiFi.mode(WIFI_STA);

  // Init ESP-NOW
  if (esp_now_init() != ESP_OK) {
    Serial.println("Error initializing ESP-NOW");
    return;
  }

  // Once ESPNow is successfully Init, we will register for Send CB to
  // get the status of Trasnmitted packet
  esp_now_register_send_cb(esp_now_send_cb_t(OnDataSent));
  
  // Register peer
  memcpy(peerInfo.peer_addr, broadcastAddress, 6);
  peerInfo.channel = 0;  
  peerInfo.encrypt = false;
  
  // Add peer        
  if (esp_now_add_peer(&peerInfo) != ESP_OK){
    Serial.println("Failed to add peer");
    return;
  }
}
 
void loop() {
  // Set values to send
  strcpy(myData.a, "THIS IS A CHAR");
  myData.b = random(1,20);
  myData.c = 1.2;
  myData.d = false;
  
  // Send message via ESP-NOW
  esp_err_t result = esp_now_send(broadcastAddress, (uint8_t *) &myData, sizeof(myData));
   
  if (result == ESP_OK) {
    Serial.println("Sent with success");
  }
  else {
    Serial.println("Error sending the data");
  }
  delay(2000);
}

代码逻辑拆开看。结构体 struct_message 里塞了 char 数组、int、float、bool 四种常见类型,两端定义必须一字不差,不然收到的就是乱码。OnDataSent 是发送回调,发完一包立刻告诉你 Delivery Success 还是 Delivery Fail,调参全靠它。

一个细节:注册回调时代码写的是 esp_now_register_send_cb(esp_now_send_cb_t(OnDataSent)),包了一层 esp_now_send_cb_t 强转,这是新版 arduino-esp32 核心的写法;如果你用老核心,网上旧教程直接传函数名也能过,报错时对照自己核心版本即可。配对部分把 peer 的 MAC、信道、加密标志填进 peerInfo:channel 填 0 表示跟随当前信道,encrypt 填 false 先跑明文,要加密再打开。另外 esp_now_init() 之前必须先把 Wi-Fi 置成 STA 模式,顺序反了初始化会失败,这是新手最容易踩的第一坑。

loop 里每 2 秒填一次数据然后 esp_now_send() 发出,返回值是 ESP_OK 就算提交成功。这四个变量只是占位示范,换成你的传感器读数、开关状态,就是正经项目了。如果串口里刷的是 Delivery Fail,按命中率从高到低排查:一,broadcastAddress 没换成自己板子的 MAC,直接抄了示例的全 FF;二,接收端没上电或者还没烧固件,peer 在但人不在线;三,两端不在同一信道,channel 填了非 0 值又和实际 Wi-Fi 信道对不上;四,esp_now_add_peer() 返回不是 ESP_OK,配对这步就失败了,后面的 send 全是空枪。把回调的状态打出来,基本一眼定位。

接收端:一个回调收下整个结构体

接收端更简单,不用配 peer,只要初始化 ESP-NOW 然后挂一个接收回调。完整代码:

/*
  Rui Santos & Sara Santos - Random Nerd Tutorials
  Complete project details at https://RandomNerdTutorials.com/esp-now-esp32-arduino-ide/  
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.
  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
*/

#include "esp_now.h"
#include "WiFi.h"

// Structure example to receive data
// Must match the sender structure
typedef struct struct_message {
    char a[32];
    int b;
    float c;
    bool d;
} struct_message;

// Create a struct_message called myData
struct_message myData;

// callback function that will be executed when data is received
void OnDataRecv(const uint8_t * mac, const uint8_t *incomingData, int len) {
  memcpy(&myData, incomingData, sizeof(myData));
  Serial.print("Bytes received: ");
  Serial.println(len);
  Serial.print("Char: ");
  Serial.println(myData.a);
  Serial.print("Int: ");
  Serial.println(myData.b);
  Serial.print("Float: ");
  Serial.println(myData.c);
  Serial.print("Bool: ");
  Serial.println(myData.d);
  Serial.println();
}
 
void setup() {
  // Initialize Serial Monitor
  Serial.begin(115200);
  
  // Set device as a Wi-Fi Station
  WiFi.mode(WIFI_STA);

  // Init ESP-NOW
  if (esp_now_init() != ESP_OK) {
    Serial.println("Error initializing ESP-NOW");
    return;
  }
  
  // Once ESPNow is successfully Init, we will register for recv CB to
  // get recv packer info
  esp_now_register_recv_cb(esp_now_recv_cb_t(OnDataRecv));
}
 
void loop() {

}

收到数据后 OnDataRecv 被触发,memcpy 把 incomingData 原样拷进 myData,之后 myData.a、myData.b 这些字段随便取用。示例只是往串口打印,实际项目里你可以接显示屏、驱动舵机、点亮继电器,都是同一套骨架。loop 是空的,所有事情都发生在回调里,这种写法对主循环特别友好。回调里别干重活,尤其是 delay 和长循环,收到包尽快返回;要驱动舵机、刷屏这类耗时操作,惯用做法是回调里只存数据和置标志,主循环里看标志干活。还有一点容易被忽略:memcpy 用的是 sizeof(myData),两端结构体只要有一边改了字段没同步,长度对不上,收到的数据就直接错位,表现为某几个字段永远是怪值——看到这种症状先对结构体定义。

照例说明一下头文件:本站编辑器会吃掉 include 的尖括号,所以代码里 #include 一律改成了引号写法 #include "esp_now.h"(WiFi.h 同理)。两种写法在 Arduino 工具链下对库搜索路径是等价的,照抄能编。

烧录验证与几句实话

发送端、接收端各烧各的固件,然后开两个 Arduino IDE 窗口,各开各的串口监视器,COM 口别选串。发送端每 2 秒打一行 Sent with success 加 Delivery Success;接收端打 Bytes received 和四个字段的值,其中 Int 每次都在变,因为发送端填的是随机数,看到它跳就是链路活着。

距离这事底稿作者做过公开实测:开阔场地两块板的板载天线相对,稳定通信跑到 220 米(约 722 英尺)。室内有墙另说,天线朝向影响很大,别拿室内穿两堵墙的体验去否定它。复现环境没什么门槛:Arduino IDE 装好 esp32 板卡支持包,开发板选 ESP32 Dev Module,两块常见的 ESP32-WROOM 开发板就行,不需要任何外设。唯一要备的是两根能传数据的 USB 线,两个串口窗口同时开。烧录时如果报连不上,按住 BOOT 键再点上传,进下载模式的老办法在这两块板上依然好使。

ESP32 ESP-NOW 220 米通信距离实测

还想往深玩,IDE 里现成的例子别浪费:File > Examples > ESP32 > ESPNow 下面有一组官方示例,管理 peer、删 peer、扫描从机都有。下一步自然是把这篇的单向链路改成双向,两块板互发传感器数据,那才是 ESP-NOW 真正好玩的地方——无连接、低延迟、不依赖任何网络设施,拿去做遥控器、做分布传感网络,比 Wi-Fi 方案清爽太多。


作者:野生极客一枚
链接:https://www.aiddithome.com/p/cf999e7cbd3f.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
线比代码多
1楼 · 2026-11-18 07:29:43

终于有不接线的无线教程了,ESP-NOW 这名字起得是真贴切,板子之间直接喊话。

学生党玩机
2楼 · 2026-11-18 07:29:43

开阔地 220 米这个数据够顶,宿舍到实验室隔一栋楼,回头试试能不能通,通了就用它传温湿度。

胶佬憨憨
3楼 · 2026-11-18 07:29:42

以前两块 ESP32 互发数据,第一反应都是连 WiFi 走 MQTT,配网那套折腾下来比业务本身还费劲。看完这篇才意识到 ESP-NOW 这条路有多省事:不建热点不配网,MAC 地址直接对发,掉电重启还自动续连。250 字节载荷装传感器数据组个包刚好,想传大点的就得自己分包了。周末就拿手头两块板照着跑一遍,先发个 DHT11 温湿度试试水。

调参到凌晨
4楼 · 2026-11-18 07:29:42

Delivery Fail 排查那段太真实了,全 FF 的 MAC 我也抄过,卡了一晚上才反应过来示例地址要换成自己的,串口一直在那 Delivery Fail,人对着屏幕怀疑人生。