| ============================================================= | |
| MOXA Smartio/Industio Family Device Driver Installation Guide | |
| ============================================================= | |
| Copyright (C) 2008, Moxa Inc. | |
| Copyright (C) 2021, Jiri Slaby | |
| .. Content | |
| 1. Introduction | |
| 2. System Requirement | |
| 3. Installation | |
| 3.1 Hardware installation | |
| 3.2 Device naming convention | |
| 4. Utilities | |
| 5. Setserial | |
| 6. Troubleshooting | |
| 1. Introduction | |
| ^^^^^^^^^^^^^^^ | |
| The Smartio/Industio/UPCI family Linux driver supports following multiport | |
| boards: | |
| - 2 ports multiport board | |
| CP-102U, CP-102UL, CP-102UF | |
| CP-132U-I, CP-132UL, | |
| CP-132, CP-132I, CP132S, CP-132IS, | |
| (CP-102, CP-102S) | |
| - 4 ports multiport board | |
| CP-104EL, | |
| CP-104UL, CP-104JU, | |
| CP-134U, CP-134U-I, | |
| C104H/PCI, C104HS/PCI, | |
| CP-114, CP-114I, CP-114S, CP-114IS, CP-114UL, | |
| (C114HI, CT-114I), | |
| POS-104UL, | |
| CB-114, | |
| CB-134I | |
| - 8 ports multiport board | |
| CP-118EL, CP-168EL, | |
| CP-118U, CP-168U, | |
| C168H/PCI, | |
| CB-108 | |
| If a compatibility problem occurs, please contact Moxa at | |
| support@moxa.com.tw. | |
| In addition to device driver, useful utilities are also provided in this | |
| version. They are: | |
| - msdiag | |
| Diagnostic program for displaying installed Moxa | |
| Smartio/Industio boards. | |
| - msmon | |
| Monitor program to observe data count and line status signals. | |
| - msterm A simple terminal program which is useful in testing serial | |
| ports. | |
| All the drivers 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 Moxa's Web sites, you may always find the latest driver at | |
| https://www.moxa.com/. | |
| This version of driver can be installed as a Loadable Module (Module driver) | |
| or built-in into kernel (Static driver). Before you install the driver, | |
| please refer to hardware installation procedure in the User's Manual. | |
| We assume the user should be familiar with following documents: | |
| - Serial-HOWTO | |
| - Kernel-HOWTO | |
| 2. System Requirement | |
| ^^^^^^^^^^^^^^^^^^^^^ | |
| - Maximum 4 boards can be installed in combination | |
| 3. Installation | |
| ^^^^^^^^^^^^^^^ | |
| 3.1 Hardware installation | |
| ========================= | |
| PCI/UPCI board | |
| -------------- | |
| You may need to adjust IRQ usage in BIOS to avoid IRQ conflict with other | |
| ISA devices. Please refer to hardware installation procedure in User's | |
| Manual in advance. | |
| PCI IRQ Sharing | |
| --------------- | |
| Each port within the same multiport board shares the same IRQ. Up to | |
| 4 Moxa Smartio/Industio PCI Family multiport boards can be installed | |
| together on one system and they can share the same IRQ. | |
| 3.2 Device naming convention | |
| ============================ | |
| The device node is named "ttyMxx". | |
| Device naming when more than 2 boards installed | |
| ----------------------------------------------- | |
| Naming convention for each Smartio/Industio multiport board is | |
| pre-defined as below. | |
| ============ =============== | |
| Board Num. Device node | |
| 1st board ttyM0 - ttyM7 | |
| 2nd board ttyM8 - ttyM15 | |
| 3rd board ttyM16 - ttyM23 | |
| 4th board ttyM24 - ttyM31 | |
| ============ =============== | |
| 4. Utilities | |
| ^^^^^^^^^^^^ | |
| There are 3 utilities contained in this driver. They are msdiag, msmon and | |
| msterm. These 3 utilities are released in form of source code. They should | |
| be compiled into executable file and copied into /usr/bin. | |
| msdiag - Diagnostic | |
| =================== | |
| This utility provides the function to display what Moxa Smartio/Industio | |
| board was found by the driver in the system. | |
| msmon - 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. | |
| msterm - 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 disabled. | |
| spd_hi Use 57.6kb when the application requests 38.4kb. | |
| spd_vhi Use 115.2kb when the application requests 38.4kb. | |
| spd_shi Use 230.4kb when the application requests 38.4kb. | |
| spd_warp Use 460.8kb when the application requests 38.4kb. | |
| spd_normal Use 38.4kb when the application requests 38.4kb. | |
| spd_cust Use the custom divisor to set the speed when the | |
| application requests 38.4kb. | |
| divisor This option sets the custom division. | |
| baud_base This option sets the base baud rate. | |
| ============== ============================================================= | |
| 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 Smartio/Industio 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. |