三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

基于NRF24L01与ESP32的无线传感网络：STM32数据采集与传输实战

发布时间：2026/8/11 9:04:57 三亩地 编程学习日记
基于NRF24L01与ESP32的无线传感网络：STM32数据采集与传输实战

这类项目最值得先看的不是功能列表，而是能不能在普通开发板上稳定跑起来，以及数据从采集到无线传输的整个链路是否清晰。基于NRF24L01和ESP32的环境检测传输系统，核心解决的是在单片机（如STM32）上采集传感器数据，然后通过无线模块发送到另一个节点（如ESP32）进行显示或上传的问题。它非常适合想学习无线通信、多单片机协同，或者需要搭建小型无线传感网络的开发者。

很多人一上来就找代码，但更容易出问题的是硬件连接、供电和通信协议配置。我建议先从最小系统开始，把发送和接收分开验证，再组合成完整的环境检测项目。下面按实际落地顺序拆一遍。

1. 先拆解项目：到底要做什么，需要哪些硬件

这个项目的标题“基于NRF24L01的环境检测传输-ESP32-单片机设计【STM32-Arduino（单机】”信息量很大，但有点杂。我们先把它理清楚。

1.1 核心任务：无线传输环境数据

项目的核心目标很明确：采集环境数据（比如温湿度），然后无线发送出去。这里有几个关键角色：

  • 数据采集端（发送端）：通常是一个单片机（如STM32），连接着温湿度传感器（如DHT11/DHT22）。它负责读取传感器数据。
  • 无线模块：NRF24L01，负责把单片机采集的数据通过2.4GHz频段发送出去。
  • 数据接收/处理端（接收端）：这里是ESP32。它通过另一个NRF24L01模块接收数据，然后可以通过串口打印、屏幕显示，或者利用其Wi-Fi/蓝牙能力上传到网络。

所以，这不是一个“单机”项目，而是一个典型的点对点无线通信系统。标题里的“单机”可能是指演示时用一块开发板模拟两端，或者指代码结构，但实际硬件需要两套。

1.2 硬件清单与选型要点

根据核心任务，你需要准备以下硬件：

角色核心部件可选型号/备注关键注意点
发送端主控MCUSTM32F103C8T6（蓝桥杯常见）确保有足够的GPIO和SPI接口（用于NRF24L01）
无线模块NRF24L01+ (带PA+LNA版本信号更强)务必确认供电是3.3V，5V会烧毁模块
环境传感器DHT11（温湿度）、DS18B20（温度）注意通信协议（单总线、I2C），准备上拉电阻
电源USB供电或3.7V锂电池+稳压模块无线模块发射时电流较大，电源要稳定
接收端主控MCUESP32 DevKit V1（NodeMCU-32S常见）自带Wi-Fi/蓝牙，方便后续扩展
无线模块NRF24L01+ (同上)同样注意3.3V供电
显示/输出SSD1306 OLED屏、串口监视器用于直观查看接收到的数据
公共连接线杜邦线（母对母、公对母）建议使用颜色区分电源、地、信号线
开发环境Keil (STM32), Arduino IDE (ESP32)标题提到Arduino，说明ESP32端可能用Arduino框架编程

硬件连接上的坑点：

  1. NRF24L01的电源：这是最容易出错的地方。模块的VCC必须接3.3V，不能接5V。很多开发板的3.3V输出能力有限，当NRF24L01发射时，电流峰值可能超过100mA，可能导致电压被拉低，通信不稳定。稳妥的做法是使用一个独立的AMS1117-3.3稳压模块为NRF24L01供电。
  2. SPI引脚：NRF24L01使用SPI通信。STM32和ESP32都有硬件SPI接口，你需要找到对应的MOSI,MISO,SCK引脚，并任意选择两个GPIO作为CE（芯片使能）和CSN（片选）信号。务必在代码中正确配置这些引脚号。
  3. 天线：如果使用带外置天线的PA+LNA版本，确保天线拧紧。使用不带天线的版本时，传输距离会非常有限（几米内），适合桌面测试。

2. 搭建开发环境与准备核心库

代码还没写，环境要先配好。这里涉及两个不同的开发环境和对应的库。

2.1 STM32端（发送端）环境准备

STM32的开发方式很多，鉴于标题提到了“Arduino（单机）”，一种可能是整个项目都用Arduino框架来写（包括STM32）。但更常见的工业做法是STM32用Keil+标准外设库或HAL库。

方案A：使用Keil MDK + STM32标准库/HAL库（推荐）这是最正统的STM32开发方式，性能和控制粒度最好。

  1. 安装Keil MDK：从官网下载安装，需要注册。
  2. 安装芯片支持包：安装STM32F1xx（或其他你使用的系列）的Device Family Pack。
  3. 获取NRF24L01驱动库：搜索并下载适用于STM32的NRF24L01库，例如nRF24L01byTMRh20的移植版，或者国内开发者整理好的。通常是一个包含.c和.h的文件包。
  4. 获取传感器库：下载DHT11等传感器的驱动库。
  5. 在Keil工程中：将上述库文件添加到你的项目，并包含正确的头文件路径。

方案B：使用Arduino IDE开发STM32这种方式代码编写简单，与ESP32端的Arduino代码风格统一。

  1. 安装Arduino IDE。
  2. 安装STM32支持：在“开发板管理器”中搜索“STM32”，安装“STM32 Cores” by STMicroelectronics。
  3. 选择开发板：工具菜单下，选择正确的STM32型号（如Generic STM32F1 series -> BluePill F103C8）。
  4. 安装库：在“库管理器”中搜索安装RF24（用于NRF24L01）和DHT sensor library。

我个人的建议：如果你是初学者，想快速打通通信，方案B（Arduino框架）更简单，避开了Keil复杂的工程配置。但如果你需要更精细的控制或用于产品，方案A是必学之路。本文后续讲解将以方案B（Arduino框架）为例，因为它受众更广，代码更易读。

2.2 ESP32端（接收端）环境准备

ESP32端使用Arduino IDE开发是主流且方便的选择。

  1. 安装Arduino IDE（如果还没装）。
  2. 安装ESP32开发板支持：在“文件->首选项”的附加开发板管理器网址中添加：https://espressif.github.io/arduino-esp32/package_esp32_index.json。然后在“开发板管理器”中搜索安装“esp32”。
  3. 选择开发板：工具菜单下，选择你的ESP32型号（如ESP32 Dev Module）。
  4. 安装库：同样在“库管理器”中安装RF24和用于显示的库（如Adafruit SSD1306、Adafruit GFX）。

2.3 核心库：RF24库的关键配置

无论STM32还是ESP32，只要用了Arduino框架，我们都会依赖RF24库。这个库功能强大，但配置项也多。

安装后，你会在示例中找到RF24的例程。对于我们的项目，最关键的是理解并正确设置以下几个参数（在radio.begin()之后设置）：

// 设置通信管道地址。发送和接收端必须使用相同的地址。 // 这是一个40位（5字节）的地址，可以自定义，但不要全为0。 uint8_t address[][6] = {"1Node", "2Node"}; // 管道0和管道1的地址 // 设置发射功率级别。RF24_PA_MIN, RF24_PA_LOW, RF24_PA_HIGH, RF24_PA_MAX radio.setPALevel(RF24_PA_LOW); // 测试时用LOW或MIN，降低功耗和干扰。实际使用根据距离选HIGH或MAX。 // 设置数据传输速率。RF24_250KBPS, RF24_1MBPS, RF24_2MBPS radio.setDataRate(RF24_1MBPS); // 1Mbps是平衡速度和可靠性的常用选择。 // 设置重传延迟和重传次数 radio.setRetries(3, 5); // 延迟250us * 3， 最多重试5次 // 选择是否启用自动应答（Auto-Acknowledge） radio.setAutoAck(true); // 通常启用，提高可靠性。 // 打开写入（发送）或读取（接收）管道 radio.openWritingPipe(address[0]); // 发送端用 // radio.openReadingPipe(1, address[1]); // 接收端用，管道1对应地址[1]

为什么这么配置？

  • 地址：就像对讲机的频道，收发必须一致。
  • 发射功率：功率越大，距离越远，但耗电也越大。桌面测试用LOW即可，避免干扰。
  • 数据速率：速率越低，抗干扰能力越强，传输距离可能更远。250KBPS最稳，2MBPS最快。1MBPS是折中。
  • 自动应答和重传：这是NRF24L01可靠性的关键。发送端发出数据后，会等待接收端的确认信号。如果没收到，会自动重发。这能有效应对无线环境中的偶然丢包。

3. 分步实现：从发送端到接收端

不要试图一次性写完两端所有代码。应该先让发送端能稳定发出数据，再让接收端能稳定收到并打印。

3.1 第一步：发送端（STM32）最小系统测试

目标：让STM32读取DHT11数据，并通过串口打印出来。先不接NRF24L01。

  1. 连接DHT11到STM32（如PA1引脚）。
  2. 编写代码，使用DHT库读取温湿度。
  3. 通过串口（如USART1,PA9/TX,PA10/RX）将数据打印到电脑的串口监视器。
  4. 确认数据读取正常，间隔1秒打印一次。

这是基础验证，确保传感器和单片机工作正常。

3.2 第二步：发送端集成NRF24L01，发送测试数据

目标：STM32能通过NRF24L01发出一个固定的字符串或数字。

  1. 按接线图连接NRF24L01到STM32的SPI引脚和CE、CSN引脚（例如PA4为CSN，PA3为CE）。
  2. 在代码中引入RF24库，并初始化。
  3. 配置RF24参数（如上一节的示例），设置发送管道地址。
  4. 在loop函数中，不再向串口发送，而是改为向NRF24L01写入一个固定的数据包，例如：
    char text[] = "Hello ESP32"; bool report = radio.write(&text, sizeof(text)); if (report) { Serial.println("Send OK"); } else { Serial.println("Send Failed"); } delay(1000);
  5. 烧录代码，打开串口监视器。你应该能看到交替的“Send OK”和“Send Failed”。因为此时没有接收端应答，启用自动应答后，发送会失败。这是正常的。你可以暂时radio.setAutoAck(false)来测试纯发送，但最终要改回true。

这一步验证了STM32与NRF24L01的SPI通信是否正常，以及发送功能是否基本可用。

3.3 第三步：接收端（ESP32）最小接收测试

目标：ESP32能接收到来自STM32的测试数据并打印。

  1. 连接NRF24L01到ESP32（注意引脚：通常VCC->3.3V,GND->GND,CE->GPIO4,CSN->GPIO5,SCK->GPIO18,MOSI->GPIO23,MISO->GPIO19）。不同板子引脚可能不同，需查手册。
  2. ESP32端代码，初始化RF24，配置参数（数据速率、功率等必须与发送端完全一致），设置接收管道地址（与发送端的写入地址对应）。
  3. 在loop函数中，监听接收。
    if (radio.available()) { char receivedText[32] = {0}; // 缓冲区 radio.read(&receivedText, sizeof(receivedText)); Serial.print("Received: "); Serial.println(receivedText); }
  4. 烧录代码，打开ESP32的串口监视器。
  5. 同时给STM32和ESP32上电。如果一切正常，ESP32的串口应该会不断打印出“Hello ESP32”。

关键排查点：

  • 电源：确保两个NRF24L01模块供电稳定（3.3V）。
  • 地址：检查发送端的openWritingPipe和接收端的openReadingPipe地址是否完全一致。
  • SPI引脚：检查代码中RF24 radio(CE_PIN, CSN_PIN)的引脚号是否与实际接线一致。
  • 参数：确认两端的setDataRate和setPALevel相同。

3.4 第四步：整合环境数据发送与接收

打通了基础通信，现在把真实数据加进去。

  1. 发送端（STM32）修改：在loop中，先读取DHT11数据，然后将数据打包成一个结构体，再发送。结构体比发送多个独立变量更可靠。
    struct SensorData { float temperature; float humidity; // 可以加时间戳、设备ID等 }; SensorData data; data.temperature = dht.readTemperature(); data.humidity = dht.readHumidity(); bool report = radio.write(&data, sizeof(data));
  2. 接收端（ESP32）修改：接收缓冲区改为SensorData结构体，然后解析并打印。
    SensorData data; if (radio.available()) { radio.read(&data, sizeof(data)); Serial.print("Temp: "); Serial.print(data.temperature); Serial.print(" *C, Humi: "); Serial.print(data.humidity); Serial.println(" %"); }
  3. 测试：此时，ESP32串口应该能周期性地显示来自STM32的温湿度数据。

3.5 第五步：ESP32端数据展示与上传（进阶）

数据收到后，可以进一步处理：

  • OLED显示：使用Adafruit SSD1306库，将温湿度数据显示在OLED屏幕上。
  • Wi-Fi上传：利用ESP32的Wi-Fi功能，将数据发送到网络服务器（如HTTP请求到云平台、MQTT发布到Broker）。这是将项目升级为“物联网”节点的关键一步。
    // 示例：使用WiFiClient发送HTTP POST请求 #include <WiFi.h> WiFiClient client; if (client.connect(server, 80)) { String postData = "temp=" + String(data.temperature) + "&humi=" + String(data.humidity); client.println("POST /api/data HTTP/1.1"); // ... 添加Host、Content-Type等头部 client.println("Content-Length: " + String(postData.length())); client.println(); client.println(postData); }
  • 蓝牙串口：也可以将ESP32设置为蓝牙串口，用手机APP接收数据。

4. 项目优化与深度避坑指南

能跑通只是第一步。要让项目稳定、可靠，还需要注意以下问题。

4.1 通信稳定性优化

无线通信极易受环境影响。

  1. 电源去耦：在每个NRF24L01模块的VCC和GND之间，尽可能靠近模块引脚的地方，焊接一个10uF的电解电容和一个0.1uF的瓷片电容。这是抑制电源噪声、防止发射时电压骤降的最有效手段。
  2. 引脚上拉：NRF24L01的IRQ引脚（如果需要使用中断模式）建议接上拉电阻。CE和CSN引脚虽然单片机内部可能有上拉，但为了稳定，也可以考虑外部上拉。
  3. 软件重试与超时：不要只依赖硬件自动应答。在发送端代码中，加入软件层面的重试逻辑和超时判断。
    bool sendData(const void* buf, uint8_t len) { unsigned long startTime = millis(); const unsigned long timeout = 200; // 200ms超时 bool success = false; while (!success && (millis() - startTime < timeout)) { success = radio.write(buf, len); if (!success) { delay(5); // 短暂延迟后重试 // 可以在这里加入一些复位或重新初始化的逻辑 } } return success; }
  4. 信道选择：2.4GHz频段很拥挤（Wi-Fi、蓝牙都在）。RF24库可以设置信道（0-125）。如果通信不稳定，可以尝试换一个信道，避开Wi-Fi常用的1,6,11信道。

4.2 低功耗设计（如果考虑电池供电）

如果发送端需要电池供电长期工作，功耗是关键。

  1. STM32睡眠模式：在两次发送间隔，让STM32进入Stop或Standby模式。可以使用RTC定时唤醒或外部中断（如DHT11的数据引脚变化）唤醒。
  2. NRF24L01功耗模式：发送完成后，立即将NRF24L01设置为powerDown模式。下次发送前再powerUp。RF24库提供radio.powerDown()和radio.powerUp()函数。
  3. 降低发送频率：根据应用需求，尽可能延长数据发送间隔（如从1秒改为10秒或1分钟）。
  4. 关闭无关外设：关闭不用的ADC、串口、时钟等。

4.3 数据包设计与错误处理

  1. 结构体打包：使用#pragma pack(1)确保结构体字节对齐，避免因编译器对齐导致收发双方结构体大小不一致。
    #pragma pack(push, 1) struct SensorData { uint16_t deviceID; float temperature; float humidity; uint32_t timestamp; uint8_t checksum; // 校验和 }; #pragma pack(pop)
  2. 加入校验：在结构体中增加一个校验字段（如校验和checksum）。接收端计算校验和，如果不匹配则丢弃该数据包，请求重发或记录错误。
  3. 序列号：为每个数据包增加一个递增的序列号，用于接收端判断是否丢包。

4.4 常见问题排查清单

当通信失败时，按以下顺序排查：

  1. 电源与接线：

    • 用万用表测量NRF24L01的VCC引脚电压，确保是稳定的3.3V（发射时也要测）。
    • 检查所有杜邦线是否接触良好，特别是GND线。
    • 检查SPI引脚（MOSI, MISO, SCK）是否接反。

  2. 软件配置：

    • 确认两端地址完全一致（包括大小写）。
    • 确认两端数据速率(setDataRate)、发射功率(setPALevel)设置相同。
    • 检查CE和CSN引脚在代码中的定义与实际接线是否一致。
    • 尝试禁用自动应答setAutoAck(false)，看是否能收到数据（测试基本收发链路）。

  3. 环境干扰：

    • 将两个设备靠近（1米内）测试，排除距离问题。
    • 远离路由器、微波炉等强2.4GHz干扰源。
    • 尝试更换NRF24L01的通信信道。

  4. 模块本身：

    • 交换两个NRF24L01模块，判断是否是某个模块损坏。
    • 如果使用无源晶振的模块，尝试降低数据速率（如设为RF24_250KBPS），这类模块对低速支持更好。

  5. 代码与调试：

    • 在发送端和接收端都开启串口调试，打印关键状态（如radio.isChipConnected()可以检查SPI通信是否正常）。
    • 简化代码，先发送/接收一个简单的uint32_t数字，排除结构体打包的问题。

这个项目从硬件连接到软件调试，完整走一遍后，你对无线通信、多单片机系统、传感器应用会有很扎实的理解。它不是一个炫技的项目，而是一个能让你摸透无线通信链路细节的经典实验。真正做产品时，这些关于电源、校验、重试、低功耗的考量，每一个都是决定成败的关键。

编程学习 学习日记 实战经验
← 返回列表