This whole idea isn't going to work until somebody makes the bus/kld
code smarter. The idea here is to change the module's internal name
from "foo" to "if_foo" so that ifconfig can tell a network driver from
a non-network one. However doing this doesn't work correctly no matter
how you slice it. For everything to work, you have to change the name
in both the driver_t struct and the DRIVER_MODULE() declaration. The
problems are:
- If you change the name in both places, then the kernel thinks that
the device's name is now "if_foo", so you get things like:
if_foo0: <FOO ethernet> irq foo at device foo on pcifoo
if_foo0: Ethernet address: foo:foo:foo:foo:foo:foo
This is bogus. Now the device name doesn't agree with the logical
interface name. There's no reason for this, and it violates the
principle of least astonishment.
- If you leave the name in the driver_t struct as "foo" and only
change the names in the DRIVER_MODULE() declaration to "if_foo" then
attaching drivers to child devices doesn't work because the names don't
agree. This breaks miibus: drivers that need to have miibuses and PHY
drivers attached never get them.
In other words: damned if you do, damned if you don't.
This needs to be thought through some more. Since the drivers that
use miibus are broken, I have to change these all back in order to
make them work again. Yes this will stop ifconfig from being able
to demand load driver modules. On the whole, I'd rather have that
than having the drivers not work at all.
-------------------------------------------------------------------------------
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
0355003f26