freebsd-dev/sys/pci
wpaul 0a28da8941 Increase the number of descriptors (and, as a consequence, the number
of associated mbuf clusters) in the RX ring from 4 to 16. On my
really fast PI 400Mhz test machines, 4 descriptors (and associated
mbuf clusters) is enough to achieve decent performance without any
RX overruns. However, one person reported problems with the following
scenario:

- P90 system running FreeBSD with a 3c905B-TX adapter, slow IDE hard
  disk (Quantum Bigfoot?)
- PII 266 with SCSI disks running LoseNT and also with a 3c905B-TX
- Both machines connected together via crossover cable at 100Mbps
  full-duplex
- LoseNT machine writing largs amounts of data (2.5 GB work of
  files each in the neighborhood of 1 to 2 MB in size) via samba to
  the FreeBSD machine

In this case, the LoseNT machine is sending data very fast. Apparently
there weren't any problems initially because the user was writing to
one particular disk which was relatively fast, however after this disk
filled up and the user started writing to the second slower disk, RX
overruns would occur and sometimes the RX DMA engine would stall after
a 100 to 500MB had been transfered. The xl_rxeof() handler is supposed
to detect this condition and restart the upload engine; I'm not sure
why it doesn't, unless interrupts are being lost and the rx handler
isn't getting called.

This is still an improvement over the Linux driver, which uses 32
descriptors in its receive ring. :)

Problem reported by: Heiko Schaefer <hschaefer@fto.de>
1998-08-21 16:58:48 +00:00
..
aic7870.c Correct SEEPROM checksum calculation when multiple checksum attemps are made. 1998-07-16 19:33:43 +00:00
brktree_reg.h Improved Hauppauge's tuner detection and bt878 support 1998-07-13 02:16:34 +00:00
brooktree848.c Use [u]intptr_t instead of [u_]long for casts between pointers and 1998-08-16 01:21:52 +00:00
bt9xx.c
cy_pci.c
cy_pcireg.h
dc21040reg.h Merge changes from vendor branch; 1998-06-13 17:20:03 +00:00
dpt_pci.c Update DPT driver from 1.4.3 to 1.4.5 1998-08-05 00:54:38 +00:00
dpt_pci.h
ide_pci.c Cast pointers to uintptr_t/intptr_t instead of to u_long/long, 1998-07-15 02:32:35 +00:00
ide_pcireg.h
if_de.c Cast pointers to uintptr_t/intptr_t instead of to u_long/long, 1998-07-15 02:32:35 +00:00
if_devar.h Merge changes from vendor branch; 1998-06-13 17:20:03 +00:00
if_ed_p.c
if_en_pci.c
if_fpa.c
if_fxp.c Implemented a more sophisticated mechanism for handling transmitter 1998-08-04 08:53:12 +00:00
if_fxpreg.h Fixed pedantic semantics errors (bitfields not of type int, signed int 1998-06-08 09:47:47 +00:00
if_fxpvar.h Reordered fxp_softc for optimal cacheline behavior. 1998-08-02 00:29:15 +00:00
if_lnc_p.c Add support for PCNet PCI chips that only work when we talk to them as ISA 1998-07-20 17:33:01 +00:00
if_sr_p.c
if_tl.c Fix this thing to work properly with multiple tlan adapters; increment 1998-08-04 01:38:52 +00:00
if_tlreg.h Updates for the ThunderLAN driver: 1998-08-03 01:33:12 +00:00
if_tx.c Fixed printf format errors (only 1 left in GENERIC now). 1998-07-13 09:53:11 +00:00
if_vx_pci.c Import the (Fast) Etherlink XL driver. I'm reasonally confident in its 1998-08-16 17:14:59 +00:00
if_xl.c Fix small printf() bogon (forgot newline, and the message was longer that 1998-08-20 14:48:58 +00:00
if_xlreg.h Increase the number of descriptors (and, as a consequence, the number 1998-08-21 16:58:48 +00:00
isp_pci.c Use [u]intptr_t instead of [unsigned] long to convert and/or represent 1998-08-10 17:21:49 +00:00
locate.pl
meteor_reg.h
meteor.c Fixed printf format errors. 1998-08-18 00:32:50 +00:00
ncr.c Fixed the formatting of some tables (mainly the one produced by ps 1998-08-10 14:27:34 +00:00
ncrreg.h
pci_compat.c Remove a stupid hack of mine which prevented PCI io memory access on the alpha. 1998-08-07 08:20:36 +00:00
pci_ioctl.h
pci.c Use "baseclass" instead of "class" for storing the contents of PCI register 1998-08-13 19:12:20 +00:00
pcic_p.c Fixed printf format errors. 1998-08-18 00:32:50 +00:00
pcic_p.h
pcireg.h
pcisupport.c Changed #if defined(i386)' to #ifdef __i386__'. 1998-07-07 05:00:09 +00:00
pcivar.h Use "baseclass" instead of "class" for storing the contents of PCI register 1998-08-13 19:12:20 +00:00
README.bt848 1.31 Randall Hopper <rhh@ct.picker.com> 1998-05-16 07:07:10 +00:00
scsiiom.c Use [u]intptr_t instead of [unsigned] long to convert and/or represent 1998-08-10 17:21:49 +00:00
simos.c Add initial support for the FreeBSD/alpha kernel. This is very much a 1998-06-10 10:57:29 +00:00
simos.h Add initial support for the FreeBSD/alpha kernel. This is very much a 1998-06-10 10:57:29 +00:00
smc83c170.h Fix some strange errors of shutting transmitter up when start 1998-07-04 08:02:46 +00:00
tek390.c
tek390.h
wdc_p.c
xrpu.c Fixed printf format errors. 1998-08-18 00:32:50 +00:00

-------------------------------------------------------------------------------
Recent versions of 3.0-current have the bktr driver built in.  Older versions
of 3.0 and all versions of 2.2 need to have the driver files installed by hand:

cp ioctl_bt848.h /sys/i386/include/
cp brktree_reg.h brooktree848.c /sys/pci/

In /sys/conf/files add:
pci/brooktree848.c        optional bktr device-driver

-------------------------------------------------------------------------------
In all cases you will need to add the driver to your kernel:

In your kernel configuration file:
controller      pci0     #if you already have this line don't add it.
device          bktr0    

There is no need to specify DMA channels nor interrupts for this
driver.

-------------------------------------------------------------------------------
Finally you need to create nodes for the driver:

Create a video device:
mknod /dev/bktr0 c 92 0

Create a tuner device:
mknod /dev/tuner0 c 92 16

-------------------------------------------------------------------------------
The code attempts to auto-probe code to detect card/tuner types.
The detected card is printed in the dmesg as the driver is loaded.  If
this fails to detect the proper card you can override it in brooktree848.c:

#define OVERRIDE_CARD	<card type>

where <card type> is one of:
	CARD_UNKNOWN
	CARD_MIRO
	CARD_HAUPPAUGE
	CARD_STB
	CARD_INTEL

-------------------------------------------------------------------------------
This model now separates the "tuner control" items into a minor device:

minor device layout:  xxxxxxxx xxxT UUUU

 UUUU:   the card (ie UNIT) identifier, 0 thru 15
 T == 0: video device
 T == 1: tuner device

Access your tuner ioctl thru your tuner device handle and anything
which controls the video capture process thru the video device handle.

Certain ioctl()s such as video source are available thru both devices.

-------------------------------------------------------------------------------
If your tuner does not work properly or is not recognized properly
try setting the tuner type via or card type:
sysctl -w hw.bt848.card=<integer> current valid values are 0 to 5 inclusive
sysctl -w hw.bt848.tuner=<integer> where integer is a value from 1 to 10
systcl -w hw.bt848.reverse_mute=<1 | 0> to reverse the mute function in the
                                driver set variable to 1.
The exact format of the sysctl bt848 variable is:
unit << 8 | value

unit identifies the pci bt848 board to be affected 0 is the first bt848 
board, 1 is the second bt848 board.
value denotes the integer value for tuners is a value from 0 to 10 for
reversing the mute function of the tuner the value is 1 or 0.

to find out all the bt848 variables:
sysctl hw.bt848



-------------------------------------------------------------------------------
The bt848 driver consists of:

src/sys/i386/include/ioctl_bt848.h
src/sys/pci/brktree_reg.h
src/sys/pci/brooktree848.c