3 Configuration

3.1 bt848x Driver Configuration

3.1.1 bt848x Driver Configuration Strategy

bt848x driver choose its operating parameter by following strategy:

1. If capture card has PCI subsystem IDs and known to driver, driver will decide card-type parameter automatically.
2. If card-type parameter is specified in configuration file, driver will use it.
3. If card-type parameter is not specified, driver will use “0” (generic or unknown).
4. Driver loads predefined paramters by card-type.
5. If other paramters were specified in driver configuration file, driver use them.

Each parameters can be “overwritten” at latter steps. So values that are described in configuration file will be most priotized.

3.1.2 bt848x Driver Configuration File

Driver configuration file locates at /platform/`uname -m`/kernel/drv/bt848x.conf. Configuration file can hold many operating parameters. See driver.conf(4) manual page for detailed notation and concept. Actual parameters are decribed in other section. See config.

If you changed configuration file, its change will _NOT_ be reflected immediately.

[Solaris 9 or later] Issue update_drv bt848x command to update driver configuration.

[Solaris 8] “modunload -i 0” command will force to unload unused drivers. Once unloaded, next open of device file will updates driver configuration.

3.1.3 Special Notation for Multiple Card Instances

If you have more than 1 card in a machine, you should specify parameters with comma-separated, except 'video-mux' and 'audio-mux' (parameter detail is described later). For example:

     card-type=11,13;        # type of card #1 is 11, and #2 is 13
     video-inputs=3,4;       # number of inputs equipted card #1 is 3, #2 is 4
     video-mux0=1,2,3;       # card #1 video multiplexer config
     video-mux1=2,0,1,3;     # card #2 video multiplexer config

3.2 Driver Configuration Parameters

card-type

Type of card. See list of card-type.

If capture card has PCI subsystem IDs and known to driver, default value of card-type is assumed by them. If else, “0” (=unknown or generic card) is assumed by default.

This parameter affects all other parameters. But, this parameter is evaluated ahead of them. So you can overwrite other parameters.

audio-inputs

Number of audio multiplexer input. Normally '1' and it is default. Note: All sound-related ioctls would fail if '0' is specified. So, '1' is adequate value even if card does not have any audio input.

tuner

Video channel of tuner input (normally '0'). If card does not have tuner, specify '-1'. '-1' is assumed by default.

svhs

Video channel of S Video (separated video) input. If card does not have S Video input, specify '-1'. This is normally '2', but '-1' is assumed by default.

gpiomask

Bit mask of GPIO (general purpose input/output pins for chipset) output. This value is used as output enable bit. If you don't understand what this parameter is, specify '0' and it is default. Specifying other than '0' is possible to harm hardware, so please be prudence in trying new value.

video-mux

Set of video signal multiplexer (up to 16) values in following format:

video-muxN = muxval_of_1ch, muxval_of_2ch, muxval_of_3ch, ...;

where N is instance number of the card.

audio-mux

Set of audio signal mutiplexer values in following format:

audio-muxN = muxval_of_tuner, muxval_of_radio, muxval_of_internal, muxval_of_external, muxval_of_mute;

where N is instance number of the card.

pll

PLL reference clock frequency. Specify '0' for card without PLL, '28' for 28MHz clock, '35' for 35MHz clock. You may need this if (1) picture was monochrome, or (2) shape of picuture looked good but color was wrong.

tuner-type

Type of tuner. See list of tuner-type. If card doesn't have tuner, specify '4' and it is default. Please do not ask me why '4' is used.

tuner-norm-variant

Type of norm standard variant. This parameter is valid only if tuner-type paramter is 22 (TEMIC 4046FM5) or 24 (Philips FQ1216ME).

Values of tuner-norm-variant (case tuner-type=22)

0x69

PAL-I

0x64

PAL-D/K

0x6c

PAL-L

others

PAL-B/G

Values of tuner-norm-variant (case tuner-type=22)

0x69

PAL-I

0x6c

PAL-L

others

PAL-B/G/D/K

has-radio

If tuner has ability to tune radio, specify '1'.

tuner-afcmode

Specify AFC (automatic frequency control) mode of TV tuner.

0

no feedback mode. (default)

i

no feedback mode, but returns error when tuner cannot detect carrier.

2

carrier detection mode.

3

signal intensity feedback mode.

More precise tuning is performed in this order, but more response time is needed. '0' is sufficient for almost case.