mirror of
https://github.com/torvalds/linux
synced 2024-10-21 18:59:26 +00:00
media: dt-bindings: nokia,smia: Convert to YAML
Convert nokia,smia DT bindings to YAML. Also add explicit license to bindings. Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com> Reviewed-by: Rob Herring <robh@kernel.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
This commit is contained in:
parent
390bb477eb
commit
8265d427ed
|
@ -1,67 +0,0 @@
|
||||||
SMIA/SMIA++ sensor
|
|
||||||
|
|
||||||
SMIA (Standard Mobile Imaging Architecture) is an image sensor standard
|
|
||||||
defined jointly by Nokia and ST. SMIA++, defined by Nokia, is an extension
|
|
||||||
of that. These definitions are valid for both types of sensors.
|
|
||||||
|
|
||||||
More detailed documentation can be found in
|
|
||||||
Documentation/devicetree/bindings/media/video-interfaces.txt .
|
|
||||||
|
|
||||||
The device node should contain a "port" node which may contain one or more
|
|
||||||
endpoint nodes, in accordance with video interface bindings defined in
|
|
||||||
Documentation/devicetree/bindings/media/video-interfaces.txt .
|
|
||||||
|
|
||||||
Mandatory properties
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
- compatible: "nokia,smia"
|
|
||||||
- reg: I2C address (0x10, or an alternative address)
|
|
||||||
- clocks: External clock to the sensor
|
|
||||||
- clock-frequency: Frequency of the external clock to the sensor
|
|
||||||
|
|
||||||
|
|
||||||
Optional properties
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
- reset-gpios: XSHUTDOWN GPIO
|
|
||||||
- flash-leds: See ../video-interfaces.txt
|
|
||||||
- lens-focus: See ../video-interfaces.txt
|
|
||||||
- rotation: Integer property; valid values are 0 (sensor mounted upright)
|
|
||||||
and 180 (sensor mounted upside down). See
|
|
||||||
../video-interfaces.txt .
|
|
||||||
- vana-supply: Analogue voltage supply (VANA), typically 2,8 volts (sensor
|
|
||||||
dependent).
|
|
||||||
|
|
||||||
|
|
||||||
Endpoint node mandatory properties
|
|
||||||
----------------------------------
|
|
||||||
|
|
||||||
- data-lanes: <1..n>
|
|
||||||
- link-frequencies: List of allowed data link frequencies. An array of
|
|
||||||
64-bit elements.
|
|
||||||
|
|
||||||
|
|
||||||
Example
|
|
||||||
-------
|
|
||||||
|
|
||||||
&i2c2 {
|
|
||||||
clock-frequency = <400000>;
|
|
||||||
|
|
||||||
camera-sensor@10 {
|
|
||||||
compatible = "nokia,smia";
|
|
||||||
reg = <0x10>;
|
|
||||||
reset-gpios = <&gpio3 20 0>;
|
|
||||||
vana-supply = <&vaux3>;
|
|
||||||
clocks = <&omap3_isp 0>;
|
|
||||||
clock-frequency = <9600000>;
|
|
||||||
port {
|
|
||||||
smiapp_ep: endpoint {
|
|
||||||
data-lanes = <1 2>;
|
|
||||||
remote-endpoint = <&csi2a_ep>;
|
|
||||||
link-frequencies =
|
|
||||||
/bits/ 64 <199200000 210000000
|
|
||||||
499200000>;
|
|
||||||
};
|
|
||||||
};
|
|
||||||
};
|
|
||||||
};
|
|
106
Documentation/devicetree/bindings/media/i2c/nokia,smia.yaml
Normal file
106
Documentation/devicetree/bindings/media/i2c/nokia,smia.yaml
Normal file
|
@ -0,0 +1,106 @@
|
||||||
|
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||||
|
# Copyright (C) 2014--2020 Intel Corporation
|
||||||
|
|
||||||
|
$id: http://devicetree.org/schemas/media/i2c/nokia,smia.yaml#
|
||||||
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||||
|
|
||||||
|
title: SMIA/SMIA++ sensor
|
||||||
|
|
||||||
|
maintainers:
|
||||||
|
- Sakari Ailus <sakari.ailus@linux.intel.com>
|
||||||
|
|
||||||
|
description:
|
||||||
|
|
||||||
|
SMIA (Standard Mobile Imaging Architecture) is an image sensor standard
|
||||||
|
defined jointly by Nokia and ST. SMIA++, defined by Nokia, is an extension of
|
||||||
|
that. These definitions are valid for both types of sensors.
|
||||||
|
|
||||||
|
More detailed documentation can be found in
|
||||||
|
Documentation/devicetree/bindings/media/video-interfaces.txt .
|
||||||
|
|
||||||
|
properties:
|
||||||
|
compatible:
|
||||||
|
const: nokia,smia
|
||||||
|
|
||||||
|
reg:
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
vana-supply:
|
||||||
|
description: Analogue voltage supply (VANA), typically 2,8 volts (sensor
|
||||||
|
dependent).
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
clocks:
|
||||||
|
description: External clock to the sensor.
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
clock-frequency:
|
||||||
|
description: Frequency of the external clock to the sensor in Hz.
|
||||||
|
|
||||||
|
reset-gpios:
|
||||||
|
description: Reset GPIO. Also commonly called XSHUTDOWN in hardware
|
||||||
|
documentation.
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
flash-leds:
|
||||||
|
description: Flash LED phandles. See ../video-interfaces.txt for details.
|
||||||
|
|
||||||
|
lens-focus:
|
||||||
|
description: Lens focus controller phandles. See ../video-interfaces.txt
|
||||||
|
for details.
|
||||||
|
|
||||||
|
rotation:
|
||||||
|
description: Rotation of the sensor. See ../video-interfaces.txt for
|
||||||
|
details.
|
||||||
|
enum: [ 0, 180 ]
|
||||||
|
|
||||||
|
port:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
endpoint:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
link-frequencies:
|
||||||
|
$ref: /schemas/types.yaml#/definitions/uint64-array
|
||||||
|
description: List of allowed data link frequencies.
|
||||||
|
data-lanes:
|
||||||
|
minItems: 1
|
||||||
|
maxItems: 8
|
||||||
|
required:
|
||||||
|
- link-frequencies
|
||||||
|
- data-lanes
|
||||||
|
|
||||||
|
required:
|
||||||
|
- compatible
|
||||||
|
- reg
|
||||||
|
- clock-frequency
|
||||||
|
- clocks
|
||||||
|
|
||||||
|
additionalProperties: false
|
||||||
|
|
||||||
|
examples:
|
||||||
|
- |
|
||||||
|
i2c2 {
|
||||||
|
#address-cells = <1>;
|
||||||
|
#size-cells = <0>;
|
||||||
|
|
||||||
|
clock-frequency = <400000>;
|
||||||
|
|
||||||
|
camera-sensor@10 {
|
||||||
|
compatible = "nokia,smia";
|
||||||
|
reg = <0x10>;
|
||||||
|
reset-gpios = <&gpio3 20 0>;
|
||||||
|
vana-supply = <&vaux3>;
|
||||||
|
clocks = <&omap3_isp 0>;
|
||||||
|
clock-frequency = <9600000>;
|
||||||
|
port {
|
||||||
|
smiapp_ep: endpoint {
|
||||||
|
data-lanes = <1 2>;
|
||||||
|
remote-endpoint = <&csi2a_ep>;
|
||||||
|
link-frequencies = /bits/ 64 <199200000 210000000
|
||||||
|
499200000>;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
...
|
|
@ -11634,7 +11634,7 @@ MIPI CCS, SMIA AND SMIA++ IMAGE SENSOR DRIVER
|
||||||
M: Sakari Ailus <sakari.ailus@linux.intel.com>
|
M: Sakari Ailus <sakari.ailus@linux.intel.com>
|
||||||
L: linux-media@vger.kernel.org
|
L: linux-media@vger.kernel.org
|
||||||
S: Maintained
|
S: Maintained
|
||||||
F: Documentation/devicetree/bindings/media/i2c/nokia,smia.txt
|
F: Documentation/devicetree/bindings/media/i2c/nokia,smia.yaml
|
||||||
F: Documentation/driver-api/media/drivers/ccs/
|
F: Documentation/driver-api/media/drivers/ccs/
|
||||||
F: drivers/media/i2c/ccs/
|
F: drivers/media/i2c/ccs/
|
||||||
F: drivers/media/i2c/smiapp-pll.c
|
F: drivers/media/i2c/smiapp-pll.c
|
||||||
|
|
Loading…
Reference in a new issue