Интерактивная система просмотра системных руководств (man-ов)
if_hatm (4)
>> if_hatm (4) ( FreeBSD man: Специальные файлы /dev/* )
BSD mandoc
NAME
hatm
- device driver for Fore/Marconi HE155 and HE622 ATM interfaces
SYNOPSIS
device hatmdevice utopiadevice atm
options NATM
DESCRIPTION
The
device driver supports the FORE (now Marconi) HE155 and HE622 ATM interface
cards.
The driver interfaces with the
natm(4)
framework,
netgraph(4)
and the HARP ATM stack.
It provides only PVC services.
Signalling, ATMARP, ILMI and other
higher layer protocols are implemented using
netgraph(4)
or HARP.
The following sysctls are recognized by the driver additionally to those
handled by
utopia(4):
hw.atm.hatm.natm_traffic
This is the traffic type to be used for NATM pvc connections.
The type of
this variable is integer and it must have one of the values 0 (UBR) or 1 (CBR).
hw.atm.hatm.natm_pcr
This is the peak cell rate to be used for NATM CBR connections.
hw.atm.hatm N .stats
Contains an array of
Vt uint32_t
with device specific statistics.
hw.atm.hatm N .istats
Contains an array of
Vt uint32_t
with internal driver statistics.
hw.atm.hatm N .debug
Bf Em
(Only if debugging enabled.)
Ef These are the debugging flags.
See
src/sys/dev/hatm/if_hatmvar.h
for the possible flags.
hw.atm.hatm N .tsr
Bf Em
(Only if debugging enabled.)
Ef This is an array containing all transmission status registers.
For each of the
4096 possible VCCs there are 15 32-bit registers.
hw.atm.hatm N .tpd
Bf Em
(Only if debugging enabled.)
Ef This is an array containing all on card current transmission packet descriptors.
For each of the 4096 possible VCCs there are 16 32-bit registers.
hw.atm.hatm N .mbox
Bf Em
(Only if debugging enabled.)
Ef This is an array containing the mbox registers.
hw.atm.hatm N .cm
Bf Em
(Only if debugging enabled.)
Ef This is an array containing all connection memory registers.
The first 32-bit integer of this array is the ABR base address.
hw.atm.hatm N .heregs
Bf Em
(Only if debugging enabled.)
Ef This is an array containing all card registers including SUNI and the FLASH ROM.
hw.atm.hatm N .lbmem
Bf Em
(Only if debugging enabled.)
Ef Returns the contents of the local memory.
The driver supports the media options
sdh , noscramb
and
unassigned
(see
utopia(4)).
ENVIRONMENT
When attaching to a device the driver checks the kernel environment
(see
kenv(1))
to see if the default queues sizes should be overwritten or not.
The
following variables are checked and interpreted as unsigned integer
values (in either radix):
hw.hatm N .rbps0_size
Size of the small receive buffer pool 0.
This pool is used for all
except raw AAL connections.
The pool size must be a power of two between
4 and 8192 inclusive.
When attaching the driver allocates this number
of mbufs.
hw.hatm N .rbps0_thresh
Interrupt threshold for small receive buffer pool 0.
When the number of free
buffers in the pool falls below this threshold it generates an interrupt
so that the driver can refill the pool.
hw.hatm N .rbpl0_thresh
Size of the large receive buffer pool 0.
This pool is used for all
except raw AAL connections.
The pool size must be a power of two between
4 and 8192 inclusive.
When attaching the driver allocates this number
of mbufs with clusters.
hw.hatm N .rbpl0_thresh
Interrupt threshold for large receive buffer pool 0.
When the number of free
buffers in the pool falls below this threshold it generates an interrupt
so that the driver can refill the pool.
hw.hatm N .rbrq0_size
Size of receive buffer return queue 0.
This queue is used to return buffers
filled with received frames to the driver.
The size must be a power of 2
between 1 and 16384 inclusive.
hw.hatm N .rbrq0_thresh
Interrupt threshold for receive buffer return queue 0.
This threshold
should only be triggered in exceptional cases.
hw.hatm N .rbrq0_tout
Interrupt timeout for receive buffer return queue 0.
An interrupt is generated
after this time if the queue is not empty.
The number is in internal card
ticks.
hw.hatm N .rbrq0_pcnt
Packet count threshold for receive buffer return queue 0.
An interrupt
is generated if this number of packets is in the queue.
hw.hatm N .rbps1_size
Size of the small receive buffer pool 1.
This pool is used for all
raw AAL connections.
The pool size must be a power of two between
4 and 8192 inclusive.
When attaching the driver allocates this number
of mbufs.
hw.hatm N .rbps1_thresh
Interrupt threshold for small receive buffer pool 1.
When the number of free
buffers in the pool falls below this threshold it generates an interrupt
so that the driver can refill the pool.
hw.hatm N .rbrq1_size
Size of receive buffer return queue 1.
This queue is used to return buffers
filled with received cells to the driver.
The size must be a power of 2
between 1 and 16384 inclusive.
hw.hatm N .rbrq1_thresh
Interrupt threshold for receive buffer return queue 1.
This threshold
should only be triggered in exceptional cases.
hw.hatm N .rbrq1_tout
Interrupt timeout for receive buffer return queue 1.
An interrupt is generated
after this time if the queue is not empty.
The number is in internal card
ticks.
hw.hatm N .rbrq1_pcnt
Packet count threshold for receive buffer return queue 0.
An interrupt
is generated if this number of cells is in the queue.
hw.hatm N .irq0_size
Size of interrupt queue 0.
This must be a number between 1 and 1023 inclusive.
hw.hatm N .irq0_thresh
Interrupt retrigger threshold of interrupt queue 0.
A new interrupt is trigger
if the queue fill state reaches this threshold and the interrupt was no
served.
hw.hatm N .tbrq0_size
Transmit buffer return queue 0 size.
This queue is used to feed back empty
buffers of transmitted frames back to the driver.
It must be a power of 2
between 1 and 4096 inclusive.
hw.hatm N .tbrq0_thresh
Transmit buffer return queue 0 threshold.
An interrupt is generated if the
queue fill state reaches this point.
hw.hatm N .tpdrq_size
Transmit descriptor ready queue size.
This queue is used by the driver
to feed transmit descriptors into the card.
The size must be a power of 2
between 1 and 16384 inclusive.
hw.hatm N .tpdmax
Maximum number of active TPDs per connection.
This controls the maximum
number of outstanding packet chunks per connection and thus the maximum
delay packets can have because of queueing on the adapter.
If set to 0,
a connection can eat up all available TPDs.
hw.hatm N .mbuf_max_pages
Maximum number of memory pages allocated to small external mbufs.
This must not be zero and not larger than 65536.
CAVEATS
When putting a HE155 into a 64-bit 66MHz PCI slot the machine may hang.
This occurs very early in the POST so that even the display does not turn on.
The HE155 runs only in 33MHz slots (either 32 or 64-bit).
HE622 cards work just fine in 64-bit slots.
The driver may not work with bounce buffer, because of
bus_dmamap_sync9
missing the
Fa offset
and
Fa len
arguments the
Nx function has.
DIAGNOSTICS
hatm0: <FORE HE> mem 0xd2600000-0xd26fffff irq 9 at device 15.0 on pci2
hatm0: ForeRunnerHE 622, Rev. D, S/N 2949834, MAC=00:20:48:2d:02:ca
