Pages: [1]
Author Topic: Open VAG  (Read 421 times)
_nameless
Hero Member
*****

Karma: +371/-2991
Offline Offline

Posts: 2962



« on: November 15, 2025, 12:17:05 PM »

OPEN VAG – Free VAG Diagnostic Tool
For those working on VAG (1990–2005) with K-Line (KW1281), OPEN VAG provides a clean GUI wrapper around the kw1281test CLI tool.
Key Features
Live output streaming
Presets for Cluster, ECU, CCM, and Radio (baud rate and address set automatically)
EEPROM, ROM, and RAM dumps (saved as .bin files)
Read and clear fault codes
Adaptation channel access (mileage, keys, coding)
Radio tools: SAFE code retrieval (Delco/Clarion) and RB4 mode toggle
Custom command support
No log files, no console windows, single executable
Compatible with KKL USB cables (FTDI/CH340) on Windows 7–11. No Python or .NET installation required.
Download
GitHub: https://github.com/ugtuner05-sys/OPEN-Vag
Run OPEN_VAG.exe directly.
Usage: Ignition on, engine off. Connect cable, select preset, execute command. Full cluster EEPROM dump completes in ~30 seconds via the Memory tab.
1. Physical Layer
Single wire (K-Line) + ground (L-Line optional).
Voltage: 12V system, but signals switch between 0V (low) and battery voltage (high).
Baud rates: Typically 10,400 baud (VAG default) or 9,600 baud.
Cable: Requires a K-Line interface (e.g., KKL USB with FTDI/CH340 chip) to convert to USB/RS232.
Pin 7 in the OBD2 connector = K-Line
Pin 4/5 = Ground
2. Initialization (Wake-Up)
To start communication:
ECU is asleep.
Tool sends a 5-baud wake-up pulse:
Pulls K-Line low for ~200ms, then high.
Sends address byte slowly (5 baud = 25, 55, etc.).
ECU responds with keyword bytes (e.g., 0x08 0xF7) to confirm protocol (KW1281, KW2000, etc.).
This is why ignition must be ON — ECU needs power to respond.
3. Message Structure (KW1281 Example)
Messages follow a block-based format:
BytePurpose
0
0x83 (header: 3 data bytes + address)
1
Target ECU address (e.g., 0x11 = Engine)
2
Source (diagnostic tool, usually 0xF1)
3
Command (e.g., 0x09 = Read Ident)
4–6
Data (optional)
7
Checksum (XOR of all bytes after length)
No fixed length — first byte defines payload.
Checksum: XOR of all bytes from length onward.
ACK/NAK: ECU sends 0x09 (ACK) or 0x7F (NAK + error).
4. Common Commands (KW1281)
CommandHexFunction
Read Ident
09
Get part number, coding, software version
Read Fault Codes
07
Retrieve DTCs
Clear Fault Codes
05
Erase DTCs
Adaptation Read/Save
21/22
Channel access (mileage, keys)
Group Read
29
Live data (like VCDS measuring blocks)
Dump EEPROM
Custom block mode
Read memory in 256-byte blocks
5. Block Mode (For Memory Dumps)
Used for EEPROM/ROM dumping.
Enter with 0x1A 0xA0 → ECU streams 256-byte blocks.
Tool sends ACK (0x09) after each block.
Exit with 0x1A 0xA1.
This is how tools like OPEN VAG dump cluster EEPROMs.
6. Timing & Flow Control
No hardware flow control — relies on timing.
Tool must wait for response before sending next command.
Idle: K-Line high.
Timeouts: Critical — too fast = missed bytes.
7. KW1281 vs KW2000
FeatureKW1281KW2000
Baud
10,400 (fixed)
Variable (up to 115k)
Used in
VAG clusters, older ECUs
Newer VAG (post-2000)
Block mode
Yes
Limited
8. Why It’s Still Used
EEPROM access (mileage, immobilizer, coding).
No CAN gateway needed.
Simple hardware (one wire).
Full control over ECU memory.
Tools That Use K-Line
VCDS (VAG-COM) – Ross-Tech’s official tool.
kw1281test – Open-source CLI (used in OPEN VAG).
VAG K+CAN, Carista, OBD Auto Doctor (limited).
AspectDetail
Wire
1 (K-Line)
Speed
10,400 baud
Wake-up
5-baud address
Messages
Header + command + data + checksum
Use Case
Diagnostics, coding, EEPROM dumps
Vehicles
VAG 1990–2005, BMW E36/E38, etc.
OPEN VAG simplifies all this — no need to memorize hex codes. Just click Read Ident or Dump EEPROM, and it handles the K-Line handshake, timing, and checksums behind the scenes.
Logged

If you are broke or expecting free handouts DO NOT message me. I'll probably put you on blast if you do.
grayjay
Jr. Member
**

Karma: +4/-1
Offline Offline

Posts: 37


« Reply #1 on: November 15, 2025, 06:50:12 PM »

Ive been using the original command line KW1281test program for instrument cluster communications for several months, it was particularly useful for adapting new keys to my A4 B6 cluster. Thanks for providing the GUI, should make it even easier to use.

Is the version of KW1281test distributed with the GUI modified from the original command line version? I had found that KW1281test was only ever written to work for the EDC15 ECU (a TDI diesel ECU that was contemporary to the ME7 gasoline engine ECUs). I tried using the command line program and it was unable to communicate with the ME7.5 in my A4 B6, program author confirmed that it did not include functionality for ECUs other than EDC15 but that functionality was likely possible to add. Note that KW1281test does work for a wider range of instrument clusters, not just those from TDI vehicles so is definitely still useful for cluster communications even for older gasoline ECU cars.

Why does the GUI include the RB4 toggle command on the radio function tab? RB4 is an encrypted instrument cluster that needs to be toggled off/on to decrypted mode in order to make any changes to the cluster (such as key adaptation). RB4 does not really have anything to do with the radio.

Much more documentation and discussion on KW1281test program available at the TDI forum where the author frequently takes new feature request and answers questions regarding the program;
https://forums.tdiclub.com/index.php?threads/kw1281test-a-free-vds-pro-vagtacho-alternative.509151/
 
Logged
_nameless
Hero Member
*****

Karma: +371/-2991
Offline Offline

Posts: 2962



« Reply #2 on: November 15, 2025, 09:12:57 PM »

Yeah, I put it together quickly, I'm sure it has some bugs
Logged

If you are broke or expecting free handouts DO NOT message me. I'll probably put you on blast if you do.
grayjay
Jr. Member
**

Karma: +4/-1
Offline Offline

Posts: 37


« Reply #3 on: November 22, 2025, 07:11:56 PM »

I gave your OPEN-VAG GUI program for KW1281test a try today, can confirm that it does work as intended and I was able to connect to the cluster and CCM on my A4 B6.
It does a nice job of automating the connection parameters like setting correct COM port, baud rate and module address for the 4 available preset module types (Cluster, CCM, Radio, ECU). Also nice to be able to quickly run KW1281test commands without much typing or needing to fuss with getting all the command line syntax exactly right.

If you have any interest in making in further improvements, here are a few of my beta-tester suggestions for changes that would make this a bit easier for new user;

1) Move the command button for TOGGLE RB4 MODE from RADIO tab to either BASIC or MISC tab.

2) The author of KW1281test is fairly prolific in providing new releases with new added features. It looks like Open-VAG included KW1281test (version 1.0.0) but there is already a newer release of KW1281test since then. Might work better long term if OPEN-VAG GUI .exe did not include the entire bundled KW1281test program bit if it instead could just reside in the same folder as a copy of KW1281test.exe and launch it externally? This way users could keep their version of KW1281test up to date without you needing to provide new updates of Open-VAG every time there is a new release of KW1281test.

3) When running commands in OPEN-VAG, there is not much immediate feedback to tell if the command launched or what is happening without knowing to jump back to the connection tab to see the live streaming output box that only resides there. My suggestion would be to place the live streaming output box in its own separate window (bottom of screen) so that it remains visible at all times without needing to jump back to the connection tab to monitor the output after a command button is launched. 

Thanks again for making this available, it is a nice improvement for using KW1281test.     
Logged
Pages: [1]
  Print  
 
Jump to:  

Powered by SMF 1.1.21 | SMF © 2015, Simple Machines Page created in 0.016 seconds with 14 queries. (Pretty URLs adds 0s, 0q)