ioctl VIDIOC_DBG_G_CHIP_INFO
&manvol;
VIDIOC_DBG_G_CHIP_INFOIdentify the chips on a TV cardint ioctlint fdint requeststruct v4l2_dbg_chip_info
*argpArgumentsfd&fd;requestVIDIOC_DBG_G_CHIP_INFOargpDescriptionExperimentalThis is an experimental interface and may change in
the future.For driver debugging purposes this ioctl allows test
applications to query the driver about the chips present on the TV
card. Regular applications must not use it. When you found a chip
specific bug, please contact the linux-media mailing list (&v4l-ml;)
so it can be fixed.Additionally the Linux kernel must be compiled with the
CONFIG_VIDEO_ADV_DEBUG option to enable this ioctl.To query the driver applications must initialize the
match.type and
match.addr or match.name
fields of a &v4l2-dbg-chip-info;
and call VIDIOC_DBG_G_CHIP_INFO with a pointer to
this structure. On success the driver stores information about the
selected chip in the name and
flags fields. On failure the structure
remains unchanged.When match.type is
V4L2_CHIP_MATCH_BRIDGE,
match.addr selects the nth bridge 'chip'
on the TV card. You can enumerate all chips by starting at zero and
incrementing match.addr by one until
VIDIOC_DBG_G_CHIP_INFO fails with an &EINVAL;.
The number zero always selects the bridge chip itself, ⪚ the chip
connected to the PCI or USB bus. Non-zero numbers identify specific
parts of the bridge chip such as an AC97 register block.When match.type is
V4L2_CHIP_MATCH_SUBDEV,
match.addr selects the nth sub-device. This
allows you to enumerate over all sub-devices.On success, the name field will
contain a chip name and the flags field will
contain V4L2_CHIP_FL_READABLE if the driver supports
reading registers from the device or V4L2_CHIP_FL_WRITABLE
if the driver supports writing registers to the device.We recommended the v4l2-dbg
utility over calling this ioctl directly. It is available from the
LinuxTV v4l-dvb repository; see http://linuxtv.org/repo/ for
access instructions.
struct v4l2_dbg_match
&cs-ustr;
__u32typeSee for a list of
possible types.union(anonymous)__u32addrMatch a chip by this number, interpreted according
to the type field.charname[32]Match a chip by this name, interpreted according
to the type field.
struct v4l2_dbg_chip_info
&cs-str;
struct v4l2_dbg_matchmatchHow to match the chip, see .charname[32]The name of the chip.__u32flagsSet by the driver. If V4L2_CHIP_FL_READABLE
is set, then the driver supports reading registers from the device. If
V4L2_CHIP_FL_WRITABLE is set, then it supports writing registers.__u32reserved[8]Reserved fields, both application and driver must set these to 0.
Chip Match Types
&cs-def;
V4L2_CHIP_MATCH_BRIDGE0Match the nth chip on the card, zero for the
bridge chip. Does not match sub-devices.V4L2_CHIP_MATCH_I2C_DRIVER1Match an &i2c; chip by its driver name. Can't be used with this ioctl.V4L2_CHIP_MATCH_I2C_ADDR2Match a chip by its 7 bit &i2c; bus address. Can't be used with this ioctl.V4L2_CHIP_MATCH_AC973Match the nth anciliary AC97 chip. Can't be used with this ioctl.V4L2_CHIP_MATCH_SUBDEV4Match the nth sub-device.
&return-value;
EINVALThe match_type is invalid or
no device could be matched.