readme.txt

moxa多串口卡linux下的驱动源码

	  a. # cd /moxa/mxdrv/driver
	     # vi moxa.c
	     
	  b. Find the array "moxa_isa_board_conf".
	     Change the memory bank and port number within this array
	     using vi. For example, to driver C218Turbo and C320Turbo
	     (16ports) ISA boards with memory bank 0xC8000 and 0xDC000 
	     as 1st and 2nd board. Just to change the source code as 
	     follows.

	     static moxa_isa_board_conf moxa_ida_boards[]={
	      {MOXA_BOARD_C218_ISA,8,0xC8000},
	      {MOXA_BOARD_C320_ISA,16,0xDC000},
	      0, 0
	     };
	     

       3.5.6 Setup kernel configuration
          Configure the kernel:
          
            # cd /usr/src/linux
            # make menuconfig
            
          You will go into a menu-driven system. Please select [Character
          devices][Non-standard serial port support], enable the [Moxa 
          IntellIO support] driver with "[*]" for built-in (not "[M]"), then
          select [Exit] to exit this program. 
          
       3.5.7 Rebuild kernel
	  The following are for Linux kernel rebuilding, for your 
          reference only.
	  For appropriate details, please refer to the Linux document.

	   a. cd /usr/src/linux
	   b. make clean		     /* take a few minutes */
	   c. make dep			     /* take a few minutes */
	   d. make bzImage		     /* take probably 10-20 minutes */
	   e. Please make sure the boot kernel (vmlinuz) is in the
	      correct position. 
	   f. If you use 'lilo' utility, you should check /etc/lilo.conf 
	      'image' item specified the path which is the 'vmlinuz' path, 
	      or you will load wrong (or old) boot kernel image (vmlinuz).
	      After checking /etc/lilo.conf, please run "lilo".

	  Note that if the result of "make bzImage" is ERROR, then you have to
	  go back to Linux configuration Setup. Type "make menuconfig" in 
          directory /usr/src/linux.

	  
       3.5.8 Configure rc file
	  Run following command for setting rc files.

	  # cd /moxa/mxdrv/driver
	  # cp ./rc.moxa /etc/rc.d
	  # cd /etc/rc.d

	  Check "rc.serial" exist or not. If "rc.serial" doesn't exist, 
	  create it by vi, run "chmod 755 rc.serial" to change the permission.
	  Add "/etc/rc.d/rc.moxa" in last line, 
     

       3.5.9 Reboot

   
   
   3.6 Static driver configuration for Linux kernel 2.0.3x, and 
       2.2.14 before.
       
       Note: To use static driver, you must install the linux kernel
             source package.

       3.6.1 Create link
	  # cd /usr/src/linux/drivers/char
	  # ln -s /moxa/mxdrv/driver/moxa.c moxa.c

       3.6.2 Copy files and make tools
	  # cd /usr/lib
	  # mkdir moxa
	  # cd /moxa/mxdrv/driver
          # make; make moxaload
          
	  # cp *.cod /usr/lib/moxa
	  # cp moxaload /usr/lib/moxa
	  # cp mxmknod /usr/lib/moxa
	  
	  # cd /moxa/mxdrv/utility
	  # make clean; make install

       3.6.3 Create special file
	  # cd /usr/lib/moxa
	  # ./mxmknod

       3.6.4 Add memory bank and port number list for ISA boards. 
          In module mode, the memory bank and port number for ISA board 
          is given by parameter. In static driver configuration, you'll 
          have to assign it within driver's source code. If you will 
          not install any ISA boards, you may skip to next portion 
          "Modify tty_io.c". The instructions to modify driver source 
          code are as below

	  a. # cd /moxa/mxdrv/driver
	     # vi moxa.c
	     
	  b. Find the array "moxa_isa_board_conf".
	     Change the memory bank and port number within this array
	     using vi. For example, to driver C218Turbo and C320Turbo
	     (16ports) ISA boards with memory bank 0xC8000 and 0xDC000 
	     as 1st and 2nd board. Just to change the source code as 
	     follows.

	     static moxa_isa_board_conf moxa_ida_boards[]={
	      {MOXA_BOARD_C218_ISA,8,0xC8000},
	      {MOXA_BOARD_C320_ISA,16,0xDC000},
	      0, 0
	     };
	     

       3.6.5 Modify tty_io.c
	  # cd /usr/src/linux/drivers/char/
	  # vi tty_io.c
	    Find pty_init(), insert "moxa_init()" as

	    pty_init();
	    moxa_init();

       3.6.6 Modify tty.h
	  # cd /usr/src/linux/include/linux
	  # vi tty.h
	    Find extern int tty_init(void), insert "moxa_init()" as

	    extern int tty_init(void);
	    extern int moxa_init(void);

       3.6.7 Modify Makefile
	  # cd /usr/src/linux/drivers/char
	  # vi Makefile
	    Find "L_OBJS := tty_io.o ...... random.o", add
	    "moxa.o" at last of this line as
	    L_OBJS := tty_io.o ....... moxa.o

       3.6.8 Rebuild kernel
	  The following are for Linux kernel rebuilding, for your 
          reference only.
	  For appropriate details, please refer to the Linux document.

	   a. cd /usr/src/linux
	   b. make clean		     /* take a few minutes */
	   c. make dep			     /* take a few minutes */
	   d. make bzImage		     /* take probably 10-20 minutes */
	   e. Please make sure the boot kernel (vmlinuz) is in the
	      correct position. 
	   f. If you use 'lilo' utility, you should check /etc/lilo.conf 
	      'image' item specified the path which is the 'vmlinuz' path, 
	      or you will load wrong (or old) boot kernel image (vmlinuz).
	      After checking /etc/lilo.conf, please run "lilo".

	  Note that if the result of "make bzImage" is ERROR, then you have to
	  go back to Linux configuration Setup. Type "make menuconfig" in 
          directory /usr/src/linux.

       3.6.9 Configure rc file
	  Run following command for setting rc files.

	  # cd /moxa/mxdrv/driver
	  # cp ./rc.moxa /etc/rc.d
	  # cd /etc/rc.d

	  Check "rc.serial" exist or not. If "rc.serial" doesn't exist, 
	  create it by vi, run "chmod 755 rc.serial" to change the permission.
	  Add "/etc/rc.d/rc.moxa" in last line, 
	  
       3.6.10 Reboot



   3.7 Custom configuration

       Although this driver already provides you default configuration, you
       still can change the device name and major number. The instruction to
       change these parameters are shown as below.

       Change Device name
       ------------------
       If you'd like to use other device names instead of default naming
       convention, all you have to do is to modify the internal code
       within the shell script "mxmknod". First, you have to open "mxmknod"
       by vi. Locate each line contains "tty[A-D]" and "tty[a-d]" and change
       them to the device name you desired. "mxmknod" creates the device names
       you need next time executed.

       Change Major number
       -------------------
       If major number 31 and 37 had been occupied, you may have to select
       2 free major numbers for this driver. There are 3 steps to change
       major numbers.

       3.7.1 Find free major numbers
	  In /proc/devices, you may find all the major numbers occupied
	  in the system. Please select 2 major numbers that are available.
	  e.g. 40, 45.
       3.7.2 Create special files
	  Run /moxa/mxdrv/driver/mxmknod to create special files with
	  specified major numbers.
       3.7.3 Modify driver with new major number
	  Run vi to open /moxa/mxdrv/driver/moxa.c. Locate the line
	  contains "MOXAMAJOR". Change the content as below.
	  #define	  MOXAMAJOR		 40
	  #define	  MOXACUMAJOR		 45
       3.7.4 Run "make clean; make install" in /moxa/mxdrv/driver.

   3.8 Verify driver installation

       You may refer to /var/log/messages to check the latest status log
       reported by this driver whenever it's activated.


-----------------------------------------------------------------------------
4. Utilities
   There are 3 utilities contained in this driver. They are mxdiag, mxmon and
   mxterm. These 3 utilities are released in form of source code. They should
   be compiled into executable file and copied into /usr/bin.

   mxdiag - Diagnostic
   --------------------
   This utility provides the function to display what Moxa Intellio multiport
   board exists in the system.

   mxmon - Port Monitoring
   -----------------------
   This utility gives the user a quick view about all the MOXA ports'
   activities. One can easily learn each port's total received/transmitted
   (Rx/Tx) character count since the time when the monitoring is started.
   Rx/Tx throughputs per second are also reported in interval basis (e.g.
   the last 5 seconds) and in average basis (since the time the monitoring
   is started). You can reset all ports' count by <HOME> key. <+> <->
   (plus/minus) keys to change the displaying time interval. Press <ENTER>
   on the port, that cursor stay, to view the port's communication
   parameters, signal status, and input/output queue.

   mxterm - Terminal Emulation
   ---------------------------
   This utility provides data sending and receiving ability of all tty ports,
   especially for MOXA ports. It is quite useful for testing simple
   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.
-----------------------------------------------------------------------------
5. Setserial

   Supported Setserial parameters are listed as below.

   uart 	  set UART type(16450-->disable FIFO, 16550A-->enable FIFO)
   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.

-----------------------------------------------------------------------------
6. Troubleshooting

   The boot time error messages and solutions are stated as clearly as
   possible. If all the possible solutions fail, please contact our technical
   support team to get more help.

   Error msg: More than 4 Moxa Intellio family boards found. Fifth board and
	      after are ignored.
   Solution:
   To avoid this problem, please unplug fifth and after board, because Moxa
   driver supports up to 4 boards.

   Error msg: Couldn't install MOXA Intellio family driver!
   Solution:
   Load Moxa driver fail, the major number may conflict with other devices.
   Please refer to previous section 3.5 to change a free major number for
   Moxa driver.

   Error msg: Couldn't install MOXA Intellio family callout driver!
   Solution:
   Load Moxa callout driver fail, the callout device major number may
   conflict with other devices. Please refer to previous section 3.5 to
   change a free callout device major number for Moxa driver.

   Error msg: ERROR! open /dev/moxa failure.
   Solution:
   The special files for MOXA ports haven't been created. Please run
   "mxmknod" to create special files.

   Error msg: WARNING! MOXA Cxxx(0xXXXXX) MemBank conflict.
   Solution:
   More than two MOXA boards attempt to use the same memory bank. Please
   check driver configuration and make sure each MOXA board has an unique
   memory bank. Usually, this happens to ISA board.

   Error msg: WARNING! MOXA Cxxx(0xXXXXX) not found.
   Solution:
   This problem usually happens to ISA board. There are three major reasons.
   a. The DIP switch for memory bank configuration is not identical to
      the setting in driver.
   b. Check if the board is properly plugged into ISA/EISA bus slot.
   c. Try the Memory Banks other than C800H,CC00H. Some mother board BIOS may
      occupy these memory areas.

   Error msg: ERROR! Firmware file(xxxx.cod) not found.
   Solution:
   Can't find firmware files(xxxx.cod). Please make sure the firmware files
   have been copied into /usr/lib/moxa.

   Error msg: ERROR! MOXA Cxxx(0xXXXXX) download firmware failure.
   Solution:
   For MOXA ISA Boards:
   a. The memory address for the board is conflicting with the BIOS shadow
      RAM or cache. Please release this base address from BIOS or change
      another memory bank.
   b. The memory address you select for the MOXA board conflicts with
      other interface boards such as SCSI board with the same memory
      address. Please adjust the memory address for either boards.

   For MOXA PCI Boards:
      The board is not properly plugged in the system or the board is
      malfunctioning.

   Error msg: ERROR! MOXA C320Turbo(0xXXXXX) CPU/Basic module not found.
   Solution:
   a. The CPU/Basic Module and UART/Extensive modules are powered off.
      Check that the connection cable between the CPU/Basic Module and
      Control Board is correct and firmly plugged in on both sides.
      Make sure power switch on CPU/Basic Module is on.
   b. Refer to User's Manual for more hardware troubleshooting procedure.

   Error msg: ERROR! MOXA C320Turbo(0xXXXXX) CPU/Basic Module download fail.
   Solution:
   a. The CPU/Basic Module and UART/Extensive modules are powered off.
      Check that the connection cable between the CPU/Basic Module and
      Control Board is correct and firmly plugged in on both sides.
      Make sure power switch on CPU/Basic Module is on.
   b. Refer to User's Manual for more hardware troubleshooting procedure.

   Error msg: ERROR! MOXA Cxxx(0xXXXXX) UART module not found.
   Solution:
   a.Make sure that all UART module(s) is(are) fastened properly.

-----------------------------------------------------------------------------
7. Programming
   Please refer to Serial-Programming-HOWTO to get complete information.