面向开发者

J2534 规范与功能说明 ›
ELM327 规范与命令说明 ›

ELM327 接口仅在 Nano ET 适配器中提供。其他 ScanDoc 适配器使用 J2534 PassThru 协议。

开发者新闻

J2534 DLL、ELM327 和 ScanDoc 适配器固件中与集成相关的变化：新功能、协议和参数 — 附使用示例。

---

DLL 2.0.0.200、Nano ET 固件构建 83 04.08.2026

下载 J2534 库 2.0.0.200 — Windows x86/x64/ARM64（Windows 7 单独构建）、macOS（universal）、Linux（x64、x86、ARM、ARM64）、Android（arm64-v8a、armeabi-v7a、x86、x86_64）、iOS。

Nano ET 固件 — 构建 83

新增

• DoIP（ISO 13400）与 BMW HSFZ — 新协议 ISO13400_PS（0x8FFD）和 HSFZ_PS（0x8FFC）。它们不属于 SAE J2534 标准，是 ScanDoc 的自有扩展：通过 Ethernet 诊断 — 网络内车辆发现（VIN、逻辑地址）、TCP 连接、routing activation、UDS 交换。tester 地址默认为 0 — 请在 routing activation 之前设置 ISO13400_SOURCE_ADDR，否则网关会拒绝；ECU 地址随每条消息传递（[TA][SA][UDS]），ISO13400_TARGET_ADDR 不通过 Set/GetConfig 设置。发送按 P2 串行化：同一时间只有一个未完成的 UDS 请求，NRC 7F xx 78 将等待延长至 P2*max（6 秒）。新的通道参数 ISO13400_P3_DOIP（0x8108）— 消息间暂停。
  示例

  uint32_t ch, code = 0;
  pt_config_t sa  = { ISO13400_SOURCE_ADDR, 0x0E80 };
  pt_config_list_t cfg = { 1, &sa };
  
  PassThruConnect(dev, ISO13400_PS, 0, 0, &ch);
  PassThruIoctl(ch, SET_CONFIG, &cfg, NULL);                 /* SA — 在 routing activation 之前设置 */
  PassThruIoctl(ch, ISO13400_DISCOVER_VEHICLES, NULL, NULL); /* ECU 的 IP 会自动记住 */
  PassThruIoctl(ch, ISO13400_CONNECT_TCP, NULL, NULL);
  PassThruIoctl(ch, ISO13400_ACTIVATE_ROUTING, NULL, &code); /* 0x10 = 成功 */
  /* 之后 PassThruWriteMsgs / PassThruReadMsgs — 常规 UDS */

• 总线故障诊断 — bus-off（线路断路/短路、无 ACK）和 CAN 波特率错误现在返回包含 baud rate 的详细错误文本，而不是笼统的失败代码。
• J2534 与 ELM327 共用一个 TCP 端口 — ELM327 的独立端口 35000 已删除，两个协议都在命令端口 53983 上服务。协议由连接的第一个字节识别：0x55（J2534 帧标记）— J2534，其他（文本 AT 命令）— ELM327。
• BLE — 可解析私有地址（RPA）：扫描器看到随机地址，已配对设备通过 IRK 解析；仅接受 Secure Connections 连接。

修复

• 按数据字节过滤 CAN — PassThruStartMsgFilter 只比较 CAN ID 的 4 个字节，忽略给定的过滤器长度。现在按标准要求对整个长度进行比较：按帧内容的 PASS/BLOCK 可用。
  示例

  /* 在接收队列中抑制 TesterPresent 应答（07E8 02 7E ...） */
  pt_msg_t mask = {0}, pattern = {0};
  mask.protocol_id = pattern.protocol_id = CAN;
  mask.data_size   = pattern.data_size   = 6;   /* 4 字节 CAN ID + 2 字节数据 */
  memcpy(mask.data,    "\xFF\xFF\xFF\xFF\xFF\xFF", 6);
  memcpy(pattern.data, "\x00\x00\x07\xE8\x02\x7E", 6);
  uint32_t fid;
  PassThruStartMsgFilter(ch, BLOCK_FILTER, &mask, &pattern, NULL, &fid);

• J2534 — 每个接收帧在接收时刻获得独立时间戳（符合规范要求；之前整批共用一个）；发送 CAN 帧的回显仅在发送成功时返回 — TX 失败时的回显会误导主机对总线状态的判断。
• ELM327 — 在活动 CAN 通道上执行 AT SH 会破坏 Flow Control（FC 无填充发送，DLC=3 — 网关不发送 Consecutive Frames），并用自己的 TX ID 覆盖接收过滤器（不使用 AT CRA 时接收损坏）。按数据手册 AT SH 只设置发送标头 — 接收过滤器现在仅由 AT CRA/CF/CM 控制。
• 与 Android 14+（Pixel）的 BLE 配对 — 当系统的 Fast Pair / Find My Device 与设备并行发起配对时会失败。
• K-Line/KWP — 密集通信时应答的最后一个字节丢失；ACK 块晚发约 70 毫秒导致识别中断；连接失败后通道卡死。
• PassThruStopPeriodicMsg 停止后可能多发送一帧。
• TP2.0/TP1.6 _PS — 通过 SET_CONFIG(J1962_PINS) 选择引脚未生效，帧未上总线。
• 畸形数据处理 — 对畸形帧（ISO15765 First/Single Frame、DoIP 包长度、TP2.0/TP1.6 重组）和主机参数（ReadMsgs、IOCTL）进行校验：设备不再挂起或损坏内存，而是返回常规 J2534 错误码。

J2534 库 — 2.0.0.200

修复

• WLAN/LAN 控制命令超时提高到 1000 毫秒 — 在缓慢或拥塞的网络中，发往设备的控制命令会超时失败。

---