Page MenuHomeFreeBSD
Files F140832080

D50608.id54425.diff
No OneTemporary
Actions

D50608.id54425.diff
View Options

diff --git a/share/man/man4/uftdi.4 b/share/man/man4/uftdi.4
--- 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 @@
.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 @@
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 .

File Metadata

Mime Type
text/plain
Expires
Mon, Dec 29, 2:37 PM (4 h, 14 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
27361926
Default Alt Text
D50608.id54425.diff (3 KB)

Event Timeline