FAQ
应用程序无法启动，或 Windows 警告该文件
当前构建未签名。首次运行时 SmartScreen 可能显示警告。确认文件来自官方下载页，然后使用 More info → Run anyway。需要 x86 Visual C++ 2015–2022 Redistributable。
应用程序也可以直接从构建文件夹运行而无需安装；项目数据仍会写入所选工作区，全局设置写入 %APPDATA%\BlackMagic。
我的 J2534 适配器不在列表中
先安装厂商驱动，然后重新打开 Settings → PassThru Interface。列表由系统中注册的 J2534 库构建。切换驱动会重新连接应用。如果适配器仍未出现，请检查驱动架构是否与 x86 构建匹配。
状态栏显示已连接，但 ECU 不应答
状态只能证明适配器已打开。请检查：
- ECU 定义中的请求和响应 CAN ID；
- 位速率（125/250/500/750 kbit/s 或 1 Mbit/s）和 11/29 位模式；
- 点火状态以及是否有另一个诊断仪持有会话；
- 日志中的原始请求和超时。
DoIP 发现找不到任何内容
- 确认 PC 和车辆在同一子网。
- 检查 Own IP、Netmask、Destination IP 和端口
13400。 - 设置车辆期望的 Tester Address，通常为
0x0E80。 - 车辆可能只在点火打开且网关唤醒后才应答。
- 如果 Discover 看不到任何内容，尝试使用 ECU Address From / To 配合 Scan。
安全访问被拒绝
项目需要在 data/auth/ 中提供正确的认证级别和 Seed2Key DLL。级别错误或使用不同算法计算的密钥会产生否定响应。日志中包含响应码。手动种子/密钥交换可在 UDS Tools → Authorization 0x27 中使用 Get Seed / Send Key。
写入返回否定响应
常见原因：ECU 处于错误的会话、未执行安全访问、参数在项目中是只读的，或值长度与视图不匹配。对于 Writable Values，检查 writeable: true、View 以及可选的 write_auth 级别。每次成功写入后都要回读参数。
某个参数在 Writable Values 中缺失
.bmecu中writeable必须为true；- 参数必须有 View；
- 带有
writeable: true的ioctl参数也会出现在 IO Control 中，在那里使用 0x2F，在这里使用 0x2E。
Measurement Values 不绘制图表
- 只有
uint和int可以绘制；ascii、hex、enum和combined显示Not graphable。 No data表示该值尚未读取；No samples表示尚未积累历史数据。- 按 Start 后，至少等待一个轮询周期。
- 如果列表为空时按 Start，不会发生任何事。
- 长时间的一系列链路错误会停止测量；请检查日志。
为什么测量 CSV 没有时间戳或表头？
这是有意设计的：文件包含所选参数的 "Name","DID","Value Unit" 行。请求时序请使用日志，完整状态请使用 .bmdump。
日志在哪里？
在 <workspace>/logs/ 中。Log & Console 面板会实时显示相同的事件。已保存的日志以 [build] 行开头，包含版本、配置和构建日期。
某个 DTC 显示 “Unknown DTC”
该故障码已被读取，但已加载的数据库中没有描述。在 data/dtc/ 下添加 .json 或 .txt 条目，或在 Project Properties 中选择本地文件。TXT 行为 CODE description；以 # 或 ; 开头的行会被忽略。
应用程序需要联网吗？
不需要。诊断、项目、日志和报告都在本地工作。AI 聊天需要配置 HTTP 端点或 ACP；MCP 客户端通过本地服务器连接。
AI 聊天没有回答
- 检查后端（OpenAI 兼容的 HTTP 端点或 OpenCode ACP）和 API 密钥；密钥存储在 Windows 凭据管理器中。
- 在日志中查找
HTTP:和CHAT:行。 - 停滞的请求会超时；按 Stop 并重试。
- 项目更改和实时 ECU 写入是 Settings → Automation 中的独立权限。
我可以把工作区移到另一台 PC 吗？
可以。复制文件夹并将其作为工作区打开。ECU 文件在项目文件夹内按名称引用。全局偏好设置是独立的，可以重新创建。
UI 只有英文——我可以使用西里尔文或中文数据吗？
可以。西里尔文或简体中文的 ECU 名称、DTC 描述和参数文本可以正确显示。界面标签本身是英文。
刷写窗口在哪里？
车辆专用刷写模块仅包含在具有该模块的构建中。通用路径是 Lua 固件和刷写 API。参见刷写。
如何报告问题？
论坛尚未开放。目前，请保留会话日志、项目转储和精确步骤；它们是复现传输或 ECU 问题所需的最低限度信息。