AX5224H.TXT Driver File Contents (AS59099V2_0.zip)

[AX5224H - 24 Bit DIO & 3 Ch. Counter/Timer Board](v1.10)

Function:
   ax5224HInit

Description:
   Initialize the device.

   int ax5224HInit(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_DI
      ID_FUNC_DO
      ID_FUNC_EVCNT
      ID_FUNC_FOUT
      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: ax5224HTerm

Description:
   Terminate the device driver.

   int ax5224HTerm(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:
   ax5224HGetDevAtbu

Description:
   Retrieve the device attribute.

   int ax5224HGetDevAtbu(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:
   ax5224HDIOSetting

Description:
   Setup DIO channel direction.

   int ax5224HDIOSetting(int base_addr, int ctrlport);
   base_addr: I/O base address of the device.
   ctrlport: The control port register data.

Return Value:
   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:
   ax5224HIRQSetting

Description:
   Setting up the interrupt service routine for digital input via interrupt.

   int ax5224HIRQSetting(int base_addr, void ISR(*isr)());
   base_addr: I/O base address of the device.
   *isr: The user specified interrupt service routine.

Remarks:
   Use this function to specified the interrupt service routine. Each time
   the interrupt was generated, the *isr will be called.

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:
   ax5224HIRQRestore

Description:
   Restore the old interrupt service routine.

   int ax5224HIRQRestore(int IRQNo);
   IRQNo: IRQ number specified in the ax5224HIRQSetting function.

Remarks:
   Use this function to restore the interrupt service routine. Call this
   function everytime if ax5224HIRQSetting was called, and before the
   ax5224HTerm was called.

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:
   ax5224HDI

Description:
   Digital input function for specified channel.

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

Remarks:
   This function will retrieve the one and only specified channel for it's
   digital input status.

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:
   ax5224HDI_P

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

   int ax5224HDI_P(int base_addr, WORD port, int* data);
   base_addr: I/O base address of the device.
   port: Port number of DIO channels.
   data: Pointer to storage of digital input status.

Remarks:
   This function will retrieve all the digital input status of 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:
   ax5224HDO

Description:
   Digital output function for specified channel.

   int ax5224HDO(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/HIGH signal to 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:
   ax5224HDO_P

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

   int ax5224HDO_P(int base_addr, WORD port, int DataOut);
   base_addr: I/O base address of the device.
   port: Port number of DIO channels.
   DataOut: Digital output status for a port(8-channel).

Remarks:
   Use this function to output signals(LOW/HIGH) at once 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:
   ax5224HSetCntMode

Description:
   Setup up Intel i8254 counter/timer mode of AX5224H.

   int ax5224HSetCntMode(int base_addr, int CntNo, int Mode);
   base_addr: I/O base address of the device.
   CntNo: Counter number. CNT#0,1,2,....
   Mode: Mode number of Inter i8254. Value from 0, Mode0, to 5,Mode5.

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:
   ax5224HGetCntSts

Description:
   Retrieve the status of the specified counter.

   int ax5224HGetCntSts(int base_addr, int CntNo, int* pStatus);
   base_addr: I/O base address of the device.
   CntNo: Counter number. CNT#0,1,2....
   pStatus: Pointer to storage of counter status.

Return Value:
   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:
   ax5224HReadCnt

Description:
   read the current count of the specified counter.

   int ax5224HReadCnt(int base_addr, int CntNo, WORD* pdata);
   base_addr: I/O base address of the device.
   CntNo: Counter number. CNT#0,1,2....
   pdata: Pointer to storage of current count.

Return Value:
   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:
   ax5224HWriteCnt

Description:
   Write data to the specified counter.

   int ax5224HWriteCnt(int base_addr, int CntNo, WORD data);
   base_addr: I/O base address of the device.
   CntNo: Counter number. CNT#0,1,2....
   data: Data that will be loaded onto the counter.

Return Value:
   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:
   ax5224HEventCount

Description:
   Event counting function.

   int ax5224HEventCount(int base_addr, int CntNo, WORD ConvNo);
   base_addr: I/O base address of the device.
   CntNo: Counter number. CNT#0,1,2....
   ConvNo: Specify the initial value to count down.

Return Value:
   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:
   ax5224HFrequency

Description:
   Frequency measurement function.

   int ax5224HFrequency(int base_addr, int* pCntNo, WORD delay, float* pFreq);
   base_addr: I/O base address of the device.
   pCntNo: Pointer to buffer of counter used. For example, if you use cascaded
      counters, CNT#1 and CNT2, to measure frequency. The buffer CntUse[] will
      be CntUse[0]=1, CntUse[1]=CntUse[2]=2. (pFreq=CntUse).
   delay: Specify the sampling period for frequency measurement.
   pFreq: Pointer to storage of measured frequency.

Remarks:
   There are plenty of frequency measument methods. This function shows how to
   measure frequency in software gating method, which may loss data in some
   non-realtime system, but makes the most use of all channels. It is your own
   freedom to implement any other measuring method as long as it works, with
   functions described above.

Return Value:
   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:
   ax5224HWaveGen

Description:
   Generate square wave through OUT pin.

   int ax5224HWaveGen(int base_addr, int CntNo, DWORD base_freq, DWORD out_freq);
   base_addr: I/O base address of the device.
   CntNo: Counter number. CNT#0,1,2....
   base_freq: Base frequency of the counter CLK source.
   out_freq: Value of the output frequency.

Return Value:
   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: 0.93