ESPARGOS pyespargos 开源项目教程

ESPARGOS pyespargos 开源项目教程

pyespargos The python library for working with the ESPARGOS WiFi channel sounder 项目地址: https://gitcode.com/gh_mirrors/py/pyespargos

1. 项目介绍

ESPARGOS pyespargos 是一个用于与 ESPARGOS WiFi 信道声音器进行交互的 Python 客户端库。ESPARGOS 是一个实时能力的、相位同步的 2 × 4 WiFi 天线阵列，基于 Espressif ESP32 芯片构建，便于开发和应用 WiFi 感知应用程序。目前，pyespargos 仅支持 HT40 数据包（40MHz 宽通道）。

2. 项目快速启动

在开始使用 pyespargos 之前，请确保您的系统已经安装了 pip。以下是快速启动项目的步骤：

首先，安装 pyespargos：

pip install pyespargos

如果您希望全局安装（而不是在虚拟环境中），可能需要使用：

sudo pip install --break-system-packages pyespargos

接下来，使用以下代码样例来开始与 ESPARGOS 设备的通信：

#!/usr/bin/env python3
import espargos
import time

# 创建一个 Board 对象，指定 ESPARGOS 设备的 IP 地址
pool = espargos.Pool([espargos.Board("192.168.1.2")])

# 启动池
pool.start()

# 进行校准，这里设置为 2 秒
pool.calibrate(duration=2)

# 创建一个 CSIBacklog 对象来缓存CSI数据
backlog = espargos.CSIBacklog(pool, size=20)
backlog.start()

# 等待一段时间，以收集一些 WiFi 数据包
time.sleep(4)

# 获取 HT40 格式的 CSI 数据
csi_ht40 = backlog.get_ht40()

# 打印 CSI 数据
print("Received CSI:", csi_ht40)

# 停止缓存和池
backlog.stop()
pool.stop()

确保替换 "192.168.1.2" 为您的 ESPARGOS 设备的实际 IP 地址。

3. 应用案例和最佳实践

pyespargos 提供了多种演示应用程序，用于测试 ESPARGOS 的功能，以下是一些应用案例：

• music-spectrum: 使用 MUSIC 算法显示空间（角）频谱。演示了到达角（AoA）的估计。
• phases-over-space: 显示每个 ESPARGOS 天线的平均接收相位。
• instantaneous-csi: 绘制测量的当前通道的频率域或时域传递函数。
• phases-over-time: 绘制每个天线随时间变化的平均接收相位。

这些案例可以帮助您了解如何使用 pyespargos 来分析和处理 WiFi 信道状态信息。

4. 典型生态项目

ESPARGOS pyespargos 作为 WiFi 感知领域的一个工具，可以与其他开源项目配合使用，以下是一些典型的生态项目：

• espargos-dataset-recorder: 用于记录 ESPARGOS 数据集以便发布的工具。
• realtime-localization: 实时定位演示，包括信道绘图、三角测量和监督训练等。

这些项目扩展了 ESPARGOS pyespargos 的功能，使其可以应用于更广泛的场景，如定位、监测和数据分析等。

pyespargos The python library for working with the ESPARGOS WiFi channel sounder 项目地址: https://gitcode.com/gh_mirrors/py/pyespargos