wi-fi 热图映射工具（whm）技术文档

wi-fi 热图映射工具（whm）技术文档

wifi-heat-mapper whm also known as wifi-heat-mapper is a Python library for benchmarking Wi-Fi networks and gather useful metrics that can be converted into meaningful easy-to-understand heatmaps. 项目地址: https://gitcode.com/gh_mirrors/wi/wifi-heat-mapper

概览

wi-fi 热图映射工具（whm），全称 wifi-heat-mapper，是一个专为Python设计的库，用于评估Wi-Fi网络性能并生成易懂的热力图。该工具特别适合网络工程师、系统管理员以及家庭实验室用户，旨在简化无线网络性能的分析过程。尽管它提供对WiFi表现的基本理解，但并非一个全面的测试解决方案。

安装指南

必要依赖项安装

确保您的环境满足以下条件：

• 操作系统: Linux x86_64
• Python版本: 3.7到3.9之间，并且需要Tkinter模块。
• 其他Python库：iperf3, matplotlib, tqdm, Pillow, scipy, numpy, PySimpleGUI。

对于Tkinter，您可能需要手动安装：

• Arch Linux和Manjaro: pacman -S tk
• Fedora, CentOS, RHEL, RockyLinux: dnf install python3-tkinter
• Debian和Ubuntu: apt install python3-tk
• openSUSE和SUSE: zypper install python3-tk
• Gentoo: 参考官方文档

whm包的安装

推荐通过pip安装whm：

pip install whm

或通过克隆源码来安装：

git clone https://github.com/Nischay-Pro/wifi-heat-mapper.git
cd wifi-heat-mapper
python3 setup.py install

使用说明

配置服务器与客户端

1. 服务器配置：在LAN中的某台机器上运行iperf3 -s启动iperf3服务器模式。

2. 客户端配置：

   • 执行whm bootstrap以初始化配置，选择想要的图表类型、重复次数、无线接口等。若使用librespeed-cli，可指定是否优先使用，并可自定义服务器列表路径。
   • 配置完成后，将生成config.json文件。

进行基准测试

• 在配置好后，使用命令来执行测试，例如：

  whm benchmark -m 地图图片路径 -s 服务器IP -c 配置文件路径
  

  其中-m是地图图像的位置，-s是iperf3服务器的地址，默认端口为5201，-c指明配置文件位置。

交互界面操作

• 点击画布添加测试点，右键进行基准测试、删除点或标记为基站。
• 至少需要4个点来进行热图生成。
• 测试结果自动保存，完成后再使用Plot绘制热图或直接通过whm plot命令指定选项绘图。

API使用文档

whm直接通过脚本调用时，并未明确提供一个公开的API文档，其主要通过命令行接口与用户互动。但是，理论上，其内部函数可以通过导入whm库并在Python脚本中调用，具体细节需查看源代码或贡献者提供的示例代码。

项目安装方式总结

安装whm有两途径：使用pip快速安装或者从GitHub下载源码编译安装。确保遵循上述依赖安装步骤，然后即可开始利用whm进行Wi-Fi网络的详细分析与热图绘制。记得配置适当的环境和依赖以保证最佳使用体验。

wifi-heat-mapper whm also known as wifi-heat-mapper is a Python library for benchmarking Wi-Fi networks and gather useful metrics that can be converted into meaningful easy-to-understand heatmaps. 项目地址: https://gitcode.com/gh_mirrors/wi/wifi-heat-mapper