diff options
-rw-r--r-- | share/man/man4/Makefile | 2 | ||||
-rw-r--r-- | share/man/man4/patm.4 | 162 |
2 files changed, 164 insertions, 0 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index dd153a3..8099c6d 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -174,6 +174,7 @@ MAN= aac.4 \ oldcard.4 \ orm.4 \ pass.4 \ + patm.4 \ pci.4 \ pccard.4 \ pccbb.4 \ @@ -318,6 +319,7 @@ MLINKS+=mem.4 kmem.4 MLINKS+=netintro.4 networking.4 MLINKS+=nge.4 if_nge.4 MLINKS+=oldcard.4 card.4 +MLINKS+=patm.4 if_patm.4 MLINKS+=pccbb.4 cbb.4 MLINKS+=pcm.4 snd.4 MLINKS+=pcn.4 if_pcn.4 diff --git a/share/man/man4/patm.4 b/share/man/man4/patm.4 new file mode 100644 index 0000000..0094f59 --- /dev/null +++ b/share/man/man4/patm.4 @@ -0,0 +1,162 @@ +.\" +.\" Copyright (c) 2003 +.\" Fraunhofer Institute for Open Communication Systems (FhG Fokus). +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" Author: Hartmut Brandt <harti@freebsd.org> +.\" +.\" $FreeBSD$ +.\" +.\" patm(4) man page +.\" +.Dd July 15, 2003 +.Dt PATM 4 +.Os FreeBSD +.Sh NAME +.Nm patm +.Nd Device driver for IDT77252 based ATM interfaces (ProSum and IDT) +.Sh SYNOPSIS +.Cd device patm +.Cd device utopia +.Cd device atm +.Cd options NATM +.Cd options LIBMBPOOL +.Sh DESCRIPTION +The +.Nm +device driver supports ATM cards based on the IDT77252 chip. It has been +tested with ProSum's ProATM-155 cards and with IDT's evaluation boards. +The driver interfaces with the +.Xr natm 4 +framework, +.Xr netgraph 4 +and HARP. +It provides only PVC services. Signalling, ATMARP, ILMI and other +higher layer protocols are implemented using +.Xr netgraph 4 +or HARP. +.Pp +For configuring the card for IP see +.Xr natmip 4 . +.Pp +The driver supports UBR, CBR, VBR and ABR traffic. Supported AALs are: +AAL0 (cell payloads), AAL5 and raw AAL. The driver supports opening +of VCI/VPI 0/0 in RX, raw AAL-mode. This VC will receive all incoming cells (even +those with non-zero GFC fields and VPI/VCI values outside the allowed range) +that are not claimed by other open connections. This may be used +for monitoring purposes. +.Pp +The following sysctls are recognized by the driver additionally to those +handled by +.Xr utopia 4 : +.Bl -tag -width XXX +.It Cm hw.atm.patmN.istats +Returns a list of +.Dv uint32_t +statistic counters with internal driver statistics. +.It Cm hw.atm.patmN.eeprom +This is a read-only variable containing the contents of the on-board EEPROM +device. +.It Cm hw.atm.patmN.lbuf_max +This puts an upper limit on the number of large receive buffers the +driver will allocate. This is a read-only variable that can be set +via a loader tunable. +.It Cm hw.atm.patmN.tx_maxmaps +This is the upper limit of transmission DMA maps the driver will allocate. +This is read-only but may be set via a loader tunable. +.It Cm hw.atm.patmN.debug +.Em (only if debugging enabled) +These are debugging flags. See +.Fn if_patmvar.h +for the possible flags. This may be initialized via a loader tunable. +.It Cm hw.atm.patmN.regs +.Em (only if debugging enabled) +Returns the current values of the card's registers. +.It Cm hw.atm.patmN.tsq +Returns the transmit status queue. +.El +.Pp +When loaded the driver initializes several variables from loader tunables: +.Bl -tag -width XXX +.It Cm hw.patmN.lbuf_max +This initializes the corresponding sysctl variable and defines an upper +limit on the number of large receive buffers (mbuf clusters). +.It Cm hw.patmN.tx_maxmaps +This initializes the corresponding sysctl variable and is the maximum +number of DMA maps for transmission that the driver will allocated. +.It Cm hw.patmN.debug +.Em (only if debugging enabled) +Initializes the debugging flags. +.El +.Pp +The driver supports the media options +.Ar sdh , +.Ar noscramb +and +.Ar unassigned +(see +.Xr utopia 4 ) +when the card is a 155MBit card. Both PMC-Sierra S/UNI and IDT77155 PHY +chips are supported for these cards. For 25MBit cards the IDT77105 is +supported. +.Sh DIAGNOSTICS +.Bd -literal +patm1: <NICStAR (77222/77252) ATM adapter> port 0xc000-0xc0ff mem 0xf8000000-0xf83fffff,0xf4000000-0xf4000fff irq 11 at device 8.0 on pci2 +patm1: IDT77252 155MBit interface; idt77252 Rev. G; IDT77155 PHY +patm1: 128K x 32 SRAM; 4096 connections +.Ed +.Sh SEE ALSO +.Xr natm 4 , +.Xr natmip 4 , +.Xr utopia 4 +.Sh CAVEATS +The card fails to generate an interrupt if a cell is received in AAL0 mode +that has the MSB of the PTI field cleared. Therefor cells will delivered +on the next receive interrupt which can happen either when the receive +status queue is full, or a cell with the last bit of the PTI set is received. +.Pp +Although the card supports AAL3/4 the driver does not. +.Pp +The rate tables used by this driver are not the tables recommended by IDT +(they are wrong anyway). The driver's tables are slightly more aggressive +than IDT's. That means, that the actual cell rate can be slightly higher +than the specified. This is in contrast to the IDT tables where cell rates +5% lesser than the allowed one have been observed. This can be changed +by changing the program that generates these tables (/sys/dev/patm/genrtab) +and regenerating the tables. +.Pp +The reported media for the 155MBit cards will always be OC3/MM, because +there is no (known to me) way to figure out the actual medium. The medium +should really be coded in the EEPROM by the manufacturer. +.Pp +The Tx cell counter in the utopia statistics is wrong, because the chip +uses idle cells for spacing and the PHY counts these cells. While +there is a configuration option for the chip to switch of these cells +and, according to the documentation, this should not influence cell spacing, +it does, so the driver let's the chip generate idle cells. +.Sh ACKNOWLEDGEMENTS +Thanks to Christian Bucari from ProSum for lending two of these cards to enable +the development of this driver. Thanks also for answering my questions. +.Sh AUTHORS +.An Harti Brandt Aq harti@freebsd.org . |