连接与设备发现

连接页是 NexuTrace 的入口。这里不只是选择端口，而是决定后续数据会按哪种链路进入：普通字节流、USB 调试通道、网络流，还是 USB-CAN 报文。

连接模式总览

模式	适合设备	关键参数
串口调试	MCU UART、USB 转串口、Bootloader、AT 指令设备	端口、波特率、数据位、停止位、校验位、流控制。
虚拟串口	USB CDC 设备、系统枚举出的 COM 设备	与普通串口一致，重点确认驱动和 COM 号。
USB 调试 - HID	标准 HID、自定义 HID 调试通道、免驱 USB 设备	VID/PID、接口号、UsagePage、Usage、输入/输出报告长度。
USB 调试 - WinUSB	自定义厂商接口、高吞吐端点、设备调试接口	VID/PID、接口号、GUID、Bulk/Interrupt 端点、端点包长。
网络调试 - TCP Server	设备主动连上电脑，电脑作为服务端监听	本地监听地址、监听端口、防火墙放行。
网络调试 - TCP Client	设备作为服务端，电脑主动连接设备	服务器 IP、服务器端口。
网络调试 - UDP	UDP 设备、广播/定向数据、轻量仿真器	本地绑定 IP、本地端口、远端 IP、远端端口。
USB-CAN - VCAN	NexuTrace/VCAN 兼容设备	CAN 模式、总线模式、仲裁波特率、数据波特率、终端电阻、总线负载上报。
USB-CAN - Candle/GS_USB	Candle 兼容设备、GS_USB 设备	CAN/CAN FD 配置、总线模式、波特率、过滤器和设备模式。

设备列表怎么看

连接窗口左侧会列出可连接设备。不同设备类型显示的信息不同，但核心判断方法一致：

字段	用途
设备名称	快速区分同类设备。无名称时以 VID/PID、端口或路径为准。
VID/PID	USB 设备身份。多个同款设备同时接入时，配合序列号判断。
接口号	多接口 USB 设备常见。HID、WinUSB、CDC 可能在不同 interface。
端点	WinUSB/HID 的输入输出通道。包长异常时先看端点信息。
UsagePage / Usage	HID 设备用途描述。自定义 HID 通常用厂商自定义 UsagePage。
序列号	多台同型号设备并行调试时最可靠的区分依据。
GUID	WinUSB 厂商接口识别信息，驱动绑定不对时这里可能为空或异常。

如果设备没有出现在列表里，先不要改协议配置。应先检查驱动、线缆、供电、设备管理器枚举、USB 模式和防火墙。

普通串口、USB 和网络模式的更详细说明见 串口、USB 与网络普通模式；协议格式本身见 协议格式详解。

串口连接

串口最容易连上，也最容易因为参数不一致造成“看起来像乱码”的问题。

参数	建议
波特率	常见值是 115200。日志能看到但内容错乱时，先核对波特率。
数据位	常见为 8 位。
停止位	常见为 1 位。
校验位	常见为无校验。工业设备可能使用偶校验或奇校验。
流控制	大多数 MCU 调试口不用流控。硬件流控设备需要 RTS/CTS 配合。

串口连接成功后，先打开文本视图和 Hex 分析视图。文本看可读性，Hex 看真实字节，两者结合能快速判断编码还是协议问题。

USB HID 与 WinUSB

HID 更适合免驱、低到中等吞吐、固定报告长度的设备；WinUSB 更适合自定义端点和高吞吐数据。选择错误时常见现象是能枚举但不能收发。

HID 调试重点：

1. 确认 UsagePage/Usage 是否是目标接口。

2. 确认报告长度，发送内容不要超过设备期望长度。

3. 设备如果不实现完整 HID descriptor，NexuTrace 会尽量静默跳过并记录诊断。

WinUSB 调试重点：

1. 确认设备绑定 WinUSB 驱动。

2. 确认 IN/OUT 端点地址和包长。

3. 高频发送时优先观察状态栏 TX/RX 速率和等待路径。

网络连接

TCP Server、TCP Client、UDP 的核心差别是“谁等谁连接”：

子模式	工作方式	常见检查
TCP Server	NexuTrace 监听端口，设备主动连入	防火墙、本机 IP、端口占用。
TCP Client	NexuTrace 主动连接设备或仿真器	设备 IP、端口、网段、服务是否启动。
UDP	无连接收发，适合广播、状态流和轻量测试	本地绑定、远端地址、端口、是否被路由或防火墙拦截。

网络调试建议先用短文本或固定 HEX 包验证收发，再启用协议解析。

USB-CAN 连接

USB-CAN 的连接参数比普通串口多，因为它同时涉及 USB 设备模式和 CAN 总线配置。

1. 子模式选择 VCAN 或 Candle/GS_USB。

2. CAN 模式选择标准 CAN、ISO CAN FD 或 NON-ISO CAN FD。

3. 总线模式选择 Normal、ListenOnly 或 LoopBack。

4. 设置仲裁波特率；CAN FD 还要设置数据波特率。

5. 需要时开启终端电阻和总线负载率上报。

6. 连接后打开 CAN 表确认 ID、DLC、Data 和状态行。

如果设备被切到 PCAN 兼容模式，通常应使用 PCAN 厂商工具访问；要继续用 NexuTrace，请把设备切回 VCAN 或 GS_USB。

连接后的第一分钟

连接成功后，建议按这个顺序确认：

1. 状态栏显示已连接，设备类型和名称正确。

2. RX/TX 计数是否随数据变化。

3. 文本、表格或 CAN 表是否有数据。

4. Hex 视图里的字节是否符合预期。

5. 再启用协议解析，并观察 Raw Frame 或通道值。

这样做可以避免把驱动、链路、编码、总线配置问题误判成协议问题。