📄 readme.txt
字号:
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.5.6 Setup kernel configuration
Configure the kernel:
# cd /usr/src/linux
# make menuconfig
You will go into a menu-driven system. Please enable [Character
devices][Non-standard serial port support] with "[*]", enable the
[Moxa Intellio support] driver with "[*]" for built-in (not "[M]")
, then select [Exit][Save] 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
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 "/usr/lib/moxa/moxaload -y" 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 clean; 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 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.7 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.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
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 "/usr/lib/moxa/moxaload -y" 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.
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -