media/v4l/vidioc-dbg-g-chip-info.rst

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
10 Name  chapter
13 VIDIOC_DBG_G_CHIP_INFO - Identify the chips on a TV card
42 contact the linux-media mailing list
50 ``match.addr`` or ``match.name`` fields of a struct
53 the driver stores information about the selected chip in the ``name``
61 the PCI or USB bus. Non-zero numbers identify specific parts of the
65 selects the nth sub-device. This allows you to enumerate over all
66 sub-devices.
68 On success, the ``name`` field will contain a chip name and the
73 We recommended the v4l2-dbg utility over calling this ioctl directly. It
74 is available from the LinuxTV v4l-dvb repository; see
78 .. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{6.6cm}|
80 .. _name-v4l2-dbg-match:
82 .. flat-table:: struct v4l2_dbg_match
83     :header-rows:  0
84     :stub-columns: 0
87     * - __u32
88       - ``type``
89       - See :ref:`name-chip-match-types` for a list of possible types.
90     * - union {
91       - (anonymous)
92     * - __u32
93       - ``addr``
94       - Match a chip by this number, interpreted according to the ``type``
96     * - char
97       - ``name[32]``
98       - Match a chip by this name, interpreted according to the ``type``
100     * - }
101       -
104 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm}|
108 .. flat-table:: struct v4l2_dbg_chip_info
109     :header-rows:  0
110     :stub-columns: 0
113     * - struct v4l2_dbg_match
114       - ``match``
115       - How to match the chip, see :ref:`name-v4l2-dbg-match`.
116     * - char
117       - ``name[32]``
118       - The name of the chip.
119     * - __u32
120       - ``flags``
121       - Set by the driver. If ``V4L2_CHIP_FL_READABLE`` is set, then the
125     * - __u32
126       - ``reserved[8]``
127       - Reserved fields, both application and driver must set these to 0.
130 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}|
132 .. _name-chip-match-types:
134 .. flat-table:: Chip Match Types
135     :header-rows:  0
136     :stub-columns: 0
139     * - ``V4L2_CHIP_MATCH_BRIDGE``
140       - 0
141       - Match the nth chip on the card, zero for the bridge chip. Does not
142 	match sub-devices.
143     * - ``V4L2_CHIP_MATCH_SUBDEV``
144       - 4
145       - Match the nth sub-device.
150 On success 0 is returned, on error -1 and the ``errno`` variable is set
152 :ref:`Generic Error Codes <gen-errors>` chapter.