Manuel hardware & software xRSPCI rev A.4
Contents
1. tty 1octl 4 setserial 8 To switch a port to RS485 automatic turnaround you can either 20 Use the provided utility from an interactive or script shell or from a compiled program using the system 3 call acksys8250 install sh a dev ttySxxx Use the following ioctl TIOCSERSETRS485 Turn on RS485 turnaround ifndef TIOCSERSETRS485 define TIOCSERSETRS485 0x5461 enable rs 485 fendif fd file descriptor of the opened XRS port ioctl fd TIOCSERSETRS485 1 if i lt 0 lt perror TIOCSERSETRS485 printf port set to RS485 auto turnaround using DTR n Turn off RS485 turnaround ifndef TIOCSERSETRS485 define TIOCSERSETRS485 0x5461 enable rs 485 fendif fd file descriptor of the opened XRS port ioctl fd TIOCSERSETRS485 0 if i lt 0 lt perror TIOCSERSETRS485 printf port set to normal full duplex mode n DRIVER USER MANUAL pjUf3052 REL A 4 MARCH 2012 Compl ment Compiling the driver under Fedora Core 4 The following procedure is published with the authorization of RT2I Translation by Acksys Applies to the driver for Linux 2 6 10 Installing the xRSPCI xRSUNI driver for Linux 2 6 Install kernel sources kernel 2 6 11 1369_FC4 src rpm 4 rpm ivh kernel 2 6 11 1369 FC4 src rpm rpmbuild bp target noarch u2. you must pass as argument tty name p tty name For example if you want to create the tty with name ttys start the driver with command insmod srlxrspci o tty name p ttyS To check the terminal name see file var log messages Y If the card s oscillator is not set to 29 4912 MHz you must add the following option when you install the driver input clock Freq in Hz For example with a 16 MHz oscillator the command is as follows insmod srlxrspci input clock 16000000 Y If you need a custom speed you must add the following option when you install the driver speed custom speed in bauds For example if you want a speed of 76800 bauds the command is as follows insmod srlxrspci o speed custom 76800 To configure the serial port speed use these functions int cfsetospeed struct termios termios p speed t speed output speed int cfsetispeed struct termios termios p speed t speed input speed If you want to use the parameter speed custom you must use the constant EXTA as this example follows cfsetospeed amp ma struct termios EXTA 14 DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 EXTA constant is defined by default in the file usr include bits termios h in the following way define EXTA B19200 If you want to use 19200 bauds B19200 you must change the constant EXTA in usr include bits termios h and compile Linux driver The next time Linux is started up the module will not run autom
3. Port imprimante ECP LPT1 gt a Processeurs Y Souris et autres p riph riques de pointage 8 DRIVER USER MANUAL APNR REL A 4 MARCH 2012 The Settings tab This tab enables the default communications parameters to be defined as with a standard COM port It can also be used to define the interface type and automatic line turnaround for RS485 Propri t s de Port de communication ACKSYS COM10 G n ral Settings FIFOs Data Rate Pilote D tails Gestion de l alimentation 2RSUNL 4RSUNI 8RSUNI SYS 160950 High Performance UART SYSTEMS COMMUNICATIONS amp S Hardware Configuration 9 RS232 or RS422 master D R8485 half duplex Error indication on ineffective DTR change attempts Default Communications Parameters Bits per second 9600 Data bits DTR OFF on open Stop bits IEEE COM Port Number Port number to use COMI 0 Restore Defaults EE Hardware configuration RS232 or RS422 master Simultaneous transmission and reception full duplex is allowed The software application can handle the RTS and DTR signals If a software application is designed to drive the turnaround by itself when using a 00150 or an ACKSYS RS485 external converter this mode allows the application to drive the RTS signal This signal must be activated before transmission and disabled once the last character is sent This method does n
4. riereevensenonsonsasonsonsnsonoonoenens 00 0000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000006 1 INSTALLING THE ACKSYS DRIVER FOR WINDOWS 98 2 INSTALLING THE ACKSYS DRIVER FOR WINDOWS NT 4 0 eese eese entente tn enano 6 INSTALLING THE ACKSYS DRIVER FOR WINDOWS 2000 XP VISTA e eee reete enne 8 INSTALLING THE ACKSYS DRIVER FOR LINUX KERNEL 2 2 X eere eee 13 INSTALLING THE ACKSYS DRIVER FOR LINUX KERNEL 2 4 X eere tette 14 INSTALLING THE ACKSYS DRIVER FOR LINUX KERNELS 2 6 17 APPENDIX A LINE TURNAROUND eres stas tatu sins 22 APPENDIX B TROUBLESHOOTING eerte enses entente tatus n statu sons tatu sessio suse n sensn rocoso cn ronosocnronos 23 VIZ DRIVER USER MANUAL DHUR REL A 4 MARCH 2012 IL DRIVER USER MANUAL DHUR REL A 4 MARCH 2012 VIZ 1 INTRODUCTION This manual describes Windows amp Linux driver installation for the following boards xRSUNI 232 PCI serial adapters RS232 2 4 amp 8 ports PCI bus 5V amp 3V xRSUNI 400 PCI serial adapters RS422 485 2 4 amp 8 ports PCI bus 5V amp 3V xRSUNILP 232 PCI serial adapters RS232 4 amp 8 ports PCI bus 5V amp 3V Low profile xRSPC1 232 PCI serial adapters RS232 2 4 amp 8 ports PCI bus 5V xRSPCI 400 PCI serial
5. to transmit 4 characters a time out interrupt is generated to warn the peripheral s driver In the case of an application transferring large blocks of data it is advisable to choose high thresholds in order to reduce the number of interrupts and thus the load on the CPU However it is not recommended that the maximum values be used especially when communicating at high speed in order to avoid reception overwrites and transmission interruptions DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 5 3 INSTALLING THE ACKSYS DRIVER FOR WINDOWS NT 4 0 Install the card and power up the PC To install the driver Start Windows NT and identify yourself as Administrator Insert the xRSPCI driver disk Run the XRSSETUP program from WINNT subdirectory Driver installation update Do you want to install the Acksys driver version 1 0 2 0 for the XASPCI cards Click the Yes button XRSSETUP v1 3 Installer for ACKSYS XRSPCI cards on Windows NT Bi Driver Name XRSNT SYS Uninstall Version 1 0 20 esa YS ZOMIMAUNICATIONSS 8 SYSTEMS m Cards Reference Parameters Configuration Model Number of Channels First Port Number 50009 Slot 9 Bus 0 usable XRS PCI 2 channels MACOM5 50000 Slot 13 Bus 0 usable AS PCI 8 channels MACOM Test Delete Print all Quit In this window you will see a list of cards detected by the driver You can eith
6. 1 y xRSPCI Communication Port COM1 2 A xRSPCI Communication Port COM5 a xRSPCI Communication Port A xRSPCI Communication Port COM xRSPCI Communication COMB F xRSPCI Communication Port COM9 2 zi Properties Refresh Remove Print 2 DRIVER USER MANUAL APNR REL A 4 MARCH 2012 xRSPCI Communication Port COM10 Properties 2 x General Settings Data Rate FIFOs Driver Resources ACKSYS Restore Defaults Standard Port Settings Baud Rate 5o y Number of Data bits pii Type of Parity y Number of Stop bits fi y Flow Control Type xon y BS485 Line turnaround Notused y co The Port settings tab enables you to define the initial communications parameters as for a standard COM port RS485 line turnaround See appendix A for further informations If the line turnaround is required RS485 RS422 multidrop for the slave nodes RS485 Line turnaroud must be set to Driven by application or automatic If not RS232 RS422 point to point RS422 multidrop for the master node RS485 Line turnaroud must be set to Not used When the Driven by application option is selected the Windows software is in charge of controlling the DTR signal Don t use this method if DTR cannot be handled in timely manner DTR must be disabled before beginning the transmission and enabled after the completion o
7. Core 4 at the end of this chapter Installing on Fedora Core 6 is similar A Linux driver module must be compiled with the knowledge of the kernel configuration on which it will be loaded So it is provided only as source code and you must compile it before using Once compiled you may load the object module into any Linux kernel matching the configuration used during the compilation To compile it you must Install the kernel sources and headers Copy the acksys sources to the drivers serial subdirectory of the kernel sources Edit the file drivers serial Makefile to add the line in bold at the indicated place obj CONFIG SERIAL 8250 8250 0 serial 8250 y obj m acksys8250 0 acksys8250 pci o obj CONFIG SERIAL 8250 CS serial cs o Follow the instructions given by the Linux distribution provider or the instructions found in the kernel README A typical kernel generation would begin with the following steps make mrproper make menuconfig or make gconfig or make xconfig The configuration step will create a file named config holding all the configuration parameters You must ensure that this file matches the configuration of the kernel in which the module will be loaded If you have the configuration file of the current kernel you can copy it to config instead of running make menuconfig See next page DRIVER USER MANUAL ADUR REL A 4 MARCH 2012 17 On some OSes the cu
8. DRIVER USER MANUAL XRSUNI xRSUNI LP xRSPCI PCI MULTIPORT SERIAL ADAPTERS COMMUNICATIONS amp SYSTEMS DRIVER is COPYRIGHT BY ACKSYS 2001 2012 This document contains information which is protected by copyright The document may not in whole or in part be reproduced transcribed stored in an electronic or any other retrieval system translated into another language or computer language without the prior written consent of ACKSYS ZA Val Joyeux 10 rue des Entrepreneurs 78450 VILLEPREUX FRANCE TRADE MARKS 8 e ACKSYSis a registered trademark of ACKSYS e Windows Seven Windows Vista Windows XP Windows 2000 Windows NT Windows 95 Windows 98 and Windows ME are registered trademarks of Microsoft e Linux is a registered trademark of Linus Torvalds NOTICE ACKSYS in no ways guarantees the contents of the present document and accepts no responsibility as to the equipment s value or suitability for the user s needs ACKSYS 0 can in no case be held responsible for any errors that may exist in this document nor for any damage of any size resulting from the supply the functioning or the use of the equipment ACKSYS 0 reserves the right to revise this document from time to time or to change its contents with no obligation to inform anyone DRIVER USER MANUAL DHYN REL A 4 MARCH 2012 I VIL DRIVER USER MANUAL pjUf3052 REL A 4 MARCH 2012 VIZ TABLE OF CONTENTS INTRODUCTION
9. Port COM10 Properties i2 x General Settings Data Rate FIFOs Driver Resources Y Ln tt 78 ACKSYS ERUIT FIFO Mode C 450 No FIFO CS50 16Byte 950 128 Byte m FIFO Interrupt Trigger Levels Receiver H 64 Receiver FIFO Flow Control Trigger Levels Flow On pcc 64 Flow Off 120 owes The FIFOs tab enables you to set the interrupt trigger levels for transmission and reception according to the number of characters in the respective buffers as well as the flow control trigger levels The default values are satisfactory for most traditional applications Configuring the interrupt trigger levels The value defined using the Transmitter cursor gives the level from which a transmitter interrupt will be generated For example the default value 4 indicates that an interrupt will be generated as soon as the number of characters in the transmission buffer drops from 5 to 4 This value should remain low but it may be advisable to increase it for higher speeds or with slow or overloaded CPUs The value defined using the Receiver cursor gives the level from which a receive interrupt will be generated In the case of the default value the interrupt occurs when the number of characters in the receive buffer rises from 63 to 64 If the number of characters received is less than the threshold and does not change during a period corresponding to the time
10. adapters RS422 485 2 4 amp 8 ports PCI bus 5V DRIVER USER MANUAL DHUR REL A 4 MARCH 2012 1 2 INSTALLING THE ACKSYS DRIVER FOR WINDOWS 98 amp ME Install the card in the PC and start up Windows As this is a PCI card the configuration will be automatically updated whenever the card is installed or removed Under Windows 98 98 SE and ME the Add new hardware wizard will automatically run the first time the card is installed as soon as the card is detected Follow the wizard instructions The driver has now been successfully installed If you wish to add a card after the driver has been installed Windows 98 will skip the Add new hardware wizard and will install the PCI communications ports automatically Properties of the communications ports The new communications ports are available as soon as installation is complete and are visible in the device manager Control panel System To edit the properties of a port double click the corresponding line System Properties 2 General Device Manager Hardware Profiles Performance View devices by type C View devices by connection E E Multi function adapters 4RSPCI 8RSPCI serial communication controler gt 8RSPCI additional serial com ports BH Network adapters E AF Ports COM amp LPT A Communications Port COMT RI Communications Port COM4 A ECP Printer Port LPT1 B xRSPCI Communication Port COM10 RJ xRSPCI Communication Port COMT
11. atibility problems with other versions of Linux please first control against this Linux version WARNING A Linux driver module must be compiled with the knowledge of the kernel configuration on which it will be loaded So it is provided only as source code and you must compile it before using Once compiled you may load the object module into any Linux kernel matching the configuration used during the compilation To compile the driver Install the kernel headers and compilation tools Use a terminal command prompt Go to the relevant driver sources directory depending on your kernel version Start compiling with the command make e Install the generated module in the 1ib modules directory with make install 18 DRIVER USER MANUAL pjUf3052 REL A 4 MARCH 2012 Installing the driver The driver can be loaded and unloaded dynamically Load it using the following command modprobe acksys8250 pci The ports are named dev ttyS lt number gt number will depend on the kind of acksys cards the number of ports on each card and the order of the cards on the PCI bus You can check the recognized ports with acksys8250 install sh p If you ever need to stop the driver enter these commands modprobe r acksys8250 pci Configuring the driver Y If you are using a card with a nonstandard oscillator other than 29 4912 MHz you must execute the following command for each port on this card setserial dev ttySxxx ba
12. atically unless you add the file zc ack in file rc serial If the rc serial file does not exist create it adding the line bin sh etc rc d rc ack Then edit the file rc local adding the following line if f etc rc d rc serial then bin sh etc rc d rc serial fi The procedure described above may differ for other versions of Linux Creating nodes When the driver is running use command mknod as follow to create nodes in the system mknod tty name c major minor If the driver is started with default option mknod ttyA04 c 40 68 To check major and minor values please see file val log messages Stopping the driver To stop the module just enter rmmod srlxrspci References Linux help file relating to serial ports http en tldp ore HOWTO Serial HOWTO html Linux help file relating to programming the serial ports http en tldp org HOWTO Serial Programming HOWTO List of sites containing Linux Howtos http metalab unc edu LDP mirrors html Source files for the Serial Linux driver 5 05 http sourceforge net projects serial http sourceforge net project showfiles php group_id 310 DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 15 Using automatic line turnaround under Linux 2 4 In RS485 or RS422 slave mode automatic line turnaround can be set Use the following iocontrol code ACKSYS ENABLE 485 MODE Validate the function of automatic line turn around Automatic line turna
13. ave a 4 port card enter 4 etc and then run the script It will create the peripheral files as follows Card Peripheral number number 1 ttyMO ttyM MAXPORT 1 2 ttyM MAXPORT ttyM 2 MAXPORT 1 Stopping the driver To stop the driver enter rmmod srllinux DRIVER USER MANUAL ADUR REL A 4 MARCH 2012 13 6 INSTALLING THE ACKSYS DRIVER FOR LINUX KERNEL 2 4 x The installation procedure has been tested initially using Linux Mandrake version 8 0 with kernel version 2 4 3 20mdk and Linux Redhat with kernel version 2 4 7 10 If you have any compatibility problems with other versions of Linux please contact ACKSYS This driver is based on the Serial Linux Driver 5 05 All the programs described below can be found in linux V3 4 subdirectory on the media supplied Installing the driver This type of installation does not require Linux to be recompiled In addition it enables the driver to be loaded and unloaded dynamically Copy the file sr1xrspci o into the directory lib modules shell uname r misc The peripheral s files may be created with standard names ttyS or with a name chosen at installation time e g tty A Starting the driver To start the driver type the following command insmod srlxrspci o To check that the driver has been correctly installed use command 1smod This will create the tty devices in the system By default the driver create ttyAO to ttyAn n depends on your board If you want to change the tty name
14. ctionality in the serial equipment such as starting a radio MODEM Checking this box leaves the DTR disabled until the application takes a deliberate action COM port number The name of the COM port may be changed here 10 DRIVER USER MANUAL DHUR REL A 4 MARCH 2012 The FIFOs tab The FIFOs tab enables you to set the interrupt trigger levels for transmission and reception according to the number of characters in the respective buffers as well as the flow control trigger levels The default values are satisfactory for most traditional applications r Y ll Propri t s de Port de communication ACKSYS COM10 NS G n ral Settings FIFOs Data Rate Pilote D tails Gestion de l alimentation 2RSUNL 4RSUNI 8RSUNI SYS 16C950 High Performance UART INS amp SYSTEMS OOMMUNICAT FIFO Interrupt Trigger levels Transmitte Receiver 100 Receiver FIFO Flow Control Thresholds Flow On 16 Flow Off 112 Restore Defaults Configuring the interrupt trigger levels The value defined using the Transmitter cursor gives the level from which a transmitter interrupt will be generated For example the default value 4 indicates that an interrupt will be generated as soon as the number of characters in the transmission buffer drops from 5 to 4 This value should remain low but it may be advisable to increase it for higher speeds or with slow or overloaded CPUs The
15. d rate divider prescaler 4 000 v Remap Baud Rates Bestore Defaults e The Clock Frequency MHz list allows you if you know it to directly specify the frequency of the embedded oscillator e The Auto detect Clock Frequency button computes the most likely oscillator frequency e The Use default rate checkbox should stay checked Unchecked it allows the user to specify rate multipliers In this case the real transmission speeds will be a multiple of the specified one e The Baud rate multiplier option applies the multiplication factor to the speed chosen by the application For example With a factor of 16 when the application specifies a speed of 115200 bauds the real speed will be 1 8435MHz e The Quad Speed is reserved for specific applications and shall be left unchecked e The Baud rate divider prescaler option divides the oscillator speed by a decimal factor which allows to reach a better precision for non standard speeds e The Remap Baud Rate button allows to substitute a speed for another For example it is possible to make the 4800 bauds speed to really communicate at 230400 bauds This is useful if your program only provides slow speeds although your serial devices allow higher ones 12 DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 5 INSTALLING THE ACKSYS DRIVER FOR LINUX KERNEL 2 2 X The installation procedure has been tested initially using Linux Ma
16. er click Exit to finish the installation or select a card and click Configure to open the Properties of ACKSYS xRSPCI window In the Properties of ACKSYS XRSPCI window You can deactivate a card by clicking on the Disable the driver of this card box For each port you can specify the RxFIFO interrupt trigger level the size of the TxFIFO buffer and the RS485 mode General Advanced General Advanced Disable card Options r Card Control CardName XRS0003 Name XRS0008 Clock Rate V Automatic Port Port name FIFO Tx AS 485 1 COM 5 8 1 Disabled Hertz g 2 CO0M amp 8 1 Disabled r Port Name First Port Number 5 5485 mode auto ATS 7 Enabled Cancel ok Cancel The drivers may be supplied on CD In this case you will need to select the folder containing the xRSPCI drivers 6 DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 Mode RS485 AutoRTS understand Line Turnaround See appendix A for further informations If the line turnaround is required RS485 RS422 multidrop for the slave nodes mode RS485 AutoRTS check box can be cheked or not If not RS232 RS422 point to point RS422 multidrop for the master node mode RS485 AutoRTS check box must not be checked If checked the DTR signal will now be driven automatically by the UART whenever a character is transmitted guaranteeing an optimal timing If not checked the Wind
17. f the transmission Since only a single driver can be enabled on a network at one time it is important that the driver is disabled as quickly as possible after transmission to avoid two drivers trying to control the lines simultaneously a condition called line contention For more efficient control or if the application cannot manage the DTR signal select the Automatic option The DTR signal will now be driven automatically by the UART whenever a character is transmitted guaranteeing an optimal timing DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 3 g ACKSYS H do 2772161101 al HIT SECK Sand SBS The Data Rate tab enables you to configure the card s specific operating modes and to visualise the frequency of the oscillator which for standard cards should be 24 4912 MHz Quad Speed option this functionality should not be used for conventional applications the tick box should be left clear User Defined Override Speed option this option enables you to enforce the communications speed given in the Override Configuration box In this case the driver ignores the speed parameter passed by the Windows API The Clock Pre Divisor option enables you to apply a division factor to the clock to obtain better precision when a high non standard speed is required DRIVER USER MANUAL DIU S 052 REL A 4 MARCH 2012 xRSPCI Communication
18. ices do not exist create them with this command acksys8250 install sh d check once more that the ports exist with acksys8250 install sh P check that the ports work as expected stty dev ttyS100 stty dev ttyS101 1s gt dev ttyS100 15 gt dev ttyS101 DRIVER USER MANUAL 1 1030 52 REL A 4 MARCH 2012 21 8 APPENDIX A LINE TURNAROUND In multidrop network RS485 or RS422 slave serial ports must have a TxD driver that can be disconnected from the transmission line when the serial port is not transmitting In xRS cards range this is implemented using the DTR control signal The DTR line is connected to the RS485 RS422 driver enable such that setting the DTR line to a low logic 0 state enables the RS485 RS422 driver Setting the DTR line high logic 1 puts the driver into the tristate condition This in effect disconnects the driver from the bus allowing other nodes to transmit over the same wire pair This mecanism called line turnaroud must be used in RS485 two wires network for all nodes RS422 four wires network for slaves nodes In RS422 with only two nodes or RS232 turnaround is not used 22 DRIVER USER MANUAL pjUf3052 REL A 4 MARCH 2012 9 APPENDIX B TROUBLESHOOTING The card is not detected by the BIOS Check the PCI PnP option in the motherboard set up program and set it to AUTO Check that the card is properly inserted into the slot Try other slots until you find
19. ndrake version 7 2 and version 2 2 17 21 of the kernel If you have any compatibility problems with other versions of Linux please contact ACKSYS All the programs described below can be found in linux kernel22 subdirectory on the media supplied Installing the driver This type of installation does not require Linux to be recompiled In addition it enables the driver to be loaded and unloaded dynamically Copy the file sr1linux o into the directory lib modules shell uname r misc Starting the driver To install the driver just enter insmod srllinux To check that the driver has been correctly installed use the Lsmod command If the card s oscillator is not set to 29 4912 MHz you must add the following option when you install the driver input clock Freq in Hz For example for a 16 MHz oscillator the command is as follows insmod srllinux input clock 16000000 The next time Linux is started up the driver will not run automatically for this to happen add the file rc ack in the file zc serial If the zc serial file does not exist create it adding the line etc rc d rc ack Then edit the file rc local adding the following line if f etc rc d rc serial then Sh etc rc d rc serial fi Creating the nodes The nodes must be created in the system To do this edit the msmknod script supplied by ACKSYS adjust the MAXPORT constant according to your card if you have a 2 port card enter 2 if you h
20. one that works If you cannot try the card in another PC to verify its operation If necessary contact your PC manufacturer to obtain an updated BIOS The card is not detected by Windows 95 98 2000 M E Xp Check the first problem In the System properties window check that the card has not already been recognized as a standard PCI card or a multi function adapter card If this is the case delete the corresponding entry and click the Refresh button until the Add new hardware wizard starts up Reinstall Windows Communications between the card and your equipment do not work Check the connection between your equipment and the card Check the communications parameters speed parity number of stop bits flow control on each side In RS422 RS485 mode the use of the convention can cause problems This is a faulty standard with one manufacturer calling what another will call In this case you could try connecting the signal to the signal In RS485 or RS422 slave modes check if the turnaround is correctly handled Contact ACKSYS ACKSYS COMMUNICATIONS amp SYSTEMS ZA Val Joyeux 10 rue des entrepreneurs 78450 Villepreux FRANCE Telephone 33 0 1 30 56 46 46 Fax 33 0 1 30 56 12 95 Web www acksys fr Hotline support acksys fr Sales sales acksys fr DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 23
21. ot allow a precise control of the commutation time after a complete frame transmission RS485 or RS422 slave In this mode the UART automatically generates a turnaround signal which is available on the DTR and RTS output signals DRIVER USER MANUAL 1 107 0 52 REL A 4 MARCH 2012 9 Use this mode when the TxD AB signals are connected to a bus in slave mode transmission and reception being alternated half duplex MR4OOISO interface cards and ACKSYS RS485 external converters use the RTS signal to free the bus when the card is not transmitting In idle state no transmission the line is in receive mode As soon as a character or a group of characters must be sent RTS is activated and the line switches to the transmission mode Error indication on ineffective DTR changes attempts When the automatic turnaround is enabled driving RTS signal has no effect anymore and the DTR is reserved in the driver If the application tries to modify DTR there won t be any real effect This checkbox indicates if the application must receive an error notification or not Default configuration parameters WARNING as well as for basic COM ports these parameters are only used by some Windows programs Always check the configuration parameters of your application DTR OFF on open The default behavior for Windows serial drivers is to activate the DTR at the port s opening This might be annoying if the DTR is used to activate some fun
22. ows software is in charge of controlling the DTR signal Don t use this method if DTR cannot be handled in timely manner DTR must be disabled before beginning the transmission and enabled after the completion of the transmission Since only a single driver can be enabled on a network at one time it is important that the driver is disabled as quickly as possible after transmission to avoid two drivers trying to control the lines simultaneously a condition called line contention To uninstall the driver run XRSSETUP EXE and click the Uninstall button Driver Name XRSNT SYS Uninstall Version 1 0 2 0 esa COMMUNICATIONS amp SYSTEMS Cards Reference Parameters Configuration Model Number of Channels First Port Number 9 R50009 Slot 9 Bus 0 usable AS PCI 2 channels MACOM5 O 50000 Slot 13 BusO usable XRS PCI 8 channels WACOM CLICK Uninstall Configure Delete Print Quit Driver installation update x 2 About to remove the Acksys XRSPCI cards driver Are you sure j Cancel Driver installation update Eg 1 The XRSPCI driver was removed The installation program will now terminate DRIVER USER MANUAL 1 107 0 52 REL A 4 MARCH 2012 7 4 INSTALLING THE ACKSYS DRIVER FOR WINDOWS 2000 XP VISTA SEVEN These operating systems automatically detect the new card A hardware installation wizard is automatically r
23. round is handled directly by the UART No parameter is required for this iocontrol It is sent to the driver using linux API function ioctl The communication channel must be opened before calling this function These constants are defined in the file iocontrol h BE CAREFUL The value of the constant is not identical on the two Linux Kernel 2 2 and 2 4 It is necessary to recompile your application with the correct include file 16 DRIVER USER MANUAL DHUR REL A 4 MARCH 2012 7 INSTALLING THE ACKSYS DRIVER FOR LINUX KERNELS 2 6 X Prerequisites You must have the following at hand to install the driver The kernel headers The setserial linux utility if special port setup is needed Root login and password One or more XRSPCI or XRSUNI cards For kernels older than 2 6 25 you must also install the kernel sources Unpacking the archive The archive is provided in compressed tar format When unpacked it creates a subdirectory in the current directory That subdirectory contains in turn two directories utils contains utilities to set up the ports driver contains for each kernel subversion the driver sources Compiling for kernels 2 6 10 to 2 6 18 The installation procedure has been tested initially using the Linux kernel 2 6 10 installed on a Debian Sarge distribution This driver is based on the Linux serial driver which has been redesigned several times in kernel 2 6 You will find notes specific to Fedora
24. rrent configuration is available in boot config Debian Mandrake On others it will be in lib modules name r include or in lib modules uname r build include RedHat or in usr src linux include or in proc config gz SuSe You must check this by yourself e If you used the exact config file matching your kernel you can skip the kernel compilation and installation Simply build the required modules Y Compile the kernel modules for instance make M drivers serial Y Move the generated modules to the system modules directory libmod 1ib modules uname r kernel drivers serial cp acksys8250 ko acksys8250 pci ko libmod depmod e If you used a new config file that you tailored to your needs you must now create a full new kernel This will automatically add the Acksys modules Y Compile the full kernel make Y Install the kernel and its modules make install modules install Y Configure GRUB or LILO Follow the indications given by the previous command Y If necessary for your distribution create a initrd file xxx is the kernel version mkinitrd o boot initrd img xxx xxx Compiling for kernels 2 6 26 and later The compilation will create an external loadable module The installation procedure has been tested initially using the Linux kernel 2 6 26 installed on a Debian Lenny stable distribution This driver is based on the Linux serial driver which has been redesigned several times in kernel 2 6 If you have any comp
25. sr redhat SPECS kernel 2 6 spec The sources are located in usr src redhat B UILD kernel 2 6 1 1 linux 2 6 11 In the drivers serial directory copy the Acksys driver sources Add the line in the Makefile see Acksys documentation obj CONFIG SERIAL 8250 8250 0 serial 8250 y existing line obj m acksys8250 0 acksys8250 pci o line to add obj CONFIG SERIAL 8250 CS serial cs o existing line change the source file acksys8250 c add after line 50 Acksys note this seems unneeded for kernel 2 6 18 define uart match port uart match port compile the modules make mrproper make oldconfig make M drivers serial if there are errors t cd usr src redhat BUILD kernel 2 6 11 1linux 2 6 11 include linux mkdir linux cp autoconf h linux cd cd t make M drivers serial install the modules cd drivers serial libmod lib modules 2 6 11 1 1369 FC4smp kernel drivers serial cp acksys8250 ko acksys8250 pci ko libmod depmod check if the module can be loaded modprobe acksys8250 pci add this line in the file etc rc d rc serial in order to load the module at boot time lsmod check that theacksys8250 et acksys8250_pci modules are in the loaded modules list run the script acksys8250_install sh provided with the driver to list the available ports acksys8250 install sh P for a 2RSPCI you would have 0000 03 02 2RSPCI ttyS100 0000 03 02 2RSPCI ttyS101 if the dev
26. ud base osc divided by 16 Here are sample commands to handle some oscillator values on a 2RSPCI or 2RSUNI On board Command to issue before use oscillator 29 4916 MHz None this is the default 48 MHz setserial dev ttyS100 baud base 3000000 setserial dev ttyS101 baud base 3000000 60 MHz setserial dev ttyS100 baud base 3750000 setserial dev ttyS101 baud base 3750000 Y If you need to use a nonstandard baud rate you must execute the following command on the port concerned setserial dev ttySxxx divisor lt uartdivisor gt setserial dev ttySxxx spd cust This will replace the 38400 baud rate with the specified one For example if you want a speed of 76800 bauds with the 29 4912 MHz oscillator the divisor is 29491200 16 76800 24 hence the command is as follows setserial dev ttyS100 divisor 24 spd cust After that setting the 38400 baud rate in any way will really set 76800 bauds There is no way to use 38400 bauds until you use the reverse command setserial dev ttyS100 spd normal Y If you plan you connect any port on RS485 bus you must issue the following command acksys8250 install sh a dev ttySxxx DRIVER USER MANUAL DHYN REL A 4 MARCH 2012 9 Using the driver The driver is fully compatible with the basic linux serial driver provided in kernel version 2 6 For more information see the following MAN pages termios 3 ttyS 4
27. un when the system starts up as soon as the card is detected Follow the wizard instructions Drivers for Windows are located on the ACKSYS CD ROM NOTE FOR WINDOWS XP and WINDOWS VISTA The wizard may announce you that the driver is not certified Ignore this message in order to continue the installation of the card Properties of all the communications ports The new communications ports are visible in the device manager control panel hardware Double click one of the ports to edit its properties Fichier Action Affichage 9 miHi sts 4 3 LABO4 RD PC 5 Autres p riph riques K Cartes graphiques Cartes r seau Cartes s rie multi ports Acksys 4RSUNI 8RSUNI ports 1 4 Acksys 8RSUNI ports 5 8 5 Claviers 3 Contr leurs audio vid o et jeu Contr leurs de bus USB ell Contr leurs de lecteur de disquette Contr leurs IDE ATA ATAPI mi Lecteurs de disque e Lecteurs de disquette i Lecteurs de DVD CD ROM Ki Moniteurs amp Ordinateur Os P riph riques d interface utilisateur amp P riph riques systeme 17 Ports COM et LPT YT Port de communication COM1 ud Port de communication ACKSYS COM10 icd Port de communication ACKSYS COM3 ud Port de communication ACKSYS COM4 X Port de communication ACKSYS 5 id Port de communication ACKSYS COM6 i d Port de communication ACKSYS COM7 YT Port de communication ACKSYS COM8 X Port de communication ACKSYS COM9 1
28. value defined using the Receiver cursor gives the level from which a receive interrupt will be generated In the case of the default value the interrupt occurs when the number of characters in the receive buffer rises from 63 to 64 If the number of characters received is less than the threshold and does not change during a period corresponding to the time to transmit 4 characters a time out interrupt is generated to warn the peripheral s driver In the case of an application transferring large blocks of data it is advisable to choose high thresholds in order to reduce the number of interrupts and thus the load on the CPU However it is not recommended that the maximum values be used especially when communicating at high speed in order to avoid reception overwrites and transmission interruptions DRIVER USER MANUAL ADNR REL A 4 MARCH 2012 11 The Data rate tab This tab enables you to select the frequency of the oscillator for some specific cards The default value is 24 4912 MHz priet s de Port de communication ACKSYS COM10 x G n ral Settings FIFOs Data Rate Pilote D tails Gestion de l alimentation 2RSUNL 4RSUNL 8RSUNI 16C950 High Performance UART ACKSYS COMMUNICATIONS amp Input Clock Clock frequency MHz 40 0000 M Auto Detect Clock Freguency Baud Rate Configuration Options J Use default baud rate Override Configuration Baud rate multiplier 1 v Bau
Download Pdf Manuals
Related Search