AuxXxilium/linux_dsm_epyc7002
1
0
Fork 0
mirror of https://github.com/AuxXxilium/linux_dsm_epyc7002.git synced 2025-01-20 00:46:22 +07:00
Code Issues Actions Packages Projects Releases Wiki Activity

media: v4l2-fwnode: Document new usage patterns of v4l2_fwnode_endpoint_parse

Browse Source 
Document that it is possible to provide defaults for multiple bus types to
v4l2_fwnode_endpoint_parse and v4l2_fwnode_endpoint_alloc_parse. Also
underline the fact that detecting the bus type without bus-type property
is only for the old drivers.

Also correct capitalisation of BT.656.

Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
This commit is contained in:
Sakari Ailus 2020-09-08 10:23:29 +02:00 committed by Mauro Carvalho Chehab
parent bb4bba9232
commit da5c791cfc
1 changed files with 8 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
include/media/v4l2-fwnode.h
View File

@ -226,11 +226,10 @@ struct v4l2_fwnode_connector {
* call this function once the correct type is found --- with a default
* configuration valid for that type.
*
* As a compatibility means guessing the bus type is also supported by setting
* @vep.bus_type to V4L2_MBUS_UNKNOWN. The caller may not provide a default
* configuration in this case as the defaults are specific to a given bus type.
* This functionality is deprecated and should not be used in new drivers and it
* is only supported for CSI-2 D-PHY, parallel and Bt.656 buses.
* It is also allowed to set @vep.bus_type to V4L2_MBUS_UNKNOWN. USING THIS
* FEATURE REQUIRES "bus-type" PROPERTY IN DT BINDINGS. For old drivers,
* guessing @vep.bus_type between CSI-2 D-PHY, parallel and BT.656 busses is
* supported. NEVER RELY ON GUESSING @vep.bus_type IN NEW DRIVERS!
*
* The function does not change the V4L2 fwnode endpoint state if it fails.
*
@ -269,11 +268,10 @@ void v4l2_fwnode_endpoint_free(struct v4l2_fwnode_endpoint *vep);
* call this function once the correct type is found --- with a default
* configuration valid for that type.
*
* As a compatibility means guessing the bus type is also supported by setting
* @vep.bus_type to V4L2_MBUS_UNKNOWN. The caller may not provide a default
* configuration in this case as the defaults are specific to a given bus type.
* This functionality is deprecated and should not be used in new drivers and it
* is only supported for CSI-2 D-PHY, parallel and Bt.656 buses.
* It is also allowed to set @vep.bus_type to V4L2_MBUS_UNKNOWN. USING THIS
* FEATURE REQUIRES "bus-type" PROPERTY IN DT BINDINGS. For old drivers,
* guessing @vep.bus_type between CSI-2 D-PHY, parallel and BT.656 busses is
* supported. NEVER RELY ON GUESSING @vep.bus_type IN NEW DRIVERS!
*
* The function does not change the V4L2 fwnode endpoint state if it fails.
*