1 files changed, 65 insertions, 54 deletions
diff --git a/share/man/man4/uftdi.4 b/share/man/man4/uftdi.4
index 9bd3d4a4a293..b526143eaa25 100644
--- a/share/man/man4/uftdi.4
+++ b/share/man/man4/uftdi.4
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" $NetBSD: uftdi.4,v 1.5 2002/02/07 03:15:08 ross Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
@@ -27,61 +30,90 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 26, 2017
+.Dd June 25, 2025
 .Dt UFTDI 4
 .Os
 .Sh NAME
 .Nm uftdi
-.Nd USB support for serial adapters based on the FTDI family of USB
-serial adapter chips.
+.Nd Future Technology Devices International USB to serial UART driver
 .Sh SYNOPSIS
-To compile this driver into the kernel,
-place the following lines in your
-kernel configuration file:
-.Bd -ragged -offset indent
 .Cd "device usb"
 .Cd "device ucom"
 .Cd "device uftdi"
-.Ed
 .Pp
-Alternatively, to load the driver as a
-module at boot time, place the following line in
-.Xr loader.conf 5 :
-.Bd -literal -offset indent
-uftdi_load="YES"
-.Ed
+In
+.Xr rc.conf 5 :
+.Cd kld_list="uftdi"
+.Pp
+In
+.Xr sysctl.conf 5 :
+.Cd hw.usb.uftdi.debug=1
+.Cd hw.usb.uftdi.skip_jtag_interfaces=0
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for various serial adapters based on the
-following FTDI chips:
+driver supports FTDI USB to serial UART devices.
+If the appropriate hardware is detected,
+the driver will be loaded automatically by
+.Xr devmatch 8 .
+To load the driver manually, add it to the
+.Ic kld_list
+in
+.Xr rc.conf 5 ,
+or use
+.Xr kldload 8
+at runtime.
+The device is accessed through the
+.Xr ucom 4
+driver which makes it behave like a
+.Xr tty 4 .
+.Pp
+Call out through this interface with applications like
+.Xr cu 1
+or
+.Xr tip 1 .
+.Sh HARDWARE
+The
+.Nm
+driver supports the following USB to serial UART controllers:
 .Pp
 .Bl -bullet -compact
 .It
-FT8U100AX
+FTDI FT4232H
 .It
-FT8U232AM
+FTDI FT232R
 .It
-FT8U232BM
+FTDI FT230X
 .It
-FT232R
+FTDI FT2232H
 .It
-FT2232C
+FTDI FT2232D
 .It
-FT2232D
+FTDI FT2232C
 .It
-FT2232H
+FTDI FT8U232BM
 .It
-FT4232H
+FTDI FT8U232AM
 .It
-FT230X
+FTDI FT8U100AX
 .El
-.Pp
-The device is accessed through the
-.Xr ucom 4
-driver which makes it behave like a
-.Xr tty 4 .
-.Pp
+.Sh SYSCTL VARIABLES
+These settings can be entered in the
+.Xr loader 8
+prompt, set in
+.Xr loader.conf 5 ,
+.Xr sysctl.conf 5 ,
+or changed at runtime with
+.Xr sysctl 8 :
+.Bl -tag -width "hw.usb.uftdi.skip_jtag_interfaces"
+.It Va hw.usb.uftdi.debug
+Enable debugging messages, default
+.Ql 0
+.It Va hw.usb.uftdi.skip_jtag_interfaces
+Ignore JTAG interfaces, default
+.Ql 1
+.El
+.Sh IOCTLS
 Many of the supported chips provide additional functionality
 such as bitbang mode and the MPSSE engine for serial bus emulation.
 The
@@ -219,27 +251,6 @@ ioctl, you must pass the special value
 .Dv UFTDI_CONFIRM_ERASE
 as the argument to this ioctl.
 .El
-.Sh HARDWARE
-The
-.Nm
-driver supports the following adapters:
-.Pp
-.Bl -bullet -compact
-.It
-B&B Electronics USB->RS422/485 adapter
-.It
-Elexol USB MOD1 and USB MOD3
-.It
-HP USB-Serial adapter shipped with some HP laptops
-.It
-Inland UAS111
-.It
-QVS USC-1000
-.It
-Buffalo PC-OP-RS / Kurouto-shikou KURO-RS universal remote
-.It
-Prologix GPIB-USB Controller
-.El
 .Sh FILES
 .Bl -tag -width "/dev/ttyU*.init" -compact
 .It Pa /dev/ttyU*
@@ -255,14 +266,14 @@ for callout ports
 corresponding callout initial-state and lock-state devices
 .El
 .Sh SEE ALSO
+.Xr cu 1 ,
 .Xr tty 4 ,
 .Xr ucom 4 ,
 .Xr usb 4
 .Sh HISTORY
 The
 .Nm
-driver
-appeared in
+driver appeared in
 .Fx 4.8
 from
 .Nx 1.5 .