用ESP32-C3打造WiFi信号热力图从硬件扫描到Web可视化实战在智能家居部署或企业级网络调试中工程师常需要评估无线信号的分布质量。传统方式依赖手机APP或专业设备但成本高且灵活性不足。本文将展示如何用ESP32-C3开发板构建一个轻量级WiFi信号扫描器通过Web界面实时可视化信号强度并自动生成信道占用分析。1. 硬件准备与基础扫描ESP32-C3的WiFi模块支持主动扫描Active Scan和被动扫描Passive Scan两种模式。主动扫描会发送探测请求帧能获取更多AP信息被动扫描仅监听信标帧功耗更低但数据有限。我们先配置基础扫描功能#include esp_wifi.h void init_wifi_scan() { wifi_init_config_t cfg WIFI_INIT_CONFIG_DEFAULT(); esp_wifi_init(cfg); esp_wifi_set_mode(WIFI_MODE_STA); esp_wifi_start(); wifi_scan_config_t scan_conf { .scan_type WIFI_SCAN_TYPE_ACTIVE, .scan_time { .active { .min 100, .max 300 } } }; esp_wifi_scan_start(scan_conf, false); }关键参数说明scan_type选择WIFI_SCAN_TYPE_ACTIVE/WIFI_SCAN_TYPE_PASSIVEscan_time.active.min/max单位ms控制每个信道的停留时间扫描结果通过事件回调获取ESP_ERROR_CHECK(esp_event_handler_register(WIFI_EVENT, WIFI_EVENT_SCAN_DONE, [](void* arg, esp_event_base_t base, int32_t id, void* data) { uint16_t ap_num 0; esp_wifi_scan_get_ap_num(ap_num); wifi_ap_record_t* ap_records (wifi_ap_record_t*)malloc(ap_num * sizeof(wifi_ap_record_t)); esp_wifi_scan_get_ap_records(ap_num, ap_records); for(int i0; iap_num; i) { printf(SSID: %s, RSSI: %d, Channel: %d\n, ap_records[i].ssid, ap_records[i].rssi, ap_records[i].primary); } free(ap_records); }, NULL));2. 扫描策略优化技巧2.1 多信道轮询策略在复杂环境中建议采用分时多信道扫描策略类型优点缺点适用场景全信道扫描数据完整耗时长约3s/轮初次环境评估定点信道扫描响应快1s可能遗漏AP实时监控特定信道自适应扫描动态调整信道逻辑复杂长期监测场景实现代码片段// 设置仅扫描信道1/6/11常见非重叠信道 wifi_scan_config_t scan_conf { .scan_type WIFI_SCAN_TYPE_ACTIVE, .channel 0, // 0表示所有信道 .scan_time { .active { .min 120, .max 250 } } }; uint8_t channels[] {1, 6, 11}; esp_wifi_set_channel(sizeof(channels), channels, WIFI_SECOND_CHAN_NONE);2.2 信号滤波算法原始RSSI值存在波动推荐采用**指数加权移动平均(EWMA)**滤波# Python示例实际需移植到C alpha 0.2 # 平滑系数 filtered_rssi [] for raw in raw_rssi_values: if not filtered_rssi: filtered_rssi.append(raw) else: filtered_rssi.append(alpha * raw (1-alpha) * filtered_rssi[-1])提示RSSI采样间隔建议≥500ms过高的扫描频率可能导致设备过热3. Web可视化界面搭建3.1 轻量级Web服务器使用ESP-IDF内置的HTTP Server组件static httpd_handle_t start_webserver() { httpd_config_t config HTTPD_DEFAULT_CONFIG(); httpd_handle_t server NULL; // 注册URI处理函数 httpd_uri_t scan_api { .uri /api/scan, .method HTTP_GET, .handler scan_data_handler, .user_ctx NULL }; if (httpd_start(server, config) ESP_OK) { httpd_register_uri_handler(server, scan_api); } return server; }3.2 前端热力图实现采用Chart.js绘制实时信号热力图!DOCTYPE html html head script srchttps://cdn.jsdelivr.net/npm/chart.js/script style #heatmap { width: 100%; max-width: 800px; margin: 0 auto; } /style /head body div idheatmap canvas idchannelChart/canvas /div script const ctx document.getElementById(channelChart).getContext(2d); const chart new Chart(ctx, { type: bar, data: { labels: [CH1, CH6, CH11], datasets: [{ label: 信号强度(dBm), data: [-65, -72, -68], backgroundColor: [ rgba(255, 99, 132, 0.7), rgba(54, 162, 235, 0.7), rgba(255, 206, 86, 0.7) ] }] }, options: { responsive: true, scales: { y: { beginAtZero: false, max: -30, min: -90 } } } }); setInterval(() { fetch(/api/scan).then(res res.json()).then(data { chart.data.datasets[0].data data.rssi; chart.update(); }); }, 2000); /script /body /html4. 实战智能家居部署辅助4.1 AP部署位置评估通过移动ESP32-C3设备记录不同位置的信号参数测试点主AP RSSI干扰AP数量建议客厅中央-55dBm2理想设备安装位卧室角落-72dBm4需增加中继节点厨房-68dBm3可接受避免关键设备4.2 信道优化方案当检测到信道冲突时自动推荐最优信道void analyze_channels(wifi_ap_record_t* aps, uint16_t count) { int channel_load[14] {0}; // 2.4GHz信道1-14 for(int i0; icount; i) { if(aps[i].primary 1 aps[i].primary 14) { channel_load[aps[i].primary - 1]; } } // 找出负载最低的信道 int best_ch 1; for(int ch0; ch14; ch) { if(channel_load[ch] channel_load[best_ch-1]) { best_ch ch 1; } } printf(推荐使用信道: %d\n, best_ch); }5. 进阶功能扩展5.1 历史数据存储利用ESP32-C3的RTC内存或SPIFFS文件系统保存扫描记录void save_scan_results(wifi_ap_record_t* aps, uint16_t count) { FILE* f fopen(/spiffs/scan_log.csv, a); if(f) { fprintf(f, timestamp,ssid,rssi,channel\n); for(int i0; icount; i) { fprintf(f, %lld,%s,%d,%d\n, esp_timer_get_time()/1000, aps[i].ssid, aps[i].rssi, aps[i].primary); } fclose(f); } }5.2 低功耗模式优化通过调整扫描参数实现电池供电wifi_scan_config_t low_power_scan { .scan_type WIFI_SCAN_TYPE_PASSIVE, .scan_time { .passive 1000, // 每个信道监听1s }, .home_chan_dwell_time 100 // 主信道额外监听时间 };实际测试发现在每10分钟扫描一次的频率下500mAh电池可续航约72小时。