README

=============================================================================
     ADVANTECH Industial Comunication Cards Setup Tool, Ver. 1.0
			Installation Guide
		    for Linux Kernel 2.0.xx 2.3.xx 
	       Copyright (C) 2000, ADVANTECH Co, Ltd.
=============================================================================
Contents

1. Introduction
2. System Requirement
3. Installation
4. Utilities
5. Troubleshooting

-----------------------------------------------------------------------------
1. Introduction
   
   ADVANTECH industial comunication cards device setup tool, Ver. 1.0,
   supports following multiport boards.
    
    - PCL-740: 			    1 port ISA  multiport board.
    - PCL-741, PCL-743/745 :	    2 port ISA  multiport board. 
    - PCL-846/847,PCL-746+,PCL-849: 4 port PCI  multiport board.
    - PCL-858:		            8 port PCI  multiport board.
	 
   This tool supports Linux Kernel 2.0.x to 2.3.x,  
   Any problem occurs, please contact ADVANTECH at 
   support@ADVANTECH.com.tw.

   In addition to Setup tool, useful utilities are also provided in this
   version. They are
    - pclterm  A Advantech's simple terminal program which is useful in testing 
		serial ports . ftp://ftp.advantech.com
    - setserial(ver 2.7)  A new system tool,can be used to get/set serial 
		ports infomations.

   This tool and utilities are published in form of source code under
   GNU General Public License in this version. Please refer to GNU General
   Public License announcement in each source code file for more detail.

   In ADVANTECH's ftp sites, you may always find latest tool at
   ftp://ftp.ADVANTECH.com  or ftp://ftp.ADVANTECH.com.tw.

   This devie scrip  can be used when system bootup, it will set up 
   Advantech ISA industial comunication card.

-----------------------------------------------------------------------------
2. System Requirement
   - Kernel version: 2.0.x to 2.3.x
   - Kernel serial  or serial module support.
   - Application Setserial(All linux release  include) 
   - Any number boards can be installed in combination

-----------------------------------------------------------------------------
3. Installation

   3.1 Hardware installation

       Just pulg the comunication cards into any unused slot.
	(Device number for the card in the linux system will be assigned 
	according to the slot number. )
     
   3.2 Setup files and device naming convention

       The driver file may be obtained from ftp, CD-ROM or floppy disk. The
       first step, anyway, is to copy driver file "pcl.icom.tar" into specified
       directory. e.g. /pcl. The execute commands as below.

       # cd /pcl
       # tar -xvf pcl.icom.tar
      
      
       Dialin and callout port
       -----------------------
       This driver remains traditiona serial device properties. There're
       two special file name for each serial port. One is dial-in port
       which is named "ttySxx". For callout port, the naming convention
       is "cuaxx".

       Device name
       -----------------------------------------------
       Naming convention for each PCL multiport board 
       ttyS0 ----- ttyS3    reserved for system use
       ttyS4 ----- ttyS127  each corresponding a serial port

       cua0  ----- cua3     reserved for system use
       cua4  ----- cua127   each corresponding a serial port.

   3.3 Setup communication card configuration
       PCL comunication card is easiest way to install. 

       1. Find "Makefile" in /pcl/pcl.icom/tool/, then run
          # make

	  The setup tool files "pcl.icom"  will be properly compiled
	  
	    Then run:

	  # ./pcl.icom

	  This will setup pcl comunication card and generate a scrip
	  pcl.icom.isa . 
  
 
       2. Create device files by executing "pclmknod".
	  # cd /pcl/pcl.icom/tool/
	  # ./pclmknod

	  if you system have few ttyS device ,you must built some:
		 
	  Default major numbers for dial-in device and callout device are
	  4, 5. pclmknod will delete any special files occuping the same
	  device naming.

	  warning: reserved four  serial device number  for serial port 
		   build-in mainboard.
	 		
       3. Set serial  resource of serial support
	 Then run:
          # ./pcl.icom.isa

       4. test Card
	  # cd /pcl/pcl.icom/untility
	  # cd /pclterm
	  # make 
          # make install
	  # pclterm
	 	  
-----------------------------------------------------------------------------
4. Utilities
   There are 2 utilities ships with this driver. They are pclterm and
   setserial.  These utilities are released in form of source code. 
   They should  be compiled into executable file and copied into /usr/bin.
   
   
   pclterm - Terminal Emulation
   ---------------------------
   This utility provides data sending and receiving ability of all tty ports,
   especially for ADVANTECH communication ports. It is quite useful for testing
   application, for example, sending AT command to a modem connected to the
   port or used as a terminal for login purpose. Note that this is only a
   dumb terminal emulation without handling full screen operation.
   for detail please reference htp://htp/advantech.com
   Run:
   # cd /pcl/pclicom/utility/pclterm
   # make
   # make install
   # pclterm
    
   Setserial
   ---------
   Supported Setserial parameters are listed as below.

   uart 	  set UART type(16450,16550,16550a,16650,1650v2,16554,16750
				16850,16950/16954)
   close_delay	  set the amount of time(in 1/100 of a second) that DTR
		  should be kept low while being closed.
   closing_wait   set the amount of time(in 1/100 of a second) that the
		  serial port should wait for data to be drained while
		  being closed, before the receiver is disable.
   spd_hi	  Use  57.6kb  when  the application requests 38.4kb.
   spd_vhi	  Use  115.2kb	when  the application requests 38.4kb.
   spd_normal	  Use  38.4kb  when  the application requests 38.4kb.
   Run:
   #cd /pcl/pclicom/utility/setserial-2.17
   #./configure
   # make
   # make install  
-----------------------------------------------------------------------------
5. Troubleshooting