Sylwester Nawrocki | ae704bc | 2013-12-20 19:57:47 -0300 | [diff] [blame] | 1 | Samsung S5C73M3 8Mp camera ISP |
| 2 | ------------------------------ |
| 3 | |
| 4 | The S5C73M3 camera ISP supports MIPI CSI-2 and parallel (ITU-R BT.656) video |
| 5 | data busses. The I2C bus is the main control bus and additionally the SPI bus |
| 6 | is used, mostly for transferring the firmware to and from the device. Two |
| 7 | slave device nodes corresponding to these control bus interfaces are required |
| 8 | and should be placed under respective bus controller nodes. |
| 9 | |
| 10 | I2C slave device node |
| 11 | --------------------- |
| 12 | |
| 13 | Required properties: |
| 14 | |
| 15 | - compatible : "samsung,s5c73m3"; |
| 16 | - reg : I2C slave address of the sensor; |
| 17 | - vdd-int-supply : digital power supply (1.2V); |
| 18 | - vdda-supply : analog power supply (1.2V); |
| 19 | - vdd-reg-supply : regulator input power supply (2.8V); |
| 20 | - vddio-host-supply : host I/O power supply (1.8V to 2.8V); |
| 21 | - vddio-cis-supply : CIS I/O power supply (1.2V to 1.8V); |
| 22 | - vdd-af-supply : lens power supply (2.8V); |
| 23 | - xshutdown-gpios : specifier of GPIO connected to the XSHUTDOWN pin; |
| 24 | - standby-gpios : specifier of GPIO connected to the STANDBY pin; |
| 25 | - clocks : should contain list of phandle and clock specifier pairs |
| 26 | according to common clock bindings for the clocks described |
| 27 | in the clock-names property; |
| 28 | - clock-names : should contain "cis_extclk" entry for the CIS_EXTCLK clock; |
| 29 | |
| 30 | Optional properties: |
| 31 | |
| 32 | - clock-frequency : the frequency at which the "cis_extclk" clock should be |
| 33 | configured to operate, in Hz; if this property is not |
| 34 | specified default 24 MHz value will be used. |
| 35 | |
| 36 | The common video interfaces bindings (see video-interfaces.txt) should be used |
| 37 | to specify link from the S5C73M3 to an external image data receiver. The S5C73M3 |
| 38 | device node should contain one 'port' child node with an 'endpoint' subnode for |
| 39 | this purpose. The data link from a raw image sensor to the S5C73M3 can be |
| 40 | similarly specified, but it is optional since the S5C73M3 ISP and a raw image |
| 41 | sensor are usually inseparable and form a hybrid module. |
| 42 | |
| 43 | Following properties are valid for the endpoint node(s): |
| 44 | |
| 45 | endpoint subnode |
| 46 | ---------------- |
| 47 | |
| 48 | - data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in |
| 49 | video-interfaces.txt. This sensor doesn't support data lane remapping |
| 50 | and physical lane indexes in subsequent elements of the array should |
| 51 | be only consecutive ascending values. |
| 52 | |
| 53 | SPI device node |
| 54 | --------------- |
| 55 | |
| 56 | Required properties: |
| 57 | |
| 58 | - compatible : "samsung,s5c73m3"; |
| 59 | |
| 60 | For more details see description of the SPI busses bindings |
| 61 | (../spi/spi-bus.txt) and bindings of a specific bus controller. |
| 62 | |
| 63 | Example: |
| 64 | |
| 65 | i2c@138A000000 { |
| 66 | ... |
| 67 | s5c73m3@3c { |
| 68 | compatible = "samsung,s5c73m3"; |
| 69 | reg = <0x3c>; |
| 70 | vdd-int-supply = <&buck9_reg>; |
| 71 | vdda-supply = <&ldo17_reg>; |
| 72 | vdd-reg-supply = <&cam_io_reg>; |
| 73 | vddio-host-supply = <&ldo18_reg>; |
| 74 | vddio-cis-supply = <&ldo9_reg>; |
| 75 | vdd-af-supply = <&cam_af_reg>; |
| 76 | clock-frequency = <24000000>; |
| 77 | clocks = <&clk 0>; |
| 78 | clock-names = "cis_extclk"; |
| 79 | reset-gpios = <&gpf1 3 1>; |
| 80 | standby-gpios = <&gpm0 1 1>; |
| 81 | port { |
| 82 | s5c73m3_ep: endpoint { |
| 83 | remote-endpoint = <&csis0_ep>; |
| 84 | data-lanes = <1 2 3 4>; |
| 85 | }; |
| 86 | }; |
| 87 | }; |
| 88 | }; |
| 89 | |
| 90 | spi@1392000 { |
| 91 | ... |
| 92 | s5c73m3_spi: s5c73m3@0 { |
| 93 | compatible = "samsung,s5c73m3"; |
| 94 | reg = <0>; |
| 95 | ... |
| 96 | }; |
| 97 | }; |