基于Arduino与CC3000的便携式WiFi探测器：硬件选型、低功耗设计与实践

1. 项目概述：打造你的口袋网络雷达

在咖啡馆、机场或者陌生的城市街区，找到一个可用的开放WiFi网络有时就像一场寻宝游戏。虽然智能手机已经普及，但专门用于网络探测的便携设备，对于开发者、网络工程师或是经常出差的“数字游民”来说，依然有其独特的价值。它能让你在不掏出手机、不消耗手机电量的情况下，直观地感知周围无线环境。今天，我想分享一个我多年前实践并优化过的项目：基于Arduino Pro Trinket和CC3000 WiFi模块的便携式开源WiFi热点探测器，我称它为“网络嗅探小助手”。

这个项目的核心是一个巴掌大小的设备，通过一个LED灯的不同闪烁模式，告诉你周围WiFi网络的“开放”状态。它完全开源，你可以自己动手焊接、编程，甚至用3D打印机打造专属外壳。整个制作过程涉及硬件选型、电路焊接、嵌入式编程和低功耗设计，是一个综合性的微控制器入门与实践项目。无论你是刚接触Arduino的新手，还是想深入了解无线模块与低功耗优化的爱好者，这个项目都能提供扎实的动手经验和原理知识。接下来，我将从设计思路开始，一步步拆解如何制作这个实用的小工具。

2. 核心硬件选型与设计思路解析

2.1 为什么选择Arduino Pro Trinket与CC3000？

在项目启动时，硬件选型是第一步，也是最关键的一步。它直接决定了项目的可行性、功耗、体积和最终成本。我选择Adafruit Pro Trinket和CC3000模块的组合，是基于以下几个核心考量：

主控：Adafruit Pro TrinketPro Trinket可以看作是Arduino Uno的一个“迷你、强化”版本。它保留了Arduino IDE编程的易用性和丰富的库支持，同时尺寸大幅缩小，非常适合嵌入式便携设备。我选择的是5V/16MHz版本，因为它与CC3000模块的电压逻辑匹配更简单。相比于普通的Trinket，Pro Trinket提供了完整的SPI接口引脚，这对于连接像CC3000这样需要高速通信的外设至关重要。它的另一个优势是原生支持USB编程，无需额外的FTDI编程器，简化了开发流程。

无线模块：CC3000 WiFi BreakoutCC3000是德州仪器（TI）推出的一款单芯片无线网络处理器。选择它，主要是因为在那时它提供了相对完整的TCP/IP协议栈，减轻了微控制器的处理负担。Arduino通过SPI接口向CC3000发送命令，CC3000则负责处理复杂的WiFi连接和网络协议。Adafruit的CC3000分线板做了很好的封装，将难缠的射频电路和天线匹配都做好了，我们只需要关心几个数字引脚即可。它有内置陶瓷天线和外接天线（uFL接口）两种版本。内置天线版本更紧凑，但灵敏度一般；外接天线版本通过连接一个2dBi或5dBi的增益天线，可以显著提升信号接收范围，适合对探测距离有要求的场景。

电源管理：LiPoly Backpack便携设备的核心是电池供电。Pro Trinket本身没有集成锂电池充电和管理电路。Adafruit的LiPoly Backpack（锂电池背包）完美解决了这个问题。它可以直接焊接在Pro Trinket的特定引脚上，提供一个微型USB充电接口，并集成了充电管理、输出保护和电压升降压电路。这意味着你可以使用一块常见的3.7V锂电池，Backpack会将其稳定地升压到5V供给Pro Trinket和CC3000。更重要的是，它允许我们通过一个简单的滑动开关来切断整个系统的电源，实现真正的物理关机，避免待机功耗。

注意：CC3000模块目前已经停产，市面上可能较难买到全新的Adafruit原装模块。但这并不影响项目的学习价值。你可以寻找库存货，或者将其视为一个经典案例来学习其设计思路。其原理（SPI控制、WiFi扫描）与当今更流行的ESP8266/ESP32系列模块是相通的。理解了这个项目，你就能轻松迁移到新的硬件平台上。

2.2 系统工作原理与低功耗设计哲学

这个探测器不是一个持续连接的WiFi客户端，而是一个间歇性工作的扫描器。它的工作流程体现了嵌入式低功耗设计的典型思路：工作-睡眠-唤醒。

1. 初始化：设备上电后，微控制器和CC3000模块完成启动和初始化。此时LED常亮，表示系统就绪。
2. 主动扫描：微控制器通过SPI总线命令CC3000执行一次WiFi网络扫描（SSID Scan）。CC3000会监听其支持的信道，收集周围所有广播自身SSID的无线接入点信息，包括信号强度（RSSI）和加密类型。这个过程通常需要几秒钟。此时LED快速闪烁，提示用户设备正在工作中。
3. 结果解析与指示：微控制器从CC3000读取扫描结果，并逐个分析。其核心逻辑是寻找“开放网络”（即security字段为WLAN_SEC_UNSEC的网络）。一旦发现任何一个开放网络，LED立即进入“慢速闪烁”模式（例如1秒周期，50%占空比），这是一个明确的“发现目标”信号。如果只发现了需要密码的网络（WEP/WPA/WPA2），则LED会以1秒一次的短暂亮起（blip）来指示“有网络但均需密码”。如果什么都没扫描到，LED则以4秒一次的短暂亮起指示“无网络环境”。
4. 深度睡眠：完成扫描和指示后，系统进入低功耗睡眠模式。这里用到了一个高级技巧：利用AVR单片机（Pro Trinket的核心）的看门狗定时器（Watchdog Timer, WDT）作为唤醒源。将WDT设置为约8秒产生一次中断，然后让单片机进入SLEEP_MODE_IDLE模式。在这个模式下，CPU和大部分外设停止工作，但Timer1（用于驱动LED PWM）仍然运行，以维持LED的闪烁指示。同时，代码会关闭SPI、ADC、I2C等未使用的外设电源以进一步省电。
5. 定时唤醒：经过预设的若干个8秒周期（例如7个周期，约56秒）后，WDT中断累积到设定值，系统被唤醒。单片机重新开启必要的外设，唤醒CC3000，然后跳回第2步，开始新一轮的扫描。

这个设计巧妙地将功耗集中在了短暂的扫描时段，而将大部分时间置于极低功耗的睡眠状态。一块100mAh的小电池，足以让设备工作很长时间。这种设计模式在物联网传感器、远程数据记录器等场景中非常普遍。

3. 材料准备与3D打印外壳制作

3.1 物料清单与工具

在动手之前，请准备好所有零件和工具。清晰的物料清单是成功的第一步。

核心电子部件：

• 主控板：Adafruit Pro Trinket 5V/16MHz (产品ID: 2000) 1个
• WiFi模块：Adafruit CC3000 WiFi Breakout with uFL connector (产品ID: 1510) 或 with chip antenna (产品ID: 1469) 1个
• 电源管理：Adafruit Pro Trinket LiIon/LiPoly Backpack (产品ID: 2124) 1个
• 天线组件（如选用uFL版本）：
  • uFL to RP-SMA适配器电缆 (产品ID: 852) 1条
  • RP-SMA接口天线，推荐2dBi (产品ID: 944) 或 5dBi (产品ID: 945) 1根
• 开关与无源器件：
  • 面包板兼容的SPDT滑动开关 (产品ID: 805) 1个
  • 直插LED（任何颜色，建议高亮）1个
  • 220欧姆电阻（1/4瓦）1个
• 电源：锂聚合物电池。标准外壳设计容纳100mAh电池 (产品ID: 1570)。若修改外壳，可使用500mAh电池 (产品ID: 1578) 以获得更长续航。
• 连接线：硅胶导线（多种颜色，22-30AWG）若干，用于板间连接。

工具与耗材：

• 焊接工具：电烙铁、焊锡丝、助焊剂。
• 辅助工具：吸锡器或吸锡带、镊子、尖嘴钳、剥线钳、剪线钳。
• 3D打印相关：
  • FDM 3D打印机（构建体积至少100x100x90mm）。
  • PLA或ABS打印耗材。主体建议用PLA（易打印），光扩散片需用透明或浅色PLA。
  • 3D建模软件（如Fusion 360, Tinkercad）用于可选的外壳修改。
  • 切片软件（如Cura, PrusaSlicer）。

3.2 外壳3D打印与后处理

这个项目的魅力之一在于其定制化的外壳。原始设计提供了四个STL文件：主体（wifiCase.stl）、盖子（wifiCover.stl）、光扩散片（wifiDif.stl）和可穿戴夹子（wifiClip.stl）。

打印参数建议：

• 材料：首选PLA。它打印温度低，不易翘曲，细节表现好，非常适合这种结构复杂的小零件。
• 层高：0.2mm。在打印速度和表面质量间取得良好平衡。
• 填充率：10%-15%。对于这种小尺寸装饰性外壳，这个填充率足以保证结构强度，同时节省材料和时间。
• 打印速度：建议使用切片软件的“标准质量”预设，通常打印速度在50-60mm/s，旅行速度在120mm/s左右。
• 支撑：不需要。原始设计已经考虑了打印角度，所有部件都可以无需支撑直接打印。
• 筏（Raft）：不需要。确保打印床调平良好，使用涂胶棒或专用贴纸增强附着力即可。

关键部件打印要点：

1. 光扩散片（wifiDif.stl）：这是让LED光线均匀照亮外壳上WiFi标志的关键。必须使用透明或半透明的浅色PLA（如白色、自然色）打印。如果使用不透明材料，LED光将无法透出，失去指示功能。打印时可以考虑将层高降低到0.16mm，以获得更光滑的表面，改善透光效果。
2. 主体（wifiCase.stl）：这是容纳所有电路的核心。打印时注意观察第一层的附着情况，确保孔洞（如USB口、天线接口、开关孔）能清晰成型。如果后续需要安装更大的500mAh电池，你需要用3D建模软件（如Tinkercad）编辑这个文件，稍微扩大内部的电池仓空间。
3. 组装顺序：打印完成后，先进行试组装。将光扩散片放入盖子内侧的卡槽，再将盖子扣到主体上。检查夹子是否能顺利卡入主体背面的滑槽。这个过程可以帮助你发现打印公差导致的问题，必要时可以用小刀或砂纸进行微调。

实操心得：打印小尺寸精密部件时，打印床的绝对水平是第一要务。哪怕只有一点点倾斜，都可能导致孔位变形或部件无法严丝合缝。花10分钟仔细调平，能节省后面数小时的打磨和修复时间。另外，PLA材料打印后可能会有轻微收缩，如果盖子太紧，可以用吹风机热风稍微加热盖子边缘，使其软化后更容易安装。

4. 电路焊接与硬件组装详解

4.1 电源电路改造与Backpack焊接

首先处理电源部分，这是整个设备稳定工作的基础。

1. 修改LiPoly Backpack：原始的Backpack设计是通过一个跳线帽来接通电源。为了使用物理开关，我们需要将其改造。找到Backpack上标有“PWR”的两个过孔（它们通常由一个细小的PCB走线连接）。用美工刀或刻刀小心地刮断这两个过孔之间的走线。操作时最好在放大镜下进行，确保只切断目标走线，不损伤旁边的焊盘。刮完后，用万用表的导通档检查，确认两个焊盘之间已经断开。
2. 焊接Backpack排针：将一排直角排针焊接到Backpack的BAT+、G和5V引脚上。这些排针将用于后续连接电源线。焊接时，确保排针与板子垂直。
3. 连接电源线与开关：这是关键步骤。我们需要制作一个“Y型”电源连接。
   • 剪两段红线（正极）和一段黑线（负极）。
   • 将一段红线的一端焊接到Backpack上已被切断的一个PWR焊盘上，另一端焊接到滑动开关的一个外侧引脚上。
   • 将另一段红线的一端焊接到开关的中间引脚上，另一端准备后续连接到Pro Trinket的BAT+引脚。这条线就是系统的主电源正极。
   • 将那段黑线的一端焊接到Backpack上未被切断的PWR焊盘（或直接焊在G焊盘上），另一端准备后续连接到Pro Trinket的GND引脚。这条线是系统的主电源地。
   • 最后，将开关的另一个空闲的外侧引脚悬空即可。这样，开关就串联在了电池正极和主板之间。

4.2 主控板、WiFi模块与指示电路的连接

接下来是核心信号线的焊接。建议先不要将模块固定死，用导线连接测试无误后再最终安装。

接线逻辑对照表：

焊接步骤与技巧：

1. 规划与测量：将Pro Trinket和CC3000模块大致按在最终外壳内的位置摆放。用导线比划一下，估算每条线所需的长度。线长宁长勿短，但也不要留过多余量，以免外壳内杂乱。建议使用不同颜色的硅胶线区分功能（如红色-正极，黑色-地线，黄色-SPI，绿色-控制线）。
2. 先焊排针：在Pro Trinket和CC3000的引脚上焊上排针。这样后续可以用杜邦线进行初步连接和测试，确认无误后再焊接永久导线。
3. 焊接电源线：将来自Backpack的BAT+（红线）和G（黑线）分别焊接到Pro Trinket的BAT+和G引脚。再将来自Backpack5V的线焊接到CC3000的VIN引脚。
4. 焊接信号线：按照上表，依次焊接SPI总线（MOSI,MISO,SCK）和控制线（IRQ,VBEN,CS）。焊接IRQ和CS时尤其要小心，避免焊锡短路到相邻引脚。
5. 焊接LED电路：将220Ω电阻的一端焊接到Pro Trinket的Pin 9。电阻的另一端连接LED的阳极（长脚）。LED的阴极（短脚）连接至任意一个GND点（例如Pro Trinket的GND引脚）。务必确认LED极性，接反了不会亮。
6. 天线安装（如果使用uFL版本）：将uFL转RP-SMA适配线的小头（uFL接口）以垂直方向轻轻按入CC3000模块上的uFL座，听到轻微的“咔嗒”声即可。切忌左右摇晃。然后将RP-SMA天线旋接到适配线的另一头。

注意事项：CC3000模块对电源噪声比较敏感。在焊接电源线时，确保连接牢固，并尽量在VIN引脚附近放置一个10uF的钽电容或电解电容到地，作为电源滤波，可以大大提高模块工作的稳定性。虽然原始BOM里没提，但这是从实际调试中得来的宝贵经验。

4.3 整机装配与测试

在将所有电路塞进外壳前，务必进行上电测试。

1. 裸板测试：暂时不要安装电池。用USB线将Pro Trinket连接到电脑。打开Arduino IDE，选择正确的板卡（Pro Trinket 5V/16MHz）和端口。上传一个简单的Blink程序（修改为Pin 9），测试LED电路是否正常。然后，将后续章节的完整代码上传，打开串口监视器（波特率57600），观察初始化信息。如果看到“Initializing CC3000... OK.”，说明SPI通信和模块初始化成功。
2. 装入外壳：
   • 首先，将uFL天线电缆紧密地盘绕起来，放入外壳底部预留的凹槽内。这是装配中最棘手的一步，如果线没盘好，电路板将无法放入。
   • 然后，以一定角度将焊接好的电路板组合体慢慢滑入外壳。让Pro Trinket的USB接口对准外壳侧面的开口，CC3000模块上的天线接头朝向另一侧。
   • 动作要慢，手感要轻。感觉有阻碍时不要用力硬塞，拿出来重新调整导线或天线电缆的位置。可能需要多次尝试。
3. 安装开关和电池：
   • 用镊子夹住滑动开关，从外壳内侧的开口处将其放入。外壳内部有卡槽和底部平台，可以固定住开关。确保开关的拨杆露在外面。
   • 将100mAh锂电池的线也盘绕好，放入外壳另一侧的电池仓。将电池的JST插头连接到LiPoly Backpack的插座上。
4. 最终合盖：将光扩散片放入盖子的内侧卡槽，确保其平整。然后将盖子对准外壳主体，均匀用力按压四周，直到所有卡扣都扣紧。最后，将可穿戴夹子对准背面的滑槽，用力推入直到锁定。

5. 软件编程与低功耗代码剖析

5.1 开发环境搭建与库安装

代码的编写和上传依赖于Arduino IDE和两个关键的库。

1. 安装Arduino IDE：从Arduino官网下载并安装最新版本的IDE。
2. 配置Pro Trinket支持：在IDE的“文件”->“首选项”的“附加开发板管理器网址”中，添加Adafruit的板卡支持网址：https://adafruit.github.io/arduino-board-index/package_adafruit_index.json。然后打开“工具”->“开发板”->“开发板管理器”，搜索“Adafruit AVR”，安装“Adafruit AVR Boards”包。安装后，就可以在开发板列表中选择“Pro Trinket 5V/16MHz (USB)”了。
3. 安装依赖库：
   • Adafruit CC3000库：这是驱动CC3000模块的核心。可以通过IDE的“库管理器”搜索“Adafruit CC3000”并安装，或者从GitHub下载后手动放入Arduino的libraries文件夹。
   • TimerOne库：用于在Pro Trinket上产生精确的PWM信号来控制LED闪烁。同样可以通过库管理器搜索“TimerOne”安装。

5.2 核心代码逻辑深度解析

项目的核心代码是一个完整的Arduino Sketch。我们来逐块分析其精妙之处。

引脚定义与对象初始化：

#define ADAFRUIT_CC3000_IRQ 3 // 必须使用支持外部中断的引脚（在Pro Trinket上，Pin 2和3是中断引脚） #define ADAFRUIT_CC3000_VBAT 5 // 模块电源使能，可配置 #define ADAFRUIT_CC3000_CS 10 // SPI片选，可配置 Adafruit_CC3000 cc3000 = Adafruit_CC3000(ADAFRUIT_CC3000_CS, ADAFRUIT_CC3000_IRQ, ADAFRUIT_CC3000_VBAT, SPI_CLOCK_DIVIDER);

这里定义了CC3000与Arduino通信的三个关键引脚。IRQ引脚必须连接至支持硬件中断的引脚，因为CC3000会通过中断来通知微控制器数据就绪。

低功耗睡眠与看门狗定时器（WDT）设置： 这是代码中最具技巧性的部分。AVR单片机有多种睡眠模式，SLEEP_MODE_IDLE是其中一种较浅的睡眠，它停止了CPU但保留了定时器等功能，恰好允许Timer1继续驱动LED闪烁。

// 在setup()中配置WDT为8秒产生一次中断 noInterrupts(); MCUSR &= ~_BV(WDRF); WDTCSR = _BV(WDCE) | _BV(WDE); // 启用WDT配置更改 WDTCSR = _BV(WDIE) | _BV(WDP3) | _BV(WDP0); // 启用WDT中断，预分频器设置为8秒 interrupts();

_BV(WDP3) | _BV(WDP0)这个组合决定了WDT的溢出时间。查阅ATmega328P的数据手册可知，这对应着8秒的周期。WDIE位表示溢出时触发中断，而非复位。

主循环（loop）中的状态机：loop()函数构成了一个清晰的状态机：

1. 快速闪烁：Timer1.pwm(TIMER1_A_PIN, 10, 100000)设置PWM频率为10Hz，模拟快速闪烁，表示开始扫描。
2. 发起扫描：cc3000.startSSIDscan(&count)启动扫描，返回发现的网络数量count。
3. 结果处理：
   • 如果count为0，设置LED为4秒亮一下（4000000微秒周期），表示无网络。
   • 如果count大于0，先预设LED为1秒亮一下（1000000微秒周期），表示有网络但可能都是加密的。
   • 然后循环调用cc3000.getNextSSID(...)获取每个网络的详细信息。关键判断是if(sec == WLAN_SEC_UNSEC)，如果发现一个开放网络，立即将LED模式改为慢速闪烁（1秒周期，50%占空比511/1023），并跳出循环。
4. 进入睡眠：扫描结束后，调用wlan_stop()（这是一个自定义函数，内部调用了cc3000.stop()和cc3000.disconnect()）关闭CC3000的射频部分以省电。然后关闭微控制器上不必要的硬件模块（SPI, Timer0, USART），进入for循环，执行sleep_mode()，等待WDT中断累积到指定次数后唤醒。

看门狗中断服务程序（ISR）：

ISR(WDT_vect) { if(!--wdtCount) { noInterrupts(); WDTCSR = _BV(WDCE) | _BV(WDE); WDTCSR = _BV(WDP2) | _BV(WDP1) | _BV(WDE); for(;;); } }

每次WDT中断（每8秒一次），wdtCount减1。如果wdtCount减到0，说明系统在预期的扫描时间内没有完成工作（可能代码死循环了），此时ISR会将WDT从中断模式改为系统复位模式，并在1秒后触发单片机硬重启。这是一个非常经典的“看门狗防死机”机制。

5.3 代码上传与配置要点

1. 选择正确的开发板和端口：在Arduino IDE中务必选择“Pro Trinket 5V/16MHz (USB)”。连接USB线后，在“工具”->“端口”中选择对应的串口。
2. 上传代码：对于Pro Trinket，上传前通常需要先按一下板载的复位按钮，然后在IDE中点击上传，并在短时间内（约10秒内）再次按一下复位按钮，以进入引导加载程序模式。多试几次就能掌握节奏。
3. 串口监视：上传成功后，打开串口监视器，将波特率设置为57600。当你拨动开关打开设备时，应该能看到“Initializing CC3000... OK.”和后续的扫描日志。这是调试的黄金工具。
4. 修改扫描间隔：如果你想调整扫描频率，可以修改sleepIntervals常量。例如，将其从7改为15，睡眠时间就会变成大约15 * 8 = 120秒。注意，扫描本身也会消耗时间，总周期会略长于睡眠间隔。

6. 调试、优化与常见问题排查

即使按照指南操作，也可能会遇到一些问题。这里记录了我实践中遇到的一些坑和解决方法。

6.1 硬件组装问题排查

6.2 软件与功能问题排查

6.3 项目优化与扩展思路

这个经典项目本身已经非常完整，但你还可以在此基础上进行优化和扩展：

1. 升级无线模块：将CC3000替换为ESP8266（如ESP-01S模块）。ESP8266更便宜、功耗更低、性能更强，且自带完整的TCP/IP栈和WiFi功能。你需要重写代码（使用ESP8266的Arduino核心库），并修改电路（ESP8266通常使用UART通信，且需要3.3V逻辑电平）。这将大大提升探测范围和可靠性。
2. 增加显示功能：添加一个小型OLED屏幕（如0.96英寸I2C SSD1306），不仅可以显示“有/无开放网络”，还能滚动显示扫描到的SSID名称和信号强度，让设备更具实用性。
3. 改变指示方式：除了LED，可以增加一个微型振动电机或蜂鸣器。在发现开放网络时，通过振动或声音提示，适合将设备放在包里不便于观看的场景。
4. 数据记录：添加一个微型SD卡模块，将每次扫描到的时间、地点（可配合简单的GPS模块？）、网络列表记录下来，用于无线环境调研。
5. 外壳再设计：利用3D建模软件，设计一个更符合你审美、或者集成腕带、钥匙扣等功能的个性化外壳。

制作这个MASLOW探测器的过程，远不止是完成一个玩具。它是一次对嵌入式系统全栈开发的微型实践：从电路设计、焊接工艺、到低功耗编程、无线通信协议，最后到产品化的外壳设计。虽然CC3000已渐成历史，但其中蕴含的“感知-处理-指示-休眠”的设计范式，以及用硬件和代码解决实际问题的思路，在任何时代的物联网项目中都不过时。希望你在动手实现的过程中，不仅能收获一个实用的小工具，更能体会到硬件创客的乐趣与成就感。如果在制作中遇到任何问题，回顾一下第六部分的排查表格，大部分难题都能找到线索。祝你制作顺利！