Page MenuHomeFreeBSD
Files F147400151

D50608.id156303.diff
No OneTemporary
Actions

D50608.id156303.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 May 29, 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:
-.Pp
-.Bl -bullet -compact
-.It
-FT8U100AX
-.It
-FT8U232AM
-.It
-FT8U232BM
-.It
-FT232R
-.It
-FT2232C
-.It
-FT2232D
-.It
-FT2232H
-.It
-FT4232H
-.It
-FT230X
-.El
-.Pp
+driver supports FTDI USB to serial UART devices.
+If the appropriate hardware is detected,
+the driver will be loaded automatically by
+.Xr devmatch 8 .
+If
+.Xr devmatch 8
+is not available, load the driver manually in
+.Xr rc.conf 5
+or with
+.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
+FTDI FT4232H
+.It
+FTDI FT232R
+.It
+FTDI FT230X
+.It
+FTDI FT2232H
+.It
+FTDI FT2232D
+.It
+FTDI FT2232C
+.It
+FTDI FT8U232BM
+.It
+FTDI FT8U232AM
+.It
+FTDI FT8U100AX
+.El
+.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*
@@ -254,15 +265,21 @@
.It Pa /dev/cuaU*.lock
corresponding callout initial-state and lock-state devices
.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "ftdi*: allocating USB transfers failed"
+.It "ftdi*: skipping JTAG interface..."
+.It "ftdi*: Warning: unknown FTDI device type..."
+.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
Wed, Mar 11, 4:23 PM (3 h, 55 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
29543816
Default Alt Text
D50608.id156303.diff (3 KB)

Event Timeline