cifX Device Driver
Contents
1. No Windows 7 or 64 bit support for INtime V3 1 Configuration firmware download via SYCON net may fail if an older version of SYCON net is used The issue is fixed by applying the patch delivered with this driver CD refer to section Patch the SYCON net installation on page 29 for further information Due to a bug in INtime V4 versions 4 20 11208 and earlier you might encounter a problem during the installation process on Windows 7 host machines Please refer to section 2 3 on page 14 for further information An application shall never use knSetKernelTime as the kernel time is used internally from the driver for timeout monitoring Setting the kernel time during runtime may result in temporary incorrect timeout handling longer shorter than expected Autostart of the cifX driver via INtime autoloader does not work for outdated INtime V3 versions V3 14 x x or higher required 1 10 CD contents Folder Content o O iros ischercincaPiheaderfies OOS tivas GIFAPibrary tles tor use in Nime Team applicators intimos Nimo Vet oraes OOO limosna CIE AP rates O mimes timo vsx oiae rates OO inimes inime Vex cixar iare SSS mmes meva mmes 7 vax SCSC SSSS mmes 7 vex SSSSCSC S S S S S mmes 7 vex SSSCSC S S S S S S lt S S nme iine vavaa arer nataon O timo frorn O MEC TN Table 4 CD contents cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 202. This manual describes the Hilscher cifX Driver for INtime The driver offers access to the Hilscher netX based hardware e g CIFX 50 with the same functional API as the cifX Device Driver for Windows It is also possible to use the cifX INtime Driver from normal Windows environment or from inside the INtime real time kernel 1 2 List of revisions Rev Date Name Chapter 2011 12 15 SS INtime V4 x support 3 2012 11 13 SS 2 3 Note about INtime bug SetupDiCallClassInstaller failed added 1 4 Information about CIFX API manual added 4 2013 08 15 MT Reference list updated SS Limitation for INtime function knSetKernelTime added Limitation for INtime autoloader added References to cifX Windows Driver Installation source fixed 2014 03 05 RM INtimeV5 xsupport 2015 06 12 LC INtime V6 x support 1 4 Reference list updated 1 9 Section Limitations reviewed Section CD contents updated 2 Note about upgrading INtime with cifX Device Driver INtime added Table 1 List of revisions cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Introduction 4 32 1 3 Terms abbreviations and definitions Communication Interface based on netX Pl DPM Dual Port Memory Physical interface to all communication board DPM is also used for PROFIBUS DP Master Table 2 Terms abbreviations and definitions 1 4 References to documents This manual r
3. oe hilscher COMPETENCE IN COMMUNICATION Driver Manual cifX Device Driver INtime V3 1 V4 x V5 x V6 x Hilscher Gesellschaft f r Systemautomation mbH www hilscher com DOCO80605DRVOGEN Revision 6 English 2015 06 Released Public Introduction 2 32 Table of Contents 1 o A AEEE REINER EIERN ERDEH EHER E AUS RARENE RS HER SLR EINER EER TUR DEERFERCREERELC ARENA SE EUHEHESERRNG 3 1 Ab urihisdocumentse een 3 1 2 ISO te vISION Sonar A legutocas 3 1 3 Terms abbreviations and CETINITION Sesma 4 1 4 Relrsrencesio documen tract 4 o ONE to acceda 5 1 5 1 Accessing the cifX INtime Driver from Windows non real time oocccccocccncconnncoconnnccnnnononnnnnnnnos 5 1 5 2 Accessing the cifX INtime Driver from INtime real tiMe ocoooncccoconcncccnnnnononnncnnanonconaronnonanononos 6 16 Requena rad 6 If Supported Aa W are a es 6 1 8 Fetes nanana A a A 6 9 ETAL ana ba 7 1 10 60 contenida dada iio 7 EFF ESTA NES air AA AAA A A o 8 MAA SOYA Misato tds 8 1 1 1 2 IMPOR AN NES ici A 8 ES EXCUSIOn O abla einen 9 A O A esau 9 1118 Registereditrademarks iodo 9 2 Installation a ke eine 10 2 1 Installation of the cifX Windows Driver recommended 2 002220022000000n00 nenne nnnnn nennen 10 2 2 Installation of the cifX INtime Driver Mandatory uu0222000222000n0nne nenne nennen nenne nnennn nenne nnnnnenn 11 23271 Alllomalie SOUND a el un een eat ae 1
4. 2015 Installation 14 32 2 3 Pass a PC card cifX to INtime To be able to use the card under INtime you need to move the card from the non real time to the real time management This is done via the Ntime Device Manager After this step has been executed the card will not be longer accessible from the Windows Device Manager or the cifX driver for Windows Note Make sure that no Windows application is accessing the cifX hardware when passing it to INtime Note Passing a PC card cifX to INtime may fail on Windows 7 systems INtime V4 versions 4 20 11208 and earlier Please see the information given below and contact the INtime support for help Open the INtime Device Manager Me INtime Configuration Panel Development Tools Local Kernel Es Real time Network P Remote NTH Connections J Miscellaneous u License Manager EF Thine Device Manager IMNtime Kernel IMtime Explorer AAA Roo Export Settings Import Settings wf Autostart this icon About Intime Exit Help Exit Figure 7 Open INtime Device Manager cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 15 32 Right click the PC card cifX and select Pass to INtime non interrupt or MSI or Pass to INtime with legacy IRQ and save the configuration If interrupt support is required select the latter Please make sure that the interrupt channel of your c
5. OA Ozzie ar ChannelO er een Ral a Channell e Channel2 a Channel3 tae Channel4 ta Channels Sample file structure for a cifX device identified by Slot number 2 and loadable module support it ID ETXI QO0 BSL BIN second stage PCL bootloader Slot 2 SS Channel nx100dpm nxo loadable module ISE Re ae E Er S e database ler Channeli Channel2 Channels SE aa esa Channels SCA nk rom Dase Firmware cifX Device Driver INtime DOC080605DRVO6EN Revision 6 English 2015 06 Released Public O Hilscher 2008 2015 Installation 21 32 2 6 Driver startup The driver behaves like any other real time INtime application and can be started via the INtime Explorer or placed in the autostart of the kernel There are different command line parameters available described in the following table option Type Despi Conf String Name of the registry file to load The referenced file is an export of the cifX Windows driver s registry key Filename of the log file to write debug information File containing the cifX Second stage loader Normally defined in registry Pol DWORD Time in milliseconds ms to poll the card for change of state information Table 9 INtime Driver Command line options Example startup ca rede log Cy ouixdry log poll 500 trace 255 cifX Device Driver INtime DOCO80605DRVOGEN Revision 6 English 2015 06 Released Public
6. Hilscher 2008 2015 Installation 2 6 1 Configure the driver for automatic startup 22 32 Usually the driver should start together with the INtime kernel This chapter describes how to add the driver to the kernel start up procedure Open INtime Autoload application INtime Kernel IMNtime Explorer INtime Configuration Autostart this icon About Ihtime Exit o ee ae S INtime Configuration Panel P Development Tools Es Local Kernel ES Real time Network Remote NT Connections G Miscellaneous of License Manager s INtime Device Manager Export Settings Import Settings Exit Help Figure 10 INtime Autoload Configuration start Click Add to define a start up entry for the cifX Driver INtime Auto Load Configuration Enabled Disabled Enabled Enabled Ntme Network Disabled Filename System System System System e Disable Auto Load OF Cancel Help Figure 11 INtime Autoload Configuration list cifX Device Driver INtime DOC080605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 23 32 Fill in all needed information and your start up parameters see section Driver startup on page 21 for a description of the start up options Auto Load Application Application Title cif Device Driver Full Path C AProgramme lN time bin CIF Drv tta Browse Parameters Ipoll 500 trace 455 Dependen
7. MOE copias o one O00000 MESETAS CTA a OY OTTEMO re alone zeige Go cias Ss O a a e as o ion 1230100 A Channel2 Module Couner Aword 00000000 Onr TIC COUN Nord NENNT EPA CAMAS ENE YO TRM C Urr NEC oo I ee e alo So Cie Dev CCC OnE 125 O 202 Channel3 ModuleCount dword 00000000 NG Orr TOCOU Y O Gee OOOO G00 HKEY O CF me MACH NES TEMNO UTT ene CONECT TOISEN OCT V C OSA T EDEA Dezte Sonia li OA AN Channel4 ModuleCount dword 00000000 AE o ie oE ont E e OOOO G00 CAPARO CAMA NE O Yo TEM One ado mano ls col ces C EDTA DO Ae ono 15000 2 Channels ModuleCount dword 00000000 ConfigCount dword 00000000 HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services CIFxDrv Parameters TraceLevel dword 0000000 HKEY _LOCAL_MACHINE SYSTEM CurrentControlSet Services CIFxDrv Parameters NX PCA PCI DPM 8_Bit dword 5431f962 DPM 16_Bit dword 4073f8e2 DEME 2 BIE Or 210824102 cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 26 32 2 7 Assign a firmware configuration file Firmware and configuration files must be downloaded on every start up power up of a PC because PC cards cifX do not have Flash memory on board to store files The driver loads these files during the start up phase but requires these files to load them into the PC card cifX The settings are stored per device as described in section Driver registry settings on p
8. refer to the SYCON net manual on how to create a fieldbus configuration for a cifX hardware Because of the separation between the Windows and INtime environment SYCON net is not able to directly download and store a firmware configuration by default Therefore the cifX32DLL dll from the Windows cifX driver located in the Windows System32 directory must be replaced with the INtime version of this DLL Please use the following steps to create a configuration OR Install SYCON net Start SYCON net and create a configuration Store the SYCON net configuration project and export the configuration from SYCON net into a database file Use either the cifX Setup Utility to place the firmware and configuration files into the cards file storage or copy the files manually into the cards file storage Now start restart the cifXINtime driver This will load the firmware and configuration into the PC card cifX Open SYCON net and open the configuration project Now you should be able to connect to the hardware and run the SYCON net diagnostics If available connect SYCON net to a PC card cifX and download the configuration This will automatically store the files in the cards file storage and restarts the device cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Using SYCON net to configure the fieldbus system 29 32 3 1 Patch the SYCON net installation Due to compa
9. 1 2 2 2 MINAS cia 13 2 3 Pass aPC Card CHO INM ae en een 14 2 4 Driver registry settings See ici 16 2 5 Firmware and configuration file Storage cccccooonnconcccconnconononnnonnnonnancnnonononnnnnnnonannnnnnnonnnnnnnss 19 2 6 DEVER STAMP Sans a a a a 21 2 6 1 Configure the driver for automatic startup cccccccccoconncccnnccconoonnonnnnnonononnncnnnnnonnnnnnnnnnnnonnnnnanennnnnonos 22 2 6 2 Configuration with a local registry file o ooooonnnccnnnccconoonnccnnnnonononononnnonononnnnnnnnonononanennnnennnnos 24 2 7 Assigna firmware configuration Tleu u2 2 Aine OO Ree E 26 221 USINO THEeX SOU NY area 26 Zale Manually Via Tedis Uyo iaa 27 3 Using SYCON net to configure the fieldbus systenm ua22000022aan0000nnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnn 28 3 Patehithe SY CON Met sta ado 29 Programming with the cifX INtime Driver ccccssseesssseseneeeenseesenseesenssoesseeeeasesoesseseensesenseesonees 30 APPEAR cia 31 9 ENS O is Lo POR POP o re 31 dues EISLOLNQULES dildo das de 31 5 3 CONC Star condado aia 32 cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Introduction 3 32 1 Introduction 1 1 About this document TenAsys INtime is a real time kernel which extends any standard Windows environment on a PC architecture with industrial grade full deterministic hard real time capabilities
10. 15 06 Released Public Hilscher 2008 2015 Introduction 8 32 1 11 Legal notes 1 11 1 Copyright Hilscher 2008 2015 Hilscher Gesellschaft f r Systemautomation mbH All rights reserved The images photographs and texts in the accompanying material user manual accompanying texts documentation etc are protected by German and international copyright law as well as international trade and protection provisions You are not authorized to duplicate these in whole or in part using technical or mechanical methods printing photocopying or other methods to manipulate or transfer using electronic systems without prior written consent You are not permitted to make changes to copyright notices markings trademarks or ownership declarations The included diagrams do not take the patent situation into account The company names and product descriptions included in this document may be trademarks or brands of the respective owners and may be trademarked or patented Any form of further use requires the explicit consent of the respective rights owner 1 11 2 Important notes The user manual accompanying texts and the documentation were created for the use of the products by qualified experts however errors cannot be ruled out For this reason no guarantee can be made and neither juristic responsibility for erroneous information nor any liability can be assumed Descriptions accompanying texts and documentation included in the us
11. CurrentControlSet Services CIFxDrv DeviceConfig lt DevNr gt lt SN gt Channel lt 0 6 gt or HKLM System CurrentControlSet Services CIFxDrv DeviceConfig Slot lt SlotNr gt Channel lt 0 6 gt ModuleCount REG _DWORD Number of configured modules Module0 E Each module gets an own entry with an index as suffix This specifies the complete path to the file ConfigCount REG_DWORD Number of configured fieldbus databases ConfigO REG_SZ Each database gets an own entry with an index as suffix This specifies the complete path to the file Warmstartfile REG_SZ File name to warmstart parameter file Table 7 INtime Driver Device Specific Settings Note All filenames are used as short file names no path information The file storage is explained in section Firmware and configuration file storage on page 19 Note An example registry file cifX reg can be found in the Driver INtime CD directory cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 18 32 Sample driver configuration HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services CIFxDrv m a EA SA BO Que ammen CACA DE vato eE Ed LOCAL MANGIERUNIE USGS INI Oisncte Sianc Celine sel ve sica ca ODA Parameters TracelLevel dword 000000ff Pollinglnterval dword 000001f4 Sample device configuration HKEY ELOCATEMAC NES EMO nO Oia cis cies O Ma eee On LAKEN EOCAT MACHTNEA S Yo
12. Driver INtime4 cifx32rsl rsl Driver INtimed cifx32rsl rsl Driver INtime6 cifx32rsl rsl Driver INtime3 cifx32dll dll On 32 bit operating system ATTENTION Driver INtime4 cifx32dll dil lt WINDOWS gt System32 This will replace the normal Windows Driver INtime5 cifx32dll dil cifX Device Driver DLL icati ill onl Driver INtime6 cifx32dll dll On 64 bit operating system ANIONS application a l ONY DEAD to access the Real Time driver lt WINDOWS gt SysWOW64 If you only want a single application to use the Real Time driver copy the INtime cifX32DLL dll into the applications directory Driver INtime4 x64 cifx32dll dll On 64 bit operating system ATTENTION Driver INtime5 x64 cifx32dll dil lt WINDOWS gt System32 INtime V3 1 does not support 64 bit Driver INtime6 x64 cifx32dll dll operating systems API Programming installation APlI includes h lt INTIME gt rt include cifX These are the header files for interfacing with the cifx32rsl cifX32dll Make sure to let your project point to this include folder APINibs INtime3 lib lt INTIME gt rt lib cifX These are the libraries for interfacing with APINibs INtime4 lib cifx32rsl cifX32dll Make sure to let your API ibs INtime5 lib project point to this additional library AP libs INtime6 lib sen Table 5 INtime Driver installation Copying files cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008
13. Ntime real time Application cifX32rsl rsl Real Time cifX API cifXDriver rta INtime low level driver Board0 n External CHO CH1 hardware Figure 2 INtime cifX driver architecture real time 1 6 Requirement Operating system Windows 2000 Windows XP Windows Vista or Windows 7 82 or 64 bit INtime Version 3 1 4 x 5 x 6 x SYCON net for netX installation from DVD CIFX version 06 2011 or higher SYCON net installation comes on DVD with the PC card cifX 1 7 Supported hardware PC card cifX PCI PCle netPLC NXSB PCA NXSB100 NXHX board NX PCA PCI NXHX netJACK 100 18 Features Based on the cifX Toolkit source V1 2 0 1 Interrupt support for PC cards cifX DMA data transfer for I O data PC card cifX Support for loadable modules Interrupt notification for applications Unlimited number of PC cards cifX supported cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Introduction 7 32 1 9 Limitations Simultaneous access from real time AND non real time mode is not possible Downloaded SYCON net configuration files are only saved for local INtime systems For remote access to INtime the firmware and configuration must be copied manually to the target system CD for INtime Driver does not contain a SYCON net for netX installation SYCON net installation comes on DVD with the PC card cifX
14. TEM Guise mine omo ls co ocean eat ono 1025008001 PAREY OCA MO NE ses O elo OO iS voy Les O E DY Dee SO es LON 0 17 InterruptEnable dword 00000001 DMAEnable dword 00000001 MAA W VOSA E wine wah ok Hada OIC Ad MACrMINn Vows Curre neo ea CEVI ces einen DES Commonly san 20 2 A Channel0 ModuleCount dword 00000001 Modu tretti IPS od Conr E Ot oo IO ne OTE La Veonkior nxdn KE Cah O CAMAS MINEN Y SEM CUr rent o nio ds Sido clics e TED Deyie long In Channell ModuleCount dword 00000000 COn Oti Mo OI LARES TEOGA LMA MINEA O Yo nea domi ollo iS e ao es CD estee Bong eN oa EA Channel2 ModuleCount dword 00000000 UCOniergCOunme Cwo re OOOO OO U0 kh LOCA Ca a or CSU MMV G luisme Comic ee ea des Cl DD VOS mee 1250 OZ skye Channels ModuleCount dword 00000000 Conti gecouae N word ODO PAKETA TOCACAMACHINEA So TEM O eee o peo dci do cias iS O Mae a ess e Co mon 1230100 AN Channel 4 ModuleCount dword 00000000 onto Coti AS DO E OOOO OG AFE C EOCATAMAC MINEN TOTEMIC UT r ONEC ONTTO er e tale So O TE DTA DOVII CoC OnE A 125 AO 20 N Channels ModuleCount dword 00000000 NG Or TICON CAE IWO or TOTOO cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 19 32 2 5 Firmware and configuration file storage PC cards cifX are not using any flash memory to store a firmware or configuration on the card Each time
15. age 16 These settings can be created and changed with the cifX Setup utility coming with the Windows cifX device driver or manually by editing the registry 2 7 1 Using the cifX Setup Utility The application is installed into the cifX driver installation directory usually Program files cifX Device Driver and will also be inserted into the Windows control panel Start the cifX Setup utility cifX Driver Setup Utility File Device Driver cix Driver Setup Utility About J Inactive Devices y Unknown ECS Serial Number 20217 Interrupt Number 9 CH 0 CH 1 CHX2 CH 3 CHX4 CH 5 Device Number 1250100 Base Address 0x00000000 Alias ECS Use Interrupt Figure 15 cifX Setup Utility cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 27 32 Configure the device by setting all needed parameters in the device tree and define the files which should be loaded to the PC card 1 cifX Driver Setup Utility File Device Driver cifX Driver Setup Utility mua About J Inactive Devices 3 Unknown ECS A wp an un Firmware not available Y Set Warm Start Parameters slave only CH 1 Version not available Change Parameters CH 2 CH 3 Assigned Module Firmware Files CH 4 CH 5 Hardware Option Undefined Add Cu Prograrmmeicifx Device Driver 1250100_20217 ChannelO nx_eis mod Remove Clear Assig
16. c Hilscher GmbH All nights reserved 3 Make sure that the ODMV3 service is not running Right click the ODMV3 tray icon found in the tray bar of your windows machine and select Service gt Stop Start ODM Diagnostic Restart oljk 0 By 13 15 4 Navigate to the folder Hot fix SYCON net on the cifX INtime driver CD 5 Replace your local version of ODMCifXDriver dil with the one delivered on CD 6 The ODMV3 service will be restarted with the next access via SYCON net Firmware and configuration files download will now work properly cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Programming with the cifX INtime Driver 30 32 4 Programming with the cifX INtime Driver The cifX INtime driver offers the same CIFX API interface like the cifX Windows driver Therefore use the CIFX API Application Programming Interface manual This manual describes the driver functions CIFX API error codes and shows some program examples The installation CD also includes an Example directory with INtime specific examples cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Appendix 31 32 5 Appendix 5 1 List of tables tabe TE EISE Ol FOV IS INS a e oia 3 Table 2 Terms abbreviations and definitiONS oooccococcncnoconcnncnonnncnonnnnonononnnnnnnnononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn
17. cies Add Delete OF Cancel Help Figure 12 INtime Autoload Configuration add cifX entry Make sure your entry is enabled INtime Auto Load Configuration Enabled Filename USB Disabled System SpinDoctor Enabled System Edit Maria Enabled System IHt me Network Disabled System Disable ciks Device Driver Enabled L Programme lHt m Delete Es Disable Auto Load ok cms som Figure 13 INtime Auto Load Configuration list with cifX entry cifX Device Driver INtime DOC080605DRVO6EN Revision 6 English 2015 06 Released Public O Hilscher 2008 2015 Installation 24 32 2 6 2 Configuration with a local registry file To allow a configuration without accessing the registry it is possible to pass a file that contains the registry contents for the driver and let the driver read the configuration from this file See conf start up parameter You can either write an own registry file or export the settings from an existing cifX Windows driver installation To export the registry process the following steps Start registry editor regedit exe Select the key HKLM SYSTEM CurrentControlSet Services CIFxDrv Export the registry by selecting Export from the file menu 2 Registrierungs Editor EA Bearbeiten Ansicht Favoriten Importieren Mit Netzwerkregistrierung verbinden Drucken Beenden I Cdfs J Cdrom Strg P Name ab Standard ab DisplayNam
18. e ab Driverversion ing ErrorControl ab Group ab ImagePath ab InstallDir ita PCIIntEnable no Start Ra Tag 82 Type Typ REG_5Z REG SZ REG Sz REG _DWORD REG 5zZ REG_EXPAND_SZ REG 5zZ REG _DWORD REG _DWORD REG_DWORD REG_DWORD 3 Changer 1 CIFDEV 13 DeviceConfig J Devices J Parameters 3 Security cisvc 3 ClipSrw 3 clr_optimization_v2 0 50727_32 3 Cmdide aa CAMSwednn Exportiert Registrierungsdaten in eine Datei Figure 14 Export cifX Windows registry entries cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 25 32 Sample export file Windows Registry Editor Version 5 00 TEEN CAVA EE CSS EMS iS oro iS cis eto SS So A SOS anne Do ied ei PESETAS CTA MACHINES YO TEM Ur rene CONE roS CEA o PVA ECSAC TEDE Dera CoC ONT ig HKEY ETO STA NE S CO TEMNO Urre nE COn zo er erste O nes e One AO PRAEENT TOCAR MACHINEN OYO EM CUr rent Controls cian do caia es Cia E ao eC On a 1230100 20277 Wa EOS InterruptEnable dword 00000000 DMAEnable dword 00000000 RENATO CAMAS NES Yo MO ao mois cio Tao C TEDT DOVII Ce Comme hz sah AA Channel0 ModuleCount dword 00000001 MMO eM eee eth x nxit Givin del GS liver nord NND Contr gor AGON Er nA LAE ETO COCA MACHINEN O S TEM O Ur ro ae Come rO O EN cie ss Oi esas Con ker ula OO Channell1 ModuleCount dword 00000000
19. e INtime driver The cifX32DLL dll version can be verified using the file property dialog from Windows Allgemein Yersion Digitale Signaturen Sicherheit Dateiinto Allgemein Yersion Sicherheit Dateiinto Dateiversom 1 1 0 0 Dateiwersion 1 1 0 0 Beschreibung ciks API DLL 86 Beschreibung ci AP DLL for IMtime 4 86 Copyright Copyright c Hilscher GmbH All rights reserved Copyright c Tendsys Corporation All rights reserved Versionsinformationen Elementname Beschreibung Besondere Beschreib Datenersion Firma Interner Name Kommentare Marken Oniginaldateiname Figure 6 Verifying the cifX32DLL version cifX Device Driver INtime DOC080605DRVO6EN Revision 6 English 2015 06 Released Public Versionsinformationen Elementname Beschreibung Besondere Beschreibi Dateiversion Firma Interner Name Kommentare Marken Unginaldateiname Hilscher 2008 2015 Installation 13 32 2 2 2 Manual installation To install the driver manually copy the files from the CD to your INtime installation The following table shows a recommendation where the files should be placed File from CD Source Local folder Destination Description Driver installation Driver INtimes cifxdrv rta lt INTIME gt bin Low Level Driver Driver INtime4 cifxdrv rta Driven INtimeBcifxdrv rta Driver INtime6 cifxdrv rta Driver INtimes cifx32rsl rsl lt INTIME gt bin API for real time projects
20. efers to the following documents 1 Hilscher Gesellschaft fur Systemautomation mbH CIFX API Application Programming Interface Revision 3 english 2014 2 Hilscher Gesellschaft f r Systemautomation mbH cifX Device Driver Installation and Operation for Windows XP Vista 7 8 V1 2 x x Revision 8 english 2013 3 Hilscher Gesellschaft f r Systemautomation mbH Dual Port Memory Interface Manual netX based products Revision 12 english 2012 Table 3 References to documents cifX Device Driver INtime DOCO80605DRVOGEN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Introduction 5 32 15 Overview The cifX INtime driver runs inside the real time extension in a separate address space A special version of the cifX Application Interface DLL cifX32DLL dll is provided with the INtime driver to allow Windows applications like SYCON net the access to the INtime driver from the Windows user space 1 5 1 Accessing the cifX INtime Driver from Windows non real time Application cifX32dl dll Special INtime Wrapper Shared memory with INtime cifXDriver rta INtime low level driver Board0 n External CHO CHIT hardware Figure 1 INtime cifX driver architecture non real time cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Introduction 6 32 1 5 2 Accessing the cifX INtime Driver from I
21. en using cifX Setup Utility to configure the card the file storage will automatically be handled by the application The cifX Setup Utility is delivered with the cifX Windows driver installation and can be found in the driver installation directory or in the system control panel The following table describes the different subdirectory levels Subdirectory lt INSTALLDIR gt Installation directory of the cifX device driver for Windows containing the second stage PCI boot loader and the cifX driver tools Note This directory must contain the second stage PCI bootloader e g NETX100 BSL bin lt Device Nr gt _ lt Serial Nr gt Device and serial number of the device or slot number if the device Slot lt 1 9 gt provides a rotary switch If the slot number is O the device and serial 7 number is always used to identify the device Note This directory must contain the rcX base firmware if loadable modules are used Channel lt gt Channel specific files loadable modules monolithic firmware files fieldbus database files Note Currently only channel 0 is supported Table 8 Firmware and configuration file storage cifX Device Driver INtime DOCO80605DRVOGEN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 20 32 Sample file structure for a cifX device with device number 1250100 and serial number 20217 lt INSTALLDIR gt Nit COU SiN second stage PCL bootloader
22. er manual do not present a guarantee nor any information about proper use as stipulated in the contract or a warranted feature It cannot be ruled out that the user manual the accompanying texts and the documentation do not correspond exactly to the described features standards or other data of the delivered product No warranty or guarantee regarding the correctness or accuracy of the information is assumed We reserve the right to change our products and their specification as well as related user manuals accompanying texts and documentation at all times and without advance notice without obligation to report the change Changes will be included in future manuals and do not constitute any obligations There is no entitlement to revisions of delivered documents The manual delivered with the product applies Hilscher Gesellschaft f r Systemautomation mbH is not liable under any circumstances for direct indirect incidental or follow on damage or loss of earnings resulting from the use of the information contained in this publication cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Introduction 9 32 1 11 3 Exclusion of liability The software was produced and tested with utmost care by Hilscher Gesellschaft fur Systemautomation mbH and is made available as is No warranty can be assumed for the performance and flawlessness of the software for all usage conditions a
23. ifX device is not shared with another windows devices otherwise system stability is compromised S INtime Device Manager gt INtime Device Manager AE Action view Help File Action View Help m I Save the configuration YE 438 windows devices a Anschl sse COM und LPT 8 CIF Communication Interface ps CIF Communication Interface Pe g cia PCUPClIe Devic 3 E ON AA Grafikkarte f Grafikkarte 2 IDE ATAJATAPI Contro O 2 IDE ATAJATAPI Controller H E Netzwerkadapter Pass to INtime non interrupt or MSI SP Netzwerkadapter Le Systemger te Systemgerate e INtime devices 40 INtime devices 1 F Anschl sse COM und L gf Anschl sse COM und LPT _ Rename Properties 4 Figure 8 Pass PC card cifX to INtime Attention You might encounter a problem with the INtime Device Manager when passing the PC card cifX on Windows 7 host machines The following issue occurs in some of the INtime V4 software release and is a problem in the INtime V4 Device Manger in combination with Windows 7 host machines INtime versions 4 20 11208 and earlier are affected and need to be patched Please contact the INtime support team and ask for an appropriate patch to solve this problem a INtime Device Manager File Action View Help ly AA Y il You have requested the following changes A Windows devices els a cea Communication Interface cee nr cifX POVPCIe Device T D
24. ilscher com France Hilscher France S a r l 69500 Bron Phone 33 0 4 72 37 98 40 E Mail info hilscher fr Support Phone 33 0 4 72 37 98 40 E Mail fr support hilscher com India Hilscher India Pvt Ltd Pune Delhi Mumbai Phone 91 8888 750 777 E Mail info hilscher in Italy Hilscher Italia S r l 20090 Vimodrone MI Phone 39 02 25007068 E Mail info hilscher it Support Phone 39 02 25007068 E Mail it support hilscher com cifX Device Driver INtime DOC080605DRVO6EN Revision 6 English 2015 06 Released Public 32 32 Japan Hilscher Japan KK Tokyo 160 0022 Phone 81 0 3 5362 0521 E Mail info hilscher jp Support Phone 81 0 3 5362 0521 E Mail jp support hilscher com Korea Hilscher Korea Inc Seongnam Gyeonggi 463 400 Phone 82 0 31 789 3715 E Mail info hilscher kr Switzerland Hilscher Swiss GmbH 4500 Solothurn Phone 41 0 32 623 6633 E Mail info hilscher ch Support Phone 49 0 6190 9907 99 E Mail ch support hilscher com USA Hilscher North America Inc Lisle IL 60532 Phone 1 630 505 5301 E Mail info hilscher us Support Phone 1 630 505 5301 E Mail us support hilscher com Hilscher 2008 2015
25. ination directory and choose which of the following features shall be installed cifX SDK Installs libraries and headers files required to develop applications for PC cards cifX Windows Application Access In order to enable the usage of Hilscher standard applications like Sycon NET cifX Test or cifX Setup within the INtime environment the cifX API library will be replaced by a special INtime wrapper library cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 12 32 Obligatory cifs INtime driver components This Feature requires 292KB on your hard drive It has 2 of 2 subfeatures selected The subfeatures require 60KB on your hard drive Location CuProgrammelcifx INtime Driwerl Figure 5 Custom setup Note Make sure that no Windows application is accessing the hardware because the setup tries to rename the original cifX32DLL dll from the cifX Windows driver located in the Windows system32 directory and copies the INtime version of the cifX32DLL dll into the directory Verifying the cifX32 DLL Version During the installation of the cifX INtime driver the cifX32DLL from the original cifX Windows driver installation located under windows System32 respectively Windows SysWow64 on 64 bit OS will be replaced by an INtime wrapper version The INtime version of the DLL allows Windows application to access the cifX hardware via th
26. isplay adapters Pass control to INtime cits POL PCle Device ai IDE ATA ATAPI controllers ch Network adapters r i Other devices INtime Device Manager A Ports COM amp LPT Mi System devices Unversal Serial Bus com 8 INtime devices a a fa NodeA Intel Mah Exsnrece T himcet Fami hr cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 16 32 Your final configuration should look like this INtime Device Manager File Action View Help Y O devices He Anschl sse COM und LPT E GraFikkarte IDE ATAJATAPI Controller E Netzwerkadapter Systemger te a IMtime devices F Anschl sse COM und LPT EL Other devices Eb IMtime cifx PCI PCIe Device Figure 9 Final cifX INtime configuration 2 4 Driver registry settings The basic driver registry settings are done by the cifX Device Driver for Windows installation If you skip the driver installation this chapter describes the necessary registry settings and the keys needed to download a firmware configuration file to a specific PC card cifX Global driver settings HKLM System CurrentControlSet Services CIFxDrv InstallDir Driver base directory This is the path the second stage loader NXCIF50 RTE bin and firmware configuration files in separate subfolders are expected HKLM System CurrentControlSet Services CIFxDrv Para
27. load Configuration start cccccooccnncccnnccccononnncnnnnconononnonnnnnononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnrnnnnnnnnnaneninns 22 Figure 11 INtime Autoload Configuration liSt coooccnnnccnnccocononnnnnnnnconnnonnccnnnnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnononnannnnnns 22 Figure 12 INtime Autoload Configuration add cifX entry cccccccooccnnnonccccononnccnnnnonononononnnnnnnnnnannnonnnnononnnnnnnnnnnnnnnnnnanenons 23 Figure 13 INtime Auto Load Configuration list with cifX entry oooocccncccconcconccnoncnnnoononcnnnnononnnnnnononnnnnnnnnnnnnnnonanrnnnonnnnnoss 23 Figure 14 Export cifX Windows registry entries ee iaa Lie 24 A NA a e a E 26 Figure 16 cifX Setup Utility Firmware configuration dialOQ ooocccnccoconncnncononnnnncononnnnnnononnnnnnonnnrnnnnonnnnnnnnononnnnnnnnnnnons 27 cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Appendix 5 3 Contacts Headquarters Germany Hilscher Gesellschaft f r Systemautomation mbH Rheinstrasse 15 65795 Hattersheim Phone 49 0 6190 9907 0 Fax 49 0 6190 9907 50 E Mail info hilscher com Support Phone 49 0 6190 9907 99 E Mail de support hilscher com Subsidiaries China Hilscher Systemautomation Shanghai Co Ltd 200010 Shanghai Phone 86 0 21 6355 5161 E Mail info hilscher cn Support Phone 86 0 21 6355 5161 E Mail cn support h
28. meters TraceLevel REG_DWORD Adjust the amount of debut outputs of the driver Each bit represents a level Bit 0 Enable debug Bit 1 Enable informational data Bit 2 Enable warnings Bit 3 Enable errors PollingInterval REG_DWORD Time in ms to check card for COS bit change HKLM SYSTEM CurrentControlSet Services CIFxDrv Parameters NX PCA PCl DPM 8 Bit REG_DWORD NXPCA PCI Timings parameter for 8 bit mode DPM 16 Bit REG_DWORD NXPCA PCI Timings parameter for 16 bit mode DPM_32 Bit REG_DWORD NXPCA PCI Timings parameter for 32 bit mode Table 6 INtime Driver Global driver settings cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 17 32 Device specific settings Valve Type Description HKLM System CurrentControlSet Services CIFxDrv DeviceConfig lt DevNr gt lt SerialNr gt or HKLM System CurrentControlSet Services CIFxDrv DeviceConfig Slot lt SlotNr gt REG_SZ Alias name of device InterruptEnable REG_DWORD Device interrupt handling enable disable 0 disable default 1 enabled Direct memory access enable disable 0 disable default 1 enable OSFile REG_SZ To use loadable modules a rcX base firmware is required This entry specifies the path to the rcX base firmware file relative to lt InstallationDir gt lt Device Number gt lt Serial Number gt lt InstallationDir gt Slot_ lt Slot Nr gt HKLM System
29. nd cases and for the results produced when utilized by the user Liability for any damages that may result from the use of the hardware or software or related documents is limited to cases of intent or grossly negligent violation of significant contractual obligations Indemnity claims for the violation of significant contractual obligations are limited to damages that are foreseeable and typical for this type of contract It is strictly prohibited to use the software in the following areas for military purposes or in weapon systems for the design construction maintenance or operation of nuclear facilities in air traffic control systems air traffic or air traffic communication systems in life support systems in systems in which failures in the software could lead to personal injury or injuries leading to death We inform you that the software was not developed for use in dangerous environments requiring fail proof control mechanisms Use of the software in such an environment occurs at your own risk No liability is assumed for damages or losses due to unauthorized use 1 11 4 Export The delivered product including the technical data is subject to export or import laws as well as the associated regulations of different counters in particular those of Germany and the USA The software may not be exported to countries where this is prohibited by the United States Export Administration Act and its additional provisions You are obligated t
30. ned Configuration Files File Add Remove Clear cancel Figure 16 cifX Setup Utility Firmware configuration dialog Note To configure devices with the cifX Setup Utility they must have been once under the control of the Windows Device Driver If a new PC card is inserted and directly passed to INtime without installing the Windows cifX Device Driver for first this card will not appear in the device list NOTE lf there is no driver running cifX Windows cifX INtime the tool will only show Inactive Devices 2 7 2 Manually via registry The cifX Setup Utility is a front end for the registry changes All devices can also be set up by changing the registry manually and copying the files into to device storage Note Refer If the configuration is changed manually the driver must be reloaded before the changes become active to section Driver registry settings on page 16 for setting up the registry manually cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 SYCON net to configure the fieldbus system 28 32 Using 3 Using SYCON net to configure the fieldbus system The Hilscher fieldbus hardware will be configured by a Windows application called SYCON net SYCON net is based on the FDT DTM concept and generates the configuration files for the hardware It is also able to update the firmware for a specific card Note Note Please
31. nnnnnnnnnnnononeness 4 Table s Refereneestod elments a e ere gies 4 TablE4 amp Dic nlenis ci dicta 7 Table 5 INtime Driver installation COPAN iaa 13 Table 6 INtime Driver Global driver settings rosae a a a ee A E E EE 16 Table 7 INtime Driver Device Specific Settings nn cda 17 Table 8 Firmware and configuration file storage cococcccccccnnnnoconcnccennnnnnnnnnnononcnnononnnononnnnononnnnnnnnnnnnnnnnnnnnnnnnnnanonononess 19 Table 9 INtime Driver Command line OPtiONS cccccoocccnnccconncnnncconnnnnnnononnnnnnonnnnnnononnnnnnnnonnnnnnnnnnnnnnnnnononnnnnnnnannnnnnnnnns 21 5 2 List of figures Figure 1 INtime cifX driver architecture non real tiM8 ooooooncccconncncoconcnononnnnonononnnnnnnnnnnncnnonnnnnnnnnrnnnnonnnrnnnnnnrnnnnnnnnnnnnnnnos 5 Figure 2 INtime cifX driver architecture real time cccccseeccceeeeecceeseeceeeeeeceaucecceuseeeseaeeecsaueeeseueeessegeeessgeeessuseessageeessags 6 Fig r SS CINES eu Wizard Tor WINGOWS 2 ee elle een 10 Figure 4 cifX INtime Driver Setup Wizard iisen iea a e a E a E EEEE 11 FlOUre o GUS OM SO UND eena e e E releases 12 Figure 6 Verifying the cifX32DLL version ccccccsecccceeeeecceeeeeceueeecceuscecseuseecsaueeecsseeesseeessageeeseaseeesegeeessgeeesseeeeesneeesss 12 Figure 7 Open INUme Devics Manager nee ee ee ee 14 Figures P ss PG card CXIO NMG ci a ai 15 Figure 9 Finalcix INTIME Configuration ans sun 16 Figure 10 INtime Auto
32. o comply with the regulations at your personal responsibility We wish to inform you that you may require permission from state authorities to export re export or import the product 1 11 5 Registered trademarks Please notice INtime is a registered trademark of TenAsys Corporation Windows and Windows XP are registered trademarks of Microsoft Corporation cifX Device Driver INtime DOCO80605DRVOGEN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installation 10 32 2 Installation The INtime driver comes with an installer program It is also possible to installation the driver manually by copying the driver software to the host system This chapter describes both the installer program and the manual installation procedure Attention Uninstall any existing cifX INtime Driver before upgrading to a newer release of TenAsys INtime software Note Depending on the INtime installation the installation directories may change Recommended installation order 1 Install cifX Device Driver for Windows 2 Configure the device firmware configuration 3 Install the INtime driver Note Recommendation First install the cifX Driver to have the default registry settings available If you install the driver later refer to section Driver registry settings on page 16 on how to create all necessary driver registry keys manually 2 1 Installation of the cifX Windows Driver recommended The cifX Device Drive
33. on 11 32 2 2 Installation of the cifX INtime Driver mandatory The INtime cifX driver comes with an automatic setup application and is available on the INtime CD in the folder Driver INtime Instructions about how to use the setup are described in the next section Note It is highly recommended to use this setup program to install the INtime cifX driver properly However it is also possible to install the INtime cifX driver manually Please refer to section Manual installation on page 13 for further instructions 2 2 1 Automatic setup To install the INtime cifX driver execute the setup wizard cifX INtime Driver Setup exe which is located on the INtime CD in the folder Installation INtime The setup wizard detects your installed INtime version automatically and installs the proper cifX driver including 64 bit installer on a 64 bit operating systems with installed INtime V4 x and later i cifX Device Driver 86 for Ten sys INtime 1 1 0 0 Setup a El Welcome to the cifx Device Driver 86 for Ten sys IMtime 1 1 0 0 Setup Wizard The Setup Wizard will install cifx Device Driver x86 For Tendsws INtine 1 1 0 0 on your computer Click Next to continue or Cancel to exit the Setup Wizard Figure 4 cifX INtime Driver Setup Wizard During the installation you can choose the setup type that best fits your needs While the typical and complete setup install all features of the driver the custom setup allows you to set the dest
34. r installation for Windows is available on the separately distributed cifX Driver for Windows CD and is located in the folder Installation A detailed description of the installation process is descrobed in the Installation and Operation Guide for the cifX Device Driver for Windows reference 2 When Windows asks for a driver for your newly inserted PC card cifX select the path to the cifX driver folder on your CD Windows automatically installs all needed tools and sets up the registry After the installation has succeeded the card can be configured using the cifX Setup tool ig cifX Device Driver x86 1 1 0 0 Setup a Lesen Sie die Lizenzbedingungen f r cifx Device Driver x86 1 1 0 0 HILSCHER SOFTWARE LICENSE AGREEMENT This document is a legal Agreement between you the license and Soe Hilscher Gesellschaft f r Systemautomation mbH wey Hilscher Please read this Se Agreement carefully before you instal the software By installing or otherwise using the software you accept the terms of this Agreement If you do not agree to the terms of this Agreement then do not install or juse the software return it to us Bones une ng E Ich stimme den Bedingungen der Lizenzvereinbarung zu Drucken Zur ck nstallieren Abbrechen Figure 3 cifX Setup Wizard for Windows cifX Device Driver INtime DOCO80605DRVO6EN Revision 6 English 2015 06 Released Public Hilscher 2008 2015 Installati
35. the card is powered up the firmware and configuration files must be downloaded to the hardware Note Firmware and configuration files are not stored on the hardware and must be downloaded each time the card is powered up It is the task of the driver to initialize the card and therefore the driver has to know which files have to be loaded to the hardware To allow device specific configuration every file that needs to be downloaded must be stored in an own folder These folders are created within the cifX driver installation directory see registry settings InstallDir usually Program Files This chapter describes where these files are stored Use the Slotnumber hardware rotary switch The Slotnumber serves to distinguish PC cards cifX from each other clearly especially if more PC cards cifX are installed in one PC The Slotnumber must be set at the cifX card using the rotary switch S otnumber While Slotnumber O means that the cifX card is identified by its device and serial number values from 1 to 9 corresponds to the Slotnumber 1 to 9 The firmware and configuration file must reside in the subdirectory Slot_ lt 1 9 gt Use the device and serial number default If the PC card cifX is not equipped with a rotary switch or the Slotnumber is set to 0 the device is identified by its device and serial number The firmware and configuration file must reside in the subdirectory lt Device Number gt _ lt Serial Number gt Note Wh
36. tibility issues with SYCON net and the cifX INtime driver a firmware or configuration download will cause a fatal crash of the SYCON net application see screenshot below n unhandled wins exception occurred in ODMYS exe 3548 This issue can be fixed by applying a special patch to the SYCON net application Check your SYCON net application to find out if the patch is necessary SYCON net V1 3 5 0 and higher do not need to be patched Sr CON net for nets 1 310 Build 110307 m gt bc Copyright 2006 2010 Hilscher Gesellschaft fur Systemautomation mbH Fiheinstra e 15 D 65795 Hattersheim zus hilscher com Alle Rechte vorbehalten For older versions a step by step instruction to apply the patch is described below 1 Navigate to the folder lt Common Files Path gt Hilscher ODMV3 eg C Program Files Common Files Hilscher ODMV3 This path only exists if SYCON net is installed on your local machine The file ODMCifXDriver dll located in this folder may have to be replaced by a newer version 2 In order to check the version of the ODMCifXDriver dll open the file properties and select the version tab If the version is equal or higher than 1 101 1 9801 your SYCON net installation is up to date you do not need to apply the patch Otherwise proceed with next step Eigenschaften von ODMCifxDriver dll s a x Allgemein ersian Sicherheit L ateiinfo Dateiversion Beschreibung LIF Device Driver Copyright
Download Pdf Manuals
Related Search