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