SDK_APP/快速故障排除指南.md

117 lines
2.8 KiB
Markdown
Raw Normal View History

2025-09-03 12:42:59 +08:00
# 快速故障排除指南
## 当前问题客户端找不到SerialTest服务器
### 立即检查清单
#### ✅ 手机端检查
- [ ] 蓝牙已开启
- [ ] 蓝牙可见性设置为"始终可见"
- [ ] 已清除蓝牙缓存
- [ ] 重启过蓝牙服务
#### ✅ 电脑端检查
- [ ] SerialTest正在运行
- [ ] 选择了正确的COM端口
- [ ] 启用了蓝牙服务器模式
- [ ] 电脑蓝牙已开启
- [ ] 电脑蓝牙设置为"可发现"
#### ✅ 环境检查
- [ ] 设备距离在10米内
- [ ] 远离其他蓝牙设备干扰
- [ ] 没有金属屏蔽物
### 快速测试步骤
#### 步骤1基础扫描测试
1. **启动Android应用**
2. **点击"连接蓝牙"按钮**(普通点击)
3. **观察扫描结果**
- 是否显示"🔍 开始扫描蓝牙设备..."
- 是否显示"📡 使用BLE扫描模式"或"📡 使用传统蓝牙扫描模式"
- 是否发现任何设备
#### 步骤2直接连接测试
1. **长按"连接蓝牙"按钮**
2. **输入MAC地址**`60:E9:AA:30:8B:0A`
3. **点击连接**
4. **观察连接状态**
#### 步骤3系统蓝牙测试
1. **打开手机蓝牙设置**
2. **扫描设备**
3. **查看是否发现您的电脑设备**
4. **如果发现,尝试配对**
### 常见问题及解决方案
#### 问题1扫描不到任何设备
**可能原因**
- 目标设备蓝牙未开启
- 设备不在可见范围内
- 蓝牙服务异常
**解决方案**
1. 重启手机蓝牙
2. 重启电脑蓝牙
3. 检查设备距离
4. 使用系统蓝牙设置测试
#### 问题2扫描到设备但连接失败
**可能原因**
- 设备未配对
- 协议不兼容
- SerialTest配置错误
**解决方案**
1. 在系统蓝牙设置中手动配对
2. 检查SerialTest配置
3. 确认波特率设置
#### 问题3连接成功但无法通信
**可能原因**
- 数据格式不匹配
- 波特率设置错误
- 协议不兼容
**解决方案**
1. 检查SerialTest数据格式设置
2. 尝试不同的波特率
3. 发送测试数据验证
### 调试信息查看
#### Android Studio Logcat
过滤标签:`BluetoothManager`
查看以下信息:
- 扫描开始和结束
- 设备发现详情
- 连接状态变化
- 错误信息
#### 应用状态显示
应用会显示:
- 🔍 扫描状态
- 📱 发现的设备信息
- ✅ 连接成功提示
- ❌ 错误信息
### 下一步操作
1. **按照检查清单逐一确认**
2. **执行快速测试步骤**
3. **记录每个步骤的结果**
4. **查看Logcat日志**
5. **如果问题持续,提供详细错误信息**
### 需要提供的信息
如果问题仍然存在,请提供:
1. **手机型号和Android版本**
2. **电脑操作系统版本**
3. **SerialTest版本和配置截图**
4. **应用扫描过程的截图**
5. **Logcat中的错误日志**
6. **系统蓝牙设置中的设备列表截图**