快速开始#

获取发布包#

NexuTrace 建议使用完整发布包运行，不建议只拷贝单个 NexuTrace.exe。发布包包含主程序、资源、语言文件、配置目录和更新程序，缺少任一部分都可能导致图标、语言、数据面板或更新功能异常。

获取方式

地址

适合情况

GitHub 发布仓库

vseasky/NexuTraceRelease.git

可访问 GitHub 时优先使用，适合获取最新发布包和版本记录。

Gitee 镜像仓库

gitee.com/vseasky/NexuTraceRelease

国内网络访问 GitHub 不稳定时使用。

授权码购买

淘宝授权码链接

试用验证通过后购买正式授权码。

如果通过 git clone 获取发布仓库，可以使用：

git clone https://github.com/vseasky/NexuTraceRelease.git

网络到 GitHub 不稳定时，也可以从 Gitee 页面下载同名发布仓库。下载完成后先解压到一个普通英文路径，例如 D:\Tools\NexuTrace，再运行主程序。

准备运行#

在 Windows 10/11 上解压 NexuTrace 发布包后，直接运行 NexuTrace.exe。如果从源码或内部构建目录运行，请保持这些目录和文件与程序放在一起：

项目

用途

Resource/Image、VekLang

图标、界面资源和中英文语言文件。

config/cfg_data

数据面板 JSON 配置，保存协议帧、通道、公式和波形绑定。

config/cfg_model

3D 场景配置，保存模型文件路径和节点绑定。

update.exe

检查更新或执行升级时使用。

如果界面、图标或语言显示异常，优先确认发布包是否完整；如果程序无法启动，再检查显卡驱动和 DirectX 11 运行环境。

首次打开检查#

  1. 确认运行的是发布包目录内的 NexuTrace.exe。

  2. 如果 Windows 安全提示拦截，先确认发布包来源，再选择允许运行。

  3. 打开后进入设置或授权窗口，确认当前处于试用、已激活或离线授权状态。

  4. 如果已经购买授权码，输入授权码并按提示激活；如果还在评估期，先完成下面的第一次收发。

  5. 建议在正式现场前把发布包、授权码、数据面板配置和常用工作区放到同一项目资料夹中备份。

五分钟完成第一次收发#

  1. 打开 NexuTrace，在顶部连接区域选择设备类型。

  2. 按设备选择参数：串口选择端口和波特率，网络选择地址和端口，USB 选择 HID 或 WinUSB，USB-CAN 选择 VCAN 或 Candle/GS_USB。

  3. 点击连接，先观察原始文本、表格或 Hex 视图是否有接收数据。

  4. 在发送区输入一条测试命令。文本命令用 ABC 模式，二进制命令用 HEX 模式。

  5. 如果设备使用结构化协议，再到数据面板选择 FireWater、JustFloat 或 NexuFrame，并建立帧与通道映射。

连接类型怎么选#

连接类型

适合场景

先检查什么

Serial / Virtual Serial

MCU 日志、AT 指令、Bootloader、USB CDC 虚拟串口

端口号、波特率、数据位、停止位、校验位和编码。

USB Debug - HID

自定义 HID 调试通道、免驱设备

VID/PID、接口号、输入/输出报告长度。

USB Debug - WinUSB

高吞吐自定义 USB 端点、设备调试接口

端点地址、包长、驱动是否绑定到 WinUSB。

Network Debug

TCP Server、TCP Client、UDP 设备或仿真器

本地绑定地址、远端 IP、端口、防火墙。

USB-CAN

VCAN、Candle/GS_USB、CAN/CAN FD 联调

设备模式、CAN 模式、仲裁波特率、数据波特率、终端电阻和总线模式。

常用默认值#

项目

默认值

说明

串口波特率

115200

最常见的 MCU 日志速率，连接不上时先和固件配置核对。

TCP / UDP 端口

32401

网络调试默认端口，可按设备协议调整。

TCP Client 远端地址

127.0.0.1

本机仿真默认值，连接真实设备时改为设备 IP。

TCP Server / UDP 本地地址

0.0.0.0

监听所有网卡，适合快速验证。

CAN 仲裁波特率

500000

常见 Classic CAN 与 CAN FD 仲裁段速率。

CAN FD 数据波特率

2000000

仅在 CAN FD 且 BRS 相关场景中使用。

第一次使用 USB-CAN#

  1. 连接类型选择 USB-CAN。

  2. 子模式选择设备当前模式：VCAN 或 Candle/GS_USB。

  3. CAN 模式选择 Standard CAN、ISO CAN FD 或 NON-ISO CAN FD。

  4. 总线模式选择 Normal；只想旁听时选择 ListenOnly；自测回环时选择 LoopBack。

  5. 设置仲裁波特率和数据波特率。复杂位时序可以打开位时序计算器或使用预设。

  6. 如果设备支持终端电阻，按实际总线拓扑开启或关闭。

  7. 连接后打开 CAN 表，确认是否能看到 ID、DLC、Data、状态帧或错误提示。

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

第一条发送怎么选#

发送入口

适合内容

单条发送

临时命令、AT 指令、短二进制包、需要按 Enter 发送的交互。

多条发送

多个命令按不同周期轮询，例如读取版本、电压、电流、状态。

文件发送

脚本、大块测试数据和协议回放文件；可暂停、继续、取消并观察进度。

CAN 发送

标准帧、扩展帧、远程帧、CAN FD、BRS、周期报文和手动发送。

数据面板 TX 帧

已经配置好协议帧和通道，希望按字段值生成协议包。

建议你第一次调试时先保留原始视图，不要一开始只看解析结果。原始数据能证明链路是否通，解析结果能证明协议是否对。