changes:
- Cleaned up register access macros so that they work like the XL
driver macros (you can switch from PIO to memory-mapped mode
using a single #define -- default is still memory mapped mode).
The old 'struct overlayed onto the memory mapped register space'
cruft has been removed.
- Improved multicast filter code. The ThunderLAN has four entry
perfect filter table in addition to the 64-bit hash table: we need
one of the perfect filter entries for the station address, but we
can use the other three for multicast filtering. We arrange to put
the first three multicast group addresses in the perfect filter
slots so that commonly joined groups like the all hosts group and
the all routers group can be filtered without using up bits in the
hash table.
Note: in FreeBSD 3.0, multicast groups are stored in a doubly
linked list, however new entries are added at the head of the list
(thereby pushing existing entries down towards the tail). We want
to update the filter starting from the oldest entry to the newest
since the all hosts group is always joined first. This means we
really want to start from the tail of the list, not the head, but
to find the tail we first have to traverse the list all the way to
the end and then add entries working backwards. This is a bit of a
kludge and could be inefficient if the list is long.
- Cleaned up autonegotiation code: tl_autoneg() wasn't always setting
modes correctly.
- Cleaned up ifmedia update and status routines as well.
- Added tl_hardreset() routine to initialize the internal PHY according
to the ThunderLAN manual.
- Did away with the kludge where PHYs were treated as separate logical
interfaces. This didn't really work, especially in the case of the
newer Olicom 2326 adapters which use a Micro Linear ML6692 PHY which
provides only 100Mbps support, relying on the internal PHY for 10Mbps
support (both PHYs share the RJ45 port, with the 6692 doing all the
autonegotiation work). This kludge resulted from my misunderstanding
of the operation of the Compaq Netelligent Dual Port card (the tlan
manual mentions multiple channels, but in a different context; this
got me a little confused). The driver has been reported to work
correctly with the dual port card.
- Added dio_getbit/dio_setbit/dio_read/dio_write functions which carefully
set the ThunderLAN's indirectly accessed internal registers. This makes
the EEPROM reading code more reliable.
Hopefully I won't have to touch this again before 3.0 goes out the door.
I plan to import the 2.2.x version sometime this week.
Approved-by: jkh
-------------------------------------------------------------------------------
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
3aba1dc21e