xref: /freebsd/share/man/man4/puc.4 (revision 9c564b6c92b0eb6ef47595f394c4e76b1a45d3c4)
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
329c564b6cSJohn Hay.Nd PCI ``Universal'' Communications driver
339c564b6cSJohn Hay.Sh SYNOPSIS
349c564b6cSJohn Hay.Cd device pci
359c564b6cSJohn Hay.Cd device puc
369c564b6cSJohn Hay.Cd device sio
379c564b6cSJohn Hay.Cd options PUC_FASTINTR
389c564b6cSJohn Hay.Sh DESCRIPTION
399c564b6cSJohn HayThis driver acts as a shim to connect pci serial ports to the
409c564b6cSJohn Hay.Xr sio 4
419c564b6cSJohn Haydriver.
429c564b6cSJohn Hay.Pp
439c564b6cSJohn HayThe list of supported devices is in
449c564b6cSJohn Hay.Em src/sys/dev/puc/pucdata.c.
459c564b6cSJohn HaySupport for new cards should be added there.
469c564b6cSJohn Hay.Pp
479c564b6cSJohn HayIf the PUC_FASTINTR option is used the driver will try to use fast interrupts.
489c564b6cSJohn HayThis should lower the interrupt latency and should be used if the
499c564b6cSJohn Hay.Xr sio 4
509c564b6cSJohn Haydriver reports
519c564b6cSJohn Hay.Em silo overflow
529c564b6cSJohn Hayerrors.
539c564b6cSJohn HayIt cannot be used if the interrupt is shared.
549c564b6cSJohn Hay.Sh SEE ALSO
559c564b6cSJohn Hay.Xr sio 4
569c564b6cSJohn Hay.Sh HISTORY
579c564b6cSJohn HayThis driver took the idea from the
589c564b6cSJohn Hay.Nx
599c564b6cSJohn Hay.Xr puc 4
609c564b6cSJohn Haydriver and still use the same structure to describe cards to ease exchanging
619c564b6cSJohn Haycard info.
629c564b6cSJohn Hay.Sh BUGS
639c564b6cSJohn HayOnly serial ports are supported through the
649c564b6cSJohn Hay.Xr sio 4
659c564b6cSJohn Haydriver at the moment.
669c564b6cSJohn HaySomeone should write support for parallel ports using the
679c564b6cSJohn Hay.Xr lpt 4
689c564b6cSJohn Haydriver.
69