快速上手
本指南带你从全新安装走到读取一个参数和一个故障码。每一步都使用应用程序中看到的英文 UI 标签。
1. 安装
- 安装程序尚未发布。发布后请从发布页下载
bmsetup.exe。 - 运行安装程序。需要 Windows 10 或更新版本。
- 如安装程序提示，请安装 x86 Microsoft Visual C++ 2015–2022 Redistributable。
- 从开始菜单启动 BlackMagic。
2. 选择工作区
首次启动时，应用会要求选择工作区目录。工作区包含：
text
workspace/
├── data/ # DTC databases, DID descriptions, auth DLLs, config.json
├── logs/ # session logs
├── projects/ # one folder per project
├── scripts/ # shared Lua scripts
└── firmware/ # shared firmware images选择一个可写的空文件夹。应用会自行创建子目录。之后可以从工作区选择器切换工作区。
3. 创建项目
- File → New project（
Ctrl+N）。 - 手动添加 ECU，或打开 Tools → CAN Scanner 添加总线上找到的 ECU。
- 保存项目（
Ctrl+S）。应用会在工作区的projects/目录中创建文件夹。
每个 ECU 保留自己的传输方式（CAN 或 DoIP）、参数、例程和 DTC 设置。
4. 连接车辆
CAN：打开 View → Settings → PassThru Interface，选择 J2534 驱动。链路建立后，状态栏显示 CAN Interface: Connected。
DoIP：打开 Tools → DoIP Setup，选择网络适配器，设置 Own IP / Netmask（静态或 DHCP）、目标 IP、端口 13400 和测试仪地址（0x0E80），然后使用 Discover 或 Scan。在该 ECU 的设置中选择 DoIP 作为传输方式。
5. 读取数据
- 在 ECU List 中双击 ECU，在 ECU Edit 中打开它。
- 在 Info 标签页点击 Refresh Info 读取标识参数。
- 在 Measurement Values 标签页设置更新周期并点击 Start。
- 在 DTC 标签页点击 Read DTC 加载故障存储。
6. 写入数值
打开 Parameters 或 Writable Values 标签页，修改数值并确认写入。写入使用该参数配置的安全级别；如果 ECU 需要 seed/key 访问，项目必须引用 data/auth/ 中的 Seed2Key DLL。
写入参数和运行例程会改变车辆状态。发送写入前，请确认参数的作用。
键盘快捷键
| 快捷键 | 操作 |
|---|---|
Ctrl+N | 新建项目 |
Ctrl+O | 打开项目 |
Ctrl+S | 保存项目 |
Ctrl+Z / Ctrl+Y | 撤销 / 重做 |
Ctrl+R | 读取选中参数（ECU Edit） |
Ctrl+C | 复制选中参数 |
Ctrl+A | 全选参数 |
Alt+, | 设置 |
撤销深度可配置（默认 20，范围 0–100），且不会在两次启动之间保留。ECU 任务运行时会阻止撤销。
所有指南页面
- 安装 — 系统要求、安装程序、静默安装。
- 工作区 — 目录布局、备份、移动。
- 项目设置 — 手动添加 ECU 以及从扫描器添加。
- 连接车辆 — J2534 与 DoIP。
- 读写数值 — 标识、参数、安全。
- 读取和清除故障 — DTC、快照、数据库。
- 记录实时数据 — 轮询、曲线、CSV。
- 脚本快速上手 — 第一个 Lua 脚本。
- 文件格式 — 项目、转储、DID、日志。
- FAQ — 常见传输和访问问题。