git: 342e9f2f305d - main - puc.4: Cleanup

Go to: [ bottom of page ] [ top of archives ] [ this month ]
From: Warner Losh <imp_at_FreeBSD.org>
Date: Wed, 11 Jun 2025 23:37:31 UTC
The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=342e9f2f305ddccbb7e7a58ddf1f428d8ab00ba1

commit 342e9f2f305ddccbb7e7a58ddf1f428d8ab00ba1
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-05-05 18:30:29 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2025-06-11 23:37:01 +0000

    puc.4: Cleanup
    
    + Alphabetize and condense supported hardware.
    + Mention PCI/PCIe where applicable.
    + Move hardware support file to FILES
    + Tag spdx
    
    MFC after:      3 days
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/1692
    Closes: https://github.com/freebsd/freebsd-src/pull/1692
---
 share/man/man4/puc.4 | 321 +++++++++++++++------------------------------------
 1 file changed, 90 insertions(+), 231 deletions(-)

diff --git a/share/man/man4/puc.4 b/share/man/man4/puc.4
index 6fde07548e18..a29376d3f2d5 100644
--- a/share/man/man4/puc.4
+++ b/share/man/man4/puc.4
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2002 John Hay.
 .\" All rights reserved.
 .\"
@@ -22,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd May 5, 2025
+.Dd June 11, 2025
 .Dt PUC 4
 .Os
 .Sh NAME
@@ -44,159 +47,112 @@ PCI multi-port serial and parallel adapters to the
 and
 .Xr ppc 4
 driver.
-.Pp
-The list of supported devices is in
-.Pa sys/dev/puc/pucdata.c .
-Support for new cards should be added there.
 .Sh HARDWARE
 The
 .Nm
 driver supports the following
-PCI multi-port serial and parallel adapters:
+PCI/PCIe multi-port serial and parallel adapters:
 .Pp
 .Bl -bullet -compact
 .It
-Sunix SUN1889
-.It
-HP Diva Serial [GSP] Multiport UART:
-.Bl -dash -compact
+Advantech 2-port PCI PCI-1602/1603 Rev A/B1
 .It
-Tosca Console
-.It
-Tosca Secondary
-.It
-Maestro SP2
+Applied Micro Circuits PCI 8 Port UART
 .It
-Superdome Console
+Avlab Technology PCI IO 2S
 .It
-Keystone SP2
+Avlab Low Profile PCI 4 Serial
 .It
-Everest SP2
-.El
+Boca Research PCI Turbo Serial 658/654
 .It
-VScom:
+Brainboxes:
 .Bl -dash -compact
 .It
-PCI-200, PCI-400, and PCI-800
-.El
+Instashield PCIe IX-400, IX-200, IX-100
 .It
-Boca Research Turbo Serial:
-.Bl -dash -compact
+Instashield PCI IS-400, IS-200
 .It
-654 and 658
-.El
+PX Series PCIe RS232/RS422/RS485/LPT
 .It
-Dolphin Peripherals:
-.Bl -dash -compact
+UC Series Universal PCI RS232/RS422/RS485/LPT
 .It
-4014 and 4035
+UP Series PCI Dual RS232
 .El
 .It
-Applied Micro Circuits 8 Port UART
-.It
-Digi Neo:
-.Bl -dash -compact
+Comtrol RocketPort 550 PCI 16/8/4 port
 .It
-PCI 4 and 8 Port
+Decision Computer PCCOM PCI 8/4/2 port
 .It
-PCIe 4 and 8 Port (with and without RJ45)
-.El
+Digi Neo PCIe 4 and 8 Port (with and without RJ45)
 .It
-Comtrol RocketPort:
-.Bl -dash -compact
-550/4 Normal and RJ45
+Digi Neo PCI 4 and 8 Port
 .It
-550/8 Normal, RJ11 and Octa
+Dolphin Peripherals PCI 4035/4014
 .It
-550/16
-.El
-.It
-IBM SurePOS 300 Series (481033H) serial ports
-.It
-SIIG Cyber Series of UART and parallel port boars:
+Exar:
 .Bl -dash -compact
 .It
-Cyber 2S and 2SP1 PCI 16550
-.It
-Cyber 4 PCI 16550
-.It
-Cyber 4S PCI 16C650 (20x family)
-.It
-Cyber I/O PCI (10x family and 20x family):
+XR17C/D152
 .It
-Cyber Parallel Dual PCI (10x family and 20x family):
+XR17C154
 .It
-Cyber Serial Dual PCI (10x family and 20x family):
+XR17C158
 .It
-Cyber 2S1P PCI (10x family and 20x family):
+XR17V258IV
 .It
-Cyber 4S PCI (10x family and 20x family):
+XR17V352
 .It
-PS8000 8S PCI 16C650 (20x family)
+XR17V354
 .It
-Quartet Serial 850
+XR17V358
 .El
 .It
-Brainboxes:
-.Bl -dash -compact
+Feasso PCI FPP-02 2S1P
 .It
-PX-101
+HP Diva Serial [GSP] Multiport UART:
+.Bl -dash -compact
 .It
-PX-246, PX-257, PX-260, PX-279
+Tosca Console
 .It
-PX-310, PX-313, PX-320, PX-346, PX-368
+Tosca Secondary
 .It
-PX-420, PX-431, PX-475
+Maestro SP2
 .It
-PX-803, PX-820, PX-831, PX-846, PX-857
+Superdome Console
 .It
-UC-101
+Keystone SP2
 .It
-UC-203, UC-253, UC-257, UC-260, UC-268, UC-279
+Everest SP2
+.El
 .It
-UC-302, UC-310, UC-313, UC-346, UC-357, UC-368
+I-O DATA RSA-PCI2/R
 .It
-UC-414, UC-420, UC-431, UC-475
+IBM SurePOS 300 Series (481033H) serial ports
 .It
-UC-607
+IC Book Labs:
+.Bl -dash -compact
 .It
-UC-836
+Dreadnought x16 Pro/Lite
 .It
-UP-189
+Ironclad x8 Pro
 .It
-UP-200
+Gunboat x4 Pro/Lite/Low Profile
 .It
-UP-869, UP-880
+Gunboat x2 Low Profile
 .El
 .It
-Intashield:
-.Bl -dash -compact
-.It
-IS-200, IS-400
-.It
-IX-100, IX-200, IX-400
-.El
+Kuroutoshikou SERIAL4P-LPPCI2
 .It
-Quatech:
+Lava Computers:
 .Bl -dash -compact
 .It
-DSC-100
-.It
-DSC-200/300
-.It
-DSCLP-100
-.It
-DSCLP-200/300
-.It
-ESC-100D
+Dual Serial PCI
 .It
-ESC-100M
+Quattro-PCIe
 .It
-QSC-100
-.It
-QSC-200/300
+Quattro-PCI
 .It
-QSCLP-100
+Octopus-550 PCI
 .El
 .It
 Moxa Technologies:
@@ -216,7 +172,7 @@ Smartio CP-104EL/PCIe
 .It
 Smartio CP-104EL-A/PCIe
 .It
-CP-112UL
+CP-112UL PCI
 .It
 Industio CP-114
 .It
@@ -233,47 +189,13 @@ CP-168EL/PCIe
 Smartio CP-168EL-A/PCIe
 .El
 .It
-Exar:
-.Bl -dash -compact
-.It
-XR17C/D152
-.It
-XR17C154
-.It
-XR17C158
-.It
-XR17V258IV
-.It
-XR17V352
-.It
-XR17V354
-.It
-XR17V358
-.El
-.It
-Advantech
-.Bl -dash -compact
-.It
-PCI-1602 Rev A
-.It
-2-port PCI (PCI-1602 Rev B1/PCI-1603)
-.El
-.It
-Lava Computers:
-.Bl -dash -compact
-.It
-Dual Serial
-.It
-Quattro
-.It
-Quattro-PCI
+NetMos NM9815 Dual 1284 Printer port PCI
 .It
-Octopus-550 
-.El
+NetMos NM9835 2/1 port UART + 1284 Printer PCI
 .It
-I-O DATA RSA-PCI2/R
+NetMos NM9845 4/6 port UART + 1284 Printer PCI
 .It
-Kuroutoshikou SERIAL4P-LPPCI2
+NetMos NM9865 4/3/2 port UART + 1/2 port 1284 Printer PCI
 .It
 Oxford Semiconductor based boards:
 .Bl -dash -compact
@@ -287,137 +209,74 @@ OX9160/OX16PCI954 UARTs
 OX16PCI958 UART
 .El
 .It
-Perle:
-.Bl -dash -compact
-.It
-Ultraport4 Express
-.It
-Speed2 LE
+Perle Ultraport4 Express PCIe Serial
 .It
-Speed4 LE
+Perle Speed8/Speed4/Speed2 LE PCI Serial
 .It
-Speed8 LE
-.El
-.It
-VScom:
+Quatech:
 .Bl -dash -compact
 .It
-PCI-100L
+DSC-300/200/100 PCI
 .It
-PCI-200L
+DSCLP-300/200/100 PCI
 .It
-200Li
-.El
+ESC-100/100D/100M PCI
 .It
-Titan:
-.Bl -dash -compact
-.It
-PCI-800H
-.It
-PCI-800H
+QSC-300/200/100 PCI
 .It
-PCI-200H
+QSCLP-100 PCI
 .El
 .It
-Titan VScom:
+SIIG Cyber Series of UART and parallel port boards:
 .Bl -dash -compact
 .It
-PCI-800L
-.It
-PCI-200HV2
-.It
-PCIex-800H
-.It
-PCIex-800H
-.El
+Cyber 2S and 2SP1 PCI 16550
 .It
-Avlab Technology PCI IO 2S
+Cyber 4 and 4S PCI 16C650 (10x family and 20x family)
 .It
-Avlab Low Profile PCI 4 Serial
+Cyber I/O PCI (10x family and 20x family)
 .It
-Syba Tech Ltd PCI-4S2P-550-ECP
+Cyber Parallel Dual PCI (10x family and 20x family)
 .It
-Sunix SUN1888
+Cyber Serial Dual PCI (10x family and 20x family)
 .It
-Sunix SER5xxxx
-.Bl -dash -compact
+Cyber 2S1P PCI (10x family and 20x family)
 .It
-2, 4 and 8 port serial
-.El
-.It
-Sunix MIO5xxxx (1284 Printer port):
-.Bl -dash -compact
+PS8000 8S PCI 16C650 (20x family)
 .It
-1, 2 and 4 port serial
+Quartet Serial 850 PCI
 .El
 .It
-Feasso PCI FPP-02 2S1P
-.It
 Sun 1040 PCI Quad Serial
 .It
-Decision Computer Inc PCCOM:
-.Bl -dash -compact
-.It
-4-port serial
-.It
-8-port serial
-.El
-.It
-PCCOM dual port RS232/422/485
+Sunix MIO5xxxx 4/2/1 port UART and 1284 Printer
 .It
-NetMos NM9815 Dual 1284 Printer port
+Sunix SUN1889/1888 PCI dual port serial
 .It
-NetMos NM9835:
-.Bl -dash -compact
-.It
-based 1 and 2 port serial
+Sunix SER5xxxx 8/4/2 port serial
 .It
-Dual UART and 1284 Printer port
-.El
-.It
-NetMos NM9845:
-.Bl -dash -compact
-.It
-6 Port UART
+Syba Tech Ltd PCI-4S2P-550-ECP
 .It
-Quad UART and 1284 Printer port
-.El
+Titan PCI-800H/PCI-200H
 .It
-NetMos NM9865:
+VScom:
 .Bl -dash -compact
 .It
-Dual UART
-.It
-Triple UART
+PCIex-800H
 .It
-Quad UART
+PCI-200HV2
 .It
-Single UART and 1284 Printer port
+200Li uPCI
 .It
-Dual UART and 1284 Printer port
+PCI-800L, PCI-200L, and PCI-100L
 .It
-Dual 1284 Printer port
+PCI-800, PCI-400, and PCI-200
 .El
-.It
-IC Book Labs:
-.Bl -dash -compact
-.It
-Gunboat x4 Lite
-.It
-Gunboat x4 Pro
-.It
-Ironclad x8 Lite
-.It
-Ironclad x8 Pro
-.It
-Dreadnought x16 Pro
-.It
-Dreadnought x16 Lite
-.It
-Gunboat x2 Low Profile
-.It
-Gunboat x4 Low Profile
 .El
+.Sh FILES
+.Bl -tag -width "sys/dev/puc/pucdata.c"
+.It Pa sys/dev/puc/pucdata.c
+list of supported devices
 .El
 .Sh SEE ALSO
 .Xr ppc 4 ,