From 7488e22d23a06d784cadf360a13e96e14900d01f Mon Sep 17 00:00:00 2001
From: Wang Panzhenzhuan <randy.wang@rock-chips.com>
Date: Thu, 6 May 2021 14:05:14 +0800
Subject: [PATCH] dt-bindings: media: i2c: Document add hi846

Signed-off-by: Wang Panzhenzhuan <randy.wang@rock-chips.com>
Change-Id: I94f48ed9d931a30d08f4af6d5c8ee203a4afbdf8
---
 .../devicetree/bindings/media/i2c/hi846.txt   | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/media/i2c/hi846.txt

diff --git a/Documentation/devicetree/bindings/media/i2c/hi846.txt b/Documentation/devicetree/bindings/media/i2c/hi846.txt
new file mode 100644
index 000000000000..1b79cd8302a8
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/i2c/hi846.txt
@@ -0,0 +1,61 @@
+* Hynix hi846 MIPI CSI-2 sensor
+
+Required Properties:
+- compatible: should be "hynix,hi846"
+- clocks: reference to the 24M xvclk input clock.
+- clock-names: should be "xvclk".
+- dovdd-supply: Digital I/O voltage supply, 1.8 or 2.8 volts
+- avdd-supply: Analog voltage supply, 2.8 volts
+- dvdd-supply: Digital core voltage supply, 1.2 volts
+- power-gpios : High active reset gpio
+- reset-gpios: High active reset gpio
+- pwdn-gpios: High active reset gpio
+Optional Properties:
+- flash-leds : attached led node
+- lens-focus : attached vcm for focus
+
+Attention:
+hi846 device address is decided by I2C_ID_SEL0 & I2C_ID_SEL1 pins;
+
+Slave address(@ 8bit) I2C_ID_SEL0 I2C_ID_SEL1
+W : 0x40 / R : 0x41 Low(default) Low(default)
+W : 0x44 / R : 0x45 Low High
+W : 0x42 / R : 0x43 High Low
+W : 0x46 / R : 0x47 High High
+
+The device node must contain one 'port' child node for its digital output
+video port, in accordance with the video interface bindings defined in
+Documentation/devicetree/bindings/media/video-interfaces.txt.
+
+Example:
+//RK356x Board
+&i2c2 {
+	status = "okay";
+
+	hi846: hi846@20 {
+		status = "okay";
+		compatible = "hynix,hi846";
+		reg = <0x20>;
+		clocks = <&cru CLK_CIF_OUT>;
+		clock-names = "xvclk";
+		power-domains = <&power RK3568_PD_VI>;
+		pinctrl-names = "default";
+		pinctrl-0 = <&cam_clkout0>;
+		power-gpios = <&gpio0 RK_PC1 GPIO_ACTIVE_HIGH>;
+		reset-gpios = <&gpio4 RK_PA7 GPIO_ACTIVE_HIGH>;
+		pwdn-gpios = <&gpio4 RK_PB2 GPIO_ACTIVE_HIGH>;
+		rockchip,camera-module-index = <0>;
+		rockchip,camera-module-facing = "back";
+		rockchip,camera-module-name = "KYT-8648-V1.0";
+		rockchip,camera-module-lens-name = "default";
+		flash-leds = <&flash_rgb13h>;
+		lens-focus = <&dw9714>;
+		port {
+			hi846_out: endpoint {
+				remote-endpoint = <&mipi_in_hi846>;
+				data-lanes = <1 2>;
+				//or data-lanes = <1 2 3 4>;
+			};
+		};
+	};
+};