summaryrefslogtreecommitdiffstats
path: root/Documentation/driver-api/serial
diff options
context:
space:
mode:
authorJiri Slaby <jslaby@suse.cz>2022-04-11 13:01:41 +0200
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>2022-04-14 18:24:24 +0200
commit5b437ae9fcbb22fe6de3c715534515209207a092 (patch)
tree6749af7f37e24a81c3b45a677ef34439a6b9d303 /Documentation/driver-api/serial
parente26595034dada8a1e6c10f0e0187f43edec72698 (diff)
downloadlinux-stable-5b437ae9fcbb22fe6de3c715534515209207a092.tar.gz
linux-stable-5b437ae9fcbb22fe6de3c715534515209207a092.tar.bz2
linux-stable-5b437ae9fcbb22fe6de3c715534515209207a092.zip
Documentation: tty: move moxa-smartio.rst to tty
It is a tty_driver, not serial -- uart_driver. So move it to the tty docs dir too. (The same as the driver itself.) Signed-off-by: Jiri Slaby <jslaby@suse.cz> Link: https://lore.kernel.org/r/20220411110143.10019-5-jslaby@suse.cz Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Diffstat (limited to 'Documentation/driver-api/serial')
-rw-r--r--Documentation/driver-api/serial/index.rst1
-rw-r--r--Documentation/driver-api/serial/moxa-smartio.rst197
2 files changed, 0 insertions, 198 deletions
diff --git a/Documentation/driver-api/serial/index.rst b/Documentation/driver-api/serial/index.rst
index 4ebdb86cd6b6..03a55b987a1d 100644
--- a/Documentation/driver-api/serial/index.rst
+++ b/Documentation/driver-api/serial/index.rst
@@ -16,7 +16,6 @@ Serial drivers
.. toctree::
:maxdepth: 1
- moxa-smartio
serial-iso7816
serial-rs485
diff --git a/Documentation/driver-api/serial/moxa-smartio.rst b/Documentation/driver-api/serial/moxa-smartio.rst
deleted file mode 100644
index af25bc5cc3e6..000000000000
--- a/Documentation/driver-api/serial/moxa-smartio.rst
+++ /dev/null
@@ -1,197 +0,0 @@
-=============================================================
-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.