ESP32-S3 双模式切换实现：兼顾手机_路由器连接与WiFi长距离通信

SmartRadio2026-04-30 22:30

ESP32-S3 双模式切换实现：兼顾手机/路由器连接与WiFi长距离通信

在ESP32开发中，我们常常会遇到一个矛盾：想让设备既能连接手机、路由器（标准WiFi），又需要实现远距离通信（比如几百米到1公里）。而ESP32-S3的WiFi LR（Long Range）模式，恰好能解决这个问题------它支持软件动态切换"标准WiFi模式"和"LR长距离模式"，无需硬件改动，既能连手机、路由器，又能和另一个ESP32-S3实现远距离通信。

本文将从原理、硬件准备、完整代码、实操步骤、避坑指南五个方面，手把手教你实现ESP32-S3双模式切换，全程可落地、可复现，适合新手入门和项目开发。

一、核心原理：为什么能实现双模式切换？

首先要明确一个关键前提：只有ESP32-S3和ESP32-S2支持WiFi LR模式，原版ESP32、ESP32-C3/C2等型号不支持，刷固件也无法实现，这一点一定要注意，避免踩坑。

ESP32-S3的双模式切换，核心是利用其WiFi协议的动态配置能力，实现两种模式的实时切换，无需重启设备，切换耗时仅毫秒级，具体原理如下：

1. 两种模式的核心区别

模式类型 协议标准 通信对象 通信距离 速率 核心用途
标准WiFi模式 802.11b/g/n（公共协议） 手机、路由器、电脑等普通WiFi设备 50~100m（普通环境） 全速（最高150Mbps） 联网、数据上传、手机控制
LR长距离模式 乐鑫私有WiFi协议（非公共） 仅ESP32-S3/ESP32-S2设备 视距800~1200m（高增益天线） 1~2Mbps（低速率） 远距离控制、传感器数据传输

2. 切换逻辑（核心步骤）

双模式切换的关键的是"先断后切再重启"，三步即可完成，全程无需重启设备：

  1. 停止当前WiFi连接，断开所有关联（避免协议冲突）；

  2. 重新配置WiFi协议（切换到目标模式：标准/LR）；

  3. 重启WiFi驱动，进入新模式，完成切换。

整个切换过程耗时<200ms，用户几乎无感知，适合需要频繁切换模式的场景。

二、硬件准备（极简配置，新手可直接采购）

硬件无需复杂改动，核心是选择支持LR模式的芯片和合适的天线，具体清单如下（性价比优先）：

1. 核心硬件（必选）

  • 主控芯片：ESP32-S3开发板（推荐ESP32-S3-DevKitC-1，资料多、稳定性强）；

  • 天线：外接2.4G高增益天线（5~8dBi，SMA接口），不要用板载天线（板载天线距离最多100m，无法发挥LR模式优势）；

  • 电源：3.3V/2A稳定电源（LR模式高功率发射时，电流可达400~500mA，普通USB供电可能掉压断连）；

  • 按键：1个独立按键（用于手动切换模式，可选，也可改为自动切换）；

  • 杜邦线：若干（连接按键）。

2. 可选硬件（进一步提升距离）

如果需要更远距离（2~3km视距），可增加射频前端模块：

  • PA（功率放大）+ LNA（低噪放）：如SKY65386，可将发射功率提升到+30dBm（1W），距离翻倍；

  • 屏蔽壳：减少外界干扰，提升通信稳定性。

3. 硬件接线（极简）

仅需连接按键（手动切换用），其他硬件无需额外接线：

  • 按键一端接ESP32-S3的GPIO0引脚；

  • 按键另一端接GND；

  • GPIO0自带内部上拉电阻，无需额外串联电阻（简化接线）。

三、完整实现代码（ESP-IDF 5.1/5.2，直接复制可烧录）

本文采用ESP-IDF框架开发（官方推荐，稳定性强），代码包含：WiFi初始化、双模式切换、按键检测、串口日志输出，注释详细，新手可直接复制使用，只需修改路由器SSID和密码即可。

1. 代码整体结构

代码分为5个核心模块：WiFi停止/启动、标准模式配置、LR模式配置、按键检测、模式切换，逻辑清晰，可直接复用。

2. 完整代码（含详细注释）

c 复制代码 
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/Task.h"
#include "freertos/queue.h"
#include "esp_log.h"
#include "esp_wifi.h"
#include "nvs_flash.h"
#include "driver/gpio.h"

// 按键配置（用于手动切换模式）
#define KEY_GPIO GPIO_NUM_0  // 按键连接GPIO0
#define TAG "WIFI_DUAL_MODE"  // 日志标签

// 模式定义（枚举，清晰区分两种模式）
typedef enum {
    WIFI_MODE_NORMAL,   // 标准WiFi模式（连路由器/手机）
    WIFI_MODE_LR        // LR长距离模式（ESP32-S3之间通信）
} wifi_work_mode_t;

wifi_work_mode_t current_mode = WIFI_MODE_NORMAL;  // 默认启动标准模式

// 标准模式：路由器信息（请替换为自己的路由器SSID和密码）
#define WIFI_SSID      "Your_Router_SSID"
#define WIFI_PASS      "Your_Router_Password"

// LR模式：AP信息（仅ESP32-S3之间通信用，可自定义）
#define LR_AP_SSID     "ESP32-LR-AP"
#define LR_AP_PASS     "12345678"  // 密码至少8位
#define LR_CHANNEL     6           // 固定信道（1/6/11，无干扰）

// 函数声明（提前声明，避免编译报错）
static void wifi_stop(void);                  // 停止当前WiFi连接
static void wifi_start_normal_sta(void);      // 启动标准模式（连接路由器）
static void wifi_start_lr_ap(void);           // 启动LR模式（AP模式，供其他ESP连接）
static void init_key(void);                   // 初始化按键（检测切换指令）
static void key_scan_task(void *arg);         // 按键扫描任务（实时检测按键）
void wifi_switch_mode(wifi_work_mode_t mode); // 模式切换核心函数

// 【核心函数1】停止WiFi连接（切换模式前必须调用）
static void wifi_stop(void)
{
    esp_wifi_stop();        // 停止WiFi驱动
    esp_wifi_disconnect();  // 断开当前连接
    vTaskDelay(pdMS_TO_TICKS(100));  // 延时100ms，确保完全停止
}

// 【核心函数2】启动标准WiFi模式（STA模式，连接路由器）
static void wifi_start_normal_sta(void)
{
    ESP_LOGI(TAG, "切换到：标准WiFi模式（可连手机/路由器）");

    // 1. 设置标准WiFi协议（802.11bgn）
    esp_wifi_set_protocol(WIFI_IF_STA, WIFI_PROTOCOL_11BGN);
    // 2. 设置WiFi模式为STA（客户端模式，连接路由器）
    esp_wifi_set_mode(WIFI_MODE_STA);

    // 3. 配置路由器连接信息
    wifi_config_t sta_cfg = {
        .sta = {
            .ssid = WIFI_SSID,        // 路由器SSID
            .password = WIFI_PASS,    // 路由器密码
            .threshold.authmode = WIFI_AUTH_WPA2_PSK,  // 加密方式（默认WPA2）
            .pmf_cfg = {
                .capable = true,
                .required = false
            },
        },
    };

    // 4. 应用配置并启动WiFi
    esp_wifi_set_config(WIFI_IF_STA, &sta_cfg);
    esp_wifi_start();
    esp_wifi_connect();  // 连接路由器
}

// 【核心函数3】启动LR长距离模式（AP模式，供其他ESP32-S3连接）
static void wifi_start_lr_ap(void)
{
    ESP_LOGI(TAG, "切换到：LR长距离模式（仅ESP32-S3之间通信）");

    // 1. 设置LR私有协议（关键！）
    esp_wifi_set_protocol(WIFI_IF_AP, WIFI_PROTOCOL_LR);
    // 2. 设置WiFi模式为AP（热点模式，其他ESP作为STA连接）
    esp_wifi_set_mode(WIFI_MODE_AP);

    // 3. 配置LR AP信息
    wifi_config_t ap_cfg = {
        .ap = {
            .ssid = LR_AP_SSID,        // LR热点名称（手机搜不到）
            .password = LR_AP_PASS,    // 热点密码
            .channel = LR_CHANNEL,     // 固定信道，避免干扰
            .authmode = WIFI_AUTH_WPA2_PSK,  // 加密方式
            .max_connection = 3,       // 最大连接数（最多3个ESP设备）
            .beacon_interval = 100,    // 信标间隔，优化长距离通信
        },
    };

    // 4. 应用配置并启动WiFi
    esp_wifi_set_config(WIFI_IF_AP, &ap_cfg);
    esp_wifi_start();

    // 5. 设置最大发射功率（20dBm，ESP32-S3最大，提升距离）
    esp_wifi_set_max_tx_power(20);
}

// 【核心函数4】模式切换（统一入口，调用即可切换）
void wifi_switch_mode(wifi_work_mode_t target_mode)
{
    // 如果目标模式和当前模式一致，无需切换
    if (target_mode == current_mode) {
        ESP_LOGI(TAG, "当前已处于目标模式，无需切换");
        return;
    }

    // 1. 停止当前WiFi连接
    wifi_stop();

    // 2. 根据目标模式，启动对应WiFi模式
    if (target_mode == WIFI_MODE_NORMAL) {
        wifi_start_normal_sta();
    } else {
        wifi_start_lr_ap();
    }

    // 3. 更新当前模式
    current_mode = target_mode;
}

// 【辅助函数1】初始化按键（配置GPIO为输入模式）
static void init_key(void)
{
    gpio_config_t key_cfg = {
        .pin_bit_mask = (1ULL << KEY_GPIO),  // 配置GPIO0
        .mode = GPIO_MODE_INPUT,             // 输入模式
        .pull_up_en = GPIO_PULLUP_ENABLE,    // 启用上拉电阻
        .pull_down_en = GPIO_PULLDOWN_DISABLE, // 禁用下拉电阻
        .intr_type = GPIO_INTR_DISABLE,      // 禁用中断，采用轮询扫描
    };
    gpio_config(&key_cfg);  // 应用GPIO配置

    // 创建按键扫描任务（实时检测按键按下）
    xTaskCreate(key_scan_task, "key_scan_task", 2048, NULL, 10, NULL);
}

// 【辅助函数2】按键扫描任务（轮询检测，避免中断复杂配置）
static void key_scan_task(void *arg)
{
    static uint8_t last_key_state = 1;  // 按键初始状态（高电平，未按下）
    while (1) {
        // 读取当前按键状态（低电平为按下，高电平为未按下）
        uint8_t current_key_state = gpio_get_level(KEY_GPIO);

        // 检测按键下降沿（按下动作，防抖处理）
        if (current_key_state == 0 && last_key_state == 1) {
            vTaskDelay(pdMS_TO_TICKS(20));  // 20ms防抖，避免误触发
            // 再次读取，确认按键确实按下
            if (gpio_get_level(KEY_GPIO) == 0) {
                // 切换模式：当前是标准模式→切LR，当前是LR→切标准
                if (current_mode == WIFI_MODE_NORMAL) {
                    wifi_switch_mode(WIFI_MODE_LR);
                } else {
                    wifi_switch_mode(WIFI_MODE_NORMAL);
                }
            }
        }

        // 更新上一次按键状态
        last_key_state = current_key_state;
        vTaskDelay(pdMS_TO_TICKS(10));  // 10ms扫描一次，降低CPU占用
    }
}

// 【初始化函数】WiFi初始化（程序入口调用）
void wifi_init(void)
{
    // 1. 初始化NVS（WiFi配置需要存储在NVS中）
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        nvs_flash_erase();
        nvs_flash_init();
    }

    // 2. 初始化网络接口
    esp_netif_init();
    // 3. 创建默认事件循环（处理WiFi连接事件）
    esp_event_loop_create_default();
    // 4. 创建默认STA和AP接口
    esp_netif_create_default_wifi_sta();
    esp_netif_create_default_wifi_ap();

    // 5. 初始化WiFi驱动
    wifi_init_config_t wifi_init_cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&wifi_init_cfg);

    // 6. 默认启动标准WiFi模式（连接路由器）
    wifi_start_normal_sta();
}

// 【程序入口】main函数（启动初始化）
void app_main(void)
{
    wifi_init();  // 初始化WiFi（默认标准模式）
    init_key();   // 初始化按键（用于切换模式）

    // 循环等待，无需做其他操作（任务由FreeRTOS管理）
    while (1) {
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

3. 代码修改说明（必做）

复制代码后，只需修改2处，即可适配你的环境：

  • 替换路由器信息：将 WIFI\_SSID 和 WIFI\_PASS 改为你自己的路由器名称和密码；

  • （可选）修改LR模式参数：LR\_AP\_SSID（LR热点名称）、LR\_AP\_PASS（热点密码）、LR\_CHANNEL（信道），建议保持默认，避免干扰。

四、实操步骤（从烧录到测试，全程手把手）

完成代码修改后，按照以下步骤操作，即可实现双模式切换，全程简单易操作。

1. 环境准备

  • 安装ESP-IDF 5.1或5.2（推荐5.2，兼容性更好）；

  • 将ESP32-S3开发板通过USB连接电脑，安装对应的串口驱动；

  • 打开ESP-IDF终端，进入代码所在目录。

2. 编译与烧录

  1. 执行 idf\.py set\-target esp32s3（指定目标芯片为ESP32-S3）；

  2. 执行 idf\.py menuconfig（可选，无需修改，直接退出即可）；

  3. 执行 idf\.py build（编译代码，首次编译耗时约5~10分钟）；

  4. 执行idf\.py flash monitor（烧录代码并打开串口监控）。

3. 模式切换测试

烧录成功后，开发板会自动启动，默认进入标准WiFi模式，通过串口日志可查看状态，测试步骤如下：

测试1：标准WiFi模式（连路由器/手机）

  • 串口日志会输出 切换到：标准WiFi模式（可连手机/路由器）；

  • 打开手机WiFi，可搜索到你路由器的SSID，开发板会自动连接路由器；

  • 连接成功后，串口会输出路由器分配的IP地址（如192.168.1.100），此时可通过手机/电脑访问该IP，实现数据通信。

测试2：LR长距离模式（ESP32-S3之间通信）

  • 长按按键（GPIO0）20ms以上，开发板会切换到LR模式，串口输出 切换到：LR长距离模式（仅ESP32\-S3之间通信）；

  • 此时，手机WiFi无法搜索到 ESP32\-LR\-AP（正常，因为LR是私有协议）；

  • 用另一块ESP32-S3（烧录相同代码，切换到LR模式），即可连接该热点，实现远距离通信（视距800~1200m）。

测试3：模式切换稳定性

反复按按键切换模式，观察串口日志，确认切换无报错、无卡顿，切换后能正常工作，说明双模式切换成功。

五、进阶优化：自动切换模式（可选）

上面的代码是"手动按键切换"，如果需要实现"自动切换"（比如检测路由器信号弱时，自动切LR模式；回到路由器附近，自动切回标准模式），可添加以下代码（替换按键扫描任务即可）：

c 复制代码 
// 自动切换模式任务（检测路由器信号强度，自动切换）
static void auto_switch_task(void *arg)
{
    int8_t rssi = 0;  // 路由器信号强度（单位dBm，值越大信号越强）
    while (1) {
        if (current_mode == WIFI_MODE_NORMAL) {
            // 读取路由器信号强度
            esp_wifi_sta_get_rssi(&rssi);
            ESP_LOGI(TAG, "当前路由器信号强度：%d dBm", rssi);

            // 信号弱（<-80dBm），自动切换到LR模式
            if (rssi < -80) {
                ESP_LOGI(TAG, "路由器信号过弱，自动切换到LR模式");
                wifi_switch_mode(WIFI_MODE_LR);
            }
        } else {
            // LR模式下，检测是否能搜索到路由器（信号强则切回标准模式）
            wifi_stop();
            esp_wifi_set_mode(WIFI_MODE_STA);
            esp_wifi_set_protocol(WIFI_IF_STA, WIFI_PROTOCOL_11BGN);
            esp_wifi_start();

            // 搜索路由器，等待1秒
            vTaskDelay(pdMS_TO_TICKS(1000));
            esp_wifi_sta_get_rssi(&rssi);

            // 信号强（>-70dBm），自动切回标准模式
            if (rssi > -70) {
                ESP_LOGI(TAG, "检测到路由器强信号，自动切回标准模式");
                wifi_switch_mode(WIFI_MODE_NORMAL);
            } else {
                // 未检测到强信号，继续保持LR模式
                wifi_switch_mode(WIFI_MODE_LR);
            }
        }

        vTaskDelay(pdMS_TO_TICKS(5000));  // 每5秒检测一次
    }
}

替换后，在app\_main中调用xTaskCreate\(auto\_switch\_task, \&\#34;auto\_switch\_task\&\#34;, 4096, NULL, 10, NULL\);，即可实现自动切换。

六、常见坑与避坑指南（必看！）

新手在实现过程中，容易遇到以下问题，提前规避可节省大量时间：

  1. 芯片选错：用了ESP32、ESP32-C3等不支持LR模式的芯片，导致切换失败。解决方案：必须用ESP32-S3或ESP32-S3；

  2. 手机搜不到LR热点：正常现象！LR是乐鑫私有协议，普通WiFi设备（手机、电脑）无法识别，只能用ESP32-S3/S2连接；

  3. 切换模式报错：未先停止WiFi就切换协议，导致协议冲突。解决方案：严格按照"stop→set_protocol→start"的顺序切换；

  4. 通信距离短：用了板载天线，或电源不稳。解决方案：换外接高增益天线，用3.3V/2A稳定电源；

  5. 编译报错 ：ESP-IDF版本过低，或未指定目标芯片。解决方案：升级到ESP-IDF 5.1+，执行idf\.py set\-target esp32s3；

  6. LR模式无法通信：两个ESP32-S3未同时切换到LR模式，或信道不一致。解决方案：确保两个设备都在LR模式，且信道相同（默认6信道）。

七、总结与拓展

ESP32-S3的双模式切换，完美解决了"连手机/路由器"和"远距离通信"的矛盾，无需硬件改动，软件即可实现，适合物联网、远程控制、传感器数据传输等场景。

拓展方向：

  • 添加UDP/TCP通信代码，实现双模式下的数据透传；

  • 结合LoRa模块，进一步提升远距离通信能力（可达3~10km）；

  • 添加OLED屏幕，实时显示当前模式、信号强度等信息；

  • 实现多设备组网，既有标准WiFi联网，又有LR长距离通信。

如果需要Arduino版本的双模式切换代码、LR模式点对点通信完整代码，或自动切换的完整工程，可留言说明，后续补充。

最后，祝大家开发顺利，利用ESP32-S3的双模式，实现更多实用的项目！

相关推荐
laowangpython1 小时前
Rust 入门：GitHub 热门内存安全编程语言
开发语言·其他·rust·github
我叫汪枫2 小时前
在后台管理系统中，如何递归和选择保留的思路来过滤菜单
开发语言·javascript·node.js·ecmascript
_.Switch2 小时前
东方财富股票数据JS逆向：secids字段和AES加密实战
开发语言·前端·javascript·网络·爬虫·python·ecmascript
软件技术NINI2 小时前
webkit简介及工作流程
开发语言·前端·javascript·udp·ecmascript·webkit·yarn
Brendan_0012 小时前
JavaScript的Stomp.over
开发语言·javascript·ecmascript
念2342 小时前
f5 shape分析
开发语言·javascript·ecmascript
苍穹之跃2 小时前
某量JS逆向
开发语言·javascript·ecmascript
思茂信息2 小时前
CST软件如何进行参数化扫描？
运维·开发语言·javascript·windows·ecmascript·软件工程·软件需求
赈早见.琥珀猪2 小时前
vue启动ReferenceError: ReadableStream is not defined
开发语言·javascript·ecmascript
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档032026年4月AI大事件深度解读：大模型竞争进入“深水区“04近期有什么ai的新消息，新动态？ 2026.4月05【AI】2026 年具身智能模型和世界模型总结062026年AI编程工具终极横评：Cursor vs Claude Code vs Copilot07实测可用｜小米 MiMo 百万亿 Token 免费领，开发者速冲08在Windows 11上安装Docker的踩坑记录09裂开！ChatGPT 居然开始要手机号验证，附详细解决方法10要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法