ADwin Java Library
Jaeger Computergesteuerte Messtechnik, Lorsch - April 2024

With this software package you can access the ADwin devices from Java via the Ethernet interface.

This is the first version with ADwinX support.
The following adjustments for ADwinX are still pending:
* Adjustments for documentation
* T12/T12.1 Datatypes byte, short and int64


* This directory contains all files necessary to access an ADwin system

  ADwin-{VERSION}.jar: Put it in your classpath to get the ADwin library

  ADwin-{VERSION}-javadoc.zip: JavaDoc documentation (open index.html to view it)

  examples.zip: Three small example programs that demonstrate the library

  DemoJar-{VERSION}.jar: One of the example programs compiled in a JAR file (to be run
               as an applet or a standalone application)

* The minimum JDK version required is 1.5.

* After you copied the ADwin-{VERSION}.jar somewhere on your disk, and extracted examples.zip,
  you can compile the examples with the command

  javac -d <Path to base directory of the resulting package>
        -classpath <complete path and file name of ADwin-{VERSION}.jar>
        <Path to examples>*.java

  *  The 'simple' example can be run with the command

     java -cp <complete path and file name of ADwin-{VERSION}.jar><ps><path to the compiled example package>
          de.adwin.examples.simple <IP-Address> <Processor>,
     where <IP-Address> is the IP-Address of an ADwin system, and <Processor> is either T9, T10, T11, T12 or T121 (ADwinX).
     <ps> is the path separator for your operating system: ':' on Unix, ';' on Windows
     The 'simple' program does not work if processfiles simple.T* are not in the current directory.

  *  The 'Demo' GUI example can be run with

     java -cp <complete path and file name of ADwin-{VERSION}.jar><ps><path to the compiled example package>
          de.adwin.examples.Demo,
     again, <ps> is the path separator.
     No command line parameters are required.

  *  The 'ReadVersion' example can be run with

     java -cp <complete path and file name of ADwin-{VERSION}.jar><ps><path to the compiled example package>
          de.adwin.examples.ReadVersion,
     again, <ps> is the path separator.
     No command line parameters are required.


* Version history:

  * 1.1:   - fixed nasty bug with data type 'long'
           - renamed all method names ending with ..._Int to ..._Long
           - renamed Set- and Get_GlobalDelay to Set- and Get_Globaldelay
           - Text of the getMessage () of ADwinCommunicationError changed for more compatibility
           - added new method Get_DeviceNo ()
           - Fixed the example programs so they run with a newer linux installation
           - String_Length and GetData_... with small array sizes now terminate if there is a
             link error
           - Start_Process now throws an exception if an invalid process file has been started
  * 1.2:   - Additional methods: Set_Processdelay, Get_Processdelay
           - internal adjustements for T11 (Load_Process, Workload, Free_Mem)
           - GetData_... methods are faster now for ADwin-Systems with ENET2 interface (AEI v. 2.66 and up)
           - New error code for ADwinCommunicationError (150)
  * 1.2.1: - The ADwin library does not write files with offensive names any more.
           - very small documentation update
           - Load_Process returns error code 205 now, if you try to load a binary file that has been built for
             a different processor than the one on the target ADwin System.
  * 1.2.2: - Different threads can now share an ADwinDevice object and access it concurrently
           - many misspellings have been corrected in the english JavaDoc documentation
  * 1.3.0: - Support for processor type T12 added
  
  * 1.4.0: - FirstArrayIndex at get_par and get_data (int, float, double)

  * 1.5.0: - FirstArrayIndex at set_data (int, float, double), IllegalArgumentException
  * 1.5.1: - @throws instead of @exception
  * 1.5.2: - public functions are thread-safe
  * 1.6.0: - ADwinX-Support
