1 ============================================== 1 =============================================================
2 MOXA Smartio/Industio Family Device Driver Ins 2 MOXA Smartio/Industio Family Device Driver Installation Guide
3 ============================================== 3 =============================================================
4 4
5 Copyright (C) 2008, Moxa Inc. 5 Copyright (C) 2008, Moxa Inc.
6 Copyright (C) 2021, Jiri Slaby 6 Copyright (C) 2021, Jiri Slaby
7 7
8 .. Content 8 .. Content
9 9
10 1. Introduction 10 1. Introduction
11 2. System Requirement 11 2. System Requirement
12 3. Installation 12 3. Installation
13 3.1 Hardware installation 13 3.1 Hardware installation
14 3.2 Device naming convention 14 3.2 Device naming convention
15 4. Utilities 15 4. Utilities
16 5. Setserial 16 5. Setserial
17 6. Troubleshooting 17 6. Troubleshooting
18 18
19 1. Introduction 19 1. Introduction
20 ^^^^^^^^^^^^^^^ 20 ^^^^^^^^^^^^^^^
21 21
22 The Smartio/Industio/UPCI family Linux driv 22 The Smartio/Industio/UPCI family Linux driver supports following multiport
23 boards: 23 boards:
24 24
25 - 2 ports multiport board 25 - 2 ports multiport board
26 CP-102U, CP-102UL, CP-102UF 26 CP-102U, CP-102UL, CP-102UF
27 CP-132U-I, CP-132UL, 27 CP-132U-I, CP-132UL,
28 CP-132, CP-132I, CP132S, CP-132IS, 28 CP-132, CP-132I, CP132S, CP-132IS,
29 (CP-102, CP-102S) 29 (CP-102, CP-102S)
30 30
31 - 4 ports multiport board 31 - 4 ports multiport board
32 CP-104EL, 32 CP-104EL,
33 CP-104UL, CP-104JU, 33 CP-104UL, CP-104JU,
34 CP-134U, CP-134U-I, 34 CP-134U, CP-134U-I,
35 C104H/PCI, C104HS/PCI, 35 C104H/PCI, C104HS/PCI,
36 CP-114, CP-114I, CP-114S, CP-114IS, CP 36 CP-114, CP-114I, CP-114S, CP-114IS, CP-114UL,
37 (C114HI, CT-114I), 37 (C114HI, CT-114I),
38 POS-104UL, 38 POS-104UL,
39 CB-114, 39 CB-114,
40 CB-134I 40 CB-134I
41 41
42 - 8 ports multiport board 42 - 8 ports multiport board
43 CP-118EL, CP-168EL, 43 CP-118EL, CP-168EL,
44 CP-118U, CP-168U, 44 CP-118U, CP-168U,
45 C168H/PCI, 45 C168H/PCI,
46 CB-108 46 CB-108
47 47
48 If a compatibility problem occurs, please c 48 If a compatibility problem occurs, please contact Moxa at
49 support@moxa.com.tw. 49 support@moxa.com.tw.
50 50
51 In addition to device driver, useful utilit 51 In addition to device driver, useful utilities are also provided in this
52 version. They are: 52 version. They are:
53 53
54 - msdiag 54 - msdiag
55 Diagnostic program for displa 55 Diagnostic program for displaying installed Moxa
56 Smartio/Industio boards. 56 Smartio/Industio boards.
57 - msmon 57 - msmon
58 Monitor program to observe da 58 Monitor program to observe data count and line status signals.
59 - msterm A simple terminal program whi 59 - msterm A simple terminal program which is useful in testing serial
60 ports. 60 ports.
61 61
62 All the drivers and utilities are published 62 All the drivers and utilities are published in form of source code under
63 GNU General Public License in this version. 63 GNU General Public License in this version. Please refer to GNU General
64 Public License announcement in each source 64 Public License announcement in each source code file for more detail.
65 65
66 In Moxa's Web sites, you may always find th 66 In Moxa's Web sites, you may always find the latest driver at
67 https://www.moxa.com/. 67 https://www.moxa.com/.
68 68
69 This version of driver can be installed as 69 This version of driver can be installed as a Loadable Module (Module driver)
70 or built-in into kernel (Static driver). Be 70 or built-in into kernel (Static driver). Before you install the driver,
71 please refer to hardware installation proce 71 please refer to hardware installation procedure in the User's Manual.
72 72
73 We assume the user should be familiar with 73 We assume the user should be familiar with following documents:
74 74
75 - Serial-HOWTO 75 - Serial-HOWTO
76 - Kernel-HOWTO 76 - Kernel-HOWTO
77 77
78 2. System Requirement 78 2. System Requirement
79 ^^^^^^^^^^^^^^^^^^^^^ 79 ^^^^^^^^^^^^^^^^^^^^^
80 80
81 - Maximum 4 boards can be installed in comb 81 - Maximum 4 boards can be installed in combination
82 82
83 3. Installation 83 3. Installation
84 ^^^^^^^^^^^^^^^ 84 ^^^^^^^^^^^^^^^
85 85
86 3.1 Hardware installation 86 3.1 Hardware installation
87 ========================= 87 =========================
88 88
89 PCI/UPCI board 89 PCI/UPCI board
90 -------------- 90 --------------
91 91
92 You may need to adjust IRQ usage in BIOS to 92 You may need to adjust IRQ usage in BIOS to avoid IRQ conflict with other
93 ISA devices. Please refer to hardware insta 93 ISA devices. Please refer to hardware installation procedure in User's
94 Manual in advance. 94 Manual in advance.
95 95
96 PCI IRQ Sharing 96 PCI IRQ Sharing
97 --------------- 97 ---------------
98 98
99 Each port within the same multiport board s 99 Each port within the same multiport board shares the same IRQ. Up to
100 4 Moxa Smartio/Industio PCI Family multipor 100 4 Moxa Smartio/Industio PCI Family multiport boards can be installed
101 together on one system and they can share t 101 together on one system and they can share the same IRQ.
102 102
103 103
104 104
105 3.2 Device naming convention 105 3.2 Device naming convention
106 ============================ 106 ============================
107 107
108 The device node is named "ttyMxx". 108 The device node is named "ttyMxx".
109 109
110 Device naming when more than 2 boards installe 110 Device naming when more than 2 boards installed
111 ---------------------------------------------- 111 -----------------------------------------------
112 112
113 Naming convention for each Smartio/Industio 113 Naming convention for each Smartio/Industio multiport board is
114 pre-defined as below. 114 pre-defined as below.
115 115
116 ============ =============== 116 ============ ===============
117 Board Num. Device node 117 Board Num. Device node
118 1st board ttyM0 - ttyM7 118 1st board ttyM0 - ttyM7
119 2nd board ttyM8 - ttyM15 119 2nd board ttyM8 - ttyM15
120 3rd board ttyM16 - ttyM23 120 3rd board ttyM16 - ttyM23
121 4th board ttyM24 - ttyM31 121 4th board ttyM24 - ttyM31
122 ============ =============== 122 ============ ===============
123 123
124 4. Utilities 124 4. Utilities
125 ^^^^^^^^^^^^ 125 ^^^^^^^^^^^^
126 126
127 There are 3 utilities contained in this dri 127 There are 3 utilities contained in this driver. They are msdiag, msmon and
128 msterm. These 3 utilities are released in f 128 msterm. These 3 utilities are released in form of source code. They should
129 be compiled into executable file and copied 129 be compiled into executable file and copied into /usr/bin.
130 130
131 msdiag - Diagnostic 131 msdiag - Diagnostic
132 =================== 132 ===================
133 133
134 This utility provides the function to displ 134 This utility provides the function to display what Moxa Smartio/Industio
135 board was found by the driver in the system 135 board was found by the driver in the system.
136 136
137 msmon - Port Monitoring 137 msmon - Port Monitoring
138 ======================= 138 =======================
139 139
140 This utility gives the user a quick view ab 140 This utility gives the user a quick view about all the MOXA ports'
141 activities. One can easily learn each port' 141 activities. One can easily learn each port's total received/transmitted
142 (Rx/Tx) character count since the time when 142 (Rx/Tx) character count since the time when the monitoring is started.
143 143
144 Rx/Tx throughputs per second are also repor 144 Rx/Tx throughputs per second are also reported in interval basis (e.g.
145 the last 5 seconds) and in average basis (s 145 the last 5 seconds) and in average basis (since the time the monitoring
146 is started). You can reset all ports' count 146 is started). You can reset all ports' count by <HOME> key. <+> <->
147 (plus/minus) keys to change the displaying 147 (plus/minus) keys to change the displaying time interval. Press <ENTER>
148 on the port, that cursor stay, to view the 148 on the port, that cursor stay, to view the port's communication
149 parameters, signal status, and input/output 149 parameters, signal status, and input/output queue.
150 150
151 msterm - Terminal Emulation 151 msterm - Terminal Emulation
152 =========================== 152 ===========================
153 153
154 This utility provides data sending and rece 154 This utility provides data sending and receiving ability of all tty ports,
155 especially for MOXA ports. It is quite usef 155 especially for MOXA ports. It is quite useful for testing simple
156 application, for example, sending AT comman 156 application, for example, sending AT command to a modem connected to the
157 port or used as a terminal for login purpos 157 port or used as a terminal for login purpose. Note that this is only a
158 dumb terminal emulation without handling fu 158 dumb terminal emulation without handling full screen operation.
159 159
160 5. Setserial 160 5. Setserial
161 ^^^^^^^^^^^^ 161 ^^^^^^^^^^^^
162 162
163 Supported Setserial parameters are listed a 163 Supported Setserial parameters are listed as below.
164 164
165 ============== ============================ 165 ============== =============================================================
166 uart set UART type(16450 --> disa 166 uart set UART type(16450 --> disable FIFO, 16550A --> enable FIFO)
167 close_delay set the amount of time (in 1 167 close_delay set the amount of time (in 1/100 of a second) that DTR
168 should be kept low while bei 168 should be kept low while being closed.
169 closing_wait set the amount of time (in 1 169 closing_wait set the amount of time (in 1/100 of a second) that the
170 serial port should wait for 170 serial port should wait for data to be drained while
171 being closed, before the rec 171 being closed, before the receiver is disabled.
172 spd_hi Use 57.6kb when the applicat 172 spd_hi Use 57.6kb when the application requests 38.4kb.
173 spd_vhi Use 115.2kb when the applica 173 spd_vhi Use 115.2kb when the application requests 38.4kb.
174 spd_shi Use 230.4kb when the applica 174 spd_shi Use 230.4kb when the application requests 38.4kb.
175 spd_warp Use 460.8kb when the applica 175 spd_warp Use 460.8kb when the application requests 38.4kb.
176 spd_normal Use 38.4kb when the applicat 176 spd_normal Use 38.4kb when the application requests 38.4kb.
177 spd_cust Use the custom divisor to se 177 spd_cust Use the custom divisor to set the speed when the
178 application requests 38.4kb. 178 application requests 38.4kb.
179 divisor This option sets the custom 179 divisor This option sets the custom division.
180 baud_base This option sets the base ba 180 baud_base This option sets the base baud rate.
181 ============== ============================ 181 ============== =============================================================
182 182
183 6. Troubleshooting 183 6. Troubleshooting
184 ^^^^^^^^^^^^^^^^^^ 184 ^^^^^^^^^^^^^^^^^^
185 185
186 The boot time error messages and solutions 186 The boot time error messages and solutions are stated as clearly as
187 possible. If all the possible solutions fai 187 possible. If all the possible solutions fail, please contact our technical
188 support team to get more help. 188 support team to get more help.
189 189
190 190
191 Error msg: 191 Error msg:
192 More than 4 Moxa Smartio/Industi 192 More than 4 Moxa Smartio/Industio family boards found. Fifth board
193 and after are ignored. 193 and after are ignored.
194 194
195 Solution: 195 Solution:
196 To avoid this problem, please unplug fifth 196 To avoid this problem, please unplug fifth and after board, because Moxa
197 driver supports up to 4 boards. 197 driver supports up to 4 boards.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.