ADwin Java Library
Jaeger Computergesteuerte Messtechnik, Lorsch - July 2021

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

Important:
This is the first version with ADwinX support.
It is in the beta stage. Detailed tests and 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 or T11.
     <ps> is the path separator for your operating system: ':' on Unix, ';' on Windows
     The 'simple' program does not work if simple.T91, simple.TA1 and simple.TB1 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
