# ScanDoc J2534 Library — Developer Documentation

> **Library 2.0.0.213** · SAE J2534 v04.04 API

Cross-platform SAE J2534-1/2 Pass-Thru library for vehicle diagnostics with
ScanDoc (Quantex) VCI adapters. This package documents everything a third-party
application needs to integrate the library: API, configuration, connection
strings, error handling and the log format.

## Artifacts

| Platform | Artifact | Transports |
|----------|----------|------------|
| Windows x86 | `j2534sd_v04_04_x86.dll` | LAN/Wi-Fi, BLE (Win10+) |
| Windows x64 | `j2534sd_v04_04_x64.dll` | LAN/Wi-Fi, BLE (Win10+) |
| macOS Universal (x86_64 + arm64) | `libj2534_v04_04.dylib` | LAN/Wi-Fi, BLE, USB |
| Linux x64 / ARM | `libj2534_v04_04.so` | LAN/Wi-Fi, BLE |
| Android (arm64-v8a, armeabi-v7a, x86, x86_64) | `libj2534.so` (JNI) | LAN/Wi-Fi, BLE |
| iOS 12.0+ (device arm64, simulator arm64/x86_64) | `libj2534.xcframework` (static) | LAN/Wi-Fi, BLE |

The library implements the SAE J2534 v04.04 API. A subset of v05.00 device
discovery functions (`PassThruScanForDevices`, `PassThruGetNextDevice`) is also
available — see [API_REFERENCE.md](API_REFERENCE.md).

## Version

Every document in this package carries the library version in its header line;
it is the version of the binaries delivered with it. The same string is
returned by `PassThruReadVersion` in `dll_version` and printed in the header of
every `.qlog` file (`# v2 <date> dll:<version> …`) — quote it when reporting an
issue, together with the firmware version of the adapter.

## Supported protocols

CAN, CAN FD, ISO 15765 (incl. CAN FD transport), ISO 9141, ISO 14230 (KWP2000),
J1850 PWM/VPW, J1939, TP 2.0, SW-CAN, ISO 13400 (DoIP, vendor extension),
HSFZ (BMW, vendor extension).

## Contents

| Document | Description |
|----------|-------------|
| [GETTING_STARTED.md](GETTING_STARTED.md) | Integration per platform, connection strings, minimal example |
| [API_REFERENCE.md](API_REFERENCE.md) | Exported functions, structures, protocol and IOCTL IDs |
| [CONFIGURATION.md](CONFIGURATION.md) | `j2534.json` — device list, interface selection; Windows registry |
| [ERROR_HANDLING.md](ERROR_HANDLING.md) | Return codes and `PassThruGetLastError` |
| [DOIP.md](DOIP.md) | ISO 13400 (DoIP) vendor extension: discovery, routing activation, UDS over IP |
| [ANDROID.md](ANDROID.md) | Android integration: JNI wrapper, BLEManager contract, demo app |
| [IOS.md](IOS.md) | iOS integration: XCFramework, Xcode setup, Info.plist keys, Swift notes |
| [LOG_FORMAT.md](LOG_FORMAT.md) | `.qlog` log file format reference |

## Support

- Website: [www.quantexlab.com](https://www.quantexlab.com)
- Developer page: <https://quantexlab.com/en/develop/j2534.html>
- Contact: <info@quantexlab.com>
