0001 =============================================================
0002 MOXA Smartio/Industio Family Device Driver Installation Guide
0003 =============================================================
0004
0005 Copyright (C) 2008, Moxa Inc.
0006 Copyright (C) 2021, Jiri Slaby
0007
0008 .. Content
0009
0010 1. Introduction
0011 2. System Requirement
0012 3. Installation
0013 3.1 Hardware installation
0014 3.2 Device naming convention
0015 4. Utilities
0016 5. Setserial
0017 6. Troubleshooting
0018
0019 1. Introduction
0020 ^^^^^^^^^^^^^^^
0021
0022 The Smartio/Industio/UPCI family Linux driver supports following multiport
0023 boards:
0024
0025 - 2 ports multiport board
0026 CP-102U, CP-102UL, CP-102UF
0027 CP-132U-I, CP-132UL,
0028 CP-132, CP-132I, CP132S, CP-132IS,
0029 (CP-102, CP-102S)
0030
0031 - 4 ports multiport board
0032 CP-104EL,
0033 CP-104UL, CP-104JU,
0034 CP-134U, CP-134U-I,
0035 C104H/PCI, C104HS/PCI,
0036 CP-114, CP-114I, CP-114S, CP-114IS, CP-114UL,
0037 (C114HI, CT-114I),
0038 POS-104UL,
0039 CB-114,
0040 CB-134I
0041
0042 - 8 ports multiport board
0043 CP-118EL, CP-168EL,
0044 CP-118U, CP-168U,
0045 C168H/PCI,
0046 CB-108
0047
0048 If a compatibility problem occurs, please contact Moxa at
0049 support@moxa.com.tw.
0050
0051 In addition to device driver, useful utilities are also provided in this
0052 version. They are:
0053
0054 - msdiag
0055 Diagnostic program for displaying installed Moxa
0056 Smartio/Industio boards.
0057 - msmon
0058 Monitor program to observe data count and line status signals.
0059 - msterm A simple terminal program which is useful in testing serial
0060 ports.
0061
0062 All the drivers and utilities are published in form of source code under
0063 GNU General Public License in this version. Please refer to GNU General
0064 Public License announcement in each source code file for more detail.
0065
0066 In Moxa's Web sites, you may always find the latest driver at
0067 https://www.moxa.com/.
0068
0069 This version of driver can be installed as a Loadable Module (Module driver)
0070 or built-in into kernel (Static driver). Before you install the driver,
0071 please refer to hardware installation procedure in the User's Manual.
0072
0073 We assume the user should be familiar with following documents:
0074
0075 - Serial-HOWTO
0076 - Kernel-HOWTO
0077
0078 2. System Requirement
0079 ^^^^^^^^^^^^^^^^^^^^^
0080
0081 - Maximum 4 boards can be installed in combination
0082
0083 3. Installation
0084 ^^^^^^^^^^^^^^^
0085
0086 3.1 Hardware installation
0087 =========================
0088
0089 PCI/UPCI board
0090 --------------
0091
0092 You may need to adjust IRQ usage in BIOS to avoid IRQ conflict with other
0093 ISA devices. Please refer to hardware installation procedure in User's
0094 Manual in advance.
0095
0096 PCI IRQ Sharing
0097 ---------------
0098
0099 Each port within the same multiport board shares the same IRQ. Up to
0100 4 Moxa Smartio/Industio PCI Family multiport boards can be installed
0101 together on one system and they can share the same IRQ.
0102
0103
0104
0105 3.2 Device naming convention
0106 ============================
0107
0108 The device node is named "ttyMxx".
0109
0110 Device naming when more than 2 boards installed
0111 -----------------------------------------------
0112
0113 Naming convention for each Smartio/Industio multiport board is
0114 pre-defined as below.
0115
0116 ============ ===============
0117 Board Num. Device node
0118 1st board ttyM0 - ttyM7
0119 2nd board ttyM8 - ttyM15
0120 3rd board ttyM16 - ttyM23
0121 4th board ttyM24 - ttyM31
0122 ============ ===============
0123
0124 4. Utilities
0125 ^^^^^^^^^^^^
0126
0127 There are 3 utilities contained in this driver. They are msdiag, msmon and
0128 msterm. These 3 utilities are released in form of source code. They should
0129 be compiled into executable file and copied into /usr/bin.
0130
0131 msdiag - Diagnostic
0132 ===================
0133
0134 This utility provides the function to display what Moxa Smartio/Industio
0135 board was found by the driver in the system.
0136
0137 msmon - Port Monitoring
0138 =======================
0139
0140 This utility gives the user a quick view about all the MOXA ports'
0141 activities. One can easily learn each port's total received/transmitted
0142 (Rx/Tx) character count since the time when the monitoring is started.
0143
0144 Rx/Tx throughputs per second are also reported in interval basis (e.g.
0145 the last 5 seconds) and in average basis (since the time the monitoring
0146 is started). You can reset all ports' count by <HOME> key. <+> <->
0147 (plus/minus) keys to change the displaying time interval. Press <ENTER>
0148 on the port, that cursor stay, to view the port's communication
0149 parameters, signal status, and input/output queue.
0150
0151 msterm - Terminal Emulation
0152 ===========================
0153
0154 This utility provides data sending and receiving ability of all tty ports,
0155 especially for MOXA ports. It is quite useful for testing simple
0156 application, for example, sending AT command to a modem connected to the
0157 port or used as a terminal for login purpose. Note that this is only a
0158 dumb terminal emulation without handling full screen operation.
0159
0160 5. Setserial
0161 ^^^^^^^^^^^^
0162
0163 Supported Setserial parameters are listed as below.
0164
0165 ============== =============================================================
0166 uart set UART type(16450 --> disable FIFO, 16550A --> enable FIFO)
0167 close_delay set the amount of time (in 1/100 of a second) that DTR
0168 should be kept low while being closed.
0169 closing_wait set the amount of time (in 1/100 of a second) that the
0170 serial port should wait for data to be drained while
0171 being closed, before the receiver is disabled.
0172 spd_hi Use 57.6kb when the application requests 38.4kb.
0173 spd_vhi Use 115.2kb when the application requests 38.4kb.
0174 spd_shi Use 230.4kb when the application requests 38.4kb.
0175 spd_warp Use 460.8kb when the application requests 38.4kb.
0176 spd_normal Use 38.4kb when the application requests 38.4kb.
0177 spd_cust Use the custom divisor to set the speed when the
0178 application requests 38.4kb.
0179 divisor This option sets the custom division.
0180 baud_base This option sets the base baud rate.
0181 ============== =============================================================
0182
0183 6. Troubleshooting
0184 ^^^^^^^^^^^^^^^^^^
0185
0186 The boot time error messages and solutions are stated as clearly as
0187 possible. If all the possible solutions fail, please contact our technical
0188 support team to get more help.
0189
0190
0191 Error msg:
0192 More than 4 Moxa Smartio/Industio family boards found. Fifth board
0193 and after are ignored.
0194
0195 Solution:
0196 To avoid this problem, please unplug fifth and after board, because Moxa
0197 driver supports up to 4 boards.
