PIO-D144/D168 User Manual
Contents
1. Return If returned value PIODA_NOERROR it means that sending data to I O port successfully Otherwise please refer to Section 2 1 Error Code PIODA Digital_Input Description This subroutine reads the 8 bits data from the specified I O port Syntax WORD PIODA Digital_Input WORD fd WORD port WORD di_data Parameter fd The file descriptor of device file that get from function PIODIO_Open port The input port number di_data A variable address used to storage the 8 bits input data Return If returned value PIODA_NOERROR it means that reading data from DI port successfully Otherwise please refer to Section 2 1 Error Code PIODA_IntInstall Description PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 8 This subroutine installs the IRQ service routine 0 Syntax WORD PIODA_Intinstall WORD fd HANDLE hisr WORD signal WORD int_source WORD activemode O Parameter fd The file descriptor of device file that get from function PIODIO_ Open hisr Address of a Event handle The handle function will be called when the interrupt happened signal The number of signal is defined by user Int_source Please refer to the following table 2 3 Table 2 3 Card No Int_source Description PIO PIOD144_168_P2C0 Enable P2C0 D144 D168 PIOD144_168_P2C1 Enable P2C1 PIOD144 168 P2C2 Enable P2C2 PIOD144 168 P2C3 Enable P2C3 PIOD144 168 ALL_INT Enable2. All Int Source activemode The value 0 means interrupt happened when signal is low The value 1 means interrupt happened when signal is high The value 2 means interrupt happened when signal is low or high 0 Return Please refer to Section 2 1 Error Code 2 3 10 PIODA_IntRemove e Description This subroutine removes the IRQ service routine e Syntax WORD PIODA_IntRemove WORD fd WORD sig_id O Parameter fd The file descriptor of device file that get from function PIODIO_Open sig_id The number of signal is defined by user PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 9 0 Return If returned value PIODA_ NOERROR it means that sending data to I O port successfully Otherwise please refer to Section 2 1 Error Code PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 10 3 PIO D144 D168 Demo Programs For Linux All of demo programs will not work normally if PIO PISO linux driver would not be installed correctly During the installation process of PIO PISO linux driver the install scripts ixpio inst will setup the correct kernel driver After driver version 0 20 3 or the later driver version compiled and installation the related demo programs development library and declaration header files for different development environments are presented as follows Table 3 1 l File Drive
3. LibaryVersion void int PIODA_Open char dev_file WORD PIODA_Close WORD fd WORD PIODA_DriverInit WORD WORD PIODA_PortDirCfs WORD WORD boolean WORD PIODA _Digital_Output WORD WORD byte WORD PIODA Digital_Input WORD WORD WORD WORD PIODA _Intinstall WORD HANDLE WORD WORD WORD WORD PIODA_IntRemove WORD WORD PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 5 2 3 Digital I O FUNCTIONS 2 3 1 2 3 2 2 3 3 PIODA GetDriverVersion Description To show the version number of PIO PISO linux driver Syntax WORD PIODIO_ GetDriverVersion Void Parameter None Return The code PIODA_NOERROR Please refer to Section 2 1 Error Code PIODA_GetLibaryVersion Description To show the version number of PIO PISO linux static libary Syntax WORD PIODIO_ GetLibaryVersion void Parameter None Return The code PIODA_NOERROR Please refer to Section 2 1 Error Code PIODA_Open Description To open device file Syntax int PIODIO_Open char dev_file Parameter dev_file The path of device file Return The file descriptor of device file If the file descriptor lt 0 it means that open device file failure PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 6 2 3 4 2 3 5 2 3 6 PIODA Close Description To close device file Syntax Word PIODIO_Close WORD fd Parameter fd The file descriptor of de
4. PIO D144 D168 User Manual Warranty All products manufactured by ICP DAS are warranted against defective materials for a period of one year from the date of delivery to the original purchaser Warning ICP DAS assume no liability for damages consequent to the use of this product ICP DAS reserves the right to change this manual at any time without notice The information furnished by ICP DAS is believed to be accurate and reliable However no responsibility is assumed by ICP DAS for its use nor for any infringements of patents or other rights of third parties resulting from its use Copyright Copyright 2003 by ICP DAS All rights are reserved Trademark The names used for identification only may be registered trademarks of their respective companies PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 1 Linux Software Installation 1 1 1 2 Static Libary Function Description 2 1 2 2 2 3 PIO D144 D168 Demo Programs For Linux 3 1 3 2 3 3 3 4 3 5 3 6 Tables of Contents Linux Driver Installing Procedure imei did is Linux Driver Uninstalling Procedure i nico dt tabs Table of ErrorCode and EOS TOA darias F ction Descriptions ido teste e e e s ert Digital VERPUNUETIONS ura da no aas 2 3 1 PIODA GetDriver Vers senicivininard radar odres 2 3 2 PODA GEL Dar y V CIO ii A Ad ad 2 3 3 A A O Ded Ae PODA cidad 2 32 PIODA Driver tina diia 230 PIOD A Porn Gis cc iS 234 PIODA Digital OMG aia t
5. ana 2 3 8 PIODA Digital putada iaa 2 39 PIODA Intinistall cid ZA LO HODA TARMA O DEMO Code POE ed A ees a A AA es Dem cod Port nr e eto Oe rotas en esc Gta DEMACIADO a escort arses Demo code IMC si ini ias Bos a ah Saute atta gk sada Salle aA ade aos eae DEMO COE TIA tados acotado edu PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 2 1 Linux Software Installation The PIO D144 D168 can be used in linux kernel 2 4 X and 2 6 X For Linux O S the recommended installation and uninstall steps are given in Sec 1 1 1 2 1 1 Linux Driver Installing Procedure Step 1 Copy the linux driver ixpio 0 20 3 tar gz or the later driver version in the directory NAPDOS Linux of the companion CD to the linux host that you want to install driver Step 2 Decompress the tarball ixpio 0 20 3 tar gz Step 3 Type cd to the directory containing the package s source code and type configure to configure the package for your system Step 4 Type make to compile the package Step 5 Type ixpio inst to install the PIO PISO driver module and build the device file ixpioX in the device directory dev automatically 1 2 Linux Driver Uninstalling Procedure Step 1 Type cd to the directory containing the package s source code Step 2 Type ixpio remove to remove the PIO PISO driver module PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 3 2 Static Libary Func
6. o enable P2CO0 as interrupt source The interrupt will be triggered when the signal is low PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 12
7. r Name Directory Path Description Name Include piodio h PIO PISO library header Lib libpio a PIO PISO static libary ixpio 0 20 3 port c Digital input demo port2 c_ Digital input and output demo examples piod144 port_a c DI and DO demo with libary examples piod168 int c Interrupt demo int2 c Interrupt demo Int_a c Interrupt demo with libary 3 1 Demo code port c This demo program is used to read data from port 2 and get out if read data error or port 2 bit 7 0 3 2 Demo code port2 c This demo program is used to output digital from port 1 and input digital data from port 0 PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 11 3 3 Demo code port_a c This demo program coded by using the static library libpio a It is used to output digital from port 1 and input digital data from port 0 3 4 Demo code int c This demo program uses P2C0 P2C1 P2C2 P2C3 as interrupt source The interrupt will be triggered according to the argument sig bedge if value 1 then the interrupt triggered at high signal and low signal or sig edge if value 1 then interrupt triggered at high signal Otherwise the interrupt triggered at low signal 3 5 Demo code int2 c This program configures driver to send signals in different signal id for the four interrupt channels 3 6 Demo code int_a c This demo program coded by using the static library libpio a t
8. tion Description The static libary is the collection of function calls of the PIO DIO cards for linux kernel 2 4 x and 2 6 x system The application structure is presented as following figure The user application program developed by C C language can call library libpio a in user mode And then static libary will call the module ixpio to access the hardware system Function Call into Libary Development Toolkit Services Call into Kernel Mode Device Control Figure 2 1 PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 4 2 1 Table of ErrorCode and ErrorString Table 2 1 Error Code Error ID Error String O PIODA_NOERROR OK No error 1 PIODA_MODULE_NAME_GET_ERROR Module name can t get from file proc ixpio ixpio 2 PIODA_DEVICE_DIO_INIT_ERROR Initial digital I O port error 3 PIODA_ACTIVE_PORT_ERROR Select I O port error 4 PIODA_PORT DEFINED ERROR Port number out of range 5 PIODA_DIGITAL_OUTPUT_ERROR Digital output error 6 PIODA_DIGITAL_INPUT_ERROR Digital input error 7 PIODA_INT_SOURCE_DEFINED_ERROR Interrupt source defined error PIODA_CONFIGURE_INTERRUPT_ERROR Configure interrupt error 9 PIODA_ACTIVEMODE_DEFINED_ERROR Defined Interrupt active mode error 10 PIODA_ADD_SIGNAL_ERROR Add signal condition error 2 2 Function Descriptions Table 2 2 Function Definition WORD PIODA_ GetDriverVersion void WORD PIODA_ Get
9. vice file that get from function PIODIO_Open Return The code PIODA_NOERROR Please refer to Section 2 1 Error Code PIODA Driverlnit Description To allocates the computer resource for the device This function must be called once before applying other PIODA functions Syntax WORD PIODA_Driverlnit WORD fd Parameter fd The file descriptor of device file that get from function PIODIO_Open Return The code PIODA_MODULE_NAME_GET_ERROR PIODA_READ_EEPROM_ERROR only for PIO DA16 device or PIODA_NOERROR Please refer to Section 2 1 Error Code PIODA PortDirCfs Description To change Digital I O port status DI or DO Syntax WORD PIODA_PortDirCfs WORD fd WORD port boolean io Parameter fd The file descriptor of device file that get from function PIODIO_Open port The port number that want to change status DI or DO PIO D144 D168 User s Manual Ver 1 0 Sep 2007 PMH 009 24 7 2 3 7 2 3 8 2 3 9 io The value O means digital output The value 1 means digital input Return If returned value lt 0 it means that changing port status DI or DO failure PIODA Digital_Output Description This subroutine sends the 8 bits data to the specified I O port Syntax WORD PIODA _Digital_Output WORD fd WORD port byte data Parameter fd The file descriptor of device file that get from function PIODIO_Open port The output port number data 8 bits data
Download Pdf Manuals
Related Search