ESP32 CSI 工具包教程

项目介绍

ESP32 CSI 工具包是一个为研究人员提供的工具，可以直接从 ESP32 微控制器访问信道状态信息（CSI）。通过使用这个工具包，研究人员可以在任何计算机、智能手机或独立设备上进行在线 CSI 处理。ESP32 的小尺寸和这些功能使得研究人员能够以新的方式执行 Wi-Fi 感知和定位等任务，而无需复杂的固件修改。

项目快速启动

环境准备

1. 硬件: ESP32 开发板（如 NodeMCU）
2. 软件:
   • ESP-IDF 开发框架
   • 代码编辑器（如 VSCode）

代码示例

以下是一个简单的示例代码，用于在 ESP32 上启用 CSI 功能并进行基本的数据捕获。

#include <stdio.h>
#include "esp_wifi.h"
#include "esp_event.h"
#include "esp_log.h"
#include "nvs_flash.h"

static const char *TAG = "CSI_Example";

void wifi_init_csi(void)
{
    tcpip_adapter_init();
    ESP_ERROR_CHECK(esp_event_loop_create_default());

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
    ESP_ERROR_CHECK(esp_wifi_start());
    ESP_ERROR_CHECK(esp_wifi_set_csi(true));
}

void app_main(void)
{
    ESP_ERROR_CHECK(nvs_flash_init());
    wifi_init_csi();

    ESP_LOGI(TAG, "CSI is enabled");
}

编译和烧录

1. 使用 ESP-IDF 命令行工具进行编译：

   idf.py build
   

2. 烧录到 ESP32 开发板：

   idf.py -p /dev/ttyUSB0 flash
   

应用案例和最佳实践

Wi-Fi 感知和定位

ESP32 CSI 工具包可以用于实现室内定位和人体检测。通过捕获和分析 CSI 数据，可以精确地确定设备的位置或检测环境中的人体活动。

动态配置和数据捕获

console_test 示例展示了一个交互式控制台，允许动态配置和捕获 CSI 数据，适用于人体活动检测算法。

典型生态项目

ESP-RADAR

ESP-RADAR 是一个基于 ESP32 的雷达系统，利用 CSI 数据进行目标检测和跟踪。它展示了如何将 CSI 技术与现有的物联网设备集成，以实现更高级的功能。

边缘 Wi-Fi 感知

"WiFi Sensing on the Edge: Signal Processing Techniques and Challenges for Real-World Systems" 是一篇详细探讨边缘设备上 Wi-Fi 感知技术的论文，提供了在实际系统中应用 CSI 技术的深入见解。

通过这些应用案例和生态项目，ESP32 CSI 工具包展示了其在无线通信和物联网领域的广泛应用潜力。