项目名称:Android 蓝牙助手应用
项目概述:
本项目旨在开发一款功能全面的 Android 端蓝牙助手应用,用于扫描、连接、调试和管理各种蓝牙设备。应用将覆盖 BLE(Bluetooth Low Energy)和经典蓝牙(Bluetooth Classic)设备,提供多样化的功能模块。
目标用户:
开发者:用于蓝牙调试与开发。
用户:用于蓝牙设备的管理与监控。
核心功能模块:
1、设备扫描与连接:
支持 BLE 设备扫描:
扫描间隔设置(单位:毫秒),支持自定义输入。
扫描超时时间设置(单位:秒),超过超时时间后自动停止扫描。
扫描过程中实时显示发现的设备列表,包括设备名称、MAC 地址、RSSI、设备类型(BLE/经典蓝牙)。
扫描结果按 RSSI 值排序,方便用户定位信号最强设备。
支持经典蓝牙设备扫描:
支持获取设备的配对状态(已配对/未配对)。
支持设备连接前展示配对 PIN 码。
自定义扫描过滤条件:
支持输入设备名称关键字进行筛选,匹配部分名称或完整名称。
支持输入 MAC 地址前缀或完整 MAC 地址进行筛选。
支持指定 UUID 进行设备过滤,仅显示特定服务的设备。
支持显示设备的 RSSI、名称、MAC 地址等信息:
RSSI 实时更新,信号强度采用颜色渐变显示(例如:红-弱,黄-中,绿-强)。
支持设备自动重连:
用户可设置自动重连的时间间隔(单位:秒)。
支持重连次数限制(例如:最多重连 3 次)。
支持 BLE 设备扫描:
扫描间隔设置。
扫描超时时间设置。
扫描过程中实时显示发现的设备。
支持经典蓝牙设备扫描:
支持配对与取消配对操作。
自定义扫描过滤条件:
支持按设备名称、MAC 地址、UUID 进行筛选。
支持模糊匹配与精准匹配。
支持显示设备的 RSSI、名称、MAC 地址等信息:
RSSI 实时更新,显示信号强度变化。
支持设备自动重连:
设置重连间隔与重连次数。
2、设备信息展示:
展示设备基本信息:
设备名称、MAC 地址、信号强度(RSSI)、设备类型(BLE/经典蓝牙)。
设备电量信息(仅适用于支持电量广播的设备)。
信号强度(RSSI)可以根据其数值范围划分为多个等级,以方便用户直观识别。常见的划分方式如下:
强信号:
RSSI ≥ -50 dBm
表示设备距离较近,信号强度非常好,连接质量优。
较强信号:
-50 dBm > RSSI ≥ -65 dBm
表示设备距离较近至中等范围,信号质量较好,通信较稳定。
中等信号:
-65 dBm > RSSI ≥ -75 dBm
表示设备距离中等范围,信号质量一般,可能偶尔有数据丢失现象。
较弱信号:
-75 dBm > RSSI ≥ -85 dBm
表示设备距离较远,信号质量较差,通信可能会出现延迟或丢包。
弱信号:
RSSI < -85 dBm
表示设备距离较远或有较多障碍物,信号非常弱,连接不稳定,可能频繁掉线。
BLE 设备 GATT 服务展示:
展示所有 GATT 服务的 UUID 列表,按服务 UUID 排序。
每个服务下展示特征值(Characteristics)的 UUID、属性(读/写/通知)。
支持折叠与展开服务树结构,点击服务项可展开查看其特征值及描述符。
特征值详情查看:
点击特征值显示详细信息,包括属性、UUID、值类型(HEX、ASCII)。
支持实时刷新特征值内容。
支持设备信息刷新与更新:
用户手动触发刷新,重新获取设备信息。
展示设备基本信息:
设备名称、MAC 地址、信号强度、连接状态。
BLE 设备 GATT 服务展示:
展示服务 UUID、特征值 UUID、描述符 UUID。
支持折叠与展开服务树结构。
支持设备信息刷新与更新。
显示设备电量信息(如果设备支持)。
展示设备基本信息(名称、MAC 地址、信号强度等)。
展示 BLE 设备的 GATT 服务、特征值(Characteristics)及描述符(Descriptors)。
3、蓝牙数据调试:
支持 BLE 数据收发:
手动输入 HEX、ASCII 数据并发送。
支持循环发送与延迟发送。
支持经典蓝牙数据收发:
经典蓝牙 SPP 协议通信。
数据包模板:
常用数据包保存。
快速发送已保存的数据包。
数据帧监控:
实时显示接收与发送的数据帧。
数据帧统计与分析。
数据格式转换:
支持 HEX、ASCII、UTF-8、Base64 互相转换。
支持 BLE 数据收发(发送 HEX、ASCII 数据)。
支持经典蓝牙数据收发(支持 SPP 协议)。
支持常用数据包模板保存与快速发送。
数据帧监控,实时查看发送与接收的数据。
支持数据格式转换(HEX、ASCII、UTF-8)。
4、日志管理:
实时日志查看:
日志按设备、时间排序。
支持日志暂停与清除。
日志筛选:
按数据类型(发送/接收)。
按设备名称或 MAC 地址。
日志导出:
支持导出为 TXT、CSV 文件。
支持选择导出日期范围。
实时日志查看。
支持日志筛选(按设备、时间、数据类型等)。
支持日志导出为文本或 CSV 文件。
5、OTA 升级:
支持 BLE 设备的 OTA 升级:
支持 DFU(Device Firmware Update)模式。
升级过程中实时显示进度。
固件文件选择:
支持 .bin、.hex 文件选择。
校验文件完整性。
OTA 升级状态监控:
显示当前升级进度。
升级失败自动重试机制。
支持 BLE 设备的 OTA 升级。
支持固件文件选择与校验。
显示 OTA 升级进度与状态。
6、设备控制模块:
支持常用蓝牙指令发送(如连接、断开、查询电量等)。
支持自定义指令集。
支持指令发送结果显示。
7、设置与个性化:
支持自定义扫描间隔与扫描超时时间。
支持更改应用主题(深色/浅色模式)。
支持通知设置(如数据接收通知、连接状态通知等)。
8、调试工具:
数据模拟器(模拟数据发送)。
数据解析器(解析接收的数据为 JSON、XML、HEX 等格式)。
9、设备管理:
支持已连接设备的自动保存。
支持设备重命名、标记。
支持设备分组与快速连接。
10、高级功能:
信号强度图表展示。
支持多设备同时连接与数据交互。
自定义协议解析器。
非功能性需求:
兼容 Android 8.0 及以上版本。
优化 BLE 连接稳定性。
保证应用内存占用合理,避免内存泄漏。
支持英文与中文双语言版本。