Commit da5c791c authored by Sakari Ailus's avatar Sakari Ailus Committed by Mauro Carvalho Chehab
Browse files

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



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: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent bb4bba92

include/media/v4l2-fwnode.h

+8 −10
Original line number Diff line number Diff line
@@ -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.

 *

CRA Git | Maintained and supported by SUSTech CRA and CCSE