ax5232.txt Driver File Contents (AS59099V2_0.zip)

[AX5232 - 32 Channel Temperature Measurement Module]

Function:
   ax5232Init

Description:
   Initialize the device.

   int ax5232Init(int base_addr, int function);
   base_addr: I/O base address of the device.
   function: Function ID.

Remarks:
   This function should be called once before the device performming any data
   I/O functions. The function ID could be either of the constants listing below
   or any combinition of them:
      ID_FUNC_AI
      ID_FUNC_AI_IRQ
      ID_FUNC_DI
      ID_FUNC_DO
      ID_FUNC_ALL

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function: ax5232Term

Description:
   Terminate the device driver.

   int ax5232Term(int base_addr);
   base_addr: I/O base address of the device.

Remarks:
   This function should be called once if the device will no longer performming
   any data I/O functions. Usually at the end of you data acquisition/control
   processes.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232GetDevAtbu

Description:
   Retrieve the device attribute.

   int ax5232GetDevAtbu(LPDEVATBU lpDevAtbu);
   lpDevAtbu: Pointer to the DEVATBU struct, which stores the device attribute.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232DI

Description:
   Digital input function for a specified channel.

   int ax5232DI(int base_addr, int chan, int* data);
   base_addr: I/O base address of the device.
   chan: Channel to perform DI function.
   data: Storage for digital input status.

Remarks:
   This function will retrieve the one and only specified channel for it's
   digital input status. The status value will stored in the third parameter,
   data, where '1' stands for 'HIGH' status, and '0' for 'LOW' one.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232DI_P

Description:
   Digital input function for a specified port(8-bit).

   int ax5232DI_P(int base_addr, int* data);
   base_addr: I/O base address of the device.
   data: Storage for digital input status.

Remarks:
   This function will retrieve all the digital input status of channels in
   the same port at one time.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232DO

Description:
   Digital output function for the specified channel.

   int ax5232DO(int base_addr, int chan, int data);
   base_addr: I/O base address of the device.
   chan: channel to proform digital output function.
   data: Digital output status.0:LOW, 1:HIGH.

Remarks:
   Use this function to output a LOW or HIGH signal to the specified channel.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.



Function:
   ax5232DO_P

Description:
   Digital output function for a specified port(8-bit).

   int ax5232DO_P(int base_addr, int data);
   base_addr: I/O base address of the device.
   data: Digital output status for a port(8-channel).

Remarks:
   Use this function to output signals(LOW/HIGH) at one time for channels in
   the same port.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232AI

Description:
   Analog input function for specified channel.

   int ax5232AI(int base_addr, int chan, int gaincode, float* pfdata);
   base_addr: I/O base address of the device.
   chan: channel to perform analog input function.
   gaincode: Gain code of the device.
   pfdata: Pointer to storage of analog input data.

Remarks:
   This function uses software triggered method to perform an analog input
   function. The gaincode should be set according to the users maunal of the
   device.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232IRQStart

Description:
   Analog input function for specified channel with interrupt.

   int ax5232IRQStart(int base_addr, WORD ScanChan, int GainCode, int IRQNo);
   base_addr: I/O base address of the device.
   ScanChan: Range of Channels to perform analog input function.
   GainCode: Gain code of the device.
   IRQNo: IRQ number used for generating interrupt.

Remarks:
   This function should be called before performing analog input function
   via interrupt. Ths ScanChan specify the channels to scan. To scan channel
   0 to 15, the ScanChan will be 0x000f, ie. from higher byte 00 to lower
   byte 0f(15), GainCode should be set according to the users manual of the
   device. IRQNo will also be the set as the on board jumper's setting.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232IRQGetStatus

Description:
   Check the writting status of the driver buffer.

   int ax5232IRQGetStatus(int IRQNo, int* flag, WORD CheckSize,
                          WORD* Index1, WORD* Index2);
   IRQNo: IRQ number specified in the ax5232IRQStart function.
   flag: Pointer to a flag to determine whether the data was ready to get.
   CheckSize: Specify the block size of data to check from the driver.
   Index1: Pointer to the current writing index of the driver buffer.
   Index2: Pointer to the current reading index of the driver buffer.

Remarks:
   Use this function to check whether the data was ready inside the driver
   buffer. The default buffer size was 4K*2 bytes. Thus the maximun block
   size to check should not exceed 2K. If the flag turns to be SET, flag=1,
   it's ready to get data with

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232IRQGetData

Description:
   Get data from the driver buffer with specified block size.

   int ax5232IRQGetData(int IRQNo, int* buffer, WORD size);
   IRQNo: IRQ number specified in the ax5232IRQStart function.
   buffer: Pointer to a buffer that will then store data from the driver.
   size: Block size of buffer to retrive from the driver.

Remarks:
   After a call to check the driver buffer status, use this function to get
   the data ready in the driver if the status flag is SET. Note that 1 block
   size means 2 byte, the buffer pointer passed should have buffer size with
   2 times the block size. And the data retrived will still be raw data, call
   the raw-to-real convert function to convert the buffer data to real data.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232IRQStop

Description:
   Stops the analog input via interrupt function.

   int ax5232IRQStop(int IRQNo);
   IRQNo: IRQ number specified in the ax5232IRQStart function.

Remarks:
   This function should be called after performing analog input via interrupt
   function.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232RawToReal

Description:
   Convert data from raw data to real data.

   int ax5232RawToReal(int GainCode, float* fBuffer int* iBuffer, WORD size);
   GainCode: Gain code used when ax5232IRQStart was called.
   fBuffer: Pointer to a buffer that will then store real data.
   iBuffer: Pointer to a buffer that stores raw data.
   size: Block size of buffer to be converted from raw data to real data.

Remarks:
   Use this function to convert the iBuffer data to real data.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232CJC

Description:
   Retrieve the CJC value of the device.

   int ax5232CJC(int base_addr, int GainCode, float* pCJC);
   base_addr: I/O base address of the device.
   GainCode: Gain code of the device.
   pCJC: Pointer to storage of CJC value.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.


Function:
   ax5232Temp

Description:
   Temperature measuring function

   int ax5232Temp(int base_addr, int chan, int GainCode, int ThermoType, float* pfdata);
   base_addr: I/O base address of the device.
   chan: Channel number.
   GainCode: Gain code of the device.
   ThermoType: Thermocouple type. The value will be one of follows:
      ID_JTYPE
      ID_KTYPE
      ID_TTYPE
      ID_ETYPE
      ID_RTYPE
      ID_STYPE
   pfdata: Pointer to storage of temperature value.

Return Values:
   This function will return an error code defined in the ERROR CODE LIST of
   AXDDR include file(axddr.h). Please be sure to check this returned value to
   determine whether the function call succeed or not. If there're no any error
   occured, the return value should be ERR_NOERR. Otherwise, the value will be
   the one defined in ERROR CODE LIST.
Download Driver Pack

How To Update Drivers Manually

After your driver has been downloaded, follow these simple steps to install it.

  • Expand the archive file (if the download file is in zip or rar format).

  • If the expanded file has an .exe extension, double click it and follow the installation instructions.

  • Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.

  • Find the device and model you want to update in the device list.

  • Double-click on it to open the Properties dialog box.

  • From the Properties dialog box, select the Driver tab.

  • Click the Update Driver button, then follow the instructions.

Very important: You must reboot your system to ensure that any driver updates have taken effect.

For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.

server: web5, load: 1.03