=====================================================================
=                 API-AIO(LNX) Additional Sample Programs           =
=               Analog Input Once from Specified Channel (SR)       =
=                                                         Ver.1.00  =
=                                                 CONTEC Co., Ltd.  =
=====================================================================

- Introduction
=======================
  This package is the additional sample programs to show usage examples
  that are not presented in the sample programs of the development 
  environment for API-AIO(LNX).
  
  Please use it as a reference when using the API-AIO(LNX) development environment.


- Specification
=======================
  [Supported driver]
  API-AIO(LNX)

  [Supported development languages]
  gcc       (C/C++)
  Python    (3.12)

  [Supported devices]
  Devices that support the AioSingleAiExSR function


- About this sample
=======================
  This is a sample program that performs analog input using the function that can select 
  input data reference destination from Gateway (Master unit) and Terminal (Slave unit).
  In this sample program, the input data reference destination can be specified arbitrarily.

  ===================================================================================
   Analog input conditions          |Setting analog input conditions |How to change *
  ===================================================================================
   Input method                     |Single-end input                |Source code
   Input range                      |+/- 10[V]                       |Source code
   Input data reference destination |Any value                       |Console
  ===================================================================================
  *  How to change
     Source code                 : Conditions can be changed in the source code. 
     Source code (Change notice) : Conditions can be changed in the source code, but please note that it may not work.
     Console                     : Any value can be set from the console.


- Glossary
=======================
  [Input data reference destination]
    When Gateway (Master unit) is used as the input data reference destination, 
    the function execution time is shorter because it does not communicate with the terminal (slave unit),
    but the input data is updated only at the set time.
    When Terminal (Slave unit) is used as the input data reference destination, 
    the function execution time is longer because it communicates with the terminal (slave unit),
    but the input data at the timing when the function is executed is acquired.

  [Timestamp]
    It is the time (seconds) after the input data of gateway (master unit) is updated.
    It will be reset when the input data is received from the terminal (slave unit).
    If the timestamp is larger than the set update time, it means that the input data reception from the terminal (slave unit) failed. 


- Usage
=======================
  1. Initialization
   - Select the command [1 : Device Init] to specify the device name.
   - Input method and input range are set in the [Device Init].
     If you want to change the input method and input range, change the value of the setting you want to change.

  2. Analog Input
   - Select the command [2 : Analog Input] to start analog input.
   - The channel number, input data and timestamp are displayed.

  3. Exit handling of device
   - Select the command [3 : Device Exit] to perform the exit handling of device.


- Version History
=======================
  Ver.1.00 (Web Release 2024.09)
  ----------------------------------------
  - First release