BUSMASTER 与固件升级器支持日志

遇到工程加载、诊断或固件升级问题时，先记下软件完整版本和 Build、问题发生时间与时区，再保存本次操作的日志。两个程序各自生成日志，请按实际使用的程序收集。

找到本次操作的日志

1. 在运行程序的 Windows 账户里按 Win + R，输入 %LOCALAPPDATA%\BUSMUST\Support 后回车。如果程序在虚拟机、另一台电脑或另一个 Windows 账户运行，请到对应环境查找。
2. 对于采用统一支持日志布局的版本，按下表保存当前文件和已有归档。用 下载中心 对照实际安装包的 Build 和发布说明。3.2.2.51 Build 565 仍使用旧路径，见下节。安装过多个版本时，请用修改时间确认文件属于本次操作。
3. 重试、重启或重新打开工程前先复制现有文件。程序正常退出后可以再补采结束记录。固件升级器按会话保存日志，请在下一次启动升级器前复制文件。

程序	文件	记录内容
BUSMASTER	BusMustSupport.log；存在时同时保存 BusMustSupport.log.previous 和 BusMustSupport.log.previous.pending	DBC、CFX 加载／保存／错误、XCP A2L、CANopen、E2E
固件升级器	FirmwareUpdate.log	本次升级会话的诊断。时间使用 UTC，N 是序号，E 是事件，R 是结果，适用时 W 是 Windows 错误码。

BUSMASTER 以 UTF-8 写入记录，在下一条完整记录将超过 128 MiB 前轮转，保留一份前次归档。轮转中断时留下的 .previous.pending 可能包含完整旧归档，请一并保存。升级器每次会话上限为 64 KiB，启动新会话可能替换上一份日志。

使用旧日志布局时

问题	使用该模块独立日志的旧版本
导入或解析 DBC	在实际运行的 BUSMASTER.exe 同目录找 dbc_load_log.txt。
加载或保存 CFX 工程	在 BUSMASTER.exe 同目录找 config_load_log.txt、config_save_log.txt，以及加载出错时的 config_load_*.err。程序目录不可写时也可查同一账户的 %TEMP%。
导入 A2L	在 BUSMASTER.exe 同目录找 a2l_load_log.txt，并保存已有的 a2l_load_log.txt.previous。
CANopen 或 E2E	在 BUSMASTER.exe 同目录找 canopen_diagnostic_log.txt 或 e2e_diagnostic_log.txt，以及存在的同名 .previous。
固件升级	在运行升级器的账户中打开 %LOCALAPPDATA%\BUSMUST\FirmwareUpdate\logs，保存 FirmwareUpdate-Support.log。正常退出升级器后、下次启动前收集。

改用新日志布局后，先前生成的旧日志留在原处。按文件时间区分旧现场和本次操作。

缺少记录时怎么查

BUSMASTER 收到首条可写入的诊断才创建文件。文件不存在、无法复制或时间未更新时，先核对 Windows 账户、应用版本、磁盘空间和目录可写性。如果文件正被占用，可在相关操作完成且程序正常退出后重试复制。日志可能因写入失败、队列丢失、退出中断或轮转而缺少部分记录。保留现有文件，并记下缺少的文件或时间段。

在统一日志中按 source 找对应模块。结合可用的进程／会话、操作阶段及原始错误码定位。如果记录缺少这些字段，请在反馈中补充复现步骤和时间。判断实际总线收发时，同时提供同一时段的 ASC、BLF 或 LOG 报文记录，或独立接收端证据。TF 卡录制／回放、BMAPI 调试输出和固件恢复数据继续按各自流程收集。

提交反馈

1. 提供软件完整版本和 Build、升级器版本（如适用）、复现时间与时区、操作功能、预期与实际结果。按问题需要附工程或配置、设备型号与固件版本、通道、截图和对端记录。
2. 保存原始文件，分享前检查副本里的本机路径、设备标识和业务数据。能脱敏时使用副本，并说明处理过哪些内容。
3. 在 技术支持 页面点击 提交结构化反馈。表单最多接收 3 个附件，单个 5 MiB、合计 10 MiB，支持 PNG、JPEG、WebP 和 UTF-8 的 TXT、LOG、JSON。若文件超限或是归档、ZIP，先在表单提交复现信息和文件清单，记录受理编号，再通过该页的微信客服或 support@busmust.com 确认原始文件的交付方式。

---

如需安装或升级 BUSMASTER，请前往下载中心获取当前正式版本与历史版本。