ESP32 IDF WiFi Mesh中MESH_ROOT能否扫描AP及主备AP回切实现问题

你好，针对你的ESP32 WiFi Mesh根节点扫描AP及主备AP回切的需求，我来帮你梳理下可行的解决方案和当前代码的问题：

一、核心结论：MESH_ROOT完全可以扫描外部AP #

首先明确：MESH_ROOT作为Mesh网络的根节点，工作在Station+SoftAP模式，是支持扫描外部WiFi AP的，你的需求（主AP故障切备、备机运行时检测主AP恢复并回切）完全可以实现。当前你遇到的“只能扫到Mesh节点SoftAP”的问题，是因为解析扫描结果时用错了API。

二、当前代码的关键问题 #

你在examineScanResults函数中使用了esp_mesh_scan_get_ap_record，这个API是专门用来获取Mesh网络内其他节点的SoftAP记录的，只会返回带有Mesh标识的AP（也就是你日志里看到的ESPM_开头的SSID）。如果你要检测的主备AP是普通WiFi AP（非Mesh节点），自然拿不到它们的扫描结果。

三、调整后的完整实现方案 #

1. 修正扫描触发逻辑（优化配置）

你当前用esp_wifi_scan_start触发扫描是可行的，但建议优化扫描参数，提升普通AP的扫描成功率：

// 调整扫描配置，针对普通AP优化
wifi_scan_config_t scan_config = {
    .show_hidden = 1,
    .scan_type = WIFI_SCAN_TYPE_PASSIVE,
    .passive_scan_time = {
        .min = 150,  // 每个信道驻留最小时间（ms），确保能捕获被动帧
        .max = 250
    },
    .channel = 0,  // 0表示扫描所有信道，若主备AP固定信道可改为对应值
};
esp_wifi_scan_start(&scan_config, 0);

2. 修正扫描结果解析逻辑（改用普通WiFi API）

当MESH_EVENT_SCAN_DONE事件触发后，使用普通WiFi API获取AP记录，这样就能拿到主备AP的信息：

case MESH_EVENT_SCAN_DONE: {
    mesh_event_scan_done_t *scan_done = (mesh_event_scan_done_t *)event_data;
    ESP_LOGI(TAG, "<MESH_EVENT_SCAN_DONE>number:%d", scan_done->number);
    // 传入扫描到的总AP数
    examineScanResults(scan_done->number);
} break;

void examineScanResults(int total_ap_num) {
    ESP_LOGW(TAG, "examineScanResults: total APs found = %d", total_ap_num);
    wifi_ap_record_t ap_record;
    const char* PRIMARY_AP_SSID = "你的主AP SSID"; // 替换为实际主AP SSID
    static int primary_ap_detected_count = 0; // 用于多次确认避免误判

    for (int i = 0; i < total_ap_num; i++) {
        // 使用普通WiFi API获取单条AP记录
        ESP_ERROR_CHECK(esp_wifi_scan_get_ap_record(&ap_record, &i));
        
        ESP_LOGI(TAG, "AP [%d] | SSID: %s | BSSID: "MACSTR" | Channel: %d | RSSI: %d",
                 i, ap_record.ssid, MAC2STR(ap_record.bssid), ap_record.primary, ap_record.rssi);

        // 检测主AP是否恢复
        if (strcmp((char*)ap_record.ssid, PRIMARY_AP_SSID) == 0) {
            primary_ap_detected_count++;
            // 连续2次扫描到主AP再触发切换，避免信号波动误判
            if (primary_ap_detected_count >= 2) {
                ESP_LOGI(TAG, "主AP已稳定恢复，开始切换回主AP...");
                switchBackToPrimaryAP(); // 实现切换逻辑
                primary_ap_detected_count = 0; // 重置计数
                break;
            }
        }
    }
    // 本次扫描未检测到主AP，重置计数
    if (primary_ap_detected_count > 0 && primary_ap_detected_count < 2) {
        primary_ap_detected_count = 0;
    }
}

3. 实现主备AP切换逻辑

当确认主AP恢复后，需要让MESH_ROOT重新连接主AP，并同步Mesh网络：

void switchBackToPrimaryAP(void) {
    // 1. 先断开当前与备AP的Station连接
    ESP_ERROR_CHECK(esp_wifi_disconnect());
    
    // 2. 配置主AP的连接参数
    wifi_config_t sta_config = {
        .sta = {
            .ssid = "你的主AP SSID",
            .password = "你的主AP密码",
            // 若主AP固定BSSID，可设置bssid_set=1并填充bssid字段
        },
    };
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &sta_config));
    
    // 3. 重新连接主AP
    ESP_ERROR_CHECK(esp_wifi_connect());
    
    // 4. 重新初始化Mesh根节点，确保整个Mesh网络同步
    ESP_ERROR_CHECK(esp_mesh_set_root(true));
}

四、注意事项 #

• 扫描周期控制：不要过于频繁扫描（建议30-60秒一次），避免占用WiFi射频资源影响Mesh网络稳定性。
• 误判避免：增加多次扫描确认主AP存在的逻辑，避免因信号波动导致的频繁切换。
• 日志调试：开启CONFIG_LOG_DEFAULT_LEVEL_DEBUG，查看WiFi连接、Mesh事件的详细日志，方便定位问题。

内容来源于stack exchange