常见问题

[返回 HX Wireless BLE Sniffer 用户指南](https://docs.wireless-tech.cn/doc/184/)

每项先说明问题现象，再列出对应的排查和解决步骤。更新流程请看[检查与安装更新](https://docs.wireless-tech.cn/doc/186/)。

## Wireshark 里看不到 HX Wireless BLE Sniffer

**问题现象**：Wireshark 欢迎页或接口列表中没有 HX Wireless BLE Sniffer。

**解决方法**：

1. 确认设备已供电，并通过 USB 数据线连接。Windows 可在设备管理器中确认设备识别和 WinUSB 驱动；macOS 可在“系统信息”中查看 USB 设备。
2. 完全退出 Wireshark，包括后台抓包进程，再重新打开。
3. **使用当前发布包中与你的操作系统对应的安装脚本**，重新安装 Host/Extcap 组件，然后重启 Wireshark。客户无需填写 COM 口。
4. 仍看不到接口时，换一个 USB 数据线或端口再试；确认没有其他抓包或升级程序占用设备。

## 开始抓包后没有数据包

**问题现象**：抓包已经开始，但包列表没有出现预期的广播或连接数据。

**解决方法**：

1. 抓广播时，将 Device 设为 All advertising devices；抓某个设备的连接流量时，请在连接建立前选中对应设备。 **All 不会跟踪 ACL 连接。**
2. 确认目标设备当前正在广播、已上电并处于接收范围内。自动发现覆盖 **LE 1M Primary**；如果目标只使用 **Coded Primary**，当前自动发现不会看到它。
3. 点击 Read Stats 查看 uptime 和 rx 是否变化。若 **rx 在增加但列表为空**，检查是否设置了捕获过滤器或显示过滤器。
4. 若 uptime 增加而 rx 不变，检查发射设备、天线、距离和配套固件；**rx 不变本身不能证明嗅探器故障。**
5. 若 Read Stats 也无响应，检查 USB 连接和驱动，并关闭其他可能占用设备的抓包或升级进程。

## 看到广播或连接请求，但没有后续 ACL

**问题现象**：可以看到目标广播或连接请求，但没有后续连接数据包。

**解决方法**：

1. 开始连接前，在 Device 中选中正确的目标设备。All advertising devices 只用于广播跟踪。 **All 不会跟踪 ACL。**
2. 如果目标已经连接，先断开连接；开始抓包并选好目标后，让目标重新连接。这样可以从连接建立阶段开始捕获。
3. 确认抓包覆盖完整的 CONNECT_IND，或扩展连接使用的 AUX_CONNECT_REQ/RSP。
4. 查看 Status 中是否出现目标不匹配、未进入 Follow 等提示。扩展连接还应确认已看到 ADV_EXT_IND、AuxPtr 和 AUX_CONNECT_REQ/RSP。

## 抓包界面中途不再滚动

**问题现象**：抓包窗口仍打开，但包列表不再增加，或连接结束后没有看到目标的后续数据。

**解决方法**：

1. 点击 Read Stats，比较 uptime、rx、crc、transport 和 gap。若 rx 不再变化，先确认发射源是否还在发送，并检查天线和距离。
2. 连接结束后，设备会继续等待当前选定目标重新连接；**不会自动切回 All**。让该目标重新连接，或停止抓包后重新选择 Device 再开始抓包。
3. Periodic 失锁时，设备会扩大接收窗口并启用恢复资源；如果空口没有新包，**Wireshark 不会生成虚拟数据包**。
4. 若 Read Stats 无响应，检查 USB 连接和驱动，并确认没有其他进程占用嗅探器。

## 加密 ACL、EAD、Mesh 或 BIS 无法解密

**问题现象**：Wireshark 显示 MIC/CMAC 校验失败、缺少解密资料，或加密载荷无法解析。

**解决方法**：

1. 先看具体提示：**缺少资料**通常表示密钥或参数未提供；**MIC/CMAC failure** 时，核对密钥、IV、目标设备和抓包是否完整。
2. 在工具栏选择匹配的 Key Type，核对密钥长度、字节顺序、目标设备和 IV Index，再添加密钥。**Secure Connections 的显示数字不能替代 SC LTK。**
3. **ACL 加密需要从连接和加密建立阶段开始抓包。**

Legacy Passkey/OOB 还需覆盖完整的 Confirm/Random 交换；若抓包晚于握手，重新开始连接并从头抓取。
4. EAD 需要正确的 SessionKey 和 IV；Mesh 至少需要 NetKey 和 IV Index，解析 Access 层还需要对应的 AppKey/DevKey。
5. **加密 BIS 应在开始接收时提供正确的 Broadcast Code。** 开始较晚无法补回之前漏掉的数据包。

## 右侧没有解析字段，或只看到 Raw Data

**问题现象**：选中数据包后，右侧没有 HX BLE Analysis，或厂商载荷只显示 Raw Data。

**解决方法**：

1. 先选中左侧的一条包记录，再展开右侧的 HX BLE Analysis。
2. 如果整个分析区都不存在，完全退出并重启 Wireshark，确保新插件已加载；仍不存在时，运行当前发布包中对应平台的安装脚本重新安装 Host/Extcap。
3. 标准 BLE 字段可继续展开 Bluetooth Low Energy Link Layer。
4. 如果只有厂商私有载荷显示 Raw Data Length 和 Raw Data，**但没有对应协议规格，这是预期显示方式**；需要协议定义才能继续解析。

## Status、Help、Read Stats 或工具栏显示异常

**问题现象**：按钮缺失或顺序不对，Help、Read Stats、Status、Reset 的行为与预期不一致。

**解决方法**：

1. **确认 Host/Extcap 来自同一个发布包，并完全退出后重启 Wireshark。**

Host/Lua 与无线节点固件是独立组件，按升级说明分别确认版本。
2. 最大化 Wireshark 窗口。工具栏的关键顺序应为 Status → Read Stats → Help → Reset。
3. Help 应打开本地用户指南；Read Stats 应显示统计弹窗并把结果写入 Status。
4. **Reset 需要先停止抓包。**

若旧标签或旧顺序仍存在，使用当前发布包中对应平台的安装脚本重新安装 Host/Extcap，再重启 Wireshark。