117 lines
2.8 KiB
Markdown
117 lines
2.8 KiB
Markdown
# 快速故障排除指南
|
||
|
||
## 当前问题：客户端找不到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. **系统蓝牙设置中的设备列表截图**
|