xref: /src/share/man/man4/ufintek.4 (revision 791c531402bd36252532a11c317fb6a5fdb9c000)
1.\"-
2.\" SPDX-License-Identifier: BSD-2-Clause
3.\"
4.\" Copyright (c) 2025 Diane Bruce
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd November, 2025
29.Dt UFINTEK 4
30.Os
31.Sh NAME
32.Nm ufintek
33.Nd Fintek F81232 USB to serial UART driver
34.Sh SYNOPSIS
35.Cd "device usb"
36.Cd "device ucom"
37.Cd "device ufintek"
38.Pp
39In
40.Xr rc.conf 5 :
41.Cd kld_list="ufintek"
42.Pp
43In
44.Xr sysctl.conf 5 :
45.Cd hw.usb.ufintek.debug=1
46.Sh DESCRIPTION
47The
48.Nm
49driver provides support for the F81232 serial adapter from FINTEK.
50If the appropriate hardware is detected,
51the driver will be loaded automatically by
52.Xr devmatch 8 .
53To load the driver manually, add it to the
54.Ic kld_list
55in
56.Xr rc.conf 5 ,
57or use
58.Xr kldload 8
59at runtime.
60The device is accessed through the
61.Xr ucom 4
62driver which makes it behave like a
63.Xr tty 4 .
64.Pp
65Call out through this interface with applications like
66.Xr cu 1
67or
68.Xr tip 1 .
69.Sh HARDWARE
70The
71.Nm
72driver supports the following USB to serial UART controllers:
73.Pp
74.Bl -bullet -compact
75.It
76FT82332
77.El
78.Sh SYSCTL VARIABLES
79These settings can be entered in the
80.Xr loader 8
81prompt, set in
82.Xr loader.conf 5 ,
83.Xr sysctl.conf 5 ,
84or changed at runtime with
85.Xr sysctl 8 :
86.Bl -tag -width "hw.usb.uftdi.debug"
87.It Va hw.usb.uftdi.debug
88Enable debugging messages, default
89.Ql 0
90.Ql 1
91.El
92.Sh FILES
93.Bl -tag -width "/dev/ttyU*.init" -compact
94.It Pa /dev/ttyU*
95for callin ports
96.It Pa /dev/ttyU*.init
97.It Pa /dev/ttyU*.lock
98corresponding callin initial-state and lock-state devices
99.Pp
100.It Pa /dev/cuaU*
101for callout ports
102.It Pa /dev/cuaU*.init
103.It Pa /dev/cuaU*.lock
104corresponding callout initial-state and lock-state devices
105.El
106.Sh SEE ALSO
107.Xr cu 1 ,
108.Xr tty 4 ,
109.Xr ucom 4 ,
110.Xr usb 4
111.Sh HISTORY
112The
113.Nm
114driver appeared in
115.Fx 16.0
116.Sh BUGS
117This driver is limited to 9600 baud.
118
119