Merge branch 'cleanups-post-3.19' of git://git.kernel.org/pub/scm/linux/kernel/git...
[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
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
31
32 Endpoint node mandatory properties
33 ----------------------------------
34
35 - clock-lanes: <0>
36 - data-lanes: <1..n>
37 - remote-endpoint: A phandle to the bus receiver's endpoint node.
38
39
40 Example
41 -------
42
43 &i2c2 {
44         clock-frequency = <400000>;
45
46         smiapp_1: camera@10 {
47                 compatible = "nokia,smia";
48                 reg = <0x10>;
49                 reset-gpios = <&gpio3 20 0>;
50                 vana-supply = <&vaux3>;
51                 clocks = <&omap3_isp 0>;
52                 clock-frequency = <9600000>;
53                 nokia,nvm-size = <512>; /* 8 * 64 */
54                 link-frequencies = /bits/ 64 <199200000 210000000 499200000>;
55                 port {
56                         smiapp_1_1: endpoint {
57                                 clock-lanes = <0>;
58                                 data-lanes = <1 2>;
59                                 remote-endpoint = <&csi2a_ep>;
60                         };
61                 };
62         };
63 };