ESP32的WiFi配置功能连接路由器局域网AP/STA模式控制教程

2388

ydxhuo.com

ESP32Wi-Fi配置

一：功能介绍

ESP32 之所以被称为“物联网神卡”，核心原因就在于它集成了强大的 Wi-Fi 和蓝牙功能。

在 Wi-Fi 开发中，主要有两种模式：

1.AP 模式 (Access Point)：ESP32 自己产生热点，手机连接它（像配置路由器一样）。

2.STA 模式 (Station)：ESP32 像手机一样连接家里的路由器（本章重点）。

连接上路由器后，ESP32 就拥有了访问互联网的能力，可以进行 NTP 对时、MQTT 通信、HTTP 请求等操作。

本期所用到的硬件：ESP32-S3 开发板、USB-TypeC数据线

网络环境：2.4 GHz Wi-Fi 网络（注意：ESP32-S3 不支持 5 GHz 频段 Wi-Fi）。

软件环境：Arduino IDE ，且已安装 ESP32 开发板（推荐 2.0.14 或以上版本）。

二：编程逻辑

1.引入头文件与定义网络凭证

#include 

// 替换为你的 Wi-Fi 名称和密码
const char* ssid     = "Your_WiFi_Name";
const char* password = "Your_WiFi_Password";

2.初始化串口wifi模式

进入 setup() 函数，将芯片设置为 Station 模式（客户端模式）并启动连接：

void setup() {
  Serial.begin(115200);
  delay(1000); // 留出时间让串口初始化

  Serial.println("\n正在初始化 Wi-Fi...");

  // 设置为客户端模式
  WiFi.mode(WIFI_STA);

  // 发起连接
  WiFi.begin(ssid, password);

  // 轮询等待连接成功
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println("\nWi-Fi 连接成功！");
  Serial.print("IP 地址: ");
  Serial.println(WiFi.localIP());
}

3.断线重连机制

在实际项目中，网络可能会短暂中断。仅靠基础代码在断线后无法自动恢复，以下提供包含自动重连与状态监测的完整代码：

#include 

const char* ssid     = "Your_WiFi_Name";
const char* password = "Your_WiFi_Password";

// 记录上次检查时间，避免阻塞 loop
unsigned long previousMillis = 0;
const unsigned long interval = 10000; // 每 10 秒检查一次连接状态

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

  WiFi.mode(WIFI_STA);
  // 启用自动重连特性（ESP32 SDK 默认提供支持）
  WiFi.setAutoReconnect(true);

  Serial.print("正在连接到 ");
  Serial.println(ssid);

  WiFi.begin(ssid, password);

  int timeout = 0;
  while (WiFi.status() != WL_CONNECTED && timeout < 20) { // 10秒超时
    delay(500);
    Serial.print(".");
    timeout++;
  }

  if (WiFi.status() == WL_CONNECTED) {
    Serial.println("\n[系统] Wi-Fi 连接成功！");
    Serial.print("[系统] IP 地址: ");
    Serial.println(WiFi.localIP());
    Serial.print("[系统] 信号强度 (RSSI): ");
    Serial.print(WiFi.RSSI());
    Serial.println(" dBm");
  } else {
    Serial.println("\n[错误] 初次连接超时，后台将继续尝试重连...");
  }
}

void loop() {
  unsigned long currentMillis = millis();

  // 定时检查 Wi-Fi 连接状态
  if (currentMillis - previousMillis >= interval) {
    previousMillis = currentMillis;

    if (WiFi.status() == WL_CONNECTED) {
      Serial.println("[状态] Wi-Fi 保持连接");
    } else {
      Serial.println("[警告] Wi-Fi 已断开，正在尝试重新连接...");
      WiFi.disconnect();
      WiFi.reconnect();
    }
  }

  // 此处放置你的主要业务逻辑代码
}