ESPARGOS Python Client Library 安装与配置指南

ESPARGOS Python Client Library 安装与配置指南

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

1. 项目基础介绍

ESPARGOS Python Client Library 是一个用于与 ESPARGOS WiFi 信道声音器进行交互的 Python 库。ESPARGOS 是一个基于 Espressif ESP32 芯片构建的实时、相位同步的 2x4 WiFi 天线阵列，它支持 WiFi 感测应用程序的开发和部署。此库目前处于开发阶段，当前支持 HT40 数据包（40MHz 宽通道）。

2. 项目使用的关键技术和框架

• 编程语言：Python
• 关键技术：
  • WiFi 信道状态信息（CSI）提取
  • MUSIC 算法进行角度到达（AoA）估计
  • 802.11g/n 帧的 L-LTF 和 HT-LTF 字段处理
  • 相位同步 ESP32 SoCs
  • HTTP / WebSockets API 通信

3. 安装和配置准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：支持 Python 的操作系统（如 Ubuntu、Windows、macOS）
• Python 版本：Python 3.x
• 网络：确保您的计算机可以访问到 ESPARGOS 设备的 HTTP / WebSockets API

安装步骤

步骤 1：安装 Python 和 pip

确保您的系统中已安装 Python 3.x，以及 pip 包管理器。

# 对于 macOS 或 Linux
sudo apt-get install python3 python3-pip

# 对于 Windows
# 下载并安装 Python，确保勾选 "Add Python to PATH"
# 打开命令提示符，执行以下命令安装 pip
python -m ensurepip --upgrade
python -m pip install --upgrade pip

步骤 2：安装 pyespargos 库

使用 pip 命令安装 pyespargos 库。

pip install pyespargos

如果您需要将 pyespargos 安装为系统范围内的包，您可能需要使用 sudo（对于 macOS 或 Linux）。

sudo pip install pyespargos

步骤 3：安装依赖的 Python 包

某些演示可能需要额外的 Python 包，如 PyQt6。您可以使用 pip 安装这些依赖项。

pip install PyQt6

步骤 4：配置 ESPARGOS 设备

确保您的 ESPARGOS 设备已经连接到网络，并且您知道它的 IP 地址。您将需要在 pyespargos 库中使用此 IP 地址。

步骤 5：运行示例代码

下面是一个简单的示例代码，用于启动 pyespargos 库并从 ESPARGOS 设备获取 CSI 数据。

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

# 创建一个包含 ESPARGOS 设备 IP 地址的池
pool = espargos.Pool([
    espargos.Board("192.168.1.2")
])

# 开始池
pool.start()

# 进行校准
pool.calibrate(duration=2)

# 创建一个 CSI 后备缓冲区
backlog = espargos.CSIBacklog(pool, size=20)

# 开始后备缓冲区
backlog.start()

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

# 获取 HT40 数据包
csi_ht40 = backlog.get_ht40()

# 打印接收到的 CSI
print("Received CSI:", csi_ht40)

# 停止后备缓冲区和池
backlog.stop()
pool.stop()

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

以上就是 ESPARGOS Python Client Library 的安装和配置指南。按照这些步骤操作后，您应该能够成功安装库，并与 ESPARGOS 设备进行通信。

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