-
Notifications
You must be signed in to change notification settings - Fork 9
/
readme.txt
262 lines (207 loc) · 9.71 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
=============================================================================
MOXA UPort 11x0 USB to Serial Hub Family Driver Installation Guide
for Linux Kernel 2.6.x
Copyright (C) 2012, Moxa Inc.
=============================================================================
Date: 07/13/2012
CONTENTS
0. Note
1. Introduction
2. System Requirements
3. Installation
3.1 Driver files
3.2 Device naming convention
3.3 Module driver configuration
3.4 Static driver configuration
3.5 Verify driver installation
4. Setserial
5. Troubleshooting
-----------------------------------------------------------------------------
0. Note
The Moxa UPort 11x0 USB to Serial Hub driver can be used in the Linux
kernel with the usbcore and usbserial modules. This two modules is
built-in module in the Linux kernel version 2.6.x and follow. In the
Linux kernel version, you must check this two build-in modules existed.
Otherwise, you will fail to using MOXA UPort 11x0 USB to Serial Hub driver.
-----------------------------------------------------------------------------
1. Introduction
The MOXA UPort 11x0 USB to Serial Hub Linux driver supports following
devices.
- UPort 1110, 1 port RS-232 USB to Serial Hub.
- UPort 1130, 1 port RS-422/485 USB to Serial Hub.
- UPort 1130I, 1 port RS-422/485 USB to Serial Hub with isolation
protection.
- UPort 1150, 1 port RS-232/422/485 USB to Serial Hub.
- UPort 1150I, 1 port RS-232/422/485 USB to Serial Hub with isolation
protection.
This driver supports x86 and x64(AMD64/EM64T) hardware platform. In
order to maintain compatibility, this version has also been properly
tested with several Linux distribution (see version.txt). However,
if compatibility problem occurs, please contact Moxa Technologies
technical support. (support@moxa.com)
All the drivers 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.
This version of driver can be only installed as Loadable Module (Module
driver). Before you install the driver, please refer to hardware installation
procedure in the User's Manual.
-----------------------------------------------------------------------------
2. System Requirements
- Hardware platform: x86, x64
- Kernel version: 2.6.x
- gcc version 3.x
- kernel source
-----------------------------------------------------------------------------
3. Installation
3.1 Driver files
3.2 Device naming convention
3.3 Module driver configuration
3.4 Static driver configuration
3.5 Verify driver installation
3.1 Driver files
The driver file may be obtained from CD-ROM or floppy disk.
The first step, is to copy driver file
"driv_linux_uport1p_v1.x_build_xx.tgz" into specified
directory. e.g. /moxa. The execute commands as below.
# cd /
# mkdir moxa
# cd /moxa
# cp /dev/fd0/driv_linux_uport1p_v1.x_build_xx.tgz
# tar xvfz driv_linux_uport1p_v1.x_build_xx.tgz
or
# cd /
# mkdir moxa
# cd /moxa
# cp /mnt/cdrom/<driver directory>/driv_linux_uport1p_v1.x_build_xx.tgz
# tar xvfz driv_linux_uport1p_v1.x_build_xx.tgz
3.2 Device naming convention
You may find all the driver files in /<driver directory>/mxu11x0/.
Following installation procedure depends on the model you'd like to
run the driver.
Dialin and callout port
-----------------------
This driver remains traditional serial device properties. Because the
limitation of the usb build-in modules that are usbcore and usbserial,
There is only one special file name for each serial port. This one is
dial-in port which is named "ttyUSBxx".
3.3 Module driver configuration
3.3.1 Build the MOXA driver
Before using the MOXA driver, you need compile the all the source
code. This step is only need to be executed once.
But you still re-compile the source code if you modify the source
code.
Find "Makefile" in /moxa/mxu11x0/driver, then run
# make clean; make install
The driver files "mxu11x0.ko" will be properly compiled
and copied to system directories respectively.
3.3.2 Load the MOXA driver
The driver will be loaded automatically while pluging the
UPort 1110/1130/1130I/1150/1150I into you PC. Besides, you can load
the driver manually.
# modprobe mxu11x0
It will activate the module driver. You may run "lsmod" to check
if "mxu11x0" is activated. Before you load this module driver, you
have to run "lsmod" to check if "usbcore" and "usbserial" are
activated.
3.4 Static driver configuration
Note: To use static driver, you must install the linux kernel
source package.
3.4.1 Create link
# cd /usr/src/<kernel-source directory>/drivers/usb/serial/
# ln -s /moxa/mxu11x0/driver/mxu11x0.c mxu11x0.c
# ln -s /moxa/mxu11x0/driver/mxu11x0.h mxu11x0.h
# ln -s /moxa/mxu11x0/driver/mxu1110_fw.h mxu1110_fw.h
# ln -s /moxa/mxu11x0/driver/mxu1130_fw.h mxu1130_fw.h
# ln -s /moxa/mxu11x0/driver/mxu1131_fw.h mxu1131_fw.h
# ln -s /moxa/mxu11x0/driver/mxu1150_fw.h mxu1150_fw.h
# ln -s /moxa/mxu11x0/driver/mxu1151_fw.h mxu1151_fw.h
3.4.2 Modify kernel configuration file.
Add the following line into configuration file.
/usr/src/<kernel-source directory>/drivers/usb/serial/Kconfig
...
config USB_SERIAL_CONSOLE
...
config USB_SERIAL_GENERIC
...
config MOXA_UPORT_11X0 <-- Add the lines.
tristate "USB Moxa UPort 11x0 Driver" <--
depends on USB_SERIAL <--
...
3.4.3 Modify the kernel Makefile
Add the following line to the last line of Makefile.
/usr/src/<kernel-source directory>/drviers/usb/serial/Makefile
...
...
...
obj-$(CONFIG_MOXA_UPORT_11X0) += mxu11x0.o <-- Add the line.
3.4.4 Setup kernel configuration
Configure the kernel:
# cd /usr/src/<kernel-source directory>
# make menuconfig
You will go into a menu-driven system. Please select [Device Drivers]
[USB Support], [USB Serial Converter support], enable both the
[USB Serial Converter support] and the [USB MOXA UPORT 11x0 Driver]
drivers with "[*]" by pressing space bar for built-in (not "[M]"),
then select [Exit] to exit this program and save kernel
configurations.
3.4.5 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/<kernel-source directory>
b. make
c. make modules
d. make modules_install
e. make install
3.5 Verify driver installation
You may refer to /var/log/messages to check the latest status
log reported by this driver whenever it's activated or type command
"dmesg" to get driver information.
-----------------------------------------------------------------------------
4. Setserial
NOTE: To use the setserial tools, you have to install it first.
The setserial is a free software, you can download it on
http://sourceforge.net/projects/setserial/ .
MOXA UPort 1130/1130I provides three interfaces(RS-485 2W, RS-485 4W, RS-422)
and UPort 1150/1150I provides four interfaces(RS-232, RS-485 2W, RS-485 4W,
RS-422). If you want to switch different interface, you can execute the
setserial command to set the port's interface. The supported parameter is
listed below.
parameter value interface
port 0 RS-232
1 RS-485 2W
2 RS-422
3 RS-485 4W
For example:
To set the port's informations:
# setserial /dev/ttyUSB0 port 1
To get the port's informations:
# setserial -G /dev/ttyUSB0
-----------------------------------------------------------------------------
5. Limitation
1. Max. ports
If you want to install more than one UPort USB serial Hub, the best
way is to connect to USB port directly. In lab test, four USB ports
with four UPort 1110/1130/1130I/1150/1150I still work very well. If we
connect to USB hub, the throughput will be dropped down. To get good
performance,please connecting UPort 1110/1130/1150/1150I to USB port
directly .
2. Compile error
To build Moxa driver, it needs kernel header files. If you got
some compile error, please run "rpm -qa | grep kernel" to check
whether the kernel-source package is installed properly. If not,
please get the kernel-source irpm package and run "rpm -ivh <pacakge>"
to install. You also need to make sure the build tool is ready,
including make/gcc/lib. Please see Linux relative document to
get more information.
3. Probe error
The UPort 1110/1130/1130I/1150/1150I needs firmware downloaded after
attaching to PC. Hence, the driver will reset the
UPort 1110/1130/1130I/1150/1150I after downloading firmware and probe the
UPort 1110/1130/1130I/1150/1150I again.After that, the
UPort 1110/1130/1130I/1150/1150I will attach to the /dev/ttyUSBxx.
Therefore, the message "mxusb:probe of x-x:x.x failed with error -5"
will show only once before successfully installing the device. You may
refer to /dev/ttyUSBxx to see if the UPort 1110/1130/1130I/1150/1150I
is set correctly.
-----------------------------------------------------------------------------