GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / devicetree / bindings / media / i2c / nokia,smia.txt
1 SMIA/SMIA++ sensor
2
3 SMIA (Standard Mobile Imaging Architecture) is an image sensor standard
4 defined jointly by Nokia and ST. SMIA++, defined by Nokia, is an extension
5 of that. These definitions are valid for both types of sensors.
6
7 More detailed documentation can be found in
8 Documentation/devicetree/bindings/media/video-interfaces.txt .
9
10
11 Mandatory properties
12 --------------------
13
14 - compatible: "nokia,smia"
15 - reg: I2C address (0x10, or an alternative address)
16 - vana-supply: Analogue voltage supply (VANA), typically 2,8 volts (sensor
17   dependent).
18 - clocks: External clock to the sensor
19 - clock-frequency: Frequency of the external clock to the sensor
20 - link-frequencies: List of allowed data link frequencies. An array of
21   64-bit elements.
22
23
24 Optional properties
25 -------------------
26
27 - nokia,nvm-size: The size of the NVM, in bytes. If the size is not given,
28   the NVM contents will not be read.
29 - reset-gpios: XSHUTDOWN GPIO
30 - flash-leds: See ../video-interfaces.txt
31 - lens-focus: See ../video-interfaces.txt
32 - rotation: Integer property; valid values are 0 (sensor mounted upright)
33             and 180 (sensor mounted upside down). See
34             ../video-interfaces.txt .
35
36
37 Endpoint node mandatory properties
38 ----------------------------------
39
40 - clock-lanes: <0>
41 - data-lanes: <1..n>
42 - remote-endpoint: A phandle to the bus receiver's endpoint node.
43
44
45 Example
46 -------
47
48 &i2c2 {
49         clock-frequency = <400000>;
50
51         smiapp_1: camera@10 {
52                 compatible = "nokia,smia";
53                 reg = <0x10>;
54                 reset-gpios = <&gpio3 20 0>;
55                 vana-supply = <&vaux3>;
56                 clocks = <&omap3_isp 0>;
57                 clock-frequency = <9600000>;
58                 nokia,nvm-size = <512>; /* 8 * 64 */
59                 link-frequencies = /bits/ 64 <199200000 210000000 499200000>;
60                 port {
61                         smiapp_1_1: endpoint {
62                                 clock-lanes = <0>;
63                                 data-lanes = <1 2>;
64                                 remote-endpoint = <&csi2a_ep>;
65                         };
66                 };
67         };
68 };