低成本一体化 WiFi / 蓝牙现场分析采集仪

一、项目概述

本项目基于 ESP32 CYD（Cheap Yellow Display）一体化带屏开发板，在 ESP32 Marauder 开源框架基础上完成适配移植，研制一款低成本便携式无线信号勘测终端。针对传统专业无线测试仪器价格昂贵、体积大、不便携带，现场勘测依赖电脑上位机的痛点，打造可独立脱机工作的轻量化无线环境巡检工具，仅用于授权内网环境下无线网络摸排、信道资源评估、物联网无线资产盘点、无线点位测绘等合规测试场景，不用于非授权网络探测。

二、硬件方案

项目主控采用 Sunton ESP32 CYD 一体化开发板，硬件集成 ESP32 主控、TFT 触控显示屏、供电管理、SD 卡存储接口，无需额外搭建外围显示、按键电路，整机结构紧凑。硬件兼容多款 CYD 规格：1.9 寸无触摸、2.4/2.8 寸电阻触摸、3.5 寸电容 / 电阻触摸版本；预留扩展接口，可外接 GPS 模块，实现勘测点位经纬度绑定，满足路测测绘需求。设备支持 Type‑C 供电，可搭配锂电池实现户外移动作业。

三、核心功能

WiFi 信号勘测：支持无线接入点与终端设备信标扫描，识别热点名称、信号强度、工作信道、厂商信息，生成信道占用图谱，直观评估信道拥挤情况；支持勘测数据本地存储至 SD 卡，可导出记录文件用于后续分析。
蓝牙信标采集：采集周边蓝牙广播报文，识别 BLE 物联网设备、Beacon 标签、AirTag 等蓝牙资产，辅助厂区、园区内蓝牙设备盘点。
点位测绘（Wardriving）：外接 GPS 模块后，采集的每一条无线信号记录同步绑定地理位置，实现无线网络分布地图测绘。
本地可视化交互：搭载触控菜单，全部功能可在屏幕上直接操作，脱机独立运行，现场实时查看扫描结果，不需要笔记本电脑配合。
数据导出复盘：采集日志、信号记录保存在 SD 卡，导出后可在 PC 端做二次统计、无线环境复盘。

四、软件实现

软件基于开源 ESP32 Marauder 固件二次适配开发，完成 CYD 屏幕驱动、触控驱动、SD 存储、GPS 串口驱动适配。固件提供网页刷写工具，支持一键烧录，也支持 Arduino IDE 源码编译。软件内部做了功能模块化拆分，分为扫描采集模块、屏幕 UI 交互模块、文件存储模块、GPS 解析模块，便于后续迭代新增功能、适配更多型号硬件。

五、应用场景

本工具面向企业信息化运维场景，在授权内网环境使用：厂区无线覆盖摸排、WiFi 信道优化评估、车间物联网蓝牙资产巡检、新建楼宇无线网络前期勘测、无线电磁环境摸底，作为专业频谱仪的轻量化补充工具。相比商用专业无线测试仪，设备成本大幅降低，适合一线运维人员常态化现场巡检。

六、项目特色与创新点

一体化便携：主控、屏幕、触控、存储集成在单块开发板，整机小巧，支持电池供电，适合移动现场勘测；
低成本方案：依托通用开源硬件，硬件采购成本低，门槛低，便于批量部署；
脱机独立作业：自带屏幕交互，摆脱对电脑的依赖，即开即用；
可扩展能力：预留 GPS 扩展，支持无线点位地理测绘，适配路测场景；固件开源可二次开发，可按需增加过滤、报表导出等定制功能。

七、合规说明

本项目为无线环境评估的技术工具，仅允许在自有、已获得书面授权的网络环境中开展测试，严禁对公共网络、他人私有无线网络进行未授权探测、报文捕获等操作，使用方需要遵守网络安全相关法律法规。

八、License

MIT license

九、项目地址

https://github.com/Fr4nkFletcher/ESP32-Marauder-Cheap-Yellow-Display