xref: /freebsd/share/man/man4/puc.4 (revision a373227418c10d9007f3ad85bde5cfa4add1001d)
19c564b6cSJohn Hay.\" Copyright (c) 2002 John Hay.
29c564b6cSJohn Hay.\" All rights reserved.
39c564b6cSJohn Hay.\"
49c564b6cSJohn Hay.\" Redistribution and use in source and binary forms, with or without
59c564b6cSJohn Hay.\" modification, are permitted provided that the following conditions
69c564b6cSJohn Hay.\" are met:
79c564b6cSJohn Hay.\" 1. Redistributions of source code must retain the above copyright
89c564b6cSJohn Hay.\"    notice, this list of conditions and the following disclaimer.
99c564b6cSJohn Hay.\" 2. Redistributions in binary form must reproduce the above copyright
109c564b6cSJohn Hay.\"    notice, this list of conditions and the following disclaimer in the
119c564b6cSJohn Hay.\"    documentation and/or other materials provided with the distribution.
129c564b6cSJohn Hay.\"
139c564b6cSJohn Hay.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
149c564b6cSJohn Hay.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
159c564b6cSJohn Hay.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
169c564b6cSJohn Hay.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
179c564b6cSJohn Hay.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
189c564b6cSJohn Hay.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
199c564b6cSJohn Hay.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
209c564b6cSJohn Hay.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
219c564b6cSJohn Hay.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
229c564b6cSJohn Hay.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
239c564b6cSJohn Hay.\" SUCH DAMAGE.
249c564b6cSJohn Hay.\"
259c564b6cSJohn Hay.\" $FreeBSD$
269c564b6cSJohn Hay.\"
279c564b6cSJohn Hay.Dd February 7, 2002
289c564b6cSJohn Hay.Dt PUC 4
299c564b6cSJohn Hay.Os
309c564b6cSJohn Hay.Sh NAME
319c564b6cSJohn Hay.Nm puc
3221bb400dSRuslan Ermilov.Nd PCI
3321bb400dSRuslan Ermilov.Dq Universal
3421bb400dSRuslan ErmilovCommunications driver
359c564b6cSJohn Hay.Sh SYNOPSIS
3621bb400dSRuslan Ermilov.Cd "device pci"
3721bb400dSRuslan Ermilov.Cd "device puc"
3821bb400dSRuslan Ermilov.Cd "device sio"
39a3732274SDoug Ambrisko.Cd "device ppc"
4021bb400dSRuslan Ermilov.Cd "options PUC_FASTINTR"
419c564b6cSJohn Hay.Sh DESCRIPTION
42a3732274SDoug AmbriskoThis driver acts as a shim to connect PCI serial and parallel ports to the
439c564b6cSJohn Hay.Xr sio 4
44a3732274SDoug Ambriskoand
45a3732274SDoug Ambrisko.Xr ppc 4
469c564b6cSJohn Haydriver.
479c564b6cSJohn Hay.Pp
489c564b6cSJohn HayThe list of supported devices is in
4921bb400dSRuslan Ermilov.Pa sys/dev/puc/pucdata.c .
509c564b6cSJohn HaySupport for new cards should be added there.
519c564b6cSJohn Hay.Pp
5221bb400dSRuslan ErmilovIf the
5321bb400dSRuslan Ermilov.Dv PUC_FASTINTR
5421bb400dSRuslan Ermilovoption is used, the driver will try to use fast interrupts.
559c564b6cSJohn HayThis should lower the interrupt latency and should be used if the
569c564b6cSJohn Hay.Xr sio 4
579c564b6cSJohn Haydriver reports
5821bb400dSRuslan Ermilov.Sy "silo overflow"
599c564b6cSJohn Hayerrors.
609c564b6cSJohn HayIt cannot be used if the interrupt is shared.
619c564b6cSJohn Hay.Sh SEE ALSO
629c564b6cSJohn Hay.Xr sio 4
63a3732274SDoug Ambrisko.Xr ppc 4
649c564b6cSJohn Hay.Sh HISTORY
659c564b6cSJohn HayThis driver took the idea from the
669c564b6cSJohn Hay.Nx
679c564b6cSJohn Hay.Xr puc 4
6821bb400dSRuslan Ermilovdriver and still uses the same structure to describe cards, to ease exchanging
699c564b6cSJohn Haycard info.
709c564b6cSJohn Hay.Sh BUGS
719c564b6cSJohn HayOnly serial ports are supported through the
729c564b6cSJohn Hay.Xr sio 4
739c564b6cSJohn Haydriver at the moment.
74