dt-bindings: media: Add macros for video interface devices

Add a new dt-bindings/media/video-interface-devices.h header that
defines macros corresponding to the orientation enumeration types from
media/video-interface-devices.yaml.

Expand the documentation of the video-interface-devices orientation to
reference the new header which provides human readable defines for the
orientation enum, to help avoid hardcoding values in dts.

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Acked-by: Conor Dooley <conor.dooley@microchip.com>
Acked-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Vladimir Zapolskiy <vladimir.zapolskiy@linaro.org>
Reviewed-by: Frank Li <Frank.Li@nxp.com>
Acked-by: Michael Riesch <michael.riesch@collabora.com>
Reviewed-by: David Heidelberg <david@ixit.cz>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
This commit is contained in:
Kieran Bingham 2026-08-04 20:43:28 +01:00 committed by Sakari Ailus
parent 3542921bd1
commit 6ab5acfb8d
2 changed files with 24 additions and 6 deletions

View File

@ -392,17 +392,22 @@ properties:
The orientation of a device (typically an image sensor or a flash LED)
describing its mounting position relative to the usage orientation of the
system where the device is installed on.
See include/dt-bindings/media/video-interface-devices.h.
$ref: /schemas/types.yaml#/definitions/uint32
enum:
# Front. The device is mounted on the front facing side of the system. For
# mobile devices such as smartphones, tablets and laptops the front side
# is the user facing side.
# MEDIA_ORIENTATION_FRONT
# The device is mounted on the front facing side of the system. For
# mobile devices such as smartphones, tablets and laptops the front
# side is the user facing side.
- 0
# Back. The device is mounted on the back side of the system, which is
# MEDIA_ORIENTATION_BACK
# The device is mounted on the back side of the system, which is
# defined as the opposite side of the front facing one.
- 1
# External. The device is not attached directly to the system but is
# attached in a way that allows it to move freely.
# MEDIA_ORIENTATION_EXTERNAL
# The device is not attached directly to the system but is attached in
# a way that allows it to move freely.
- 2
additionalProperties: true

View File

@ -0,0 +1,13 @@
/* SPDX-License-Identifier: (GPL-2.0-only OR MIT) */
/*
* Copyright (C) 2026 Kieran Bingham <kieran.bingham@ideasonboard.com>
*/
#ifndef __DT_BINDINGS_MEDIA_VIDEO_INTERFACE_DEVICES_H__
#define __DT_BINDINGS_MEDIA_VIDEO_INTERFACE_DEVICES_H__
#define MEDIA_ORIENTATION_FRONT 0
#define MEDIA_ORIENTATION_BACK 1
#define MEDIA_ORIENTATION_EXTERNAL 2
#endif /* __DT_BINDINGS_MEDIA_VIDEO_INTERFACE_DEVICES_H__ */