User Manual
Contents
1. see A EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 36 pcidioGetirq uit Description This function returns the content of the card s internal interrupt register upon appearance of the final interrupt Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt Int_State gt Array for the register status typedef PCIDIO_INT_STATE BYTE BoardNumber Card allocation DWORD IRQIO_1_32 Interrupt register of the base card DWORD IRQIO_33_64 Interrupt register of the extension card BYTE IRQTIMER Interrupt register for the timer BYTE PERREG Global interrupt register of the card lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt IRQIO_1_32 gt The register returns the status of the respective interrupt sources of inputs 0 to 31 A set bit indicates a pending interrupt lt IRQIO_33_64 gt The register returns the status of the respective interrupt sources of inputs 32 to 63 A set bit indicates a pending interrupt lt IRQTIMER gt The variable contains the status and the interrupt status of the timer in the two lowest bit positions Bit 1 BitO Significance 0 0 Timer is not running and no timer interrupt was triggered 0 1 Timer is running and no timer2. PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 12 The individual interrupts of the inputs are configured enabled and disabled again by soft ware There are two different edge configurations available for the inputs It is possible to trigger an interrupt upon a rising or a falling edge at the input contact After a hardware reset all interruption settings are deleted and the falling edge set as fault triggering edge d Note Further details on I O interrupts can be found in the chapters on software programming 3 4 Timer There is a 24 bit timer integrated on the PCIDIO32 base card to cyclically generate inter rupts One clock cycle is 100ns so a maximum interval of 1 6777217 seconds can be set An interrupt can be triggered upon every zero crossing of the timer if so enabled and set by the software Note Further details on the timer can be found in the chapters on soft ware programming 3 5 Managing Interrupts The PCIDIO offers several interrupt sources that are managed by interrupt sharing on the card There are configuration enabling and disabling functions for each of the individual card internal interrupts There are also configuration enabling and disabling functions available for the PCI interrupt used by the card Also the user can transfer an interrupt handler function of his own to the PCI inter
3. PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual Side 1 01 12 2014 Rev 3 5b pcidio en um 3v5b doc PCIDIO User Manual Revision 3 5b RoHS Compliant Directive 2005 95 EC PCIDIO64 PCIDIOEX PCIDIO32 EBRU GmbH Am Laempertsbach 23 D 99826 Nazza Germany Tel 49 36924 30 800 Fax 49 36924 42 204 www ebru de info ebru de PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 2 P Table of Contents 1 Introd cti n ssassassriasniassesnnnsnnonnn inanes nakan nnin naa nnmen aan anaana nakna Annaan aaae naiak na munana nanan Waem to nine A Sanna 4 1 1 Scope of Delivery rresia ere aa aaa aaa EA EEA Eaa E EENE EEIE EE A AAEE 4 1 2 Bs 2 Ik 9 epee eee rine ee errr ere Ser pa cern een er ar Sen eee 4 1 3 System Req lemenlS pensiei slg uaa pas a leper de eta ag eal eet due ian 6 1 4 Software Support os costae ccs seckseea acta suacedetiacesuusecyecchshea iu stenesde stuceetersecinsdsaGesreustatestantzensaseeienateaa 6 1 5 Notation in this APIA isos zs cane anit astavasheesgcaetansapantsesadad eens tatleiaaiailinessusdiereiiGsaeradisandelnsetealans 6 PATAC LELIT p sesese cscs ee esessesiscctennsessdcescwstdseuasbavinsuuazeanevedseseeseucausicauauecavenstanussuzeasisos dumnuadeeeasedeesuetabeneusies 7 2 1 Installation under Windows 7 Vista XP 32 64 Bit ecccceeeseeeeeeeeeeeee scence eeeeeeeeeeee
4. pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 10 3 3 1 External Power Supply The external power supply of the I Os and the optical isolation is provided by the respective connector to the 24VDC and GND with 24VDC 30 connections Tip We urgently recommend you also apply the power supply to all available connections on principle Since the external power supply is completely independent of the base and extension card the I Os on the two cards can be operated at two entirely different potentials Conversely that also means that when working with base and extension card the external power supply must be applied to both connectors Note Do not exceed the total current of 5A on the PCIDIO32 base card The total current on the PCIDIOEX extension card may not ex ceed 2A if the external power supply is only connected to the IDC socket If the external power supply is connected to connector KL1 as well or instead the total current on the PCIDIOEX may reach 5A 3 3 2 Outputs of the I Os The optically isolated and permanently short circuit proof outputs of the I Os are each built with Power MOSFET transistors and have internal temperature monitoring that automatically switches off the respective output in the case of overload or short circuit and switches it back on when the MOSFET depletion layer temperature falls below the 150 C threshold Each output also has a 1A freewheeling recovery diode between the respective
5. running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 41 5 3 Digital Output Functions pcidioDOSetChanne IState I El Description Sets the assigned output to the assigned level Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt Channel gt Channel number 0 63 of the desired output channel lt ChannelState gt Status of the channel 1 signifies a high level and 0 a low level on the corresponding I O pin of the PCIDIO connector Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDOSetByte uit Description This function available starting from the driver DLL version 3 0 sets the output level of the assigned 8 channel output group to the assigned levels d Note Channels that are operated as inputs or are not used must always be initialised to 0 lt gt Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os
6. EBRU pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 43 pcidioDOServiceChannel uit Description Updates the status of all output channels as programmed with the functions pcidio DOSetChannelState or pcidioDOSetState Note If the watchdog is used this program must be called at least once within the watchdog s programmed timeout period if no other output function is being used Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual Side 44 01 12 2014 Rev 3 5b pcidio en um 3v5b doc Appendix A1 Pin Assignment 37 pin D SUB Socket PCIDIO32 Base Card Starting with PCB revision XE as delivered condition since 2005 the external power supply can also be connected internal on the card on a separate screw type terminal block Description Pirn 24V DC When looking from the front pin 1 is the left connector of the screw type terminal block For wiring we recommend using a wire of 0 75mm max 2 5mm EBRU G PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual
7. 12 2014 Rev 3 5b Side 5 The 32 digital I Os on the PCIDIO32 base card are connected to the card s slot bracket by a 37 pin D SUB socket The optional PCIDIOEX extension card is connected by a IDC head er which can optionally be connected via the PCIDIOKA ribbon cable to a second slot bracket with 37 pin D SUB socket If using a 1 1 crimped cable both cards are pin compatible Optionally the PCIDIOHM Clamp Module with spring force connection for user friendly wir ing and the corresponding PCIDIOVK1M or PCIDIOVK2M connector cable are available for the DIN standard rail Features 32 digital I Os on the PCIDIO32 base card optically galvanically isolated from the com puter and optimised for 24VDC A further 32 digital I Os on the optional PCIDIOEX extension card optically galvanically isolated from the computer and base card and optimised for 24VDC Each I O freely usable as an input or output and interrupt source Galvanic isolation voltage min 1500Vrms Outputs Max 1A output current per channel Direct connection of resistive capacitive or inductive loads Permanently short circuit proof with automatic restart attempts and overvoltage protec tion Short circuit recognition for diagnostic purposes Programmable computer independent watchdog for the outputs Inputs Switching threshold optimised for 24VDC Input current at 24VDC approx 3 5 mA Each input can trigger interrupts with programmable edge RC input filter and
8. Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 40 PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt Channel gt Channel number 0 63 of the desired input channel lt ChannellntEnable gt Releases input channel as interrupt source with 1 or blocks the channel again with 0 lt ChannelTrigger gt Defines the interrupt trigger time where 0 stands for a trigger on a falling edge and 1 stands for a trigger on a rising edge Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDIGetIrqChannelConfiguration Description Returns the interrupt configuration of an input ty Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt Channel gt Channel number 0 63 of the desired input channel Output lt ChannellintEnable gt If 1 the input is locally enabled as interrupt source if 0 the input is locally disabled as interrupt source lt ChannelTrigger gt If 0 the falling edge will be selected as trigger time for the input and if 1 the rising edge will be selected Return If the function was executed successfully it returns TRUE If an error has occurred while
9. interrupt was triggered 1 0 Timer is no longer running and timer interrupt was triggered 1 1 Timer is running and timer interrupt was triggered lt PERREG gt This register offers another method of determining the card as interrupt source Bit 0 This bit is 1 if at least one interrupt of the card is pending Bit 2 This bit is 1 if the timer interrupt is pending Bit 3 This bit is 1 if at least one of the interrupts of the base card inputs is pending Bit 4 This bit is 1 if at least one interrupt of the extension card inputs is pending EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 37 Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioResetirq uit Description This function resets in the user specific mode the kernel mode interrupt handler This func tion must be called at end of the user specific interrupt handler Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorM
10. output and GND and a diode in series to protect against reverse currents Thus resistive inductive and capacitive loads can be connected directly Due to the diode protection and the drain source resistance of the MOSFET the voltage drop at each output is between 0 6V and 2V pending on load The load switching capabilities and switching frequency of the outputs are by nature strongly dependent on the type and size of the respective load Po KHz at 0 25 A and purely resistive load Turn on time typ max 45 us 125 us at 270 Ohm load Turn off time typ max 80 us 250 us at 270 Ohm load Min isolation voltage of optocoupler 5 000 Vrms Switching frequency typical 500 Hz at 1A and purely resistive load EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual 3 3 3 Inputs of the I Os Optocouplers are implemented to optically isolate the inputs of the I Os and are supplied with power from the external power supply on the respective male connectors A diode in series and a resistor in series for limiting the current set the switching threshold a down stream RC network and a digital filter serve to suppress interference and transients Technical Data Input Switching threshold typ max 12 VDC 10 12 VDC 30 Switching frequency gt 5 KHz Input current Vin 8 2 V 1 15 V 3900 Ohm Max input voltage Vin 31 8 VDC Min isolation voltage of optocoupler 5 000 Vrms 3 3 4 Shor
11. pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 45 NG eee 7 NC NC eej O Ot ext 24V TO o GND DC 0O O 1 0 63 VO 62 0 O 61 0 60 O 10 59 I 0 58 O O H 10 57 0 56 O O H 10 55 0 54 O 10 53 0 52 4 f O 51 0 50 Q VO 49 VO 48 4 0 O 10 47 0 46 O O 0 45 0 44 4 0 43 VO 42 O 10 41 0 40 O O H 110 39 0 38 O O 1 0 37 VO 36 O Ort 10 35 0 34 O 10 33 With a 1 1 crimped cable from the 40 pin IDC Header to a 37 pin D SUB Socket both cards are pin compatible When using an AWG28 ribbon cable the ampacity is 1A per wire used which means the total currents may only be 2A maximum if not using the additional KL1 connector A3 Connector Assignment KL1 PCIDIOEX Extension Card If the external power supply is applied alternatively or simultaneously to the IDC Header and the KL1 connector the total currents may be maximum 5A Description Pin 724V DC When looking from the front pin 1 is the left connector of the screw type terminal block For wiring we recommend using a wire of 0 75mm max 2 5mm EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 46 B PCIDIOHM Clamp Module For user friendly system wiring in the switch cabinet there is the Clamp Module PCIDIOHM with spr
12. sample programs for demonstration and start up EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 8 3 Hardware 3 1 Block Diagram The block diagram below shows the layout of the PCIDIO The functionalities in the area shown in yellow are implemented on the PCIDIO32 the functionalities in the area shown in green are implemented on the PCIDIOEX Both cards together constitute the PCIDIO64 in the area shown in blue PCIDIO64 32 digital 24V I O s Ext 24V Ext Gnd 40 pin IDC Header 32 digital 24V I O s Optical Isolation f Address Optical Isolation Digital Logic Extension Watchdog Control unit Interrupt Logic PCl Interface D x O O N a te Q amp ca o 3 2 General Notes All connectors may only be connected when powered off Make sure the slot bracket of the card is screwed onto and earthed through the computer case For connections outside the computer use exclusively shielded cable and make sure the shielding is earthed Make sure when touching the card or connecting the connector cable that no static dis charge can occur over the card Make sure the connector cable is properly inserted other wise the card may not function properly When screwing the PCIDIO32 base card and PCIDIOEX extension card together to the PCIDIO64 board set you must make absolutely sure that only plastic nuts and plasti
13. the operation of the outputs with the watchdog enabled In this ex ample all outputs will be given a pattern the activation of an individual output is done in a similar manner unsigned char _ucWatchdogIntervall watchdog interval unsigned char _ucWatchdogService flag for watchdogservice PCIDIOALLCHANNELS 1 _OutputStates state of the outputs PCIDIOALLCHANNELS _NewOutputState new state of the outputs set the output mask 1_OutpuState Basis OxAAAAAAAA 1_OutputState Extension 0x55555555 start watchdog 1_bReturnValue pcidioSetWatchdogIntervall 1_ucActIndex 1_ucWatchdogIntervall if __bReturn Value TRUE set outputs 1_bReturnValue pcidioDOSetState 1_uc ActIndex board address number 1_OutputState state of the outputs function returns with no error if 1_bReturnValue TRUE wait min 250us due to the switching delay of the output transistors and input filter if necessary with load sensitive delay here 1ms Sleep 1 read state of the outputs 1_bReturnValue pcidioDIGetState 1_ucActIndex board address number amp 1_NewOutputState new state of the outputs error Tf _bReturn Value FALSE get error message pceidioGetErrorMsg 1_strErrorTxt flag for the watchdogservice 1_ucWatchdogService TRUE is the watcidogserviceflag set if __ucWatchdogService TRUE set outputs again pcidioDOServiceChannel 1_ucActIndex EB
14. unsigned char IrqPin unsigned char IrqLine i lt DevicelD gt Describes the function group in which the PCIDIO card is arranged with the hexadeci mal value 0004h lt VendorlD gt Describes the vendor ID of the PCIDIO with the hexadecimal value 1172h lt StateReg gt Describes the PCI status of the PCIDIO lt ControlReg gt Control register for the PCI bus lt ClassCode gt Contains the card class description with the hexadecimal value 118000h lt RevisionID gt Describes the revision of the card FPGA e g 02h lt HeaderType gt Describes the type of the PCI header with the hexadecimal value OOh lt BaseAodress gt Describes the base address form BARO amp OxOFFFC of the card in the I O range of the PC system for direct programming EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 30 lt SubSys D gt Contains the sub system identification of the PCIDIO with the hexadecimal value 0662h lt SubVenI D gt Contains the sub vendor identification with the hexadecimal value EB84h lt IrqPin gt Contains the PCI interrupt pin used lt IrqLine gt Contains the interrupt number used Output Filled external data array Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidio
15. 00 pm Fax 49 36924 42 204 F Customised Models As an all round industrial electronics service provider we will gladly conduct custom modifi cations or extensions for you Because we have integrated the PCI interface into an FPGA together with the entire control there exist many possibilities for development G Service Address We hope you will never have any need for this service address Nevertheless should any malfunction occur despite careful production and controlling please write to EBRU GmbH Am Laempertsbach 23 D 99826 Nazza Germany Should your send your card in for repair please include as detailed a description of the mal function as possible That way we can handle your specific case much more quickly H Updates We provide driver software and documentation updates on our website at www ebru de Revision History DLL Version Changes 2 0 First implementation of the api with support for Windows 98 98SE ME 2000 XP 3 0 Byte accesses on the I O s Support for Windows Vista 32 bit 3 2 To support interrupt functionality in conjunction with Quad Core CPUs modifications were done in the file KP_PCIDI SYS and also in the files PCIDIO In the files PCIDIO a new function pcidioResetIRQ was implenmented This function was first introduced in Release 3 2 and resets in the user EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 R
16. 01 12 2014 Rev 3 5b Side 39 Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDiGetState uit Description Returns the state of all inputs at once Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output lt AllChannelState gt Status of all input channels of the selected card The variable is a structure of two 32 bit long values and each bit stands for a channel Nonexistent channels are always 0 typedef struct PCIDIOALLCHANNELS DWORD Basis Status of the base card inputs DWORD Extension Status of the extension card inputs Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDISetIrqChannelConfiguration Description sets the interrupt configuration for an input channel ty Note The PCI interrupt itself will not be globally released or blocked with this function This function only blocks or activates the respective lo cal I O interrupt in the card interrupts mask Parameter gt Input lt BoardNumber gt EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I
17. 1 12 2014 Rev 3 5b Side 21 Interrupthandler void Inthandler void unsigned char _ucActIndex unsigned char _ucState PCIDIO_INT_STATE 1 _IntState read the interrupt state SE E s See pcidioDIGetIrg l_ucActIndex amp l_IntState if _IntState IROTIMER amp 0x02 0 read output pcidioDIGetChannelState l_ucActIndex 1 amp l_ucState toggle state and set output pcidioDOSetChannelState l_ucActindex 1 l_ucState pcidioResetIRQ l_ucActIndex EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 22 4 7 Driver Concept The Windows 7 Vista XP 32 Bit and 64 Bit and 2K 32 Bit driver for the PCIDIO is imple mented as WDM driver and comprises the following components WDMdriver kp_pcidi sys for Windows 7 Vista XP und 2K APEDLL pcidio dll for Visual C with cdecl and stdcall declarations These Software components are available for 32 Bit and 64 Bit systems As for 64 Bit systems the programmer has to take care which application has to be devel oped For a 32 Bit application the DLL pcidio_32_64 dll and for a 64 Bit application the DLL pcidio 64 64 dIl must be used along with the respective Lib files During compilation for 64 Bit systems the preprocessor directive KERNEL_64Bit must be used The API does not differ for the several systems only the internal data processi
18. GetErrorMsg pcidioSetTimer h Description ets the timer interval of the PCIDIO with the assigned value O ii d Note The timer interval is derived as assigned value 1 100ns which means times of 200ns to 1 6777217s can be programmed Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt Timerinterval gt Value for the timer interval in counts from 1 200ns to 2 16777216 1 6777217s Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU see A EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 31 pcidioStartTimer h Description tarts the timer of the PCIDIO without interrupt handling O ii d Note If an interrupt handle is desired then the functions pcidioSe tIRQTimer and pcidioEnablelrq must be called before the function is called Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified us
19. PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 3 perdio SAM TIMEN arae awed Saisie chet OE OEE AA 31 PCIGIO STOP VIMO ciir E E E TEE E EEEE EE E O ETE EEE 31 podios o IRO TIME asenna E A T E NEES 32 pcidioSetWatchdogIntervall 0 cecececeeeeeceeneeeeeeeaeeeeeeeaeeeeeeaaeeeeseaaeeeeseaaeeeeseaaeeeeseaaeeeeeaaeeeeaeages 32 pcidioGetWatchdogState ecceeeeeeeeeeeeeeeeeeee seen ee ee ee ee ae ee esse KET NEEE E EEEE REEE EE EEE 33 PCIGIQMOS CU tec taaalecanfananccngaterue tnantaseianes ucataysnetagatared A E E 34 pedio GETEMOPM SG aurrei a auc apts Uaodaakebuedainan S 34 WCIGIOEMADIS IEG PAA EE E A A gtanad stdaagerdatntaadecdadadst vautunadeeduadetdantantesdsaddaretgtanatecaamastedes 35 padio LISADEGA doy genmeGuuhennene staat E oyun di E 35 PCICIOG OU G PAE EAE A EA IEA EA E mewsiihenttan A AE 36 PCICIOROS E a E E E A 37 5 2 Digital Input Functions a tas seperse tses neeseuesceacmasdianstsansoncageraud scinmtannmmininebctourigeeausmeateensiewancecaeucnaees 38 PCIDIODIGStChannel States ccicctcsvece cee lancccescanneceevanie Ea ce lansuceneanneteevanie cake 38 peidio DIGBY E iicccecciseccocstnencesoan ences EE EEE EAR A 38 PCIGIODIGOtState i son eiises ses seenecemtanecaesataue doatsveceead Wace quueginec ces Unaueciuitait atuswsenaswaginen ITEE EEEE 39 pcidioDISetilrqChannelConfiguration ccceeeceeeeeee cece ener cece eee eeeeaaeeeeeeaaeeeeeeaaeee
20. RU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 18 The flag _ucWatchdogService is set in the program sequence to TRUE and checked The program must call the watchdog service function at least once within the programmed time out period otherwise the outputs will be reset by the hardware It is still possible to query the status of the watchdog before calling the watchdog service function That way it can be recognised whether the watchdog has tripped since the last op eration of the outputs Should that be the case an error has occurred in the user program that prevented the timely service of the watchdog 4 4 Operation of the Digital Inputs Next we shall demonstrate the read in of the digital inputs Again it must be noted here that there are two options individually accessing a certain channel and collectively accessing all channels This chapter deals with individual access by way of example Collective access follows the same method except with the help of another function call unsigned char l_ucInputState state of the input unsigned char _ucChannel number of the input read the input _bReturnValue pcidioDIGetChannelState l_ucActIndex board address number l_ucChannel number of the input amp l_ucInputState state of the input error if __bReturnValue 0 get error message pcidioGe
21. User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 42 lt bytenumber gt Number of the output group 0 3 base card and 4 7 extension card lt State gt Output level to set the output channels of the selected card Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDOSetState Description ets the state of all output channels h DC ii d Note Channels that are operated as inputs or are not used must always be initialised to 0 Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt AllChannelState gt Status of all output channels of the selected card The assigned structure contains one vari able for each of 32 channels Nonexistent channels or channels used as inputs must always be set to 0 typedef struct PCIDIOALLCHANNELS DWORD Basis Status of base card outputs DWORD Extension Status of extension card outputs Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual
22. al pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 16 The second way to operate the outputs is to set all output channels with a certain pattern PCIDIOALLCHANNELS _OutputStates _ state of the outputs PCIDIOALLCHANNELS 1 _NewOutputState new state of the outputs take the address number of the current board from the board information 1_ucActIndex _Summery Buffer 0 BoardNumber set the mask of the outputs 1_OutputState Basis OXAAAAAAAA 1_OutputState Extension 0x55555555 set the outputs 1_bReturnValue pcidioDOSetState I_ucActIndex board address number 1_OutputState output state mask error if 1__bReturn Value TRUE wait min 250us due to the switching delay of the output transistors and input filter if necessary with load sensitive delay here 1ms Sleep 1 read state of the outputs 1_bReturnValue pcidioDIGetState l_ucActIndex board address number amp 1_NewOutputState output state mask error if 1__bReturn FALSE get error message pceidioGetErrorMsg 1_strErrorTxt d Note The function Sleep can be replaced by a Delay function that waits minimum 250us in addition to any load dependent delay EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 17 4 3 Operation of the Digital Outputs with Watchdog Enabled Now we shall describe
23. an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioSetWatchdogIntervall h Description ets the timeout period for the PCIDIO watchdog to the assigned value and starts it DC ii Note Setting the timeout period immediately starts the hardware watch dog The watchdog can only be disabled or the timeout period made settable again by a hardware reset or the appropriate software func tion pcidioReset Note If the watchdog is enabled an output must be accessed at least once within the timeout period otherwise the watchdog will switch off the output EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 33 Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt WatchdogInterval gt Value for the timeout period of the watchdog in counts from 1 26 2144ms 255 6 684672s Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioGetWatchdogState Description Returns the watchdog status whether it has tripped ty Parameter gt Input lt BoardNumber gt PCIDIO addressing index detect
24. c EBRU GmbH aempertsbach 23 9826 Nazza Gel PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 9 screws such as those that come with the PCIDIOEX are used in order to prevent electrical short circuits to neighbouring cards The plastic nuts must be at least 3 mm thick to be effec tive as contact protection 3 3 Digital I Os The PCIDIO family of cards has up to 64 freely configurable inputs and outputs All I Os can be configured independently of one another as input or as output with read back The soft ware sets the direction of the ports and their interrupt functionality Note As soon as a port is set to 1 the correspondingly allocated pin is set to High 24V and the IO serves as output Ports used as input may never be set to 1 If a port is read the level of the correspondingly allocated pin is read back 0 for GND or 1 for 24V Outputs can also be read back After switching on the computer or after a reset all outputs are programmed to 0 and the interrupt functionality is deactivated Tip For programming read the corresponding chapter of this manual 24V ext Input Output Q From Control Logic _ To Control _ Logic e O QO T Photocoupler Photocoupler GND ext EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual
25. digital filter with 10KHz cut off frequency Unused inputs can be left open Other features Programmable 24 bit 10 MHz timer with interrupt operation 2 additional jumpers for distinguishing multiple cards within the same system 32 bit PCI short card Universal Card for 5V 33MHz and 3 3V 66MHz PCI slots External supply of output transistors and the optical isolation via the connector of the respective card with 24VDC 30 Optional Clamp Module PCID IOHM with spring force connection for user friendly wiring Comprehensive software for Windows 7 64 32 Bit Vista 64 32 Bit XP 64 32 Bit 2K and DOS included Customised modifications and drivers possible upon request RoHS compliant according to Directive 2002 95 EC Also available as software compatible CompactPCI board cPCIDIO with 32 lOs without the option to add further I Os EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 6 1 3 System Requirements The PCIDIO family requires a PC with an X86 processor or compatible computer One free 32 bit PCI slot at 5V 83MHz or 3 3V 66MHz is required 1 4 Software Support Please read the Readme files in the current software package to find out what software is included There are drivers demo programs and tools available 1 5 Notation in this Manual Function names are always bold and italicised lt TimesNewRoman gt parameters ar
26. e 25 pcidioDeinitCards uit Description This function deinitialises all PCIDIO family cards present in the system and deletes the memory occupied by the driver Note This function should be run at the end of an application in order to free up the memory occupied by the driver and to delete the inter rupt handler Before calling this function we recommend additionally either to globally reset the card in the user program or at least to delete the outputs and reset the interrupt configurations Parameter gt Input none Output none Return none pcidioGetSummaryOfAllBoards Description Gives an overview of the cards present This overview contains the location of the card in the system the position of the card addressing jumper and the basis address of the card in the I O range and the card number Given this data it is possible to use the cards uniquely in the program ty Parameter gt Input lt SummaryBuffer gt Pointer to the data buffer for the overview data The pointer must show a sufficiently large data array of PCIDIO_SUMMERY type EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 26 typedef struct PCIDIO_SUMMERYSummerybuffer PCIDIO_HANDLE hPCIDIOHandle BYTE BoardIndex BYTE BoardNumber BYTE SlotNumber BYTE BUSNumer BYTE BoardAdressJumper DWORD Board
27. e Digital Outputs As an introduction to using the card operation of the outputs without employing the watch dog will be described here There are principally two ways to operate the outputs The first way shown here is to set a special output unsigned char _ucActIndex board address unsigned char _ucSetOutputState 1 state of the output unsigned int _ucNewOutputState new state of the output unsigned char _ucChannel output channel to change take the address of the current board from the board information 1_ucActIndex l_SummeryBuffer 0 BoardNumber set an output 1_bReturnValue pcidioDOSetChannelState 1_ucActIndex board address l_ucChannel output to change _ucSetOutputState output state error if __bReturn Value TRUE wait min 250us due to the switching delay of the output transistors and input filter if necessary with load sensitive delay here 1ms Sleep 1 read the state of the output 1_bReturnValue pcidioDIGetChannelState 1_ucActIndex board address number LucChannel output to read amp l_ucNewOutputState new state error if 1_bReturnValue FALSE get error message pcidioGetErrorM sg 1_strErrorTxt d Note The function Sleep can be replaced by a Delay function that waits minimum 250us in addition to any load dependent delay EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manu
28. e in angle brackets physical units are in square brackets TimesNewRoman source code segments are italicised description of driver functions notes on specific or special use tips for use parameters for functions function input parameters function output parameters function return values OTL g par EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 7 2 Installation Before installing the card carefully read your computers manual on the installation of ex pansion cards and then follow the installation procedure described in this manual Make sure the slot bracket of the card is screwed onto and earthed through the computer case Note If an already present driver has to be replaced please use in any case the corresponding uninstall bat of the driver package before installation of a new driver 2 1 Installation under Windows 7 Vista XP 32 64 Bit 1 Install the PCI card into a free PCI slot in your computer Careful You must discon nect your computer from the mains supply since some motherboards are still pow ered even if the computer is supposed to be switched off Switch the computer on and launch Windows The hardware wizard will launch automatically Close the wizard by clicking Cancel as the driver cannot be installed using the wizard and open the file manager e g Explorer Change to the d
29. ed by the function pcidioGetSummaryOfAllBoards Output lt WatchdogState gt Watchdog status with 0 for watchdog has not tripped and 1 for watchdog has tripped Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU see A EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 34 pcidioReset uit Description This function resets the PCIDIO hardware including any present extension cards com pletely to its default state Note This feature is only available on hardware revision 2 and higher see lt Revision D gt of the structure PClHeader detected by the function pcidioGetPC Configuration If the function is executed on a card of lower hardware revision it returns FALSE Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioGetErrorMsg uit Description This function returns the last given error message Parameter gt Input none Output lt Er
30. ee oe wees re ee ee 48 Published by EBRU GmbH In den Kreuzwiesen 21 D 69250 Sch nau www ebru de Copyright EBRU GmbH 2004 2014 All rights reserved No part of this manual may be copied or edited diffused or reproduced using electronic systems in any way wthout the explicit consent of EBRU GmbH The companies and product names given in this manual are the property of the respective companies This documentation has been created to describe the use of hardware and software The manufacturer may make technical changes for im proving the product Important notice We must draw your attention to the fact that we cannot carry legal responsibility or assume any liability for cons equences of incorrect use or software errors We always appreciate every notification of errors and all comments and suggestions for improvement etc EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 4 1 Introduction Dear Customer In purchasing the PCIDIO you have chosen a high quality technical product from EBRU GmbH that was in perfect condition when it left our factory Nevertheless please check the completeness and condition of the package Should any thing be missing or defective please notify us immediately Before you install the card carefully read through the chapter on installation 1 1 Scope of Delivery We make every effort to deliv
31. eeeeeeeeeeeeeeeeeeeeees 39 pcidioDIGetlrqChannelConfiguration ceeeeeeeeeeeeeeeeeee cece ee eeeeeeeeeeeeeeeeeeeeeeaaeeeeeeaeeeeeeeeeeeeeeeeees 40 5 3 Digital Q tp t FUNCIONS sespe a eaa a a a ee 41 PCIDIODOSStC Nan Mel Staline sei a E EE E nh DE E R 41 Peidio DOS OIBO oenar oreinen e Eea EEEE ETE EEEE PEKAT EE A AAE EESE ENEO EE 41 DCIGIODOSStS tate are a E A E ERN 42 PCIDIODOSESVICECHANME osea aaia AAE RA EA AEEA AE E AEEA EAAS 43 iNeo olo 1 Aranea E E E A A NS 44 Ai Pin Assignment 37 pin D SUB Socket PCIDIO32 Base Card cccccecceecceeeeeeteeeeeeeeneeeeees 44 A2 Pin Assignment 40 pin IDC Header PCIDIOEX Extension Card c cccccceeeeeeeeeereeeneeeteees 45 A3 Connector Assignment KL1 PCIDIOEX Extension Card c cccccceteeeeeeeeeeeeeeseeeeeeeeeneeseees 45 B PCIDIOHM Clamp MO Quiles aicisccssestoecesacnadssunscevsatustndsidessuceaneeasdeand sdavablessugsadeadeansauean saaasdavstowarnd 46 C DOS NS gece cae a creche tat Cos nc Sat ana Meecha a aa aa eeri an 47 D ltem NUMDESS cccccccccccsssesseeeceseeececseseeaeeeceeeesceesesaeaeseceescuseesneaeseseseesceesesaeeeseeeeseseseseeaeseseeeeseaes 47 FE UO sss E dae oar cee canes E E E E E 48 F Customised Models siisii aaa eaan da nae kaTa a A D EE an EE E ai 48 G Sorico PUGS SS cenar ii eetis ae aai Saaana eaa ETEEN A EORR Pa TAi a iiai EEE 48 H Wo 0 21 2 eee ere ene ere en cre re ye nr ete ee ee E eee 48 l Revision Fistor ae ne reper eee er eran meer rer rrr tr
32. er a complete product package So that you can make sure you have received a complete package we have listed the parts contained in the package below e PCIDIO32 or PCIDIO64 or PCIDIOEX including screw set consisting of 4 plastic screws 4 plastic nuts and 4 spacer rollers e Additional slot bracket PCIDIOKA with 37 pin D SUB Socket for the PCIDIOEX op tional e PCIDIOHM Clamp Module optional e PCIDIOVK1M or PCIDIOVK2M connector cable for optional Clamp Module PCIDI OHM optional 1 2 Description Item N lOs Timer Watchdogfor Ext supply Extendable 24V outputs PCIDIO32 32 Yes Yes Yes Yes PCIDIO64 64 Yes Yes Yes No PCIDIOEX 32 No Yes Yes No only in conjunction with PCIDIO32 The PCIDIO offers up to 64 optically isolated digital I Os optimised for 24VDC Each digital I O can be used as digital input or output and interrupt source as needed The PCI short format unit consists of the PCIDIO32 base card with 32 digital I Os which can be extended by plugging in the optional PCIDIOEX extension card to add another 32 digital I Os to make the PCIDIO64 without taking up a further slot in the PC The PCIDIO32 can later be upgraded at any time to a PCIDIO64 by plugging in the PCIDI OEX extension card The PCIDIOEX comes with the necessary installation material for the upgrade spacers nuts and screws EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01
33. ev 3 5b Side 49 specific mode the kernel mode interrupt handler This function must be called at end of the user specific interrupt handler If the function is not called only the first interrupt will be recognized by the kernel and all further interrupts won t be sent to the user specific mode With existing projects the PCIDIO files and the file wdapi1010 dll must be replaced and the interrupt handler must be upgraded as described In the Windows directory system32 drivers the files kp_pcidi sys and windrvr6 sys have also to be replaced with the new files Support for 64 Bit systems introduced in Release 3 5 Slight adjustment of the specification for the inputs and outputs due to change of optocoupler New contact data EBRU
34. ing cage connections and approx dimensions 102 5 mm width 90 0 mm depth 60 0 mm height available for the DIN Rail TS 35 and TS 32 The module is optionally available with wall mount and screw type terminals System wiring is done on the spring force connec tions with 0 25 mm to 1 5 mm wires also with fer rules We recommend using shielded connector cables such as PCIDIOVK for connecting the PCIDIO to the D SUB connection of the Clamp Module Name Contact Pin Name Contact Pin terminal D SUB male terminal D SUB male strip connector strip connector Notconnected 1 1 vos 8 8 amp 8 eno i n von 7 7 eno 9 oas f CT 9 ooo T S S o S a i D fk po tH f n k voo 6e 6 o 16 16 Tabelle Connector assignment of terminal strip and D SUB socket of PCIDIOHM Name when using a 1 1 wired connector cable to the PCIDIO Casing of the connector wired over Y condenser to clamp 38 of the terminal strip We urgently recommend earthing pin 38 as well in order to prevent interference on the con nector cable EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 47 C DOS Driver There is a suitable DOS driver in the source code available for operating the PCIDIO under MS DOS The initialisation is done over PCI BIOS extensions and the card is communicated with over I O command
35. ing the function pcidioGetErrorMsg pcidioStopTimer h Description tops the timer of the PCIDIO without blocking the interrupt Note In order to terminate the interrupt handle the functions pcdioSe DC mm tIRQTimer and pcidioDisablelrq must also be called after calling this function Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU see A EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 32 pcidioSetIRQTimer h Description locks and releases the timer interrupt for processing OO iii Note The PCI interrupt itself will not be globally released or blocked with this function This function blocks or activates the timer interrupt on ly locally in the card interrupts mask Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt CntriByte gt Control register for controlling the timer interrupt 1 gt Release 0 gt Block Output none Return If the function was executed successfully it returns TRUE If
36. lOAadress i lt hPCIDIOHandle gt Handle on the PCIDIO card for internal use lt BoardIndex gt Index for addressing the PCIDIO card This element is required for addressing the card in all functions lt BoardNumber gt Index for addressing the PCIDIO card This element can be used alternatively for addressing the card in all functions lt SlotNumber gt Number of the slot in which the card is located lt BusNumber gt Number of the bus on which the card is located lt BoardAdressJumper gt Position of the address jumper on the card specifically for primary distinction of the individual cards lt BoardlOAadress gt Address of the card in the I O range of the computer system Note The data buffer must be applied by the application developer and passed on to the function Tip The data buffer should always be able to accept four card over views Output The filled data buffer Return If the function was run successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 27 pcidioGetBoardRevision ty Description Returns the revision number of the hardware Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the fu
37. nction pcidioGetSummaryOfAllBoards Output lt BoardRevision gt Revision of the hardware in hexadecimal e g 02h Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioGetBoardAddressJumper Description Returns the position of the address jumpers SO and S1 ty Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output lt BoardAdressJumper gt Position of the address jumper on the card specifically for primary distinction of the individ ual cards It returns values in the range of 0 3 Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 28 pcidioGetBoardConfigurationData Description Returns the individual configurations of the addressed PCIDIOs ty Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output lt CntChannel gt Number of available digital channels Either 32 or 64 is returned Retu
38. ng differs in its implementation For DOS applications there is a driver included as C source code EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 23 5 API Reference This chapter describes the programming interface of the PCIDIO under Windows which the application programmer has available Tip Only use the functions documented here Using undocumented fea tures can destroy the card or the hardware connected to it Also it can happen that these functions will no longer be supported in the next version e Function prototypes In the following function descriptions the function prototypes for VC will be used e Blocking function calls Please note that program execution will only be continued if a function call has been executed completely We shall refer to this below as BLOCKING e Parameters Parameter upon input and output stands for assigned variables data arrays or point ers to these e Nomenclature The Advanced Programming Interface applies for all cards in the PCIDIO card fam ily as long as supported by the respective card All function names have the family prefix ocidio and a function group prefix gt General Functions DI gt Digital Inputs DO gt Digital Outputs For the most part the function names use self explanatory descriptions There is no postfix used for the func
39. olated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 20 4 6 Handling the Timer with Interrupt Operation Here we describe timer programming with interrupt handling In the interrupt handler of the timer programming an output of the PCIDIO will be switched upon a timer interrupt EBRU unsigned long _ulTimerIntervall stop timer pcidioStopTimer l_ucActIndex configure timer 1_bReturnValue pcidioSetTimer 1_ucActIndex 1_ulTimerIntervall if __bReturn Value TRUE enable PCI Interrupt and install interrupt handler 1_bReturnValue pcidioEnableIrq _ucActIndex amp IntHandler if __bReturnValue TRUE enable timer interrupt 1_bReturnValue pcidioSetIRQTimer 1_ucActIndex 1 if __bReturn Value T RUE start timer 1_bReturnValue pcidioStartTimer 1_ucActIndex if 1__bReturnValue TRUE wait 10s Sleep 10000 disable PCI Interrupt 1_bReturnValue pcidioDisableIrq 1_ucActIndex if 1__bReturnValue TRUE disable timer interrupt 1_iReturnValue pcidioSetIRQTimer 1_ucActIndex 0 if 1__bReturnValue TRUE stop timer 1_bReturnValue pcidioStopTimer 1_ucActIndex error if 1_bReturnValue FALSE get error message pcidioGetErrorMsg _strErrorTxt PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 0
40. rive where the installation files are located Change to the directory Win_32 32 Bit Win_64 64Bit Run the installation routine Install_x32 32Bit Install_x64 64 Bit Now the driver installation is accomplished automatically Follow the instructions of the operating system around the installation The card is ready to go when the installation has fin ished Before using the card you should reboot your computer To test the installation you can now use the sample programs for demonstration and start up 2 2 Installation under Windows 2000 1 Install the PCI card into a free PCI slot in your computer Careful You must discon nect your computer from the mains supply since some motherboards are still pow ered even if the computer is supposed to be switched off Switch the computer on launch Windows 2000 and log in as Administrator The hardware wizard will launch automatically Close the wizard by clicking Cancel as the driver cannot be installed using the wizard and open the file manager e g Explorer Change to the drive where the installation files are located Change to the directory Win32 Run the installation routine nstall_x32 Now the driver installation is accomplished automatically Follow the instructions of the operating system around the installation After the installation has finished you must reboot your computer After reboot the card is ready to go To test the installation you can now use the
41. rn If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioGetDriverVersion h Description eturns the card driver version D m Tip With this function you can check whether the correct driver version is being used or not Parameter gt Input none Output lt DriverVersion gt Version of installed driver Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 29 pcidioGetPCiConfiguration ty Description Returns the PCI configuration data of the selected card Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt PCIConfiguration gt Pointer to a structure of the type PC HEADER which the function fills with data typedef struct PCIHEADER unsigned int DeviceID unsigned int VendorID unsigned int StateReg unsigned int ControlReg unsigned long ClassCode unsigned char RevisionID unsigned char HeaderType unsigned long BaseAdress unsigned int SubsysID unsigned int SubVenID
42. rorMsg Pointer to a sufficiently large external text field min 100 characters to be created by the programmer into which the string from the function is copied Return none EBRU see A EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 35 pcidioEnablelrq uit Description This function installs the user specific interrupt handler and enables the PCI interrupt glob ally but not the respective local masks Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt IntHandler gt Function pointer of type PC DIO_INT_HANDLER on the user interrupt handler Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDisablelirq uit Description This function disables the PCI interrupt globally but not the respective local masks Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards Output none Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg EBRU
43. rupt After a hardware reset the interrupt functionality is disabled and not configured Note Further details on interrupt programming can be found in the chap ters on software programming EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 13 3 6 Address Jumper So as to distinguish multiple cards of the PCIDIO family within the same computer there are two jumpers integrated on the PCIDIO32 base card That way four cards with a total of maximum 256 I Os can be distinguished The jumpers are labelled S1 and SO on the base card The position of the switches can be queried using software functions The driver uses the position of the jumper for addressing if several cards are present 3 7 General Data Technical Data General Dimensions 175mm x 107mm without connector and slot bracket PCIDIO32 base card connection 37 pin D SUB Socket PCIDIOEX extension card connection 40 pin IDC Header Power supply of inputs and outputs External power supply over the respective connectors Operating temperature 0 70 C Storage temperature 40 100 C Rel humidity 0 90 non condensing EBRU 4 Programming PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 14 This chapter shows how the PCIDIO cards can be programmed using the Windows dri
44. s sssesseesneseeeseentsernesnsstestnetnrtenstnetnttnnsttstnnnnnnntsttnnnnnnnnnenenn nnen 18 4 5 Digital Inputs as Interrupt SOURCE sssesssesseesessesernesnestestntntttnstntnntnnsttsttntnnsttnttnnnn tn enenenn nenna 19 4 6 Handling the Timer with Interrupt Operation ccccceeseeeeeeeeeeeeeeceeeeeeeeeeeeeseeeseaeseeeeteneesaees 20 4 7 Driver COMICS pl 625 vacates ate ei accede at Sem cca cactus Gai tas es cial ate alee ceed 22 5 API ReferenCe a ssscsiesescese esses cdvcccusictsscuasebe wedurtwendvancwedveuseusecnecvescdssessesmendensbebessenertinetneeetuanentceiens 23 51 General lp 6 3 9 ere ee ee ne eee ee 24 PCIDIOGEtCOUNTBOAIAS 0 ieee cece ee ee ee ee eee ee ee ee nate ee REENE EEA NEEE EEEE REENEN E 24 PCICIOINITCANAS e A A secede T poste aa eaduundendedeved A indie E T 24 perdio Demne ANAS uor anaa E EA ERA 25 pcidioGetSummaryOfAllBoardSs cceeeceeeeeeeeeeeneeeeeeee tees ee ae nese eeaa nese eeaaeeeeeeaeeeeeeeaeeeeeeeaeeeeeeeaes 25 peidioGetBoard Revis OM scii EEEa OAE EEEE AEAEE EEEE EEEE 27 pcidioGetBoardAddreSSJUMPeL dersiaserarsnaii ie a EEA E AESA 27 pcidioGetBoardConfigurationData saeeeeseeeeeeeenneenerrteeenntenetntteeantedtantteaatesantteennteennnneennnt 28 peidioGetDriverV CISION sisi eet sccedece irae in e EE O E EEE EA REEE NEER EE AEE 28 PcidioGetPCICOnfiguration s seiseeserscarerieeneerie nennen eanne AENEA ENEE EEE EENE NENE EE 29 peidio SEU MONK esea E 30 EBRU
45. s You can find more information on this in the corresponding Readme file and the source code comments D Item Numbers Description PCIDIO32 Base card with 32 I Os Base card with 32 I Os S S y O PCIDIOEX Extension card of the PCIDIO32 base card by a further 32 I Os as plug on module including screw set PCIDIO64 PCIDIO32 base card and PCIDIOEX extension card with 64 I Os assem bled as ready to install card set PCIDIOKA Ready to install connector cable of the PCIDIOEX extension card as tional accessory consisting of 40cm ribbon cable AWG28 1 1 crimped with A side 40 pin IDC Socket and B side D SUB 37 pin Socket mounted on PC slot bracket PCIDIOHM Optional Clamp Module with spring force connections and D SUB connec tion for the DIN standard rail for user friendly wiring in the switch cabinet for 32 I Os PCIDIOVK1M_ Optional connector cable 1m 37 pin 1 1 wired for connecting PCIDIO to DIN Clamp Module PCIDIOHM PCIDIOVK2M Optional connector cable 2m 37 pin 1 1 wired for connecting PCIDIO to DIN Clamp Module PCIDIOHM PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 48 E Support Should you have any questions on our product or need assistance get in touch with our support team giving an exact description of your problem and we will gladly help you out E mail support ebru de Tel 49 36924 30 800 Mo Fr 8 00 am 5
46. seeeeeeneeeeenaees 7 2 2 Installation under Windows 2000 icasseGescin ieee cnutecnaeseei a vuardd dia euneatuDaetice deri cacioubeslaglaani teeta 7 LA Flo A st ce acc E E E E E ES 8 3 1 Block DA ised Sa ete seed de cha E E E eae eed 8 3 2 General eee ene ee ee Cee ene er eee eee ee Cece 8 3 3 Digital OS een eee reer re een eee renee eer ener er Trees 9 3 3 1 External Power SUPplyse cecene EENE EEA NE EENEN 10 Soe OULPUTS OF THe T OS aien E E ES 10 Soa INPUTS OF THEN OS raria E E N 11 3 3 4 SHOMt CIFCUIT RECOQMILION sessie pa E E R REE RSN 11 33 5 Outputs Watchdog escossa Deni a S EEEE EEE E NSE THE E EEEN 11 3 3 6 Controlling Os with Interrupts essssersenssrrierrnenrsunninnnkenn en EE 11 Ea 0 E E EE E E E tre meee T 12 3 5 M naging Interrupts eccrine e a a wate a E ET 12 3 6 Address JUMPEL ccceccceeeceeeeeceeeeeee ee eeceeseeceeeaecenaseeeeaaeaesaaeaeseaeaesaaeeesaeeesnaesesnneeenieenenneneaas 13 CTAC aE DE ii en ee ee eee ee eee ee 13 4 Programming sisii ainena eines raian Enea ia aeaaaee aaea aaar tal ie reae denarani 14 4 1 Initialising the PCIDIO Family sessesneennesneeseenesernesnesnesrnernrsnnstnetnntnnsttstnntnnsntsttnnnnnnnnnnenn nn enn 14 4 2 Simple Operation of the Digital Outputs sseesssesnesessteetnerntenestnetnrtnnsttsttnrnnsrtnttnnnnnnnnnnenn nennen 15 4 3 Operation of the Digital Outputs with Watchdog Enabled c ccccccecsssesssreessseeessseeeesneeees 17 4 4 Operation of the Digital Input
47. sg EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 38 5 2 Digital Input Functions pcidioDIGetChannelState Ty Description Returns the input state of the assigned channel Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt Channel gt Channel number 0 63 of the desired input channel Output lt ChannelState gt The status of the channel a 1 signifies a high level and 0 a low level on the corresponding I O pin of the PCIDIO connector Return If the function was executed successfully it returns TRUE If an error has occurred while running it returns FALSE The error can be identified using the function pcidioGetErrorMsg pcidioDIGetByte ty Description This function is available starting from the driver DLL version 3 0 and returns the input state of the assigned 8 channel group Parameter gt Input lt BoardNumber gt PCIDIO addressing index detected by the function pcidioGetSummaryOfAllBoards lt bytenumber gt Number of the input group 0 3 base card and 4 7 extension card Output lt State gt The state of the 8 selected input channels of the selected card EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc
48. t Circuit Recognition The read back of an I O used as output can be exploited for short circuit recognition If after setting an I O and a delay of at least 250us in addition to any load dependent delay the corresponding I O is read back it must return a 1 If a 0 is returned instead then an exter nal short circuit exists 3 3 5 Outputs Watchdog The output transistors on the cards can be monitored by a common computer independent watchdog the timeout period can be programmed to be between 26 21ms and 6 68 sec onds After switching on the computer or restarting the software the watchdog will be dis abled When the watchdog is enabled if there is not at least one output on the PCIDIO32 base card or any present PCIDIOEX extension card accessed with a write within the programmed timeout period then all output transistors on both the PCIDIO32 base card and any present PCIDIOEX extension card will be immediately reset After programming the timeout cannot be changed and the watchdog cannot be disabled again The watchdog will only be disabled and the value made settable again after a soft ware card reset or after rebooting the PC Whether the watchdog has tripped can be checked with the driver 3 3 6 Controlling I Os with Interrupts Each input can be used as a separate interrupt source They are programmed by functions of the supplied software driver EBRU pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 11
49. tErrorMsg I_strErrorTxt EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 19 4 5 Digital Inputs as Interrupt Source This subchapter describes the use of an input channel as interrupt source A channel is con figured as interrupt source upon rising edge and a counter in the user interrupt handler is incremented upon every rising edge unsigned char g_ucIntCounter global interrupt counter unsigned char _ucActIndex unsigned char l_ucChannel configure digital input as interrupt source L bReturnValue pcidioDISetIrgChannelConfig uration l_ucActindex l_ucChannel 1 1 if l__bReturnValue TRUE enable PCI Interrupt and install interrupt handler L_bReturnValue pcidio EnableIRQ l_ucActindex amp Inthandler if __bReturnValue TRUE g_ucIntCounter 0 while g_ucIntCounter lt 100 Sleep 1 disable PCI Interrupt l_bReturnValue pcidioDisableIrq l_ucActIndex error 2 if l_bReturn Value FALSE get error message pcidioGetErrorMsg l_strErrorTxt Interrupthandler PCIDIO_INT_HANDLER Inthandler void t unsigned char l_ucActIndex PCIDIO_INT_STATE l_IntState read the interrupt state pcidioDIGetIrq l_ucActIndex amp l_IntState if l_IntState IRQIO_1_32 0 g_ucIntCounter pcidioResetIRQ l_ucActIndex EBRU PCIDIO PCI Card With 32 64 Optically Is
50. tion declaration _cdecl The function declaration _stdcall has the postfix StdCall added to its name This makes it also possible to use other programming languages with which a DLL can be integrated EBRU see A EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 24 5 1 General Functions pcidioGetCountBoards Description Returns the number of PCIDIO family plug in cards found and initialises the driver accord ingly ii d Note This function should be run at the beginning of an application so as to determine whether there are any cards present at all Parameter gt Input none Output none Return If the function was run successfully it returns the number of cards found or 0 for no cards pcidiolnitCards ut Description This function initialises all PCIDIO family cards present in the system and arranges them according to the position of the address jumper d Note This function should be run at the beginning of an application so that all cards are initialised correctly Parameter gt Input none Output Number of initialised cards Return If the function was run successfully it returns TRUE otherwise FALSE EBRU PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual EBRU pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Sid
51. ver and the API reference The programming is illustrated in the form of flow charts and C source code All examples listed here are exclusively for the purpose of demonstrating the functions 4 1 Initialising the PCIDIO Family This subchapter shows a way to specify the cards present in the system and to read their addressing data EBRU unsigned int _uiDriverVersion version of the installed driver PCIDIO_SUMMERY _SummeryBuf 4 buffer for the board information BOOL _bReturnValue return value of the functions char l_strErrorText 100 error message int LiCntCards number of present boards get driver version _bReturnValue pcidioGetDriverVe rsion amp l_uiDriverVersion Is the correct driver installed If l_bRetunValue TRUE amp amp L_uiDriverVersion ACT_DRIVER_VERSION get the number of present boards l_iCntCards pcidioGetCountBoards are boards present if __iCntCards gt 0 initialize the present boards _bReturnValue pcidiolnitCards amp l_iCntCards read the board informations from all present boards L bReturnValue pcidioGetSummeryOfAllBoards l_SummeryBuffer error if l_bReturn Value FALSE get error message pcidioGetErrorMsg l_strErrorTxt PCIDIO PCI Card With 32 64 Optically Isolated Digital I Os User Manual pcidio en um 3v5b doc 01 12 2014 Rev 3 5b Side 15 4 2 Simple Operation of th
Download Pdf Manuals
Related Search