Merge tag '9p-for-5.4' of git://github.com/martinetd/linux
[sfrench/cifs-2.6.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 The device node should contain a "port" node which may contain one or more
11 endpoint nodes, in accordance with video interface bindings defined in
12 Documentation/devicetree/bindings/media/video-interfaces.txt .
13
14 Mandatory properties
15 --------------------
16
17 - compatible: "nokia,smia"
18 - reg: I2C address (0x10, or an alternative address)
19 - vana-supply: Analogue voltage supply (VANA), typically 2,8 volts (sensor
20   dependent).
21 - clocks: External clock to the sensor
22 - clock-frequency: Frequency of the external clock to the sensor
23 - link-frequencies: List of allowed data link frequencies. An array of
24   64-bit elements.
25
26
27 Optional properties
28 -------------------
29
30 - nokia,nvm-size: The size of the NVM, in bytes. If the size is not given,
31   the NVM contents will not be read.
32 - reset-gpios: XSHUTDOWN GPIO
33 - flash-leds: See ../video-interfaces.txt
34 - lens-focus: See ../video-interfaces.txt
35 - rotation: Integer property; valid values are 0 (sensor mounted upright)
36             and 180 (sensor mounted upside down). See
37             ../video-interfaces.txt .
38
39
40 Endpoint node mandatory properties
41 ----------------------------------
42
43 - data-lanes: <1..n>
44
45
46 Example
47 -------
48
49 &i2c2 {
50         clock-frequency = <400000>;
51
52         camera-sensor@10 {
53                 compatible = "nokia,smia";
54                 reg = <0x10>;
55                 reset-gpios = <&gpio3 20 0>;
56                 vana-supply = <&vaux3>;
57                 clocks = <&omap3_isp 0>;
58                 clock-frequency = <9600000>;
59                 nokia,nvm-size = <512>; /* 8 * 64 */
60                 link-frequencies = /bits/ 64 <199200000 210000000 499200000>;
61                 port {
62                         smiapp_ep: endpoint {
63                                 data-lanes = <1 2>;
64                                 remote-endpoint = <&csi2a_ep>;
65                         };
66                 };
67         };
68 };