| AVR Z-LINKŪ |

# Requirements to run the Chat Application

The GUI is realized in Java and requires that a Java Runtime Environment (JRE) is installed before the application can be executed. A serial port library is also required by the GUI application to interface with the radio platform. This is needed because Java by default does not support handling of serial ports. The next three sections describes how to prepare your PC and then how to run the chat application.

Note:
  These instructions are only valid for Windows operating systems (XP and NT).

Steps:

- Java Runtime Environment
- Serial Port Library for Java
- Running the application

## Java Runtime Environment

This section describes how to check that the correct version of the JRE is installed.

1. Go to Start Menu->Control Panel. Open the file named "Java". In the window that opens, select the tab named "Java" and click on the "View..." button within the "Java-Applet-Runtime-Settings" box.
2. A new dialog appears that lists the available JRE versions and their path.
3. Download and install the current JRE from Sun's Java Homepage (http://java.sun.com/) if no Java Runtime Environment was found, or if the installed instance is below version 1.5.x.

## Serial Port Library for Java

The serial port library is installed by copying the files found in the "lib\pc" folder into the following Java system folders:

Note:
  "..." in the paths below is just a truncation of the file paths.

1. Copy the "win32comm.dll" file to the "...\Java\jre1.5.x\bin" folder.
2. Copy the "comm.jar" file to the "...\Java\jre1.5.x\lib\ext" folder.
3. Copy the "javax.comm.properties" file to the "...\Java\jre1.5.x\lib" folder.

## Running the application

Note:
  Ensure that the procedures described in Java Runtime Environment and Serial Port Library for Java has been completed successfully in advance of doing the steps described below.

There are at least a few possible ways to run the AVR414 Chat Application. Some of them are listed here:

- Preferred: An executable JAR (Java Archive) file can be found in the "bin" folder. Double click it, and the chat application will start.
- Alternative: The complete Java source code for the AVR414 chat application can be found in the "source\pc" folder. By using javac (Java compiler) it is possible to convert the Java source code into byte code that can be run by the java interpreter (java).

@DOC_TITLE@