1. 项目概述用光点“看见”身边的无线网络你有没有想过我们身边看不见摸不着的WiFi信号其实像一条条繁忙的街道上面跑着各种各样的“数据车辆”这些车辆来来往往有的信号强有的信号弱有的速度快有的速度慢。作为一个喜欢折腾硬件的玩家我总想把这些抽象的信息变得直观可见。于是就有了这个项目一个基于ESP32的WiFi嗅探器它能将周围无线网络的“交通状况”实时地显示在一块16x16的彩色LED阵列上。简单来说这个小设备就像一个无线网络的“雷达屏幕”。它不关心数据包里的具体内容比如你正在浏览什么网页只关注那些“信封”上的信息谁在发送设备的MAC地址、信号从哪个“车道”WiFi信道来、以及信号有多强。然后它把这些信息编码成颜色和亮度投射到LED点阵上。一眼望去你就能看到周围有多少设备在线它们分布在哪些信道上以及各自的信号强度如何。这对于排查家庭WiFi干扰、了解周边网络环境拥挤程度或者单纯作为一个酷炫的桌面摆件都特别有用。这个项目的核心是让ESP32这颗强大的物联网芯片工作在一种特殊的“混杂模式”下。在这种模式下ESP32的WiFi射频模块会像收音机调频一样逐个扫描所有WiFi信道并捕获它能听到的所有数据包帧头。我们从中提取出源MAC地址设备的唯一硬件标识和接收信号强度指示RSSI再经过一番巧妙的数学映射最终驱动WS2812B LED阵列显示出绚丽的动态效果。整个过程硬件连接简单代码逻辑清晰非常适合有一定嵌入式开发基础并对无线网络、数据可视化感兴趣的爱好者动手复现。2. 核心硬件选型与电路设计解析2.1 主控与显示单元为什么是ESP32和WS2812B选择ESP32-WROVER-B作为主控芯片是经过一番考量的。最初我也尝试过更常见的ESP8266但在编译涉及底层WiFi驱动和混杂模式操作的库时遇到了不少兼容性问题。ESP32则不同其双核处理器和更丰富的内存资源为同时运行复杂的网络嗅探逻辑和LED刷新驱动提供了充裕的算力。更重要的是ESP32的WiFi库对“混杂模式”的支持更为成熟和稳定社区资源也异常丰富这大大降低了开发门槛。WROVER版本集成了额外的PSRAM虽然本项目不一定用得上全部但为未来功能扩展比如历史数据记录留足了空间。显示部分我选择了最常见的16x16 WS2812B全彩LED点阵。这种LED每个像素点都集成了驱动芯片只需要一根数据线进行级联控制极大地简化了布线。256个像素点对于呈现13个WiFi信道X轴和信号强度梯度Y轴来说分辨率刚刚好既能清晰表达信息又不会让电路和代码过于复杂。其5V的工作电压也是标准电平方便供电设计。这里有个细节WS2812B对时序要求非常严格数据信号需要是5V逻辑电平而ESP32的GPIO输出是3.3V。直接连接可能导致数据无法被正确识别因此一个电平转换电路是必不可少的。2.2 关键电路电平转换与独立供电方案电平转换是保证项目稳定运行的关键一环。我手头正好有一个现成的双向电平转换模块它内部自带电压调节使用起来非常方便。实际上任何能将3.3V逻辑电平转换为5V的逻辑电平转换器如74HCT125等芯片搭建的电路都可以胜任。回顾起来使用这个集成模块让我节省了一根单独的3.3V供电线。供电设计是本项目的一个重点也是容易踩坑的地方。一个16x16的全白WS2812B点阵在最高亮度下理论峰值电流可能接近15A按每个LED 60mA计算。当然我们实际使用时不会全白且最高亮但瞬间点亮几十个LED的电流冲击也不容小觑。ESP32开发板上的USB口通常只能提供500mA左右的电流远远无法驱动整个LED阵列。因此必须为LED阵列提供独立的、强大的5V电源。我的方案是使用一个5V、3A以上的直流电源适配器通过一个2.1mm的DC插头供电。在电源接入点我并联了一个220μF/16V的电解电容这个电容的作用是“缓冲池”可以吸收LED快速变化时产生的瞬间大电流避免电源电压被拉低而产生抖动这种抖动会导致LED显示闪烁甚至ESP32重启。这是一个非常实用且必要的保护措施。最终的连接关系如下ESP32侧GPIO4数据输出 - 电平转换器低压侧输入端ESP32的GND - 电平转换器GNDESP32的5V引脚注意这是其USB输入经过稳压后的5V输出电流能力有限仅用于给电平转换器供电- 电平转换器5V输入。电平转换器侧高压侧输出端 - LED点阵的“DI”数据输入引脚高压侧GND - LED点阵GND高压侧5V输入 - 此路5V来自外部大功率电源而非ESP32。LED点阵与电源外部电源正极5V同时连接到点阵的“5V”引脚和220μF电容的正极外部电源负极GND同时连接到点阵的“GND”引脚、电容的负极以及电平转换器的GND。务必确保所有单元的GND最终都连接在一起共地是电路正常工作的基础。注意切勿尝试用ESP32的USB口或其板载的5V引脚直接为整个LED点阵供电这极有可能损坏你的ESP32开发板或电脑USB端口。3. 软件原理与代码深度剖析3.1 WiFi混杂模式如何“听到”所有数据包要让ESP32成为WiFi嗅探器核心是将其WiFi网卡设置为“混杂模式”。我们日常的手机、电脑连接WiFi时网卡处于“托管模式”它只会接收目标地址是自己的数据包并自动过滤掉其他无关的数据。这就像在聚会上你只理会喊你名字的人。而“混杂模式”则关闭了这个过滤器。在此模式下网卡会捕获其无线频道上能接收到的所有数据包的副本无论目标地址是谁。这就好比在聚会上你突然能听到房间里所有人的对话开头谁在对谁说话但你并不去仔细听对话的具体内容数据载荷。本项目正是利用这一点我们只解析数据包的“信封”——即MAC帧头部获取源MAC地址谁发送的、信道、信号强度RSSI等信息然后立即丢弃数据包的有效载荷部分这样既实现了监控又最大限度地避免了隐私问题。在代码中这通过esp_wifi_set_promiscuous(true)函数调用来实现。之后我们需要注册一个回调函数esp_wifi_set_promiscuous_rx_cb()。每当有数据包被捕获这个回调函数就会被触发我们可以在其中对数据包进行快速解析。3.2 数据映射算法从MAC地址到绚丽色彩原始数据MAC地址、RSSI、信道需要被映射到LED点阵的坐标和颜色上这是可视化的精髓。X轴映射信道 - 列WiFi在2.4GHz频段有13个信道北美标准。我们的LED点阵有16列。一个简单的线性映射是将信道1映射到第0列信道13映射到第12列第13-15列留空或作为边界。这样每个信道在屏幕上都有一个固定的“车道”。Y轴映射信号强度 - 行接收信号强度指示RSSI是一个负值单位是dBm。数值越大越接近0信号越强。通常-30dBm是极强信号靠近路由器-100dBm是极弱信号即将断开。我们将这个范围线性映射到16行上例如-30dBm对应最底部的第15行视觉上信号强在更直观-100dBm对应最顶部的第0行。这样信号强的设备在屏幕上显示的位置就更低、更醒目。颜色映射MAC地址 - 颜色这是让显示动态多彩的关键。一个MAC地址是6字节48位的全球唯一标识符。前3个字节是组织唯一标识符OUI代表制造商后3个字节由厂商分配相对随机。为了平衡辨识度和隐私我们只取后3个字节来生成颜色。具体做法是将这3个字节24位压缩为RGB565格式即5位红色、6位绿色、5位蓝色共16位。这样同一台设备总会显示为相同的颜色而不同的设备则会因为MAC地址尾部的不同而呈现出不同的色彩实现了“以颜色区分设备”。3.3 动态显示策略衰减与模糊让信号“流动”起来如果只是将实时数据瞬间绘制到屏幕上显示会变得非常闪烁和混乱难以观察信号的变化趋势。因此我引入了一个“衰减模糊”算法这也是代码中最具技巧性的部分。其原理是在每一帧显示刷新前不对整个屏幕进行清屏而是将屏幕上每个像素点的亮度或所有颜色分量乘以一个小于1的衰减系数例如0.9。这样上一帧留下的光点会在这一帧变暗一点。然后再将当前扫描到的新数据以其完整的亮度绘制到对应的像素上。这样做的效果是活跃信号持续发送数据的设备其对应的像素点会被不断“刷新”到最亮保持鲜艳稳定。消失的信号停止发送数据的设备其对应的像素点亮度会随着每一帧逐渐衰减几秒钟后慢慢“淡出”直至熄灭。你可以清晰地看到一个光点慢慢消失的过程。移动的信号如果设备移动导致信号强度或信道发生变化旧位置的光点会衰减新位置会出现亮光形成一种拖尾或移动的视觉效果非常直观。这种处理方式使得静态的LED点阵能够呈现出动态的、带有时间维度的信息让你一眼就能看出哪些信号是稳定的哪些是刚刚出现或消失的极大地提升了可视化的信息量。4. 固件编译、烧录与配置详解4.1 开发环境搭建与库依赖本项目代码基于Arduino框架进行开发这对于大多数爱好者来说是最友好的方式。你需要先安装Arduino IDE并在“开发板管理器”中添加ESP32的支持。具体步骤网上教程很多核心是添加正确的板卡支持网址。代码依赖两个重要的库FastLED这是驱动WS2812B等LED的行业标准库效率极高提供了丰富的颜色控制和显示函数。可以通过Arduino的库管理器直接搜索安装。ESP32 WiFi 底层API这部分已包含在ESP32的Arduino核心中无需额外安装。我们需要调用的是WiFi.h和esp_wifi.h等头文件提供的底层函数。项目的源代码我托管在GitHub上。你可以直接下载整个仓库。打开主.ino文件后Arduino IDE会自动识别同文件夹内的其他源文件。4.2 关键参数配置与自定义在代码的开头你会找到一系列#define宏定义这是你需要根据自己硬件进行调整的地方。// 硬件配置 #define LED_PIN 4 // ESP32连接电平转换器的GPIO引脚 #define CHIPSET WS2812B // LED灯珠型号 #define COLOR_ORDER GRB // WS2812B的颜色顺序是绿-红-蓝而非通常的RGB #define NUM_LEDS 256 // 16x16 256个LED // 显示效果配置 #define BRIGHTNESS 50 // 全局亮度0-255建议从50开始太亮伤眼且耗电 #define FRAMES_PER_SECOND 60 // 刷新率60fps足够流畅 #define FADE_RATE 0.85 // 衰减系数0-1。值越大光点留存越久值越小消失越快。烧录步骤用USB线连接ESP32到电脑。在Arduino IDE中选择正确的板型如“ESP32 Wrover Module”。选择正确的端口。点击上传按钮。首次上传可能需要按住ESP32上的“BOOT”按钮。烧录成功后的首次运行上电后LED点阵会先进行一个简单的全彩测试然后进入嗅探模式。此时你应该能看到屏幕上开始随机出现不同颜色的光点。拿起你的手机打开WiFi不一定需要连接在设备附近移动观察屏幕上是否有一个对应颜色的光点在移动或闪烁这代表它成功捕获了你手机的探测请求或数据包。实操心得FADE_RATE是一个需要根据个人喜好调整的重要参数。在信号非常密集的环境如办公室可以将其调低如0.7让旧信号更快消失避免屏幕堆积太多噪点。在家庭等信号较少的环境可以调高如0.9以便更持久地观察设备活动。BRIGHTNESS也强烈建议不要一开始就开到255过高的亮度不仅刺眼还会导致色彩失真和电源压力剧增。5. 外壳设计与光学优化为了让项目从一个实验板子变成一个美观的桌面设备一个好的外壳必不可少。我使用3D打印制作了一个暗色的外壳将ESP32、电平转换器和线路都隐藏其中只露出LED点阵。光学部分有一个关键技巧LED是点光源直接观看会非常刺眼且像素点过于明显。我在LED点阵前约40mm约1.5英寸的位置加装了一块磨砂半透明的亚克力板作为柔光罩。这个距离经过多次测试是平衡光线扩散效果和显示清晰度的最佳值。太近柔光效果不足依然能看到明显的点状光斑太远光线扩散过度不同像素的颜色会混在一起导致显示模糊。磨砂亚克力板能将每个LED的点光源扩散成一个柔和的光斑使得16x16的离散像素在视觉上融合成一片连续平滑的“光幕”大大提升了观赏性。你可以使用现成的毛玻璃或购买磨砂亚克力板自己切割。固定时确保亚克力板与LED面平行才能获得均匀的显示效果。6. 项目应用场景与扩展思路这个ESP32 WiFi嗅探器不仅仅是一个酷炫的玩具它在实际中也有多种应用场景家庭网络优化将它放在家中可以直观看到哪个信道的WiFi设备最多、干扰最大。帮助你为路由器选择一个相对空闲的信道提升网络质量。你还能看到家里所有智能设备手机、平板、IoT设备的在线状态。无线安全教学演示它是一个非常生动的教具可以直观展示无线网络中设备的广播、探测等行为理解MAC地址、信道、信号强度等概念。现场活动监控在小型会议、聚会场所可以快速评估现场的无线设备密度和信号分布情况。艺术装置其动态的光影效果本身就可以作为一件反应网络环境变化的数字艺术品。扩展思路数据记录与分析可以让ESP32将嗅探到的数据MAC、RSSI、时间戳通过WiFi发送到电脑或服务器进行长期记录和分析绘制信号强度热力图或设备活动规律图。频谱扩展当前仅支持2.4GHz频段。可以尝试使用支持双频的ESP32模块并修改代码增加对5GHz频段WiFi的嗅探并将两个频段的信息用不同方式显示如上下分区。交互功能增加一个按钮或触摸传感器切换不同的显示模式例如只显示信号最强的几个设备、按设备类型根据OUI前缀猜测用图标显示、或者进入频谱分析仪模式等。美化显示尝试不同的颜色映射算法或者加入更复杂的动画效果比如信号强的设备光点会有“脉动”效果。7. 常见问题与故障排除实录在实际制作和调试过程中我遇到了不少问题这里总结出来希望能帮你避开这些坑。问题一LED点阵完全不亮或显示乱码。排查步骤检查电源这是最常见的问题。首先确认外部5V电源适配器是否正常工作输出电流是否足够建议3A以上。用万用表测量接入LED点阵的5V和GND之间电压是否稳定在5V左右。检查电平转换确认ESP32的GPIO4是否有信号输出。可以用逻辑分析仪或另一个LED简单测试。确认电平转换器的3.3V侧输入和5V侧输出是否正常。特别注意电平转换器的方向不要接反输入输出端对应正确。检查数据线连接确认LED点阵的“DI”数据输入引脚是否正确连接到了电平转换器的输出端。WS2812B的数据流向是单向的务必接入“IN”端。检查代码配置核对代码中的LED_PIN、NUM_LEDS、COLOR_ORDER是否与你的硬件连接一致。WS2812B的COLOR_ORDER通常是GRB而不是默认的RGB。问题二LED点阵闪烁、部分灯珠颜色异常或ESP32频繁重启。原因分析这几乎可以肯定是电源问题。WS2812B在刷新时会产生瞬间的大电流导致电源电压瞬间跌落称为“电压毛刺”ESP32因电压不稳而复位。解决方案强化电源确保使用足功率的5V电源3A或以上。电源线要粗而短减少线损。增加电容在LED点阵的电源输入引脚处并联一个大容量的电解电容如原文的220μF和一个0.1μF的陶瓷电容。电解电容应对低频大电流波动陶瓷电容滤除高频噪声。电容要尽可能靠近LED点阵的电源引脚焊接。降低亮度在代码中调低BRIGHTNESS值能显著降低整体电流消耗。问题三嗅探不到任何设备屏幕始终是黑的。排查步骤确认环境确保周围有活跃的WiFi设备手机、电脑等。可以尝试用手机不断刷新网页或播放视频以产生数据流量。检查WiFi模式确认代码中正确设置了混杂模式 (esp_wifi_set_promiscuous(true))并且回调函数已注册。信道扫描代码应包含循环切换信道的逻辑。使用串口调试工具查看ESP32打印的日志确认它是否在正常扫描各个信道。权限与法规请注意在有些国家或地区使用WiFi混杂模式可能受到法律监管仅限于对自己拥有的网络或在明确授权的环境下进行安全评估。请确保你的使用符合当地法律法规。问题四显示刷新卡顿动画不流畅。原因与解决计算负载过重在回调函数中执行了太复杂的计算如复杂的颜色转换。确保回调函数只做最简单的数据提取和存储将映射和显示刷新放在主循环中。FastLED刷新优化使用FastLED.show()函数时确保帧率 (FRAMES_PER_SECOND) 设置合理。对于256个LED60FPS已经非常流畅追求更高帧率会增加不必要的CPU负担。WiFi中断影响WiFi射频活动本身会占用CPU资源。可以尝试将ESP32的其中一个核心专用于WiFi任务嗅探另一个核心用于LED驱动和显示逻辑这需要用到FreeRTOS任务管理属于进阶优化。这个项目从构思到实现最深的体会是硬件与软件的协同设计。电源的稳定性是硬件基石而巧妙的数据映射和显示算法则是软件的魂。当你看到屏幕上随着网络活动而流淌的光点时那种将无形电磁波化为有形光影的成就感是纯粹的代码或电路项目无法比拟的。它摆在桌上就是一个不断变化、讲述着周边数字世界故事的窗口。
ESP32 WiFi嗅探器：用LED点阵可视化无线网络信号与设备分布
1. 项目概述用光点“看见”身边的无线网络你有没有想过我们身边看不见摸不着的WiFi信号其实像一条条繁忙的街道上面跑着各种各样的“数据车辆”这些车辆来来往往有的信号强有的信号弱有的速度快有的速度慢。作为一个喜欢折腾硬件的玩家我总想把这些抽象的信息变得直观可见。于是就有了这个项目一个基于ESP32的WiFi嗅探器它能将周围无线网络的“交通状况”实时地显示在一块16x16的彩色LED阵列上。简单来说这个小设备就像一个无线网络的“雷达屏幕”。它不关心数据包里的具体内容比如你正在浏览什么网页只关注那些“信封”上的信息谁在发送设备的MAC地址、信号从哪个“车道”WiFi信道来、以及信号有多强。然后它把这些信息编码成颜色和亮度投射到LED点阵上。一眼望去你就能看到周围有多少设备在线它们分布在哪些信道上以及各自的信号强度如何。这对于排查家庭WiFi干扰、了解周边网络环境拥挤程度或者单纯作为一个酷炫的桌面摆件都特别有用。这个项目的核心是让ESP32这颗强大的物联网芯片工作在一种特殊的“混杂模式”下。在这种模式下ESP32的WiFi射频模块会像收音机调频一样逐个扫描所有WiFi信道并捕获它能听到的所有数据包帧头。我们从中提取出源MAC地址设备的唯一硬件标识和接收信号强度指示RSSI再经过一番巧妙的数学映射最终驱动WS2812B LED阵列显示出绚丽的动态效果。整个过程硬件连接简单代码逻辑清晰非常适合有一定嵌入式开发基础并对无线网络、数据可视化感兴趣的爱好者动手复现。2. 核心硬件选型与电路设计解析2.1 主控与显示单元为什么是ESP32和WS2812B选择ESP32-WROVER-B作为主控芯片是经过一番考量的。最初我也尝试过更常见的ESP8266但在编译涉及底层WiFi驱动和混杂模式操作的库时遇到了不少兼容性问题。ESP32则不同其双核处理器和更丰富的内存资源为同时运行复杂的网络嗅探逻辑和LED刷新驱动提供了充裕的算力。更重要的是ESP32的WiFi库对“混杂模式”的支持更为成熟和稳定社区资源也异常丰富这大大降低了开发门槛。WROVER版本集成了额外的PSRAM虽然本项目不一定用得上全部但为未来功能扩展比如历史数据记录留足了空间。显示部分我选择了最常见的16x16 WS2812B全彩LED点阵。这种LED每个像素点都集成了驱动芯片只需要一根数据线进行级联控制极大地简化了布线。256个像素点对于呈现13个WiFi信道X轴和信号强度梯度Y轴来说分辨率刚刚好既能清晰表达信息又不会让电路和代码过于复杂。其5V的工作电压也是标准电平方便供电设计。这里有个细节WS2812B对时序要求非常严格数据信号需要是5V逻辑电平而ESP32的GPIO输出是3.3V。直接连接可能导致数据无法被正确识别因此一个电平转换电路是必不可少的。2.2 关键电路电平转换与独立供电方案电平转换是保证项目稳定运行的关键一环。我手头正好有一个现成的双向电平转换模块它内部自带电压调节使用起来非常方便。实际上任何能将3.3V逻辑电平转换为5V的逻辑电平转换器如74HCT125等芯片搭建的电路都可以胜任。回顾起来使用这个集成模块让我节省了一根单独的3.3V供电线。供电设计是本项目的一个重点也是容易踩坑的地方。一个16x16的全白WS2812B点阵在最高亮度下理论峰值电流可能接近15A按每个LED 60mA计算。当然我们实际使用时不会全白且最高亮但瞬间点亮几十个LED的电流冲击也不容小觑。ESP32开发板上的USB口通常只能提供500mA左右的电流远远无法驱动整个LED阵列。因此必须为LED阵列提供独立的、强大的5V电源。我的方案是使用一个5V、3A以上的直流电源适配器通过一个2.1mm的DC插头供电。在电源接入点我并联了一个220μF/16V的电解电容这个电容的作用是“缓冲池”可以吸收LED快速变化时产生的瞬间大电流避免电源电压被拉低而产生抖动这种抖动会导致LED显示闪烁甚至ESP32重启。这是一个非常实用且必要的保护措施。最终的连接关系如下ESP32侧GPIO4数据输出 - 电平转换器低压侧输入端ESP32的GND - 电平转换器GNDESP32的5V引脚注意这是其USB输入经过稳压后的5V输出电流能力有限仅用于给电平转换器供电- 电平转换器5V输入。电平转换器侧高压侧输出端 - LED点阵的“DI”数据输入引脚高压侧GND - LED点阵GND高压侧5V输入 - 此路5V来自外部大功率电源而非ESP32。LED点阵与电源外部电源正极5V同时连接到点阵的“5V”引脚和220μF电容的正极外部电源负极GND同时连接到点阵的“GND”引脚、电容的负极以及电平转换器的GND。务必确保所有单元的GND最终都连接在一起共地是电路正常工作的基础。注意切勿尝试用ESP32的USB口或其板载的5V引脚直接为整个LED点阵供电这极有可能损坏你的ESP32开发板或电脑USB端口。3. 软件原理与代码深度剖析3.1 WiFi混杂模式如何“听到”所有数据包要让ESP32成为WiFi嗅探器核心是将其WiFi网卡设置为“混杂模式”。我们日常的手机、电脑连接WiFi时网卡处于“托管模式”它只会接收目标地址是自己的数据包并自动过滤掉其他无关的数据。这就像在聚会上你只理会喊你名字的人。而“混杂模式”则关闭了这个过滤器。在此模式下网卡会捕获其无线频道上能接收到的所有数据包的副本无论目标地址是谁。这就好比在聚会上你突然能听到房间里所有人的对话开头谁在对谁说话但你并不去仔细听对话的具体内容数据载荷。本项目正是利用这一点我们只解析数据包的“信封”——即MAC帧头部获取源MAC地址谁发送的、信道、信号强度RSSI等信息然后立即丢弃数据包的有效载荷部分这样既实现了监控又最大限度地避免了隐私问题。在代码中这通过esp_wifi_set_promiscuous(true)函数调用来实现。之后我们需要注册一个回调函数esp_wifi_set_promiscuous_rx_cb()。每当有数据包被捕获这个回调函数就会被触发我们可以在其中对数据包进行快速解析。3.2 数据映射算法从MAC地址到绚丽色彩原始数据MAC地址、RSSI、信道需要被映射到LED点阵的坐标和颜色上这是可视化的精髓。X轴映射信道 - 列WiFi在2.4GHz频段有13个信道北美标准。我们的LED点阵有16列。一个简单的线性映射是将信道1映射到第0列信道13映射到第12列第13-15列留空或作为边界。这样每个信道在屏幕上都有一个固定的“车道”。Y轴映射信号强度 - 行接收信号强度指示RSSI是一个负值单位是dBm。数值越大越接近0信号越强。通常-30dBm是极强信号靠近路由器-100dBm是极弱信号即将断开。我们将这个范围线性映射到16行上例如-30dBm对应最底部的第15行视觉上信号强在更直观-100dBm对应最顶部的第0行。这样信号强的设备在屏幕上显示的位置就更低、更醒目。颜色映射MAC地址 - 颜色这是让显示动态多彩的关键。一个MAC地址是6字节48位的全球唯一标识符。前3个字节是组织唯一标识符OUI代表制造商后3个字节由厂商分配相对随机。为了平衡辨识度和隐私我们只取后3个字节来生成颜色。具体做法是将这3个字节24位压缩为RGB565格式即5位红色、6位绿色、5位蓝色共16位。这样同一台设备总会显示为相同的颜色而不同的设备则会因为MAC地址尾部的不同而呈现出不同的色彩实现了“以颜色区分设备”。3.3 动态显示策略衰减与模糊让信号“流动”起来如果只是将实时数据瞬间绘制到屏幕上显示会变得非常闪烁和混乱难以观察信号的变化趋势。因此我引入了一个“衰减模糊”算法这也是代码中最具技巧性的部分。其原理是在每一帧显示刷新前不对整个屏幕进行清屏而是将屏幕上每个像素点的亮度或所有颜色分量乘以一个小于1的衰减系数例如0.9。这样上一帧留下的光点会在这一帧变暗一点。然后再将当前扫描到的新数据以其完整的亮度绘制到对应的像素上。这样做的效果是活跃信号持续发送数据的设备其对应的像素点会被不断“刷新”到最亮保持鲜艳稳定。消失的信号停止发送数据的设备其对应的像素点亮度会随着每一帧逐渐衰减几秒钟后慢慢“淡出”直至熄灭。你可以清晰地看到一个光点慢慢消失的过程。移动的信号如果设备移动导致信号强度或信道发生变化旧位置的光点会衰减新位置会出现亮光形成一种拖尾或移动的视觉效果非常直观。这种处理方式使得静态的LED点阵能够呈现出动态的、带有时间维度的信息让你一眼就能看出哪些信号是稳定的哪些是刚刚出现或消失的极大地提升了可视化的信息量。4. 固件编译、烧录与配置详解4.1 开发环境搭建与库依赖本项目代码基于Arduino框架进行开发这对于大多数爱好者来说是最友好的方式。你需要先安装Arduino IDE并在“开发板管理器”中添加ESP32的支持。具体步骤网上教程很多核心是添加正确的板卡支持网址。代码依赖两个重要的库FastLED这是驱动WS2812B等LED的行业标准库效率极高提供了丰富的颜色控制和显示函数。可以通过Arduino的库管理器直接搜索安装。ESP32 WiFi 底层API这部分已包含在ESP32的Arduino核心中无需额外安装。我们需要调用的是WiFi.h和esp_wifi.h等头文件提供的底层函数。项目的源代码我托管在GitHub上。你可以直接下载整个仓库。打开主.ino文件后Arduino IDE会自动识别同文件夹内的其他源文件。4.2 关键参数配置与自定义在代码的开头你会找到一系列#define宏定义这是你需要根据自己硬件进行调整的地方。// 硬件配置 #define LED_PIN 4 // ESP32连接电平转换器的GPIO引脚 #define CHIPSET WS2812B // LED灯珠型号 #define COLOR_ORDER GRB // WS2812B的颜色顺序是绿-红-蓝而非通常的RGB #define NUM_LEDS 256 // 16x16 256个LED // 显示效果配置 #define BRIGHTNESS 50 // 全局亮度0-255建议从50开始太亮伤眼且耗电 #define FRAMES_PER_SECOND 60 // 刷新率60fps足够流畅 #define FADE_RATE 0.85 // 衰减系数0-1。值越大光点留存越久值越小消失越快。烧录步骤用USB线连接ESP32到电脑。在Arduino IDE中选择正确的板型如“ESP32 Wrover Module”。选择正确的端口。点击上传按钮。首次上传可能需要按住ESP32上的“BOOT”按钮。烧录成功后的首次运行上电后LED点阵会先进行一个简单的全彩测试然后进入嗅探模式。此时你应该能看到屏幕上开始随机出现不同颜色的光点。拿起你的手机打开WiFi不一定需要连接在设备附近移动观察屏幕上是否有一个对应颜色的光点在移动或闪烁这代表它成功捕获了你手机的探测请求或数据包。实操心得FADE_RATE是一个需要根据个人喜好调整的重要参数。在信号非常密集的环境如办公室可以将其调低如0.7让旧信号更快消失避免屏幕堆积太多噪点。在家庭等信号较少的环境可以调高如0.9以便更持久地观察设备活动。BRIGHTNESS也强烈建议不要一开始就开到255过高的亮度不仅刺眼还会导致色彩失真和电源压力剧增。5. 外壳设计与光学优化为了让项目从一个实验板子变成一个美观的桌面设备一个好的外壳必不可少。我使用3D打印制作了一个暗色的外壳将ESP32、电平转换器和线路都隐藏其中只露出LED点阵。光学部分有一个关键技巧LED是点光源直接观看会非常刺眼且像素点过于明显。我在LED点阵前约40mm约1.5英寸的位置加装了一块磨砂半透明的亚克力板作为柔光罩。这个距离经过多次测试是平衡光线扩散效果和显示清晰度的最佳值。太近柔光效果不足依然能看到明显的点状光斑太远光线扩散过度不同像素的颜色会混在一起导致显示模糊。磨砂亚克力板能将每个LED的点光源扩散成一个柔和的光斑使得16x16的离散像素在视觉上融合成一片连续平滑的“光幕”大大提升了观赏性。你可以使用现成的毛玻璃或购买磨砂亚克力板自己切割。固定时确保亚克力板与LED面平行才能获得均匀的显示效果。6. 项目应用场景与扩展思路这个ESP32 WiFi嗅探器不仅仅是一个酷炫的玩具它在实际中也有多种应用场景家庭网络优化将它放在家中可以直观看到哪个信道的WiFi设备最多、干扰最大。帮助你为路由器选择一个相对空闲的信道提升网络质量。你还能看到家里所有智能设备手机、平板、IoT设备的在线状态。无线安全教学演示它是一个非常生动的教具可以直观展示无线网络中设备的广播、探测等行为理解MAC地址、信道、信号强度等概念。现场活动监控在小型会议、聚会场所可以快速评估现场的无线设备密度和信号分布情况。艺术装置其动态的光影效果本身就可以作为一件反应网络环境变化的数字艺术品。扩展思路数据记录与分析可以让ESP32将嗅探到的数据MAC、RSSI、时间戳通过WiFi发送到电脑或服务器进行长期记录和分析绘制信号强度热力图或设备活动规律图。频谱扩展当前仅支持2.4GHz频段。可以尝试使用支持双频的ESP32模块并修改代码增加对5GHz频段WiFi的嗅探并将两个频段的信息用不同方式显示如上下分区。交互功能增加一个按钮或触摸传感器切换不同的显示模式例如只显示信号最强的几个设备、按设备类型根据OUI前缀猜测用图标显示、或者进入频谱分析仪模式等。美化显示尝试不同的颜色映射算法或者加入更复杂的动画效果比如信号强的设备光点会有“脉动”效果。7. 常见问题与故障排除实录在实际制作和调试过程中我遇到了不少问题这里总结出来希望能帮你避开这些坑。问题一LED点阵完全不亮或显示乱码。排查步骤检查电源这是最常见的问题。首先确认外部5V电源适配器是否正常工作输出电流是否足够建议3A以上。用万用表测量接入LED点阵的5V和GND之间电压是否稳定在5V左右。检查电平转换确认ESP32的GPIO4是否有信号输出。可以用逻辑分析仪或另一个LED简单测试。确认电平转换器的3.3V侧输入和5V侧输出是否正常。特别注意电平转换器的方向不要接反输入输出端对应正确。检查数据线连接确认LED点阵的“DI”数据输入引脚是否正确连接到了电平转换器的输出端。WS2812B的数据流向是单向的务必接入“IN”端。检查代码配置核对代码中的LED_PIN、NUM_LEDS、COLOR_ORDER是否与你的硬件连接一致。WS2812B的COLOR_ORDER通常是GRB而不是默认的RGB。问题二LED点阵闪烁、部分灯珠颜色异常或ESP32频繁重启。原因分析这几乎可以肯定是电源问题。WS2812B在刷新时会产生瞬间的大电流导致电源电压瞬间跌落称为“电压毛刺”ESP32因电压不稳而复位。解决方案强化电源确保使用足功率的5V电源3A或以上。电源线要粗而短减少线损。增加电容在LED点阵的电源输入引脚处并联一个大容量的电解电容如原文的220μF和一个0.1μF的陶瓷电容。电解电容应对低频大电流波动陶瓷电容滤除高频噪声。电容要尽可能靠近LED点阵的电源引脚焊接。降低亮度在代码中调低BRIGHTNESS值能显著降低整体电流消耗。问题三嗅探不到任何设备屏幕始终是黑的。排查步骤确认环境确保周围有活跃的WiFi设备手机、电脑等。可以尝试用手机不断刷新网页或播放视频以产生数据流量。检查WiFi模式确认代码中正确设置了混杂模式 (esp_wifi_set_promiscuous(true))并且回调函数已注册。信道扫描代码应包含循环切换信道的逻辑。使用串口调试工具查看ESP32打印的日志确认它是否在正常扫描各个信道。权限与法规请注意在有些国家或地区使用WiFi混杂模式可能受到法律监管仅限于对自己拥有的网络或在明确授权的环境下进行安全评估。请确保你的使用符合当地法律法规。问题四显示刷新卡顿动画不流畅。原因与解决计算负载过重在回调函数中执行了太复杂的计算如复杂的颜色转换。确保回调函数只做最简单的数据提取和存储将映射和显示刷新放在主循环中。FastLED刷新优化使用FastLED.show()函数时确保帧率 (FRAMES_PER_SECOND) 设置合理。对于256个LED60FPS已经非常流畅追求更高帧率会增加不必要的CPU负担。WiFi中断影响WiFi射频活动本身会占用CPU资源。可以尝试将ESP32的其中一个核心专用于WiFi任务嗅探另一个核心用于LED驱动和显示逻辑这需要用到FreeRTOS任务管理属于进阶优化。这个项目从构思到实现最深的体会是硬件与软件的协同设计。电源的稳定性是硬件基石而巧妙的数据映射和显示算法则是软件的魂。当你看到屏幕上随着网络活动而流淌的光点时那种将无形电磁波化为有形光影的成就感是纯粹的代码或电路项目无法比拟的。它摆在桌上就是一个不断变化、讲述着周边数字世界故事的窗口。
