ESP32与Qt Creator实现低成本WiFi信号三维可视化

1. 项目背景与核心价值

这个项目源于我在智能家居开发中遇到的一个实际问题：如何在不破坏装修的情况下，可视化房屋内的WiFi信号分布。传统方案要么需要专业设备，要么只能获得抽象的信号强度数值。于是我用ESP32开发板和Qt Creator搭建了一套低成本的空间信号可视化系统，能够实时显示三维空间中的WiFi信号热力图。

整套方案硬件成本控制在200元以内，软件完全开源。特别适合以下场景：

• 家庭用户优化路由器摆放位置
• 办公室部署无线网络时的信号测试
• 物联网教学中的无线信号可视化案例
• 智能家居安装调试时的信号诊断工具

2. 硬件系统设计

2.1 ESP32选型与配置

选用ESP32-WROOM-32D模组的核心考量：

• 内置WiFi和蓝牙双模（本项目仅使用WiFi功能）
• 足够的外设接口（本项目用到ADC和UART）
• 低功耗特性（移动测量时可用电池供电）
• 成熟的开发社区支持

关键硬件配置要点：

cpp复制// ESP32 WiFi扫描配置
wifi_country_t country = {
    .cc = "CN",
    .schan = 1,
    .nchan = 13,
    .max_tx_power = 80,
    .policy = WIFI_COUNTRY_POLICY_AUTO
};
ESP_ERROR_CHECK(esp_wifi_set_country(&country));

2.2 传感器网络搭建

为实现空间定位，系统采用多基站架构：

1. 主控节点：搭载ESP32的开发板，负责信号采集
2. 信标节点：3个固定位置的ESP32模块作为位置参考
3. 移动终端：手机或平板运行Qt可视化程序

基站部署建议：

• 至少3个信标节点形成三角定位
• 节点间距建议2-5米（视空间大小调整）
• 高度建议1.2-1.5米（常规使用高度）

3. 软件架构实现

3.1 ESP32固件开发

信号采集核心逻辑：

1. 启动WiFi扫描获取周边AP列表
2. 记录每个AP的MAC地址和RSSI值
3. 通过三边定位算法计算当前位置
4. 通过蓝牙或串口上传数据

关键代码片段：

cpp复制void wifi_scan_handler(void *pvParameters) {
    while(1) {
        wifi_scan_config_t scanConf = {
            .ssid = NULL,
            .bssid = NULL,
            .channel = 0,
            .show_hidden = true
        };
        ESP_ERROR_CHECK(esp_wifi_scan_start(&scanConf, true));
        
        uint16_t apCount = 0;
        esp_wifi_scan_get_ap_num(&apCount);
        wifi_ap_record_t *apList = malloc(apCount * sizeof(wifi_ap_record_t));
        ESP_ERROR_CHECK(esp_wifi_scan_get_ap_records(&apCount, apList));
        
        // 数据处理和传输
        process_scan_results(apList, apCount);
        free(apList);
        vTaskDelay(pdMS_TO_TICKS(SCAN_INTERVAL));
    }
}

3.2 Qt可视化程序开发

3.2.1 三维场景构建

使用Qt3D模块创建可视化环境：

• 导入房屋CAD模型或手动绘制简单结构
• 建立三维坐标系系统
• 实现可交互的视角控制

核心类结构：

cpp复制class SignalMap : public Qt3DCore::QEntity {
    Q_OBJECT
public:
    explicit SignalMap(Qt3DCore::QNode *parent = nullptr);
    void updateHeatMap(const QVector<SignalPoint> &points);
    
private:
    Qt3DRender::QMesh *m_roomMesh;
    QVector<Qt3DExtras::QSphereMesh*> m_signalPoints;
    Qt3DExtras::QDiffuseSpecularMaterial *m_material;
};

3.2.2 热力图渲染算法

采用改进的Kriging插值算法：

1. 将空间划分为1m×1m×0.5m的体素网格
2. 对每个体素计算信号强度加权平均值
3. 应用颜色映射（红-黄-绿-蓝表示强到弱）

颜色映射实现：

cpp复制QColor SignalVisualizer::getColorForStrength(float dbm) {
    // dBm范围通常在-30到-90之间
    float normalized = (dbm + 30) / (-90 + 30);
    normalized = qBound(0.0f, normalized, 1.0f);
    
    if(normalized < 0.25) {
        return QColor::fromRgbF(0, 0, 1 - normalized*4);
    } else if(normalized < 0.5) {
        return QColor::fromRgbF(0, (normalized-0.25)*4, 1);
    } else if(normalized < 0.75) {
        return QColor::fromRgbF((normalized-0.5)*4, 1, 1 - (normalized-0.5)*4);
    } else {
        return QColor::fromRgbF(1, 1 - (normalized-0.75)*4, 0);
    }
}

4. 系统集成与校准

4.1 硬件组装要点

推荐配置清单：

组装注意事项：

1. 信标节点天线朝向应保持一致
2. 避免金属物体靠近天线
3. 主控板与信标节点固件版本需一致
4. 首次使用前需充满电

4.2 系统校准流程

三阶段校准法：

1. 位置校准

   • 将移动终端放置在已知坐标点
   • 记录各信标RSSI值
   • 计算路径损耗系数

2. 方向校准

   • 旋转设备记录信号变化
   • 建立天线方向模型

3. 环境校准

   • 在不同材质表面测试
   • 建立材质衰减参数表

校准数据存储格式示例：

json复制{
    "calibration_points": [
        {
            "x": 1.0,
            "y": 2.0,
            "z": 0.5,
            "readings": [
                {"beacon": "B1", "rssi": -65},
                {"beacon": "B2", "rssi": -72},
                {"beacon": "B3", "rssi": -68}
            ]
        }
    ],
    "environment_factors": {
        "wall_attenuation": 8.5,
        "floor_attenuation": 12.2
    }
}

5. 实测效果与优化

5.1 典型场景测试数据

在80平米公寓中的测试结果：

5.2 常见问题排查指南

问题1：定位漂移严重

• 检查信标节点是否移动
• 重新运行位置校准
• 确认环境无大型金属物体

问题2：热力图刷新卡顿

• 降低Qt3D渲染质量
• 增加扫描间隔时间
• 关闭不必要的可视化效果

问题3：信号强度突变

• 检查周围是否有新开电器
• 确认路由器信道是否自动切换
• 查看是否有其他2.4GHz设备干扰

6. 进阶开发方向

6.1 多频段支持扩展

当前版本仅支持2.4GHz频段，可通过以下方式扩展：

1. 更换支持5GHz的ESP32模块
2. 修改WiFi扫描配置：

cpp复制wifi_bandwidth_t bw = WIFI_BW_HT40;
esp_wifi_set_bandwidth(WIFI_IF_STA, bw);

6.2 机器学习增强

收集大量数据后可以：

1. 建立信号传播预测模型
2. 实现自动路由器配置推荐
3. 开发信号异常检测功能

训练数据示例结构：

python复制# 输入特征
features = [
    'distance_to_router', 
    'wall_count',
    'material_type',
    'height_difference'
]

# 目标值
target = 'signal_strength'

这个项目最让我惊喜的是ESP32的WiFi扫描性能完全能满足专业级需求。在实际测试中，将扫描间隔设置为500ms时，系统可以稳定运行8小时以上。一个特别实用的技巧是：在Qt程序中添加一个"信号轨迹记录"功能，拿着设备在房间走动后，可以生成最优路由器位置建议。