1. 项目缘起为什么我们需要一个口袋里的网络“听诊器”做网络运维或者经常折腾家庭、办公室网络的朋友肯定都遇到过这样的场景墙角的网口突然没信号了新买的交换机端口死活不亮灯或者怀疑自己做的网线水晶头没打好。这时候一个靠谱的网络测线仪就成了救命稻草。传统的网络测线仪功能单一体积不小而且通常只能告诉你“通”或“不通”至于网络质量如何、速率是多少、有没有丢包它就无能为力了。更高级的便携式网络测试仪比如福禄克Fluke的MicroScanner系列功能强大但价格动辄几千上万对于个人用户或小型工作室来说实在是一笔不小的开销。于是一个想法就冒出来了能不能自己动手做一个功能足够用、成本足够低、体积足够小巧能真正塞进口袋的局域网LAN测试工具它不仅要能测线序、测通断最好还能显示一些基础的网络状态信息比如连接速率、双工模式甚至能做个简单的Ping测试。这就是“Pocket LAN Tester”口袋局域网测试仪项目的初衷。它的核心目标就是利用手头易得的开源硬件和元器件打造一个极致的、高性价比的便携式网络诊断工具。从相关的热搜词来看这个项目的技术栈非常清晰核心是处理以太网Ethernet通信需要一个微控制器MCU来驱动OLED显示屏进行信息展示。这正好构成了一个典型的嵌入式系统MCU作为大脑通过某种接口如SPI或I2C控制OLED屏同时通过以太网物理层PHY芯片或集成以太网的MCU与网络进行交互。下面我就结合自己的实际制作经验把这个项目的完整实现过程、技术选型考量、踩过的坑以及最终的优化心得毫无保留地分享出来。2. 核心架构与硬件选型在成本、功耗与功能间寻找平衡点做一个东西最忌讳的就是一开始就埋头写代码。硬件是软件的舞台舞台没搭好戏肯定唱不下去。对于Pocket LAN Tester我们需要拆解出几个核心模块并为每个模块找到最合适的“演员”。2.1 主控MCU性能、接口与生态的权衡主控芯片是整个设备的核心。它需要满足几个硬性条件内置或可外接以太网MAC这是实现网络测试功能的基础。要么芯片本身集成了MAC控制器要么我们得通过外部总线如SPI连接一个带MAC的以太网模块如W5500、ENC28J60但后者性能和灵活性会差一些。足够的GPIO和通信接口需要至少一组SPI或I2C来驱动OLED屏可能需要UART用于调试还需要一些GPIO来控制状态LED或按钮。适当的处理能力与内存需要运行一个轻量级的TCP/IP协议栈如lwIP并能处理简单的网络诊断逻辑。低功耗与小型封装既然是“口袋”设备功耗和体积必须考虑。QFN、LQFP等贴片封装是首选。开发环境友好有成熟的IDE如Keil、IAR、VS CodePlatformIO、丰富的库支持和活跃的社区。基于这些条件我排除了传统的51单片机性能不足和高端的MPU如i.MX系列成本过高、功耗大。目光自然落在了ARM Cortex-M系列MCU上。在众多型号中STM32F103C8T6俗称“蓝莓派”或“最小系统板”和ESP32系列是两大热门候选。STM32F103C8T6方案优点价格极其低廉约10元人民币生态极其庞大资料遍地都是。它没有内置以太网MAC但可以通过SPI接口连接W5500这类硬件协议栈芯片。W5500内部集成了完整的TCP/IP协议栈和MAC/PHY大大减轻了MCU的负担开发难度直线下降。缺点需要两颗主要芯片STM32 W5500增加了PCB布局复杂度和整体功耗。性能对于复杂的网络协议处理可能稍显吃力。ESP32方案如ESP32-S3优点单芯片解决方案ESP32系列通常集成了Wi-Fi和蓝牙部分型号如ESP32-Ethernet-Kit或通过外部PHY如LAN8720/IP101GR支持以太网。它双核处理能力强内存大且原生支持LwIP协议栈网络功能强大。开发环境Arduino或ESP-IDF也非常成熟。缺点成本相对STM32F103W5500方案要高一些ESP32模组约20-30元。如果不需要Wi-Fi功能这部分硬件算是一种“浪费”。但考虑到其高度集成性和强大的性能它仍然是极具竞争力的选择。我的最终选择与理由 经过权衡我选择了ESP32-S3作为主控。原因如下集成度与性能的胜利单芯片解决网络、处理和显示驱动简化了硬件设计。双核240MHz主频和512KB SRAM运行LwIP和图形界面游刃有余。开发效率使用Arduino框架或ESP-IDF网络编程和OLED驱动都有大量现成库快速原型开发优势明显。未来扩展性内置Wi-Fi意味着未来我可以轻易为测试仪增加无线网络诊断功能如扫描Wi-Fi信道、信号强度而无需改动硬件。功耗管理ESP32系列具有丰富的低功耗模式对于电池供电的口袋设备至关重要。当然STM32W5500方案对于极致成本控制或学习特定芯片组合的朋友来说依然是绝佳的选择。本项目以ESP32-S3为主线进行阐述但核心思路是相通的。2.2 显示单元OLED屏的选型与驱动要点“Pocket”设备屏幕必须小巧、清晰、省电。OLED有机发光二极管屏是不二之选它自发光、对比度高、视角广、响应快且功耗显著低于同尺寸LCD。从热搜词“oled 显示屏上显示日期和时钟”、“oled显示汉字”、“oled字库”、“oled取模”可以看出大家关心的正是如何在这种小屏上有效显示信息。常见的OLED屏尺寸有0.96英寸和1.3英寸分辨率多为128x64或128x32像素。关键选型点通信接口主要有I2C和SPI两种。I2C只需2根线SCL SDA节省GPIO但刷新速度较慢。适合显示静态或更新不频繁的信息如IP地址、速率。SPI需要4根线SCK MOSI DC CS有时还包括复位RST线占用IO多但刷新速度快。适合需要动态刷新或简单动画的场景。选择建议对于网络测试仪信息更新频率不高秒级I2C接口完全足够且能最大化节省GPIO。因此我选择了0.96英寸、128x64分辨率、I2C接口的OLED屏通常使用SSD1306驱动芯片。驱动库在Arduino环境下Adafruit_SSD1306和Adafruit_GFX库是黄金组合提供了丰富的绘图和文字显示函数支持自定义字库完美解决了“显示汉字”的需求。2.3 网络物理层PHY连接RJ45的桥梁ESP32-S3内部有以太网MAC但需要一个外部的物理层PHY芯片来实现数字信号与网线中模拟信号的转换并通过网络变压器Magjack连接到RJ45接口。PHY芯片选择LAN8720A和IP101GR是两款非常常见且廉价的10/100M PHY芯片。它们通过RMII接口与ESP32的MAC连接。需要关注的是晶振配置LAN8720A常用50MHz无源晶振IP101GR常用25MHz有源晶振和复位电路。网络变压器Magjack这是一个将PHY芯片与外部网络隔离的组件保护设备免受浪涌冲击。通常选择集成变压器的RJ45插座即Magjack如HR911105A它把变压器和RJ45做在了一起进一步简化了设计。RJ45接口与指示灯标准的8P8CRJ45插座是必须的。为了直观显示链路状态最好集成链路Link和活动Activity两个LED指示灯。这两个灯的驱动信号通常可以由PHY芯片直接提供如LAN8720的nINT/REFCLKO和LED2引脚。2.4 电源与结构设计供电目标是用一块常见的**锂电池如10440或14500型号**供电。需要一个充电管理芯片如TP4056为锂电池充电同时需要一个升压稳压电路如MT3608将电池电压3.7V稳定升压至5V或3.3V为整个系统供电。ESP32-S3的核心电压是3.3VPHY和OLED屏通常也是3.3V所以整个系统可以统一在3.3V下工作简化电源设计。结构为了真正“口袋化”需要使用四层板进行紧凑的PCB布局将所有元件集成在一块比名片还小的板子上。外壳可以使用3D打印设计成圆润的、便于握持的形状并留出屏幕窗口、RJ45接口和USB-C充电口。3. 软件设计与核心功能实现让硬件“活”起来硬件设计好后软件就是灵魂。我们需要让这个设备能够自动识别网络状态并将信息清晰地展示在OLED屏幕上。3.1 开发环境与基础库搭建我选择使用Arduino框架进行开发主要是因为其快速原型开发能力。在VS Code中安装PlatformIO插件创建基于ESP32-S3的项目。首先在platformio.ini配置文件中声明依赖的库[env:esp32-s3-devkitc-1] platform espressif32 board esp32-s3-devkitc-1 framework arduino monitor_speed 115200 lib_deps adafruit/Adafruit SSD1306^2.5.7 adafruit/Adafruit GFX Library^1.11.5 olikraus/U8g2^2.35.12 ; 另一个强大的OLED驱动库备选 ; 以太网库通常由ESP32框架自带3.2 以太网初始化和网络信息获取这是最核心的部分。我们需要初始化PHY芯片启动LwIP协议栈并获取链路信息。#include ETH.h #include WiFi.h // 用于一些通用网络函数 // 根据你的PHY芯片和电路连接定义引脚 #define ETH_PHY_TYPE ETH_PHY_LAN8720 // 或 ETH_PHY_IP101 #define ETH_PHY_ADDR 0 #define ETH_PHY_MDC 23 #define ETH_PHY_MDIO 18 #define ETH_PHY_POWER -1 // 如果PHY有独立电源控制引脚 #define ETH_CLK_MODE ETH_CLOCK_GPIO0_IN // LAN8720的时钟模式 static bool eth_connected false; void WiFiEvent(WiFiEvent_t event) { switch (event) { case ARDUINO_EVENT_ETH_START: Serial.println(ETH Started); ETH.setHostname(pocket-lan-tester); // 设置设备主机名 break; case ARDUINO_EVENT_ETH_CONNECTED: Serial.println(ETH Connected); eth_connected true; break; case ARDUINO_EVENT_ETH_GOT_IP: Serial.print(ETH MAC: ); Serial.print(ETH.macAddress()); Serial.print(, IPv4: ); Serial.print(ETH.localIP()); if (ETH.fullDuplex()) { Serial.print(, FULL_DUPLEX); } Serial.print(, ); Serial.print(ETH.linkSpeed()); Serial.println(Mbps); eth_connected true; break; case ARDUINO_EVENT_ETH_DISCONNECTED: Serial.println(ETH Disconnected); eth_connected false; break; case ARDUINO_EVENT_ETH_STOP: Serial.println(ETH Stopped); eth_connected false; break; default: break; } } void setup() { Serial.begin(115200); WiFi.onEvent(WiFiEvent); // 注册网络事件回调 ETH.begin(ETH_PHY_ADDR, ETH_PHY_POWER, ETH_PHY_MDC, ETH_PHY_MDIO, ETH_PHY_TYPE, ETH_CLK_MODE); }这段代码初始化了以太网并通过事件回调函数捕获连接状态、获取IP地址、双工模式和链路速度。这些信息正是我们要在屏幕上显示的关键数据。3.3 OLED信息显示与界面设计在小小的128x64像素屏幕上合理安排信息需要巧思。我设计了一个简单的多屏界面通过一个按钮进行切换屏幕1主信息屏显示最关键的实时状态。第一行设备名称 (如 “LAN-TESTER”)第二行链路状态 ( “LINK UP” 或 “NO CABLE” ) 和速度 ( “100M” / “10M” )第三行双工模式 ( “FULL” / “HALF” )第四行自动获取的IP地址 ( “IP:192.168.1.100” )屏幕2Ping测试屏允许用户对指定IP进行Ping测试显示结果。显示目标IP可预设或通过简单方式输入本项目先做固定IP测试显示发送数、接收数、丢包率、平均延迟。屏幕3线序测试屏这是传统测线仪的核心功能。需要利用ESP32的GPIO模拟传统测线仪的发射和接收。原理是设备一端将8根网线依次置为高电平另一端检测是哪一根线收到了信号。对于单端设备需要做一个回环头Loopback Adapter插在远端。屏幕上以图形化方式显示1-8号线哪根通哪根断以及线序直通或交叉。OLED驱动代码示例主信息屏#include Adafruit_SSD1306.h #include Adafruit_GFX.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, OLED_RESET); void displayMainInfo(String linkStatus, int speed, bool duplex, String ip) { display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); display.setCursor(0, 0); // 第一行标题 display.println(Pocket LAN Tester); display.drawLine(0, 10, 128, 10, SSD1306_WHITE); // 画一条分隔线 // 第二行链路状态与速度 display.setCursor(0, 15); display.print(Link: ); display.print(linkStatus); display.print( ); display.print(speed); display.println(Mbps); // 第三行双工模式 display.setCursor(0, 25); display.print(Duplex: ); display.println(duplex ? Full : Half); // 第四行IP地址 display.setCursor(0, 35); display.print(IP: ); display.println(ip); // 底部状态栏例如显示电池电量 display.drawLine(0, 54, 128, 54, SSD1306_WHITE); display.setCursor(0, 56); display.print(BAT: ); display.print(readBatteryLevel()); // 假设的函数 display.println(%); display.display(); }3.4 高级功能实现Ping与线序测试Ping测试实现 ESP32的LwIP提供了ping的API我们可以封装一个简单的函数。#include esp_ping.h void pingHost(ip_addr_t target_ip) { ping_config_t config ping_default_config(); config.target_addr target_ip; config.count 4; // 发送4个ping包 config.interval_ms 1000; config.timeout_ms 1000; esp_ping_callbacks_t cbs { .on_ping_success ping_success_cb, .on_ping_timeout ping_timeout_cb, .on_ping_end ping_end_cb, .cb_args NULL }; esp_ping_handle_t ping; esp_ping_new_session(config, cbs, ping); esp_ping_start(ping); // 在回调函数中更新OLED显示 }在ping_end_cb回调中我们可以计算出丢包率和平均时延并更新到OLED的第二个屏幕上。线序测试实现 这是一个相对独立的功能。我们需要将ESP32的8个GPIO引脚连接到RJ45接口的8个触针上。测试时设备自身作为“主端”依次向1-8号线发送一个脉冲信号。在网线另一端需要插上一个回环头。这个头子内部将1-3 2-6 3-1 4-4 5-5 6-2 7-7 8-8两两短接对于直通线测试这样发送端发出的信号就会被环回到对应的接收引脚。设备作为“从端”检测这8个引脚哪个收到了信号。如果某对线如1和2能正确收发则说明这对线是通的且线序正确。在OLED上用8个短横线或方块图形来表示1-8号线通的就点亮或显示“OK”断的就显示“XX”或保持熄灭。同时可以判断是直通线1-1 2-2...还是交叉线1-3 2-6...。注意GPIO直接连接网线接口存在静电放电ESD风险在实际PCB设计中必须在GPIO和RJ45触点之间串联电阻并添加ESD保护二极管或者使用专用的网络测试模拟开关芯片以提高可靠性。4. PCB设计、组装与调试从原理图到实体软件逻辑跑通后就需要把它固化到硬件上。这一步是业余爱好者向专业制作迈进的关键。4.1 原理图设计要点使用KiCad或Altium Designer等工具绘制原理图。核心部分包括ESP32-S3最小系统包括芯片、滤波电容、复位电路、Boot模式选择电阻、USB转串口芯片如CH340C及其电路。以太网模块ESP32-S3的RMII引脚EMAC_TX_CLKEMAC_TXD0EMAC_TXD1EMAC_TX_ENEMAC_RXD0EMAC_RXD1EMAC_RX_EREMAC_RX_DVEMAC_REF_CLK连接到PHY芯片LAN8720A。注意为PHY芯片提供稳定的25MHz或50MHz时钟源晶振电路并正确连接复位和配置引脚如nINT/REFCLKOLED1LED2。网络变压器与RJ45PHY的TX±和RX±引脚通过网络变压器连接到RJ45 Magjack。别忘了在PHY和变压器之间按照芯片手册要求串联匹配电阻通常75Ω。OLED接口将ESP32的任意一组I2C引脚如GPIO8-SDA GPIO9-SCL连接到OLED屏的对应引脚并加上上拉电阻通常4.7kΩ。电源树这是稳定性的基石。USB-C输入 - TP4056充电管理 - 锂电池 - MT3608升压至5V - AMS1117-3.3 LDO稳压至3.3V。在每一个芯片的电源引脚附近都必须放置一个0.1uF的陶瓷去耦电容大电流路径上还需要添加更大容量的钽电容或电解电容如10uF。用户接口一个轻触开关用于切换屏幕/开始测试一个按键用于开始Ping测试。几个LED用于指示电源、充电状态、链路状态。4.2 PCB布局与布线挑战为了做到口袋大小必须使用四层板信号层、GND层、PWR层、信号层。布局原则模块化布局将电源、MCU、以太网、OLED、接口分区放置功能相关的元件靠近。电源优先先规划电源路径确保大电流通道足够宽。AMS1117等LDO要靠近用电模块。关键信号线RMII信号线属于高速数字信号50MHz需要做等长和阻抗控制通常目标单端50Ω。尽量走线短、直在GND参考层上保持完整回流路径。一组信号线尽量平行走避免跨分割。晶振电路靠近PHY芯片走线短而粗用地线包围下方所有层禁止走线。USB差分线如果用了USBD和D-需要差分走线等长、等距、阻抗控制90Ω。大面积铺铜第二层和第三层尽量作为完整的地平面和电源平面为信号提供良好的参考和屏蔽。4.3 焊接、组装与“上电冒烟”测试焊接0402、QFN封装的元件需要一把好的恒温烙铁和热风枪以及足够的耐心。焊接顺序建议电源芯片-去耦电容-MCU-其他芯片-阻容元件-接口。组装完成后千万不要直接插电池按以下步骤测试目视检查检查有无连锡、虚焊、元件焊反。电源短路测试用万用表蜂鸣档测量3.3V、5V、电池正负极对GND的电阻确保没有直接短路。上电测试限流使用可调直流电源将电压设置为3.8V模拟锂电池电流限制在100mA以内连接到电池接口。观察电流读数如果电流极大如超过50mA且持续上升或电源打嗝立即断电检查。电压测量如果上电后电流正常几十mA测量AMS1117-3.3的输出是否为稳定的3.3V测量ESP32的VDD引脚电压是否正常。编程测试通过USB连接电脑检查设备管理器是否出现串口。尝试上传一个最简单的Blink程序测试MCU是否工作正常。4.4 软件调试与功能联调硬件基础打好后就是逐步验证各个功能。OLED显示先写一个简单的测试程序在屏幕上显示“Hello World”确保I2C通信正常。以太网链路烧录包含以太网初始化代码的程序插上网线连接到路由器。观察PHY芯片的Link LED是否亮起串口是否打印出获取到的IP地址和速率信息。Ping功能在获取到IP后尝试Ping同一个局域网内的网关或已知主机在串口查看结果。线序测试这是硬件交互最复杂的部分。需要单独编写测试程序并制作回环头。通过串口打印出每个引脚的检测状态与预期对比调试GPIO的输入输出配置和检测逻辑。整合与优化将所有功能整合到主程序中实现按键切换屏幕、更新显示。优化电源管理加入休眠模式延长电池续航。5. 踩坑实录与经验总结那些只有动手才知道的事这个项目看起来不复杂但实际做下来坑是一个接一个。这里分享几个让我印象深刻的教训。5.1 PHY芯片的时钟与复位不起眼的细节决定成败最初我选择了LAN8720A因为它便宜且常见。按照典型电路使用一个50MHz的无源晶振连接在XI和XO引脚。ESP32的ETH_CLOCK_GPIO0_IN模式意味着时钟由外部提供来自LAN8720的REFCLKO引脚。结果死活连不上网串口一直打印“ETH Started”但没有连接事件。排查过程检查焊接重新加焊LAN8720无效。检查RMII连线用万用表一根根核对无误。检查电源3.3V稳定。测量时钟用示波器测量50MHz晶振两端没有波形问题找到了。无源晶振需要MCU内部的振荡器电路驱动才能起振而LAN8720的XI脚是输入它自己不能驱动晶振。对于LAN8720必须使用有源晶振或者使用ESP32输出时钟给LAN8720。解决方案我换用了IP101GR芯片。它的典型电路使用25MHz无源晶振并且芯片内部有振荡电路可以直接驱动无源晶振。更改原理图和PCB后问题解决。教训阅读PHY芯片的数据手册时必须仔细看时钟电路部分明确是“有源晶振”、“无源晶振”还是“外部时钟输入”这个细节在很多教程里都是一笔带过。5.2 电源噪声导致OLED显示异常在第一个版本中OLED屏幕偶尔会出现花屏或者内容乱码。尤其是在进行网络Ping测试时屏幕闪烁更明显。排查过程起初怀疑是I2C总线受到干扰在SDA和SCL上加了更小的上拉电阻从4.7kΩ降到2.2kΩ问题依旧。用示波器观察I2C波形发现数据波形本身很干净但在某些时刻电源轨3.3V上会有几十毫伏的毛刺。追踪发现当ESP32的Wi-Fi射频部分工作时即使以太网在用Wi-Fi模块也可能在后台活动瞬间电流变化较大而我的3.3V LDOAMS1117输出端只用了10uF的钽电容响应速度不够快导致电压轻微跌落。解决方案在AMS1117的3.3V输出端并联一个100uF的电解电容和一个0.1uF的陶瓷电容。大电容提供储能小电容滤除高频噪声。同时在靠近ESP32和OLED的电源入口处再各自添加一组10uF0.1uF的电容。修改后屏幕显示异常问题彻底消失。教训嵌入式系统的电源去耦永远不嫌多特别是对于数字和模拟混合、有射频电路的场景。手册上推荐的最小值往往只是“能用”的下限为了稳定应该加倍甚至加一个数量级。5.3 线序测试的硬件保护与软件防抖最初的线序测试电路我是直接用ESP32的GPIO通过一个330Ω的限流电阻连接到RJ45插座的触针上。测试时有一次不小心把网线插到了带电的PoE交换机端口上虽然可能性不大但很危险。瞬间一股青烟从RJ45插座冒出对应的GPIO引脚烧毁了。解决方案硬件隔离在GPIO和RJ45之间必须加入保护电路。我后来改用了BSS138这样的低压N-MOSFET作为模拟开关由GPIO控制MOSFET的导通将测试电压3.3V施加到网线上。同时在网线输入端并联TVS二极管如SMBJ5.0A到地用于钳位高压浪涌。电阻也换成了更小的值如100Ω以提供一定的限流。软件防抖网线插入和拔出时触点可能会产生抖动导致误检测。在软件中对于线序检测的输入信号必须加入消抖逻辑。不是检测到一次高电平就认为通而是连续多次如10次间隔1ms采样都是高电平才判定为连通状态。5.4 结构设计带来的装配难题第一版3D打印的外壳设计时只考虑了元件的二维投影没有仔细核算三维空间。结果组装时发现USB-C母座的高度和电池的厚度有冲突屏幕排线被外壳边缘压住导致接触不良。解决方案使用Fusion 360等软件进行设计时一定要把所有关键元件PCB、电池、屏幕、接口都建模进去进行虚拟装配检查干涉。特别是连接器和排线的弯曲半径要留足空间。后来我重新设计了外壳将电池仓做在侧面为USB-C接口上方留出了凹槽并为屏幕排线预留了走线槽和压紧结构。经过这些坑的洗礼最终的“Pocket LAN Tester”V2.0版本终于稳定可靠地工作了。它体积小巧可以轻松放进口袋或工具包一次充电可以连续工作超过8小时能够快速诊断网络链路状态、进行Ping测试和线序测试对于日常的网络排查工作来说已经完全够用甚至比很多廉价的商用测线仪还要好用。这个项目最大的收获不仅仅是做出了一个工具更是在硬件选型、电路设计、PCB布局、嵌入式编程和问题调试方面完成了一次全面的实战演练。如果你也对硬件和网络感兴趣强烈建议你尝试一下这个过程本身就是最好的学习。