1. 项目缘起当ESP8266遇上LCD一个网络扫描仪的诞生几年前我还在折腾用ESP8266做简单的物联网传感器节点把温湿度数据发到服务器上。后来项目做多了手头积攒了不少ESP8266开发板和几块闲置的LCD屏幕。某天调试一个需要连接新Wi-Fi的设备时我突发奇想能不能让ESP8266自己动起来把周围所有能搜到的Wi-Fi网络信息像手机那样直观地显示在一块小屏幕上这样无论是在调试网络环境、寻找信号死角还是单纯想看看周围有多少个“神秘”的AP都能有个便携的硬件工具而不用每次都打开电脑或手机。这就是“Scan Networks ESP8266 Display LCD”项目的初衷。它本质上是一个基于ESP8266 Wi-Fi SoC的便携式无线网络扫描仪核心功能是主动扫描周围的Wi-Fi网络并将关键信息如SSID、信号强度RSSI、加密方式和信道实时显示在一块LCD屏幕上。别看功能听起来简单从固件开发、屏幕驱动到电源管理和用户体验优化里面有不少值得细说的门道。特别是如何让扫描过程高效、信息显示清晰以及在资源有限的MCU上平衡功能与性能都是实际动手时会遇到的挑战。接下来我将基于这个想法结合我多次迭代的经验拆解从硬件选型、环境搭建、代码实现到优化调试的全过程。无论你是刚接触ESP8266和Arduino的新手还是想为手头的模块找个有趣应用的老玩家这篇内容都能给你一份可直接“抄作业”的详细指南。2. 硬件选型与电路连接为扫描仪搭建身体一个项目的硬件是骨架选对了才能跑得稳。对于这个网络扫描仪核心就三部分主控ESP8266、显示单元LCD和供电。我们逐一分析。2.1 ESP8266开发板选型NodeMCU还是WeMos D1ESP8266模块本身只是一个芯片我们通常使用集成了USB转串口、稳压电路和GPIO引脚的开发板。最常见的有NodeMCU和WeMos D1 mini。NodeMCU通常指基于ESP-12E/F模块的开发板。它的优点是GPIO引脚全部引出且带有板载LED和按键方便调试。尺寸稍大但扩展性强。WeMos D1 mini基于ESP-12F尺寸非常小巧价格也便宜。它的引脚布局兼容Arduino Uno的部分引脚定义对Arduino用户更友好。缺点是GPIO数量比NodeMCU略少且没有板载用户按键。对于本项目我推荐使用WeMos D1 mini。原因有三一是体积小巧最终成品可以做得更便携二是其引脚如D1, D2...在Arduino IDE中定义清晰连接LCD时不易混淆三是其功耗相对较低。当然NodeMCU完全可用只是后续接线时需要注意引脚编号的对应关系NodeMCU常用的是GPIO编号如GPIO4、GPIO5。2.2 LCD屏幕选型I2C接口是王道LCD种类繁多从1602字符屏到各种TFT彩屏。选择的核心原则是接口简单、驱动库成熟、功耗低、显示信息足够。1602字符液晶屏16x2经典选择能显示32个字符。直接驱动需要连接7-10根线比较占用IO口。因此强烈建议使用带有I2C接口转换板的1602屏。这个转换板通常使用PCF8574T芯片将并行通信转为I2C只需要连接4根线VCC, GND, SDA, SCL极大简化了布线。这是本项目最平衡的选择。OLED屏SSD1306, 128x64更薄、更省电、对比度高。也是I2C或SPI接口。显示效果比字符屏好可以显示图形和自定义字体。缺点是阳光下可视性可能不如背光液晶屏且通常显示面积较小。TFT彩屏功能强大可以显示颜色和图片但驱动复杂、功耗高、库文件体积大对于单纯的网络信息显示有点“杀鸡用牛刀”且可能影响ESP8266的扫描性能。综合建议选择带I2C背板的1602液晶屏。它成本低、接线简单、显示字符信息完全够用SSID、RSSI、信道并且有非常稳定的LiquidCrystal_I2C库支持。这是经过验证最稳定、最省心的方案。2.3 电路连接四线连接的艺术假设我们使用WeMos D1 mini和I2C 1602 LCD连接如下WeMos D1 mini 引脚I2C 1602 LCD 引脚说明3.3VVCC绝对不要接5V大多数I2C转换板工作电压是3.3V-5V但为安全起见与ESP8266共用3.3V。GNDGND共地。D2 (GPIO4)SDAI2C数据线。ESP8266的I2C引脚可以软件定义D2/D1是常用组合。D1 (GPIO5)SCLI2C时钟线。注意有些I2C模块需要调整背光地址或对比度电位器。模块背面通常有一个可调电阻用螺丝刀旋转可以调节屏幕显示深浅如果上电后只看到一排方块调整它即可。另外I2C地址默认为0x27也可能是0x3F代码中需要确认。供电方面在开发调试阶段通过USB线连接电脑即可。如果想做成独立设备可以连接一个3.7V的锂电池如18650到开发板的3.3V和GND需确认开发板是否支持直接接电池有些板载稳压芯片支持有些需要接VIN引脚并通过板载稳压器降压。更稳妥的做法是使用一个小的锂电池充电管理模块如TP4056配合升压模块输出稳定的5V或3.3V。3. 软件开发环境与核心库配置硬件连好后就要让软件跑起来。ESP8266最友好的开发方式就是使用Arduino IDE。3.1 Arduino IDE环境搭建安装Arduino IDE从官网下载并安装最新版。添加ESP8266开发板支持打开IDE进入文件 - 首选项。在“附加开发板管理器网址”中填入http://arduino.esp8266.com/stable/package_esp8266com_index.json点击“好”保存。安装ESP8266开发板包进入工具 - 开发板 - 开发板管理器。搜索“esp8266”找到由“ESP8266 Community”发布的版本点击安装。安装必要的库进入工具 - 管理库。搜索并安装LiquidCrystal_I2C库作者通常是Frank de Brabander。这个库用于驱动I2C接口的1602液晶屏。搜索并安装ESP8266WiFi库。这个库通常随开发板包一起安装用于Wi-Fi操作包括扫描网络。3.2 核心代码逻辑拆解扫描与显示的舞蹈项目的核心代码逻辑是一个循环扫描 - 解析 - 显示 - 等待 - 再扫描。下面我们分块解析关键代码。首先包含必要的头文件和定义全局对象#include ESP8266WiFi.h #include Wire.h #include LiquidCrystal_I2C.h // 设置LCD的I2C地址、列数和行数。如果屏幕不亮尝试将0x27改为0x3F。 LiquidCrystal_I2C lcd(0x27, 16, 2); // 定义扫描间隔时间毫秒 const unsigned long SCAN_INTERVAL 10000; // 10秒扫描一次 unsigned long previousMillis 0;在setup()函数中我们需要初始化串口用于调试、LCD屏幕并启动Wi-Fi模块设置为STA模式但不连接任何网络void setup() { Serial.begin(115200); // 初始化串口通信便于调试输出 delay(100); // 初始化LCD lcd.init(); lcd.backlight(); // 打开背光 lcd.clear(); lcd.setCursor(0, 0); lcd.print(Wi-Fi Scanner); lcd.setCursor(0, 1); lcd.print(Initializing...); delay(2000); // 将Wi-Fi设置为STA模式并断开任何已有连接确保处于纯净的扫描状态 WiFi.mode(WIFI_STA); WiFi.disconnect(); delay(100); lcd.clear(); lcd.print(Ready to Scan); Serial.println(Setup done. Ready to scan.); }真正的核心在loop()函数中。我们使用非阻塞的定时方式每隔一段时间执行一次扫描避免使用delay()导致程序卡死。void loop() { unsigned long currentMillis millis(); // 检查是否到达扫描间隔时间 if (currentMillis - previousMillis SCAN_INTERVAL) { previousMillis currentMillis; // 保存本次扫描时间 // 执行扫描并显示结果 scanAndDisplayNetworks(); } // 在这里可以添加其他非阻塞任务比如按键检测 }scanAndDisplayNetworks()是这个项目最核心的函数void scanAndDisplayNetworks() { lcd.clear(); lcd.setCursor(0, 0); lcd.print(Scanning...); Serial.println(Starting Wi-Fi scan...); // 执行Wi-Fi扫描返回找到的网络数量。这是一个阻塞调用可能需要1-3秒。 int numberOfNetworks WiFi.scanNetworks(); lcd.clear(); if (numberOfNetworks 0) { lcd.print(No networks); lcd.setCursor(0, 1); lcd.print(found.); Serial.println(No networks found.); } else { // 通常我们只关心信号最强的几个网络因为屏幕空间有限 // 这里我们显示信号最强RSSI值最大负数绝对值最小的一个网络 // 更复杂的实现可以轮流显示多个网络或进行排序 int strongestRSSI -1000; // 初始化一个很弱的信号 int strongestIndex -1; String strongestSSID ; int strongestChannel 0; String strongestEncryption ; // 遍历所有找到的网络找出信号最强的 for (int i 0; i numberOfNetworks; i) { int currentRSSI WiFi.RSSI(i); if (currentRSSI strongestRSSI) { // RSSI是负值越大表示信号越好 strongestRSSI currentRSSI; strongestIndex i; } } // 获取最强网络的详细信息 if (strongestIndex 0) { strongestSSID WiFi.SSID(strongestIndex); strongestChannel WiFi.channel(strongestIndex); strongestEncryption getEncryptionType(WiFi.encryptionType(strongestIndex)); // 在LCD第一行显示SSID可能过长需要截断 lcd.setCursor(0, 0); String displaySSID strongestSSID.substring(0, 16); // 1602屏一行16字符 lcd.print(displaySSID); // 在LCD第二行显示信号强度和信道 lcd.setCursor(0, 1); String infoLine S: String(strongestRSSI) C: String(strongestChannel); // 如果还有空间可以加上加密方式缩写比如“WPA2” // 但16字符很紧张这里只显示信号和信道 lcd.print(infoLine); // 串口输出更详细的信息 Serial.print(i 1); Serial.print(: ); Serial.print(strongestSSID); Serial.print( (); Serial.print(strongestRSSI); Serial.print( dBm)); Serial.print( Ch ); Serial.print(strongestChannel); Serial.print( ); Serial.println(strongestEncryption); } // 扫描完成后建议删除扫描结果以释放内存 WiFi.scanDelete(); } } // 辅助函数将加密类型枚举转换为可读字符串 String getEncryptionType(wifi_auth_mode_t encryptionType) { switch (encryptionType) { case WIFI_AUTH_OPEN: return Open; case WIFI_AUTH_WEP: return WEP; case WIFI_AUTH_WPA_PSK: return WPA; case WIFI_AUTH_WPA2_PSK: return WPA2; case WIFI_AUTH_WPA_WPA2_PSK: return WPA/WPA2; case WIFI_AUTH_WPA2_ENTERPRISE: return WPA2-E; default: return Unknown; } }这段代码实现了一个基础但可用的版本每10秒扫描一次并在LCD上显示信号最强网络的SSID、信号强度和信道。串口监视器会输出所有扫描到的网络详情方便调试。4. 功能进阶与深度优化从能用变好用上面的基础版本能跑起来但离一个“好用”的工具还有距离。下面分享几个我经过多次迭代后加入的优化点。4.1 信息轮播与滚动显示只显示一个网络信息太浪费了。我们可以让信息在屏幕上轮播。思路是扫描完成后将网络列表按信号强度排序并存储起来然后在loop()中除了扫描定时再增加一个显示定时器轮流显示前N个网络的信息。// 全局变量存储网络信息 #define MAX_NETWORKS_TO_STORE 5 String ssidList[MAX_NETWORKS_TO_STORE]; int rssiList[MAX_NETWORKS_TO_STORE]; int channelList[MAX_NETWORKS_TO_STORE]; int storedNetworkCount 0; unsigned long lastDisplayChange 0; const unsigned long DISPLAY_INTERVAL 2000; // 每2秒切换一个网络显示 int currentDisplayIndex 0; void loop() { unsigned long currentMillis millis(); // 扫描定时 if (currentMillis - previousMillis SCAN_INTERVAL) { previousMillis currentMillis; performScanAndStore(); // 新的扫描函数将结果存入数组 } // 显示轮播定时 if (currentMillis - lastDisplayChange DISPLAY_INTERVAL storedNetworkCount 0) { lastDisplayChange currentMillis; displayNetwork(currentDisplayIndex); currentDisplayIndex (currentDisplayIndex 1) % storedNetworkCount; // 循环索引 } }performScanAndStore()函数执行扫描然后对结果按RSSI排序可以使用简单的冒泡排序并将前5名存入全局数组。displayNetwork(int index)函数则根据索引从数组中读取信息并显示在LCD上。对于长SSID一行显示不下可以加入滚动动画。这需要更精细的状态控制在loop()中每几百毫秒移动一次显示起始位置实现字幕滚动效果。4.2 信号强度可视化伪图形1602字符屏虽然不能显示真图形但我们可以用字符来模拟信号条让信号强度更直观。例如用[ ]这样的字符串来表示强度。String getSignalBar(int rssi) { // RSSI范围大致从-30极好到-100极差 int bars; if (rssi -50) bars 4; else if (rssi -60) bars 3; else if (rssi -70) bars 2; else if (rssi -80) bars 1; else bars 0; String bar [; for (int i 0; i 4; i) { if (i bars) bar ; else bar ; } bar ]; return bar; }然后在显示时将信号条字符串打印在LCD的合适位置。4.3 低功耗优化如果你希望用电池供电并长时间运行功耗是关键。ESP8266在主动扫描Wi-Fi时功耗较高约70mA持续工作电池撑不了多久。优化策略大幅增加扫描间隔比如每60秒甚至5分钟扫描一次。在loop()中大部分时间MCU处于空闲状态。使用深度睡眠这是最省电的方式。ESP8266可以在两次扫描之间进入深度睡眠Deep Sleep此时功耗可降至20μA左右。但深度睡眠会重启整个系统需要将扫描结果存储在RTC内存或外部EEPROM中并在唤醒后恢复显示逻辑更复杂。同时LCD也需要在睡眠时关闭背光。关闭LCD背光在非交互时段关闭LCD背光能节省可观电量。可以通过一个GPIO口控制背光电源或者利用lcd.noBacklight()函数如果库支持。一个简单的深度睡眠实现框架void setup() { // ... 初始化LCD、串口等 performScanAndDisplay(); // 显示保持一段时间 delay(5000); // 配置深度睡眠时间单位微秒 ESP.deepSleep(60 * 1000000); // 睡眠60秒 } void loop() { // 深度睡眠后代码不会执行到这里因为会重启 }注意使用深度睡眠时需要将ESP8266的GPIO16 (D0)引脚连接到RST复位引脚这样才能用定时器唤醒。4.4 增加用户交互按键与模式切换可以增加一个或两个按键实现模式切换。例如模式A轮播显示所有网络。模式B锁定显示信号最强的网络。模式C只显示开放未加密网络。按键短按切换模式长按触发一次立即扫描。这需要引入按键消抖库如Bounce2和简单的状态机来管理模式。代码复杂度会增加但可玩性大大提高。5. 常见问题排查与实战心得在实际制作过程中你几乎一定会遇到下面几个问题。这里把我的踩坑经验分享给你。5.1 LCD屏幕无显示或乱码这是最常见的问题90%的原因出在I2C通信上。检查接线确保VCC接3.3VGND共地SDA和SCL接对引脚。检查I2C地址使用一个简单的I2C扫描程序来确认你的LCD模块地址。在Arduino IDE中运行以下代码查看串口输出#include Wire.h void setup() { Wire.begin(); Serial.begin(115200); Serial.println(I2C Scanner...); } void loop() { byte error, address; for(address 1; address 127; address ) { Wire.beginTransmission(address); error Wire.endTransmission(); if (error 0) { Serial.print(Found device at 0x); if (address16) Serial.print(0); Serial.println(address,HEX); } } delay(5000); }找到的设备地址通常是0x27或0x3F需要替换到LiquidCrystal_I2C lcd(0x27, 16, 2);这行代码中。调节对比度找到LCD模块背面的蓝色电位器用螺丝刀缓慢旋转直到字符清晰显示。检查库版本确保安装的LiquidCrystal_I2C库是较新的、兼容的版本。5.2 Wi-Fi扫描失败或返回结果为空检查Wi-Fi模式务必在setup()中调用WiFi.mode(WIFI_STA);和WiFi.disconnect();并稍作延迟。这确保了模块处于正确的客户端模式且没有尝试连接从而能进行主动扫描。天线问题有些ESP8266模块如ESP-01板载天线性能较弱或天线被金属物体遮挡。尝试改变设备朝向和位置。电源干扰Wi-Fi扫描是射频操作对电源噪声敏感。确保使用质量好的USB线或稳压电源并在电源引脚附近并联一个100μF的电解电容和一个0.1μF的陶瓷电容以滤除噪声。代码逻辑WiFi.scanNetworks()是阻塞的且扫描时间可能因环境而异1-5秒。确保在扫描期间不要进行其他耗时操作或重置。扫描完成后及时调用WiFi.scanDelete()释放内存。5.3 程序运行不稳定或偶尔重启ESP8266内存有限不当的内存操作会导致崩溃看门狗复位。字符串处理避免在函数内创建过大的临时String对象尤其是在全局循环中。尽量使用字符数组(char[])或String的保留空间功能(reserve())。在扫描网络时SSID可能很长要做好截断处理。堆栈溢出减少函数调用层级避免过深的递归。将一些全局字符串变量声明为静态或使用PROGMEM将常量字符串存入闪存而非RAM。看门狗ESP8266有软件看门狗。如果你的loop()中某次执行时间过长比如处理大量网络数据需要在长时间循环中调用yield()或ESP.wdtFeed()来喂狗防止复位。电源稳定性和上一点一样不稳定的电源是导致随机重启的元凶之一。用万用表测量运行时的3.3V电压看是否有大幅跌落。5.4 扫描间隔不准确或显示刷新卡顿这通常是因为在loop()中使用了阻塞的delay()函数。务必使用本文推荐的基于millis()的非阻塞定时方法。确保scanAndDisplayNetworks()函数本身的执行时间远小于你设定的SCAN_INTERVAL。如果扫描和显示处理本身就很慢比如排序很多网络你需要考虑优化算法或减少处理的数据量。最后一个我个人觉得非常实用的小技巧在串口输出中不仅打印扫描到的网络也打印每次扫描开始和结束的时间戳以及自由堆内存的大小。这能帮你直观了解程序的耗时和内存使用情况对于优化和调试有奇效。Serial.printf([%lu] Start Scan. Free Heap: %d bytes\n, millis(), ESP.getFreeHeap()); int n WiFi.scanNetworks(); Serial.printf([%lu] Scan Done. Found %d nets. Free Heap: %d bytes\n, millis(), n, ESP.getFreeHeap());这个基于ESP8266和LCD的网络扫描仪项目从想法到实现再到不断优化是一个典型的嵌入式开发小循环。它涉及硬件接口、通信协议、实时编程和电源管理等多个方面。当你亲手做出这个小设备拿着它漫步在办公室或家里看着屏幕上跳动的网络信息时那种把代码变成实体、并解决实际小需求的成就感正是嵌入式开发的乐趣所在。希望这份详细的指南能帮你绕过我踩过的那些坑顺利做出属于你自己的便携网络探测工具。