ax5500.txt Driver File Contents (AS59099V2_0.zip)

[AX5500 - 12 Conter/Timer & 24 Digital I/O Card]

Function:
   ax5500PCIDevInfo

Description:
   Retrieve the PCI device information.

   int ax5500PCIDevInfo(int DevNo,int* pbase_addr, int* pIRQNo, int* pSlotNo);
   DevNo: Device scan order that will be found by PCI device driver.
   pbase_addr: Pointer to I/O base address of the device.
   pIRQNo: Pointer to device IRQ number.
   pSlotNo: Pointer to device slot number.

Remarks:
   Call this function to retrieve the AXIOM PCI/Compact PCI devices' information
   , such as base address, IRQ number, and slot number. These information will
   be used by all the other driver function calls.

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

Description:
   Initialize the device.

   int ax5500Init(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: ax5500Term

Description:
   Terminate the device driver.

   int ax5500Term(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:
   ax5500GetDevAtbu

Description:
   Retrieve the device attribute.

   int ax5500GetDevAtbu(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:
   ax5500DIOSetting

Description:
   Setup DIO channel direction.

   int ax5500DIOSetting(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:
   ax5500IRQSetting

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

   int ax5500IRQSetting(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:
   ax5500IRQRestore

Description:
   Restore the old interrupt service routine.

   int ax5500IRQRestore(int IRQNo);
   IRQNo: IRQ number specified in the ax5500IRQSetting function.

Remarks:
   Use this function to restore the interrupt service routine. Call this
   function everytime if ax5500IRQSetting was called, and before the
   ax5500Term 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:
   ax5500DI

Description:
   Digital input function for specified channel.

   int ax5500DI(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:
   ax5500DI_P

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

   int ax5500DI_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:
   ax5500DO

Description:
   Digital output function for specified channel.

   int ax5500DO(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:
   ax5500DO_P

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

   int ax5500DO_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:
   ax5500SetCntMode

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

   int ax5500SetCntMode(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:
   ax5500GetCntSts

Description:
   Retrieve the status of the specified counter.

   int ax5500GetCntSts(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:
   ax5500ReadCnt

Description:
   read the current count of the specified counter.

   int ax5500ReadCnt(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:
   ax5500WriteCnt

Description:
   Write data to the specified counter.

   int ax5500WriteCnt(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:
   ax5500EventCount

Description:
   Event counting function.

   int ax5500EventCount(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:
   ax5500Frequency

Description:
   Frequency measurement function.

   int ax5500Frequency(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:
   ax5500WaveGen

Description:
   Generate square wave through OUT pin.

   int ax5500WaveGen(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: web4, load: 1.32