TLCDCEmu Java - How-To

What Is Needed ?

• A VDO/Dayton Tuner List (or Update List by the way) head unit and a PC. If you don't have that, we can't help :-).
• A hardware adapter to connect your head unit to your PC. See this page.
• A recent Java Runtime Engine (JRE), such as version 5 (1.5) from Sun.
• The latest binary release of TLCDCEmu from the SourceForge download page.
• The RxTx library for serial communications. The Windows version is included in the above zip for convenience, but if you're on Linux, Mac or Solaris, you'll have to download the library separately from the RxTx.org website.

How to install ?

Suggested install is as follows :

1. Install the JRE.
2. Unzip the TLCDCEmu binary release where you like.
3. If you're under Windows™, copy the .dll files from the lib directory to a directory in the PATH. For example, under Windows™, you should copy them to the bin dir of your JRE (it should be C:\Program Files\Java\JRE<version>\bin) or in C:\Windows\System32. If you're using another OS, do the same with the corresponding rxtxSerial library.
4. Finally, check the serial port settings in TLCDCEmu.properties (text file).

How to run ?

1. Connect all your wires and power your hardware adapter.
2. Start your PC.
3. Start TLCDCEmu.bat. It should initialize and show a few things on the console. If you have activated the GUIPlugin, a window should open like on the screenshot page.
4. Turn your head unit on.
5. You should now be able to switch the source of your head unit to the "CD Changer" position (display shows TR1 CD1). The SPDIF is now activated and you should hear the sound coming out of the car speakers.
6. According to the plugins you have activated, different behaviours may be enabled. See the plugins page for more information.

How to stop ?

To exit cleanly, type q + return in the console window. The GUI should be seen as a plugin for HLCDCEmu, and that's why it is not recommended to close the application from this plugin.
Of course, any dirty exit (closing the console, CTRL-C, pulling the plug) will work too...
If you exit while your head unit is still turned on and on CD Changer position, it should display LINK ERR after a few seconds...

How to customize ?

In the TLCDCEmu.properties file, you can change a few things :

• SerialPortName indicates the serial port your adapter is connected to. It uses the platform-dependant names (e.g. COM1 on Windows(TM) or /dev/ttyS0 on Linux).
• DebugLevel gives you more or less information on the console. It ranges from 0 (none) to 6 (debug).
• Plugins is a comma separated list of classes. More information on the plugins page.
• SerialDriverClass should remain with the value gnu.io.RXTXCommDriver for the current version.

Problems ?

For now, please use this thread on mp3car to discuss your experience with the emulator.

if you feel it deserves it...

This project is hosted by