Configuration - KSWsaa713x package user's manual

Next: Appendices, Previous: Installation, Up: Top

3 Configuration

3.1 saa713x Driver Configuration

3.1.1 saa713x Driver Configuration Strategy

saa713x driver choose its operating parameter by following strategy:

If capture card has PCI subsystem IDs and known to driver, driver will decide card (and optionally tuner) parameter automatically.
If card parameter is specified in configuration file, driver will use it.
If card parameter is not specified, driver warns to specify it.

3.1.2 saa713x Driver Configuration File

Driver configuration file locates at /platform/`uname -m`/kernel/drv/saa713x.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. Run /opt/KSWv4lcmn/makedev-v4l reload saa713x to update configuration actually. update_drv seems not to work correctly.

3.2 Driver Configuration Parameters

3.2.1 Module parameters

Module parameters affects all installed cards.

core_debug

Debug level for saa713x core module. Default value is 1.

0: Critical error message only.
1: Greeting message and possible error message.
2: Brief debugging message.
3: Precise debugging message.

irq_debug

Debug level for saa713x interrupt module. DANGER. Default value is 0.

gpio_tracking

Produce GPIO (general purpose input/output) output if non-zero is specified.

core_trace

Enable function tracing if non-zero is specified.

video_debug

Debug level for saa713x video module. Default value is 1.

gbuffers

Number of maximam buffers for mmaped V4L1 buffers. Default value is 4.

gbufsize

Maximam size for each mmaped V4L1 buffers in byte. Default value is 884736 (864 kilobytes).

saa713x_i2c_debug

Debug level for saa713x I2C module. Default value is 1.

saa713x_i2c_scan

Do I2C device scanning at device attach. Default value is 0 (won't scan).

v4l1_compat_debug

Debug level for V4L1 compatibility module. Default value is 1.

i2c_core_debug

Debug level for I2C core module. Default value is 1.

tuner_debug

Debug level for I2C tuner module. Default value is 1.

tuner_type

Type of tuner. See list of tuner_type. This parameter is obsoleted; recommends tuner parameter instead. Default value is determined by card parameter.

tuner_addr

I2C address of tuner. This parameter is obsoleted; recommends tuner_probe parameter instead.

tuner_pal

Variety of PAL standards. Meaningful only for TEMIC 4046FM5 or Philips FQ1216ME.

0x42 or 0x62: PAL-B (Default)
0x44 or 0x64: PAL-D
0x47 or 0x67: PAL-G
0x49 or 0x69: PAL-I
0x4c or 0x6c: PAL-L

saa7133gyc_debug

Debug level for KuroutoShikou SAA7133GYC-STVLP(/R) or Yuan Tu800 support module. Default value is 1.

upd64031a_debug

Debug level for uPD64031A module. Default value is 1.

upd64083_debug

Debug level for uPD64083 module. Default value is 1.

3.2.2 Instance Parameters

Instance parameters can affect only specific card if property name has instance number at its tail. e.g.

     card0 = 10;	# type of first card is 10
     card1 = 11;	# type of second card is 11
     tuner = 20;     # tuner types are 20 for all card

card

Type of card. See list of card. If capture card has PCI subsystem IDs and known to driver, default value of card is assumed by them. Default value is 0 (Unknown/Generic setting).

tuner

Type of tuner. See list of tuner_type. tuner parameter is priorized to tuner_type parameter. Default value is determined by card parameter.

upd64031a_card

Type of uPD64031A (ghost reducer chip) implementation.

0: Use chip initial values (Default)
1: Use standard values
2: Setup values for KuroutoShikou CX23416GYC-STVLP
3: Setup values for Nagase Sangyou TransGear 5000TV
4: Setup values for IO-Data GV-MVP/RX
5: Setup values for AOpen VA2000 SNT6
6: Setup values for KuroutoShikou SAA7133GYC-STVLP(/R) or Yuan Tu800

upd64031a_card=6 is the only meaningful value for saa713x driver This is instance parameter.

upd64083_card

Type of uPD64083 (3D Y/C separator chip) implementation. See upd64031a_card parameter. This is instance parameter.

3.2.3 I2C address parameters

I2C address parameters are instance parameters specific to I2C devices. They are used to specify I2C address(es) at on-board device probing. Usually I2C device driver manages search range by itself, you can probably ignore these parameters except for special situation (e.g trying new product). By default, these parameters are empty and ignored.

They have common postfixes in its property name. Supported postfixes are listed below:

BASENAME_probe: I2C address(es) to be probed.
BASENAME_probe_range: 3-value tuple(s) of I2C address range to be probed. First value of tuple is I2C adapter ID. Value 0xffff means any adapter. Second value of tuple is starting I2C address of probe, third value is end I2C address of probe.
BASENAME_ignore: I2C address(es) to be ignored at probing.
BASENAME_ignore_range: Tuple(s) of I2C address range to be ignored at probing. See BASENAME_probe_range parameter for tuple designation.
BASENAME_force: 3-value tuple(s) of I2C address range to be attached forcibly. First value of tuple is I2C adapter ID. Value 0xffff means any adapter. Second value of tuple is I2C address where I2C device is attached. Third value is ignored.

     # Searches I2C addresses 0x40, 0x48, 0x4f for tuner from first card
     tuner_probe0 = 0x40;
     tuner_probe_range0 = 0xfffe, 0x48, 0x4f;
     tuner_ignore0 = 0x49;
     tuner_ignore_range0 = 0xfffe, 0x4a, 0x4e;

Possible basename are listed below:

tuner_POSTFIX: Specifies I2C address of tuner.
saa7133gyc_POSTFIX: Specifies I2C address of KuroutoShikou SAA7133GYC-STVLP(/R) or Yuan Tu800 support chip.
upd64031a_POSTFIX: Specifies I2C address of NEC uPD64031A (ghost reducer) chip.
upd64083_POSTFIX: Specifies I2C address of NEC uPD64083 (3D Y/C separator) chip.
tda9887_POSTFIX: Specifies I2C address of Philips TDA9885/9886/9887 (radio/TV demodulator) chip.