NodeMCU用C语言如何实现WiFi通信？

NodeMCU 开发最主流、最简单、资源最丰富的语言是 Lua (通过 NodeMCU Firmware)，而 C 语言是通过 ESP-IDF (Espressif IoT Development Framework) 来使用的。

当你说“nodemcu wifi c语言”时，你实际上是在问 “如何使用 ESP-IDF 框架为 ESP8266/ESP32 (NodeMCU 的核心芯片) 编写 C 语言程序来控制 WiFi”。

下面我将为你提供一个完整的、从零开始的指南。

核心概念：ESP-IDF vs. NodeMCU Firmware

如果你的项目对性能、稳定性和功能有较高要求，或者你想系统地学习嵌入式 C 开发，ESP-IDF 是你的不二之选，如果你只是想快速点亮一个 LED 或让设备连上 WiFi，Lua 更方便。

环境搭建：使用 ESP-IDF 开发 NodeMCU (ESP8266)

我们将以最经典的 ESP8266 NodeMCU 为例，介绍如何搭建 ESP-IDF 开发环境。

所需硬件

• 一块 NodeMCU 开发板 (ESP8266 核心版)
• 一根 Micro USB 数据线
• 电脑 (Windows, macOS, 或 Linux)

所需软件

• Python 3.6+ (ESP-IDF 需要 Python 来运行构建脚本)
• Git (用于从 GitHub 下载 ESP-IDF 代码)
• ESP-IDF 工具链 (编译器、链接器等)
• 串口驱动 (用于烧录和调试)

安装步骤 (以 Windows 为例)

安装 Python 和 Git

• 访问 Python 官网 下载并安装 Python 3.6 或更高版本。安装时务必勾选 "Add Python to PATH"。
• 访问 Git 官网 下载并安装 Git。

获取 ESP-IDF

打开命令提示符 (CMD) 或 PowerShell，执行以下命令，这会克隆 ESP-IDF 的最新版本到你的电脑上。

# 创建一个文件夹用于存放 ESP-IDF
mkdir C:\esp
cd C:\esp
# 克隆 ESP-IDF 仓库 (我们使用 v3.4 版本，对 ESP8266 支持稳定)
git clone --recursive https://github.com/espressif/ESP8266_RTOS_SDK.git
# 设置环境变量
cd ESP8266_RTOS_SDK
export.bat  # 在 Windows 下使用 .bat 文件

配置 VS Code (推荐)

使用 Visual Studio Code 是最方便的开发方式。

1. 安装 VS Code：从 官网 下载安装。
2. 安装 C/C++ 和 ESP-IDF 插件：
   • 打开 VS Code。
   • 进入扩展市场，搜索并安装 C/C++ (Microsoft) 和 ESP-IDF (espressif) 插件。
3. 打开 ESP-IDF 示例项目：
   • 在 VS Code 中，按 Ctrl+Shift+P 打开命令面板。
   • 输入 ESP-IDF: Open ESP-IDF Project Examples。
   • 选择你的 ESP-IDF 路径 (C:\esp\ESP8266_RTOS_SDK)。
   • 选择 get-started -> hello_world 示例项目。
4. 配置项目：
   • 在 VS Code 中打开 hello_world 项目文件夹。
   • 按 F1，输入 ESP-IDF: Select Configure。
   • 选择你的 ESP8266 开发板 (ESP8266_NODEMCU_V3)。
   • VS Code 会自动帮你设置好 sdkconfig 和所有环境变量。

安装串口驱动

• Windows: 下载并安装 CH340/CP2102 驱动。
• macOS: 通常系统自带,无需安装。
• Linux: 通常系统自带，sudo apt-get install git wget make libncurses-dev flex bison gperf python python-pip python-setuptools python-serial pypython-cryptography python-future。

你的开发环境就搭建好了！

C 语言 WiFi 编程示例：连接到 WiFi

我们将创建一个最简单的程序，让 NodeMCU 连接到指定的 WiFi 网络。

创建项目

在 VS Code 中，创建一个新的文件夹，my_wifi_project，在里面创建一个 main 文件夹，然后在 main 文件夹中创建一个 main.c 文件。

编写代码

将以下代码复制到 main.c 文件中。

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/event_groups.h"
#include "esp_system.h"
#include "esp_log.h"
#include "esp_wifi.h"
#include "esp_event.h"
#include "esp_netif.h"
// 定义 WiFi 事件组
#define WIFI_CONNECTED_BIT    BIT0
#define WIFI_FAIL_BIT         BIT1
// 你的 WiFi 名称和密码
#define EXAMPLE_ESP_WIFI_SSID      "Your_WiFi_SSID"
#define EXAMPLE_ESP_WIFI_PASS      "Your_WiFi_Password"
// 最大重试次数
#define EXAMPLE_ESP_MAXIMUM_RETRY  5
static const char *TAG = "wifi_station";
static EventGroupHandle_t s_wifi_event_group;
// 等待连接成功或失败
static int s_retry_num = 0;
// WiFi 事件处理函数
static void event_handler(void* arg, esp_event_base_t event_base,
                         int32_t event_id, void* event_data) {
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {
        // 如果是 WiFi 启动事件，则开始连接
        esp_wifi_connect();
        ESP_LOGI(TAG, "Wi-Fi connecting...");
    } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {
        // 如果是 WiFi 断开连接事件
        if (s_retry_num < EXAMPLE_ESP_MAXIMUM_RETRY) {
            esp_wifi_connect();
            s_retry_num++;
            ESP_LOGI(TAG, "retry to connect to the AP");
        } else {
            xEventGroupSetBits(s_wifi_event_group, WIFI_FAIL_BIT);
        }
        ESP_LOGI(TAG,"connect to the AP fail");
    } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
        // 如果是获取到 IP 地址事件
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
        ESP_LOGI(TAG, "got ip:" IPSTR, IP2STR(&event->ip_info.ip));
        s_retry_num = 0;
        xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT);
    }
}
void wifi_init_sta(void) {
    // 1. 创建事件组
    s_wifi_event_group = xEventGroupCreate();
    // 2. 初始化 LwIP 协议栈
    ESP_ERROR_CHECK(esp_netif_init());
    // 3. 创建默认事件循环
    ESP_ERROR_CHECK(esp_event_loop_create_default());
    // 4. 创建 WiFi 站模式 (STA) 网络接口
    esp_netif_t *sta_netif = esp_netif_create_default_wifi_sta();
    assert(sta_netif);
    // 5. 初始化 WiFi 驱动
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));
    // 6. 注册事件处理回调函数
    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,
                                                        ESP_EVENT_ANY_ID,
                                                        &event_handler,
                                                        NULL,
                                                        NULL));
    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,
                                                        IP_EVENT_STA_GOT_IP,
                                                        &event_handler,
                                                        NULL,
                                                        NULL));
    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,
                                                        IP_EVENT_STA_LOST_IP,
                                                        &event_handler,
                                                        NULL,
                                                        NULL));
    // 7. 配置 WiFi
    wifi_config_t wifi_config = {
        .sta = {
            .ssid = EXAMPLE_ESP_WIFI_SSID,
            .password = EXAMPLE_ESP_WIFI_PASS,
            /* Authmode threshold resets to WPA2 as default if password matches WPA2 standards (pasword len => 8).
             * If you want to connect the device to old WEP networks, please set the threshold value
             * to WIFI_AUTH_WEP accordingly.
             */
            .threshold.authmode = WIFI_AUTH_WPA2_PSK,
            .pmf_cfg = {
                .capable = true,
                .required = false
            },
        },
    };
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA) );
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config) );
    ESP_ERROR_CHECK(esp_wifi_start() );
    ESP_LOGI(TAG, "wifi_init_sta finished.");
    // 8. 等待连接结果
    EventBits_t bits = xEventGroupWaitBits(s_wifi_event_group,
            WIFI_CONNECTED_BIT | WIFI_FAIL_BIT,
            pdFALSE,
            pdFALSE,
            portMAX_DELAY);
    if (bits & WIFI_CONNECTED_BIT) {
        ESP_LOGI(TAG, "connected to ap SSID:%s password:%s",
                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    } else if (bits & WIFI_FAIL_BIT) {
        ESP_LOGI(TAG, "Failed to connect to SSID:%s, password:%s",
                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    }
    /* The event will not be processed after unregister */
    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(IP_EVENT, IP_EVENT_STA_GOT_IP, &instance));
    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(WIFI_EVENT, ESP_EVENT_ANY_ID, &instance));
    vEventGroupDelete(s_wifi_event_group);
}
void app_main(void) {
    // 初始化并连接 WiFi
    wifi_init_sta();
    // 连接成功后，可以在这里做其他事情，比如创建 TCP 服务器、HTTP 客户端等
    ESP_LOGI(TAG, "App main started!");
    while(1) {
        // 主循环
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

代码解释：

1. 头文件: 引入了 ESP-IDF 的各种核心组件，如 FreeRTOS 任务、事件组、WiFi 和网络接口。
2. 宏定义: 定义了你的 WiFi 信息 (SSID, PASSWORD)、事件位和最大重试次数。
3. event_handler: 这是核心的事件处理函数，ESP-IDF 使用事件驱动模型。
   • WIFI_EVENT_STA_START: WiFi 启动,开始连接。
   • WIFI_EVENT_STA_DISCONNECTED: 断开连接,自动重连。
   • IP_EVENT_STA_GOT_IP: 成功获取到 IP 地址,表示连接成功。
4. wifi_init_sta: 这是 WiFi 初始化和连接的函数，包含了所有必要的步骤：创建事件组、初始化 LwIP、注册事件回调、配置 WiFi 参数、启动 WiFi 等。
5. app_main: 这是 ESP-IDF 程序的入口函数，类似于 C 语言的 main()，我们在这里调用 wifi_init_sta() 来启动连接过程。

编译和烧录

1. 修改代码：将 main.c 中的 Your_WiFi_SSID 和 Your_WiFi_Password 替换成你自己的 WiFi 信息。
2. 编译：
   • 在 VS Code 中，按 F1，输入 ESP-IDF: Build Project。
   • 或者打开 VS Code 的集成终端 (Ctrl+``)，输入idf.py build`。
3. 烧录：
   • 将 NodeMCU 用 USB 线连接到电脑。
   • 在 VS Code 的集成终端中，输入 idf.py -p COMX flash monitor (将 COMX 替换成你的 NodeMCU 的串口号，COM3)。
   • -p COMX 指定端口，flash 表示烧录，monitor 表示打开串口监视器。

查看结果

烧录成功后，串口监视器会输出日志,你会看到类似下面的信息：

I (352) wifi_station: wifi_init_sta finished.
I (352) wifi_station: Wi-Fi connecting...
I (452) wifi_station: got ip:192.168.1.108
I (452) wifi_station: connected to ap SSID:Your_WiFi_SSID password:Your_WiFi_Password
I (452) wifi_station: App main started!

这表示你的 NodeMCU 已经成功通过 C 语言连接到了 WiFi！

总结与进阶

• 从零开始: 使用 ESP-IDF 开发 ESP8266/ESP32 是一个完整的学习过程，虽然初期配置稍显复杂，但一旦环境搭建好,后续开发会非常顺畅。
• 官方文档是最佳资源: ESP-IDF 官方文档 是你最好的老师，里面有详细的教程、API 参考和示例。
• 进阶方向:
  1. TCP/UDP 通信: 连接成功后，你可以学习如何创建 TCP 客户端/服务器或 UDP 通信。
  2. HTTP/HTTPS 客户端: 让你的设备向服务器发送数据或获取网页内容。
  3. MQTT 协议: 学习使用 MQTT,这是物联网领域最常用的轻量级通信协议。
  4. 传感器集成: 连接各种传感器（如 DHT11, BMP280）并采集数据通过 WiFi 上传。

希望这个详细的指南能帮助你顺利开启 NodeMCU 的 C 语言 WiFi 开发之旅！