EZ COM USER MANUAL 8 >i< 4 PORT INTELLIGENT SERIAL
Contents
1. 20 DTR DCD 8 8 DCD RTS 4 4 RTS CTS 5 5 CTS SG 7 7 SG NULL MODEM AND MODEM CABLE 15 Some serial devices have the buffer control signal on pin 19 in which case pin 6 on the host is connected to pin 19 on the remote device B 2 Modem Connections A straight through cable is required e g pin 2 to pin 2 pin 3 to pin 3 etc DTE Host Remote DCE Signal Pin Signal GND c GND TxD P TxD RxD RxD RTS 4 4 RTS CTS lt 2 CTS DSR 6 4 6 DSR SG 7 7 SG DCD 8 9 DCD DTR 20 O 9 20 DTR XENIX CONFIGURATION 16 APPENDIX C SCO XENIX CONFIGURATION C 1 Hardware Configuration Before insert the EZ COM adapter into computer slot please determine the on board segment address You may select range from A0000 to D0000 which below 1M address also select above address range from C00000 to EFFFFF Each board occupies 64K bytes memory and do not forget select different address for more than one board The device name is dev ttyXYZ where X is a letter from a to d corresponds to four adapters Y is a number from 1 to 4 corresponds to four terminal concentrator of adapter and Z is a number from 1 to 8 corresponds to eight ports For example the dev ttya36 is the port 6 of the third terminal concentrator of the first adapter The MODEM device name is dev ttyA36 During the software installation you must a2. c et j et PROGRAMMING TECHNICAL UNDER MS DOS 51 return value cx register count of sent bytes 11 send break signal ah register always set to 1Ah dx register port number al register send break signal K stop to send break signal 12 return information about driver ah register always set to 1Bh dx register port number cx register length of block es di register starting address of block return value ax register count of received bytes 13 turn on RTS ah register always set to 3Ch dx register port number al register turn off RTS 14 set timeout ah register always set to 3Dh dx register port number PROGRAMMING TECHNICAL UNDER MS DOS 52 al register timeout no each unit is 1 18 sec 15 return status ah register always set to 3Eh dx register port number al register buffer full on remote site 11 flowconro return ax register 0 inactive otherwise active number of characters in the queue the functions with al 10 and al 11 are the same as subfunctions with ah Oh and ah Ofh please see item 1 and 8 16 extended control ah register always set to 3Fh dx register port number al register function number cx register PC COM VIRTUAL TERMINAL UTILITIES 57 Specifies interrupt level of serial port The syntactic specification of SETUP is SETUP portaddr BAUD baud parity data stop IRQ no MCR d2 handshaking
3. void error char s puts s exit 1 main 1 int i cnt char b FILE f if f fopen COM5 wb NULL error Device open error cnt 0 for i 0 31 lt 0 80 1 cnt fprintf f c i printf dWMn cnt fclose f for i 1 i lt 10000 if fopen COM5 rb NULL error Device open error for i 0 31 lt 0 80 1 fscanf f c amp b printf DATA c cWMn i b if i b error ERROR fclose f 4 Clock C version include lt stdio h gt include lt io h gt include lt conio h gt PROGRAMMING TECHNICAL UNDER MS DOS 35 define DEVNAME 5 void printdata s char s char id 9 t1 3 t2 3 d1 3 42 3 id 8 t1 2 t2 2 41121 42121 0 strncpy id amp s 5 8 strncpy t1 amp s 14 2 strncpy t2 amp s 16 2 strncpy d1 amp s 18 2 strncpy d2 amp s 20 2 printf ID s TIME s s DATE 5 5 id t1 t2 d1 d2 main 4 FILE f char 5 128 int fh count c z i clrscr if f fopen DEVNAME rb puts Open Error exit 1 4 c 1 write fh amp c 1 z read fh amp c 1 y while z O kbhit c amp Ox7f if c 0x30 c 3 write fh amp c 1 delay 100 count read fh s 64 for i 0 i lt count i s i amp 0 7 printdata s 9 fileno f PROGRAMMING TECHNICAL UNDER MS DOS 36 write
4. 69 EK DCOPVURIGIITO l san 69 K 2 WARRANTY INFORMATION D cu 69 INTRODUCTION 1 CHAPTER 1 INTRODUCTION The EZ COM intelligent serial package is the Corollary 8 4 adapter and 8 tc concentrator compatible product which contains one intelligent serial adapter and one terminal concentrator Each terminal concentrator provides eight asynchronous serial communication ports RS232 which transmits communication signals by using the cable with an 8 pin mini DIN connector to intelligent serial adapter The hardware configuration of intelligent serial adapter and 8 port terminal concentrators are shown in the belows User may use this configuration to link the computer and serial peripheral devices such as serial printers plotters etc Each EZ COM intelligent serial adapter can be used to connect up to four terminal concentrators total 32 RS232 ports are provided Up to four EZ COM intelligent serial adapters can be inserted into one computer system so that it supports 128 ports in one computer system The advantages of using EZ COM intelligent serial adapter and 8 port terminal concentrators are that when you construct the communication link from PC to peripheral devices you only need use one inexpensive cable line to replace the eight RS232 cables it extends communication distance and reduces cabling cost Each intelligent serial adapter contains four hig
5. 275 PRINT DATA 5 5 280 IF 5 lt gt 5 THEN PRINT ERROR 290 IF 5 lt gt 5 THEN 310 300 NEXT 310 CLOSE 2 2 File Transfer BASIC version Part 1 REM SERIAL DRIVER DEMO PROGRAM FOR BASIC LANGUAGE 30 REM 40 REM THIS PROGRAM WILL TRANSMIT MESSAGES TO 50 REM REMOTE SITE THROUGH DEVICE DRIVER 60 READ AS 70 OPEN 1 5 80 FOR I 1 TO 10 90 READ MS 100 PRINT f1 LINE I M 110 NEXT I 120 PRINT 1 130 CLOSE 1 140 PRINT DATA TRANSMITTED 150 END 155 REM THE DEVICE NAME IS 11 160 DATA 11 170 DATA SERIAL DRIVER DEMO PROGRAM FOR BASIC LANGUAGE 180 DATA THIS MESSAGE IS RECEIVED FROM REMOTE SITE 190 DATA THIS IS LINE 3 200 DATA TRANSMIT OK 210 DATA ABCDEFGHIJKLMNOPQRSTUVWXYZ 220 DATA abcdefghijklmnopqrstuvwxyz 230 DATA THIS DEVICE DRIVER IS VERY EASY TO USE 240 DATA SEE REFERENCE MANUAL FOR MORE INFORMATION DATA COPYRIGHT BY DECISION COMPUTER DATA GOOD LUCK REM SERIAL DRIVER DEMO PROGRAM FOR BASIC LANGUAGE 40 REM THIS PROGRAM WILL RECEIVE MESSAGES 50 REM FROM REMOTE SITE COMPUTER 60 READ 5 70 OPEN 1 1 5 80 INPUT 1 5 90 IF M THEN 120 100 PRINT 5 110 GOTO 80 PROGRAMMING TECHNICAL UNDER MS DOS 34 CLOSE 1 PRINT DATA RECEIVED END REM THE DEVICE NAME IS 11 DATA 11 3 Loopback Test C version include lt stdio h gt include lt stdlib h gt
6. B600 B300 B38400 38400 B19200 19200 B9600 9600 B4800 4800 B2400 2400 B1200 1200 B600 600 B300 300 db int data bits Either CS8 CS7 CS6 55 CS8 8 CS7 7 CS6 6 CS5 5 parity int parity bit Either PNONE PEVEN PODD PNONE 0 PODD 1 PEVEN 2 even parit sb int stop bits Either 511 or 512 PROGRAMMING TECHNICAL UNDER MS DOS 39 STI 1 ST2 2 return value int 0 success 2 comtxch portno ch int comtxch int portno char ch The comtxch is used to send a character to serial port ch char transmitted character return value int 0 success 3 comrxch portno ch int comrxch int portno char ch The comrxch is used to get a character ch char received character return value int EE success fail receive no character 4 comstat portno int comstat int portno The comstat is used to get serial port status the status indicator is shown in the following return value int bit 15 bit 14 transmitter shift register empt bit 13 transmitter holding register empt PROGRAMMING TECHNICAL UNDER MS DOS 40 Y ou may check the parameters to detect which bit is set X0010 X0020 0080 S RDA 8 0X0100 X2000 X4000 S TIMEOUT 0X8000 5 comactive portno int comactive int portno Check if the port is active return value int 0 inactive 6 comsetDTR portno n void comsetDTR int portno n Set DTR signal ON
7. 3 Switch on terminal concentrator SWITCH SETTINGS 9 OFF ON The switch on the terminal concentrator is used to determine whether the power is supported from intelligent adapter When set to on the power source comes from power adapter otherwise when set to off the power source comes from intelligent adapter Please note that if you select power source from intelligent adapter each adapter only support two terminal concentrators If the distance between intelligent and terminal concentrator more than 3m you need use power adapter to avoid lost of data CABLING INFORMATION 10 APPENDIX A CABLING INFORMATION 1 EZ COM with Terminal Concentrator EZ COM with the terminal concentrator provides RS232C interface with DB25 female connectors for each port 20000000 EZCOM 8 port terminal concentrator 2 8 pin mini DIN Connector 8 mini DIN connector with cable is used to connect host and terminal concentrator The signals of the connector is shown in the follows CABLING INFORMATION 11 DB25 Connectors RS232 Type The signal assignments for a standard DB25 connector are shown below Signal Direction Pin Signal Name Name Output Receive Data RxD 6 DataSetReady DSR CC Input 7 SignalGround SG AB Data Terminal Ready DTR 14 25 CABLING INFORMATION 12 A 4 Cable connections RS232 To connect
8. DOS 49 ah register always set to 3h dx register port number return value ax register line status and modem status 5 activate port ah register always set to 4h dx register port number return value bl maximum function number supported 6 set DTR ah register always set to 6h al register 0 tum off DIR dx register port number 7 nondestructive read ahead ah register always set to Ch dx register port number return value 0 if character is available al the read character FFFF if no character is available PROGRAMMING TECHNICAL UNDER MS DOS 50 The character read by this operation is not removed from input queue This means that the same character will be obtained in next read operation 8 set flow control ah register always set to Fh al register enable or disable flow control When set to 1 means enable bit 0 enable disable receiving XON XOFF i enable disable RTS CTS bit 2 should be set to 1 bit 3 enable disable transmitting XON XOFF dx register port number 9 receive block from a port ah register always set to 18h dx register port number cx register length of block es di register starting address of block return value ax register count of received bytes 10 send block to a port ah register always set to 19h dx register port number cx register number of bytes to be sent es di register starting address for received block
9. VERIFY The input format is free format You may exchange any two fields that will not corrupt your setup procedure The default parameters are baud 9600 parity N data 8 stop 1 no 4 d2 3 handshaking XOFF portaddr Specifies which port address is control by PCCOM device driver You may input 3F8 or 2F8 BAUD baud Baud rate You may key in any baud rate the device driver will adjust your baud rate to desire baud rate that the serial port can accept If you key in 65535 baud this means 115200 According to our test The PCCOM device driver can accept up to 115200 baud under 8m cable You need not key in BAUD when baud rate matches the follows 9600 4800 2400 1200 600 300 150 parity parity bit O odd data Data bits 8 eight data bits stop Stop bits two stop bits PC COM VIRTUAL TERMINAL UTILITIES S8 IRQ no Select which interrupt is used The interrupt number must matches the interrupt number of PCCOM COM installation When a character is received from anyone of portadd then the IRQ is emerged which active the corresponding device driver that has the same IRQ specification MCR d2 Select OUT1 and OUT2 signal d2 3 means OUT1 0 and 2 0 d2 7 means OUT 1 1 and OUT2 0 d2 B means OUT 1 0 and OUT2 1 d2 F means OUT1 1 and OUT2 1 handshaking Select software handshaking VERIFY List all setting parameters After serial ports are setup system will check whether the specified
10. port is good if the corresponding port is bad system will prompt to notice user The interrupt setting and port address of standard COMI and COM2 are shown in the following COMI address 3F 8 2 address 2 8 interrupt for COM IRQ4 interrupt for COM2 IRQ3 modem control register B To setup COMI the commands are shown in the following PCCOM 4 SETUP 3F8 MCR B XON VERIFY PC COM VIRTUAL TERMINAL UTILITIES 59 G 4 How to Execute VT EXE After PCCOM and SETUP are executed just run VT to enter virtual terminal evaluation mode The screen you will see is shown below F1 HELP Copyright DECISION COMPUTER You may key in character from keyboard to communicate with host computer or select function to setup communication parameters available function keys are shown in the following HELP When press F1 key system will display functions that you can select S CTRL Press F2 key will send XOFF code to host computer to notice that virtual terminal is too busy When you want set XON to host computer again please press Q CTRL SETUP Setup the communication protocol such as baud rate data bits stop bits etc C CTRL Press F4 key will send C CTRL code to remote computer to kill the executing process LISTCFG VIRTUAL TERMINAL UTILITIES 60 List the communication parameters on the screen SAVECFG Save the setup communication parameters to disk file named VT CFG Download receive
11. 1 PORT PORT value can be 1 to 128 For example dev rwlpall is 1 dev rwlpal2 is 2 dev rwlpa21 is 9 2 COMMAND a GETSEQ PORT Read the PRINT ON OFF control sequence defined on the port For example read the information from port 2 Ipcontrol GETSEQ 2 b SETSEQ PORT PRINTON PRINTOFF Set the PRINT ON OFF control sequence For example if you want set PRINT ON by ESC 5i and PRINT OFF by ESC 4i where ESC is escape code to port 1 you can use Ipcontrol SETSEQ 1 1033 5i 033 4i The default ANSI sequence is set by ESC 5i for PRINT ON and ESC 4i for PRINT OFF 3 SETRATIO PORT RATIO To set the printer speed It defines the ratio time used by the printer on the port It depends on the buffer size and the Speed of the printer Default RATIO is 40 maximum value is 256 If you increase the value you will allocate more time for a slowly printer For example to set port 1 with a ratio of 55 Ipcontrol SETRATIO 1 55 4 GETRATIO PORT To get the current ratio from the PORT H 3 How to Use Transparent Printer If you want to start a printing on the first card first box and the first port you can use the cat command cat filename dev rwlpall TRANSPARENT PRINTING UNDER UNIX 66 You can include the printer inside the printing spooler If you use the name to start a printing you can use lp filename d YP Or LPDEST YP export YP lp filename TECHNICAL REFERENCE INFORMATION 67 APPENDIX TECHNICAL REFERENCE I
12. 4 comsettimeout portno timeout void comsettimeout int portno timeout Set time out timeout int time out number the unit is 1 18 sec 15 comgettimeout portno int comgettimeout int portno Get time out return value int The time out value unit is 1 18 sec 16 comgetbufstat portno int comgetbufstat int portno PROGRAMMING TECHNICAL UNDER MS DOS 43 The comgetbufstat is used to count the received characters in buffer return value int count of received characters in buffer 17 comgetDCD portno int comgetDCD int portno Get DCD signal return value int set OFF 18 comgetDSR portno int comgetDSR int portno Get DSR signal return value int 0 set OFF 19 comgetCTS portno int comgetCTS int portno Get CTS signal retum value int 0 set OFF 20 comgetflow portno n int comgetflow int n To get communication protocol n enable disable hardware software protocol XON XOFF protocol CTS RTS protocol return value int PROGRAMMING TECHNICAL UNDER MS DOS 44 0 success 21 comtxs portno s int comtxs int portno char s The comtxs is used to send one string to serial port it call BIOS for each character 5 char one character string to be sent return value int 0 success 22 5 int comtxs int portno char s The comrxs is used to get one string from ring buffer it call BIOS for each character 5
13. ER MS DOS 32 F 1 How TO USE DEVICE DRIVER 32 Table of Contents ii F 2 EZ COM LIBRARY oe goo tres ne 37 IS SS sm ayaka tate de t ttd esc kawashqa uo 45 F 4 I O CONTROL VIA SOFTWARE 2 0 2 2 0017 46 APPENDIX G PC COM VIRTUAL TERMINAL UTILITIES 54 G 1 VALID CONTROL SEQUENCE OF 54 G 2 EXTENDED GRAPHICS 2 0 000000000000 35 G 3 How To SETUP PC COM DRIVER TO RUN 56 G 4 How TO EXECUTE VT EXE eere eee eee tee 59 G 4 1 DOWNLOAD DATA FROM HOST 60 G 4 2 UPLOAD DATA TO HOST aaa Les exa eoe e Una coax 61 m eret E e tube e added ees 61 GS EXAMPLES uu amina aa l a a S 62 APPENDIX H TRANSPARENT PRINTING UNDER UNIX 64 DEVICE 000000000000000 64 H 2 TRANSPARENT PRINTING CONTROL 64 H 3 How TO USE TRANSPARENT mener 65 APPENDIX I TECHNICAL REFERENCE INFORMATION 67 APPENDIX J IMPORTANT TIBS 68 APPENDIX K WARRANTY INFORMATION
14. EZ COM USER MANUAL 8 4 PORT INTELLIGENT SERIAL ADAPTER amp CONCENTRATOR 00000000 00000001 10000003 imams cmm 7 18 U10229 SSo1durooung Z 121 110929 2110920 dosopy Z IV UI0929 Z UI0229 61 7 ivy ssoudurooung 2 1811110920 sso1durooung LI 2 Tey u10929 2110922 8 dosop NES 4 7 1 LL uoruoAuoour ju AOS woysks Sunvodo XINA XINAN 01 JOAUP Pesur NOA 951401 950914 SOxU STUI 05 61 Oded 1 snp UT Z j uloozo sSoiduroung SASA XIND XINAX 404 EZ USER MANUAL 8 4 PORTS INTELLIGENT SERIAL ADAPTER and CONCENTRATOR Table of Contents i TABLE OF CONTENTS CHAPTER 1 INTRODUCTION 1 CHAPTER 2 UNPACKING INFORMATIDON 4 CHAPTER 3 SYSTEM REQUIREMENITS S CHAPTER 4 HARDWARE INSTALLATION 6 CHAPTER 5 SWITCH SETTINGS 7 5 1 INTRODUCTION ortu alae eal 7 5 2 SELECTION OF SWITCH 8 6 2 5 7 APPENDIX A CABLING IN
15. FORMATIONN 10 EZ COM WITH TERMINAL CONCENTRATOR 10 2 8 PIN MINI DIN 10 DB25 CONNECTORS RS232 2 4 0 0002 1 CABLE CONNECTIONS RS232 2 2 12 CONNECTOR o baro 12 AO RJ 45 CONNECTOR e 13 APPENDIX B NULL MODEM AND MODEM _ 14 B 1 NULL MODEM CONNECTIONS 5232 5 14 B 2 MODEM e eee 15 APPENDIX C SCO XENIX CONFIGURATIONN 16 HARDWARE 55 5 9 959 16 C 2 INSTALLATION FOR SCO 22242 5 555 5 16 APPENDIX D SCO UNIX SYSTEM V AT amp T UNIX SYSTEM V INTERACTIVE UNIX SYSTEM V 18 D 1 HARDWARE 18 D 2 SOFTWARE INSTALL PROCEDURE ccccccecccccceccccsceteeeesecceccccccucseseveseecs 18 APPENDIX E MS DOS CONFIGURATION 21 DEVICE DRIVER 2 0 2 21 E DEVICE 23 E 3 COMMUNICATION PARAMETERS 5 222222 2 7 72000 27 APPENDIX F PROGRAMMING TECHNIQUES UND
16. MINAL UTILITIES 63 The graphics control string is stored in the VT DOC file 1 HELP Copyright DECISION COMPUTER Co Ltd TRANSPARENT PRINTING UNDER UNIX 64 APPENDIX H TRANSPARENT PRINTING UNDER UNIX Under UNIX operating system the command can be used to provide transparent printing function on terminal In the following we will introduce how to use the transparent printing utilities H 1 Device Name The device name of transparent printing on terminal are dev rwlpCBP where C is a letter from a to d corresponds to four adapters B is a number from 1 to 4 corresponds to four terminal concentrator and P is a number from 1 to 8 corresponds to eight ports For example the dev rwlpall is the device name for first card first box first port card number B terminal concentrator number P port number The printing entry is associated with the terminal entry tty so that you can not use stty command to change communication parameter such as baud rate flow control from dev rwlpCBP If you need change communication parameter please use stty to change dev ttyXYZ see appendix D For example you not use stty 9600 dev rwlpall you must use stty 9600 dev ttyall H 2 Transparent printing control The Ipcontrol command is used to control transparent printing its command syntax is defined as TRANSPARENT PRINTING UNDER UNIX 65 COMMAND PORT parameter
17. NFORMATION The technical reference of EZ COM intelligent 8 port card is shown in the distribution diskette you can type the file named RWTECH DOC for more details The specification of FOSSIL driver is also in the FOSSIL DOC file IMPORTANT TIPS 68 APPENDIX J IMPORTANT TIPS For ESDI SCSI users in xenix UNIX system If you use ESDI or SCSI hard disk controller for xenix or UNIX system probably you have the hard disk drivers supplied by manufacturer Please make sure that the ESDI or SCSI device driver files are resident in your system before installing EZ COM intelligent card device driver In xenix system you can check usr sys conf or usr sys io directories for ESDI or SCSI device driver files In UNIX system please check etc conf pack d directory for these files If you can not find these files in your system please contact the ESDI or SCSI controller supplier to get these files WARRANTY INFORMATION 69 APPENDIX K WARRANTY INFORMATION K 1 Copyright Copyright 1993 DECISION COMPUTER INTERNATIONAL CO LTD all rights reserved No part of EZ COM software and manual may be reproduced transmitted transcribed or translated into any language or computer language in any form or by any means electronic mechanical magnetic optical chemical manual or otherwise without the prior written permission of DECISION COMPUTER INTERNATIONAL CO LTD Each piece of EZ COM package permits user to use EZ COM only on a single com
18. aud Baud rate You may key in one of the follows 38400 19200 9600 4800 2400 1200 600 300 parity none parity even parit odd parit MS DOS CONFIGURATION 29 data Data bits 6 six data bits seven data bits 8 eight data bits stop Stop bits handshaking Select software or hardware handshaking VERIFY List all setting parameters The following examples are provided to help clarify the use of the RSETUP command EXAMPLE E 3 1 A RSETUP 5 To setup I O port COMS the default parameters are baud rate 9600 parity N data bits 8 stop bits 1 disable handshaking EXAMPLE E 3 2 A RSETUP 9600 COMS5 4 E 8 2 XONXOF VERIFY To setup port COMS COM6 7 COMS software handshaking protocol is enable baud rate is 9600 parity check is MS DOS CONFIGURATION 30 even data bits 1s 8 stop bits is 2 After I O ports are setup system list all setting parameters E 4 Diagnostic Under MS DOS The RTESTCOM program provides diagnostic routine to test your serial ports under MS DOS operating system To test your serial port under MS DOS please type A RTESTCOM then screen will display as follows EZ COM TEST PROGRAM V2 0 2222222 00000 E 2 2 2 2 E 2 2222222 z x x x COPYRIGHT 1993 DECISION COMPUTER INTERNATIONAL CO LTD wait a moment the screen will display as f
19. bck where is the system prompt 5 AT amp T INTERACTIVE UNIX SYSTEM 19 3 Insert distribution diskette into floppy disk drive A then copy the files from the distribution diskette to root directory doscp 2 ezcom tar z 4 install device drivers please type uncompress ezcom tar z tar xvf ezcom tar amp cd ezcom The setup program will ask you some questions to setup your kernel 5 Reboot the system Now your new UNIX system which includes device drivers is activated 6 Connect each terminal to DB25 connector 1 Under the SCO UNIX if the new system fails to reboot boot the original system using the command unix bck 2 For interactive UNIX when system is fail for boot please press return key to halt autoboot then type unix bck 3 For AT amp T UNIX if system fail to boot please modify AUTOBOOT NO parameter from etc default boot file then type unix bck Please note that before you install your distribution disk you need modify AUTOBOOT parameter 4 To remove driver from unix please type the followings and select uninstall function cd ezcom 5 After installation the system enable each port automatically Under the SCO UNIX you may use disable command to disable your tty port or use enable to enable your tty port To enable tty please type AT amp T INTERACTIVE UNIX SYSTEM 20 enable dev ttyal enabl
20. char the pointer to the receive string return value int 0 success 23 comgetinfo portno baud db parity sb void comgetinfo unsigned int baud int db parity sb The comgetinfo is used to get communication parameters of each port baud unsigned int baud rate db int data bits Either 5 6 7 or 8 data bits PROGRAMMING TECHNICAL UNDER MS DOS 45 parity int parity bit Either NONE EVEN ODD EVEN 2 even parit sb int stop bits Either 1 or 2 stop bits 24 comioctl portno ioctrl void int portno long int ioctrl Extend I O control This function provides SCC protocol ioctrl long int Four bytes command is stored in this field For more details please see the file RWTECH DOC in the distribution diskette F 3 Examples In the distribution disk we provide file transfer and setup program all of these programs use EZ COM library RSETUP C Setup communication parameters RTX C Transfer file RRX C Receive file F 4 V O Control Via Software Interrupt To communicate directly with device drivers the EZ COM provides a set of subfunctions grouped under extended BIOS INT 13H All these functions are included in the EZ COM library however if you want control through BIOS interrupt by yourself you need prepare CPU register contents and fork a PROGRAMMING TECHNICAL UNDER MS DOS 46 system call In the following we will describe these I O cont
21. character ends and another starts Either 1 or 2 stop bits can be specified When stop bits is specified then stop bits are generated or checked in the transmit or receive data respectively XON XOFF XON XOFF is software handshaking which is used to prevent the lost of data while communication between two MS DOS CONFIGURATION 28 serial ports Suppose we connect two computer named local computer and remote computer if local computer is too busy to receive data from remote computer it send XOFF S CTRL whose code is 19 to remote computer to notice he is in busy mode When remote computer receives XOFF it will stop transmission until the local computer sends XON Q CTRL whose code is 17 to continue transmission The same manner is activated at remote computer The syntactic specification of RSETUP is RSETUP devicename baud parity data stop handshaking VERIFY The input format is free format You may exchange any two fields that will not corrupt your setup procedure The default parameters baud 9600 parity N data 8 stop l handshaking disable need not specify devicename Specifies which device is control by RW device driver To specify device name there are two methods 1 one bye one to enter each device name one by one for example COMS COM6 2 2 group to enter several device name by group for example 5 8 means there are COMS COM6 7 COMS 9 10 11 2 b
22. data from host Receive data from the remote site then save these data to a user specified file Upload transmit data to remote site Transfer a user specified file that located at PC which is now run VT to remote site EXIT Exit virtual terminal evaluator SHELL Fork MS DOS shell command interpreter the terminal evaluator is still resident on the main memory When you enter shell command you may run any MS DOS commands and programs because you stay at MS DOS mode To enter VT again please type EXIT G 4 1 Download Data from Host When you select F7 system will ask a file name which is used to save data that sent from remote computer Suppose your virtual terminal is connected to XENIX operating system and you want download a file aa from host to PC and save it in PC DOC file the procedure is cat aa don t enter lt CR gt select F7 PC DOC enter file name PC VIRTUAL TERMINAL UTILITIES 61 G 4 2 Upload Data to Host When you select F8 system will ask a file name and send the file contents to host computer Under XENIX operating system suppose you want send a file PC DOC from PC to host computer and save it in aa file the upload procedure is cat gt aa PC DOC G 4 3 Setup When you select F3 you may modify the communication parameters After communication parameters are setup you may use F6 to save the configuration and F5 to list the configuration When VT 15 loaded it will check VT CFG to load t
23. e 12 To disable tty please type disable dev ttyal 1 disable dev ttyal2 6 To disable and enable tty under AT amp T UNIX and Interactive UNIX please use the entty command to enable your tty port and use the distty command to disable your tty port entty ttyall entty ttyal2 To disable tty please type distty ttyall distty 12 MS DOS CONFIGURATION 21 APPENDIX E MS DOS CONFIGURATION E 1 Device Driver Installation The RW SYS is a device driver for EZ COM intelligent 8 port card Please add the following line DEVICE RW SYS v n32 to your CONFIG SYS file then power off system and install EZ COM intelligent 8 port card before rebooting system Where the option fields are described in the follows Verbose install message such as IRQ buffer size etc Shows the message only quiet mode a n Where n is hexadecimal for segment address default is D000 Under the MS DOS configuration the segment address must be set below 1M address If more than one board are installed repeat this optional switch if more than one boards please set different address n n Where n in the is specified number of ports attached to the system The default value is 8 maximum number is 128 b n Where n is input buffer size unit is byte default value is 512 i n Where n is the IRQ number If more than one boards insert to the system they use common IRQ The defaul
24. e BIOS and I O buffer Jumpers on adapter Determines whether the power of terminal concentrator is provided by adapter Switch on terminal concentrator Determines the power source If more than one adapter are installed please set different segment address and do not conflict with the other adapters such as network card card etc 5 2 Selection of Switch Settings 1 Switch on adapter SWITCH SETTINGS 8 I ON 12345678 The switch is used to determine segment address of on board BIOS I O buffer etc when the corresponding switch is set to off it means 1 otherwise set to on it means 0 SW 8 represents address line A23 SW 7 represents address line A22 etc You may set on and off configuration to the segment address you require The figure shown in the above is 04000 0000 Each adapter occupies 64K bytes to map to the address of host PLEASE CHECK YOUR SYSTEM CONFIGURATION TO AVOID CONFLICT WITH THE OTHER ADAPTER 2 JP1 JP2 JP3 and JP4 The JP2 and are used to determine whether the power is supported from adapter to terminal concentrator When short the jumper the power is supported from adapter otherwise when open the jumper the power of terminal concentrator is supported from extra power adapter JP1 is used to determine the power of the first terminal concentrator and JP2 is used to determine the power of the second terminal concentrator etc
25. erial adapters can be inserted into one computer system total 128 ports are provided Suitable for XENIX UNIX MS DOS IBM PC AT PC 386 PC 486 hardware compatible Only one inexpensive cable line with 8 pin mini DIN connector to replace eight RS232 asynchronous communication cables Maximum transmission distance over 1000 ft 300m Baud rate selectable for each individual port and the maximum 15 38400 Software handshaking XON XOFF hardware handshaking RTS CTS selectable INTRODUCTION 3 9V power adapter for terminal concentrator Corollary 8 4 adapter and 8 tc concentrator compatible Provides transparent printing on terminal EASY COM 8 PORT CONCENTRATOR EASY COM 8 x 4 PORT INTELLIGENT CARD UNPACKING INFORMATION 4 CHAPTER 2 UNPACKING INFORMATION Check that your EZ COM intelligent package includes the following items EZ intelligent adapter EZ COM 8 port terminal concentrator 9V power adapter EZ COM cable line with 8 pin mini DIN connector User manual EZ COM software and device drivers for operating systems Warranty form SYSTEM REQUIREMENT 5 CHAPTER 3 SYSTEM REQUIREMENTS Before installing your EZ COM intelligent serial adapter and 8 port terminal concentrators make sure that The host computer is an IBM PC AT PC 386 PC 486 or compatible The one switch bank and four jumpers of EZ COM adapter and one switch bank of t
26. erminal concentrator are correctly configured to coincide with the operating system you are using If the distance between the adapter and terminal concentrator is more than 3m please use power adapter For short distance the power of each adapter only provides two terminal concentrators HARDWARE INSTALLATION 6 CHAPTER 4 HARDWARE INSTALLATION Your EZ COM intelligent serial adapter is designed to be inserted in any available slot in your PC AT PC 386 PC 486 or compatible In order to gain access to the expansion slots follow the steps listed below 1 Turn off all power to your computer and all peripheral devices before installing your EZ COM intelligent serial adapter Remove the cover of the computer Insert the preconfigured EZ COM intelligent serial adapter into any available slot Make sure the adapter is firmly seated in the chosen slot Replace the cover of the computer Route the cable line with 8 pin mini DIN into both terminal concentrator and intelligent serial adapter Connect peripheral devices connector to terminal concentrator Plug the power cable into wall outlet if needed SWITCH SETTINGS 7 CHAPTER 5 SWITCH SETTINGS 5 1 Introduction The one switch block and four jumpers on the EZ COM adapter and one switch on the terminal concentrator must be configured correctly in accordance with the operating system you are using Switch on adapter Determines the address of th
27. fh amp c 1 y while kbhit 5 Loopback Test PASCAL version program DEMO const device COM5 var i cnt integer a b char f text begin assign f device rewrite f cnt 0 for i 31 to 80 begin cnt cnt 1 a chr i write f a end writeln cnt close f for i 1 to 10000 do assign f device reset f for i 31 to 580 do begin a chr i read f b writeln DATA a 8 b 8 if a b then begin writeln ERROR exit end end close f end PROGRAMMING TECHNICAL UNDER MS DOS 37 F 2 EZ COM Library EZ COM provides C and PASCAL library routines to let user to write application programs to control serial communication via device drivers To write an application program you must link RCOMLIB C or RCOMLIB PAS file according to your selection language In the following we describe the EZ COM library more details setup communication parameters comrxch set DTR signal ON or OFF check next character in queue set flow control comrxblk PROGRAMMING TECHNICAL UNDER MS DOS 38 1 cominit portno baud db parity sb int cominit unsigned int baud int portno db parity sb The cominit is used to setup several communication parameters portno int port number port number defined at MS DOS CONFIGURATION CHAPTER baud unsigned int baud rate Either B38400 B19200 B9600 B4800 B2400 B1200
28. file The configuration file name is RTESTCOM CFG You can use lt RETURN gt key to let RTESTCOM accepts your selection during you execution the RTESTCOM program and press lt ESC gt key to return the last menu PROGRAMMING TECHNICAL UNDER MS DOS 32 APPENDIX F PROGRAMMING TECHNIQUES UNDER MS DOS There are three methods to write application programs to control serial communication 1 Use device driver name to perform 2 Use EZ COM library through DOS interrupt routines 3 Use low level BIOS interrupt routines F 1 How to Use Device Driver After device driver is installed you may use device name such as COMS COM6 etc as a file to perform I O operations Since many high level languages provide several kinds of I O operations e g in C language the write statement for low level and fprintf for high level I O You must care which routine is used by yourself to prevent the lose of I O data if you use high level I O you must use flush to dump buffer contents to serial device when necessary In the following we provide BASIC C and PASCAL examples I Loopback test BASIC version REM OPEN LOGICAL DEVICE 5 OPEN 0 1 COM5 CNT 0 FOR I amp H31 TO amp H80 CNT CNT 1 5 6 PRINT 1 5 PRINT CNT CLOSE 1 FOR I 1 TO 1000 NEXT I OPEN I 2 COM5 FOR I amp H31 TO amp H80 AS CHRS I PROGRAMMING TECHNICAL UNDER MS DOS 33 271 BS INPUTS 1 2
29. h port are shown in the follows 1 es 1 4 7 L i 1 5 8 c I CONi 1 1 u COM 1 2 5 16 1 2 6 17 1 2 19 Cow 24 COM31 CO COM33 COM34 COM35 COM36 COM37 7 COMAS COMS2 COMS3 54 OJO O IO IOO QI IO OOO 30 31 36 38 39 50 51 MS DOS CONFIGURATION e TREE Titi 55 56 57 58 85 MS DOS CONFIGURATION MS DOS CONFIGURATION 6 2 100 101 102 102 103 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 87 88 91 92 93 94 95 97 MS DOS CONFIGURATION 27 129 A 129 0 E 3 Communication Parameters Set Up Before setup communication parameters we describe the communication parameters in the following baud rate The transmit speed between two serial ports parity The parity bit is used in error detection Three different settings are used which are ODD EVEN and NONE parity data bits The number of bits in each transmitted or received serial character Either 7 or 8 data bits can be specified stop bits The stop bits is used to detect where one
30. h speed communication links so that it can connect to four terminal concentrators which only needs to use four inexpensive cables rather than 32 RS232 cables The EZ COM intelligent adapter is particular suited to facilitate the connection of terminals VDUs in multi user operating systems Each package is supplied complete with one terminal concentrator containing eight female DB25 connectors INTRODUCTION 2 If extra concentrators are needed please order the concentrator item The EZ COM intelligent serial board may be installed in any IBM PC AT PC 386 PC 486 or hardware compatible system To accommodate a variety of operating systems the distribution diskettes contains many device drivers for the operating system you need The architecture of EZ COM intelligent package provides the distribution multiprocessor I O system both intelligent serial adapter and terminal concentrator use HIGH intelligent CPU main processor which handles the send and receive functions between the intelligent serial adapter and terminal concentrators it saves the workload of the host computer The features of the EZ COM intelligent package are CPU is provided on both intelligent serial adapter and terminal concentrator Each terminal concentrator contains eight RS232 ports for asynchronous communications Up to four terminal concentrators are connected to one EZ COM serial adapter total 32 ports are provided Up to four EZ COM s
31. he last save configuration automatically The communication parameters are list in the following 1 IRQ number Select which interrupt 2 port number Select which I O port 3 baud rate Select communication speed 4 data bits Select data bits 5 stop bits Select stop bits 6 parity Press SPACE bar to select parity 7 ECHO Press SPACE bar to select local ECHO ON OFF When your host computer has ability to send back the received PC VIRTUAL TERMINAL UTILITIES 62 character you must select local ECHO OFF to let host computer prompt your typing character 8 new line Press SPACE bar to select new line ON OFF VT will add CR code when it receive lt LF gt at new line ON mode 9 delay time Select delay time interval between two transmitting characters when upload is processing G 5 Examples The following control string will draw a figure which is shown in the following Don t forget to press any key to enter text mode lt ESC gt P 100000000000010000000 100100000000010000100 100100001000000000100 100000001000000000000 005000030 P0005200032 005400034 0005600036 005800038 P0006000040 0006200042 006400044 006600046 0006800048 C001000010000050 001000010000040 C001000010000030 C001000010000020 C001000010000010 C001000010000005 C001000010000015 C001000010000025 C001000010000035 C001000010000045 C001000010000055 M0010000100 00030000200 00009000090 o PC VIRTUAL TER
32. nswer IRQ number you need not select IRQ number from hardware however it needs to emerge interrupt from software Please select the different IRQ number for all boards C 2 Installation for SCO XENIX After the hardware configuration is set please install the software drivers The instalation procedure is described as follows 1 Login as a root user 2 Backup system kernel please type cp xenix xenix old where is the system prompt SCO XENIX CONFIGURATION 17 3 Insert distribution diskette labeled SCO XENIX System V into floppy disk drive A then copy the files from the distribution diskette to root directory doscp ezcom tar z To install device drivers please type uncompress ezcom tar z tar xvf ezcom tar amp cd ezcom The setup program will ask you some questions to setup your kernel Reboot the system Now your new XENIX system which includes device drivers is activated Connect each terminal to DB25 connector NOTE If the new system fails to reboot boot the original system using the command xenix old To remove driver from xenix please type the followings and select uninstall function cd ezcom After installation the system each port automatically you may use disable command to disable your tty port or use enable to enable your tty port To enable tty please type enable de
33. ollows EZ COM TEST PROGRAM V2 0 SETUP EXTERNAL LOOP TEST AUTO TEST HEAVY DUTY TEST SAVE CONFIGURATION EXIT PROGRAM COPYRIGHT 1993 DECISION COMPUTER INTERNATIONAL CO LTD 1 SETUP RS232 You may specify communication parameters such as baud rate data bits etc 2 EXTERNAL LOOP TEST MS DOS CONFIGURATION 31 When you select external loop test your typing characters will be sent from one serial port to another serial port Before you select external loop test please connect pin 2 of send port to pin 3 of receiver port and pin 3 of send port to pin 2 of receiver port Since the serial communication is full duplex you can loopback send and received port in one port a Connects two rs232 ports pin 2 TxD RxD pin 3 pin 3 RxD gt TxD pin 2 b Loopback pin 2 TxD pin 3 RxD 3 AUTO TEST When you select auto test the RTESTCOM will test your serial port automatically External loop test is used to check the selected port sending character are read from README DOC file 4 HEAVY DUTY TEST When you select heavy duty test the diagnostic program will test your serial ports in a long period The program set variable baud rate and variable block size to test your serial card In the meanwhile the screen will display the statistical analysis reports 5 SAVE CONFIGURATION Save communication parameters to disk When RTESTCOM is loaded it will load the preconfiguration from disk
34. or OFF n int 7 compeek portno int compeek int portno The compeek is used to perform nondestructively read a character The read character remains in the receive buffer return value int OXFFFF PROGRAMMING TECHNICAL UNDER MS DOS 41 8 comsetflow portno n void comsetflow int portno n To set communication protocol n int i F_XONXOF 0X09 F RTSCTS 0X01 set CTS RTS protocol 9 comtxblk portno pointer n int int portno n void far pointer To transmit a block of data it uses one BIOS call to transmit a block of data pointer pointer pointer to start of block n int block length return value int number of characters be sent 10 comrxblk portno pointer n int comrxblk int portno n void far pointer To receive a block of data it uses one BIOS call to receive a block of data pointer pointer pointer to start of block n int number of characters should be received return value int number of characters actually received 11 combreak portno brk void combreak PROGRAMMING TECHNICAL UNDER MS DOS 42 int portno brk Send the break signal to driver unbreak the communication 12 cominstalled portno int cominstalled int portno Check if the driver is installed return value int 0 not installed 13 comsetRTS portno n void comsetRTS int portno n Set RTS signal ON or OFF n unsigned int ACTIVE 1 set RTS ON INACTIVE 0 set RTS OFF 1
35. puter a registered user may use the program on a different computer but may not use the program on more than one computer at the same time Corporate licensing agreements allow duplication and distribution of specific number of copies within the licensed institution Duplication of multiple copies is not allowed except through execution of a licensing agreement Welcome call for details K 2 Warranty Information EZ COM warrants that for a period of one year from the date of purchase unless otherwise specified the warranty card that the goods supplied will perform according to the specifications defined in the user manual Furthermore that the EZ COM product will be supplied free from defects in materials and workmanship and be fully functional under normal usage WARRANTY INFORMATION 70 In the event of the failure of a EZ COM product within the specified warranty period EZ will at its option replace or repair the item at no additional charge This limited warranty does not cover damage resulting from incorrect use electrical interference accident or modification of the product goods returned for warranty repair must have the serial number intact Goods without serial numbers attached will not be covered by the warranty Transportation costs for goods returned must be paid by the purchaser Repaired goods will be dispatched at the expense of EZ COM To ensure that your EZ COM product is covered by the war
36. ranty provisions it is necessary that you return the Warranty card Under this Limited Warranty EZ obligations will be limited to repair or replacement only of goods found to be defective as specified above during the warranty period EZ COM is not liable to the purchaser for any damages or losses of any kind through the use of or inability to use the EZ COM product EZ COM reserves the right to determine what constitutes warranty repair or replacement Return Authorization It is necessary that any returned goods are clearly marked with an RA number that has been issued by EZ COM Goods returned without this authorization will not be attended to NO 8 NO 449 0000 00040 NO ONILLAS HOLIMS WOO ASW I AAS 0000 00020 t b y I AAS 0000 000 0
37. rol functions and teach users to use it All functions are designed as a FOSSIL driver The specification of FOSSIL driver is shown in the FOSSIL DOC file of distribution diskette Before you perform system call you must specify subfunction number in ah register ah description _____ block write break begin or end 1 set up communication parameters ah register always set to Oh al register al is used to setup communication parameters bit 7 6 5 setup stop bits PROGRAMMING TECHNICAL UNDER MS DOS 47 bit contents dx register port number return value ax register bit 15 to bit 8 line status bit 7 to bit 0 modem status bit 15 bit 14 transmitter shift register empt PROGRAMMING TECHNICAL UNDER MS DOS bit 13 transmitter holding register emp EGRE bite 1 aes clear to send 2 send a character ah register always set to 1h al register character dx register port number return value ax register line status and modem status 3 receive a character ah register always set to 2h al register received character dx register port number return value line status al receive character 4 get port status bs ot ON oO d c2 et c 48 PROGRAMMING TECHNICAL UNDER MS
38. t value is 11 decimal c n MS DOS CONFIGURATION 22 Determines the device driver name start from which number The default value is 5 It means the device driver name start from COMS COM6 7 etc p n Determines the start port number for BIOS The default value is 4 NORMALLY DO NOT USE THIS FIELD the port number will be defined by device driver automatically it depends on driver name specified If you select driver name start from COM5 then the port number is set to 4 if you select driver name start from COM6 then it was set to 5 t n Determine time out The default value is 3 seconds The default values of each option field are summary in the follows default value v 0 q Fase O d D000 hexadecimal 1 The default communication parameters for each port Suppose you have two boards installed in the computer system and one occupies D000 one occupies A000 segment E MS DOS CONFIGURATION 23 address the number of ports are 64 then in the configuration file you must specify as DEVICE RW SYS v aD000 aA000 n64 E 2 Device Name After device driver is installed the device name is registered by MS DOS user may use device name as a file to open write read or use commands to specify I O redirection easily For example type rsetup c gt COMS5 Suppose in the RW SYS setting we set c 5 and p 4 then the device name correspond to eac
39. the 8 port from terminal concentrator to other DATA TERMINAL EQUIPMENT DTE devices we recommend using a DTE to DTE connection as shown below DTE DTE Signal Pin Pin Signal GND eI GND TxD 3 RxD RxD 2 TxD DTR 20 76 DSR DSR 6 o DTR SG SG DCD 2 RTS RTS iW 5 CTS CTS 3 8 DCD A 5 RJ 11 Connector An optional DB25 to RJ 11 module jack is provided for each RS232 port The signal assignment of RJ 11 are shown in the follows Signal Ground Data Set Read CABLING INFORMATION 13 1 2 3 4 5 6 6 RJ 45 Connector An optional DB25 to RJ 45 module jack is provided for each RS232 port The signal assignment of RJ 45 are shown in the follows Eom T Clear to Send Data Set Read 1 2 3 4 5 6 7 8 NULL MODEM AND MODEM CABLE 14 APPENDIX B NULL MODEM AND MODEM CABLE B 1 Null Modem Connections RS232 If the software supplier or operating system does not specify a particular cable configuration we recommend you use the following null modem cable when XON XOFF is utilized Host Remote Signal Pin Pin Signal GND 15 GND TxD 2 3 RxD RxD 3 2 TxD DTR 20 20 DTR pu Ds DCD 8 8 DCD RTS 4 4 RTS crs 5 Ds SG SSS SG If hardware handshaking is necessary use the following cable Host Remote Signal Pin Pin Signal GND 1 1 GND TxD 1 RxD RxD 3 2 TxD DTR 20 6 DSR DSR 64
40. v ttyal 1 enable dev ttyal 2 To disable tty please type disable dev ttyall disable dev ttyal2 SCO AT amp T INTERACTIVE UNIX SYSTEM 18 APPENDIX D SCO UNIX SYSTEM V AT amp T UNIX SYSTEM V INTERACTIVE INIX SYSTEM V Release 3 2 4 0 CONFIGURATION D 1 Hardware Configuration Before insert the EZ COM adapter into computer slot please determine the on board segment address You may select range from A0000 to D0000 which below IM address also select above 1M address range from C00000 to EFFFFF Each board occupies 64K bytes memory and do not forget select different address for more than one board device name is dev ttyXYZ where X is a letter from a to d corresponds to four adapters Y is a number from 1 to 4 corresponds to four terminal concentrator of adapter and Z is a number from 1 to 8 corresponds to eight ports For example the dev ttya36 is the port 6 of the third terminal concentrator of the first adapter The MODEM device name is dev ttyA36 During the software installation you must answer IRQ number you need not select IRQ number from hardware however it needs to emerge interrupt from software Please select the different IRQ number for all boards D 2 Software Install Procedure After the hardware configuration is set please install the software drivers The installation procedure is described as follows 1 Login as a root user 2 Backup system kernel please type cp unix unix
Download Pdf Manuals
Related Search