From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from regular1.263xmail.com ([211.150.99.133]:35893 "EHLO regular1.263xmail.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S965372AbeCHGjA (ORCPT ); Thu, 8 Mar 2018 01:39:00 -0500 From: Wen Nuan To: mchehab@kernel.org, davem@davemloft.net, gregkh@linuxfoundation.org, linus.walleij@linaro.org, rdunlap@infradead.org, jacob2.chen@rock-chips.com Cc: linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, eddie.cai@rock-chips.com, Leo Wen Subject: [PATCH v4 2/2] dt-bindings: Document the Rockchip RK1608 bindings Date: Thu, 8 Mar 2018 14:38:42 +0800 Message-Id: <1520491122-5629-3-git-send-email-leo.wen@rock-chips.com> In-Reply-To: <1520491122-5629-1-git-send-email-leo.wen@rock-chips.com> References: <1520491122-5629-1-git-send-email-leo.wen@rock-chips.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-media-owner@vger.kernel.org List-ID: From: Leo Wen Add DT bindings documentation for Rockchip RK1608. Changes V4: - Revise the comment of node. - Revise the comment of 'endpoint@1'. Signed-off-by: Leo Wen --- Documentation/devicetree/bindings/media/rk1608.txt | 95 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 96 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/rk1608.txt diff --git a/Documentation/devicetree/bindings/media/rk1608.txt b/Documentation/devicetree/bindings/media/rk1608.txt new file mode 100644 index 0000000..ea23d2d --- /dev/null +++ b/Documentation/devicetree/bindings/media/rk1608.txt @@ -0,0 +1,95 @@ +Rockchip RK1608 as a PreISP to link on Soc +------------------------------------------ + +Required properties: + +- compatible : "rockchip,rk1608"; +- reg : SPI slave address of the rk1608; +- clocks : Must contain an entry for each entry in clock-names; +- clock-names : Must contain "mclk" for the device's master clock; +- reset-gpios : GPIO connected to reset pin; +- irq-gpios : GPIO connected to irq pin; +- sleepst-gpios : GPIO connected to sleepst pin; +- wakeup-gpios : GPIO connected to wakeup pin; +- powerdown-gpios : GPIO connected to powerdown pin; +- pinctrl-names : Should contain only one value - "default"; +- pinctrl-0 : Pin control group to be used for this controller; + +Optional properties: + +- spi-max-frequency : Maximum SPI clocking speed of the device; + +The device node should contain one or two port child nodes with child +'endpoint' node. There are two ports then port@0 must +describe the output and port@1 input channels. Please refer to the +bindings defined in +Documentation/devicetree/bindings/media/video-interfaces.txt. + +endpoint node +------------- + +- data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in + video-interfaces.txt. If present it should be <1> - the device + supports only one data lane without re-mapping. + +Note1: Since no data is generated in RK1608，so this is meaningful that you need +a extra sensor (such as a camera) mounted on RK1608. You need to use endpoint@x +to match these sensors. + +Note2:You must set the current value of the spi pins to be 8mA, if they are not. + +Example: +&spi0 { + status = "okay"; + spi_rk1608@00 { + compatible = "rockchip,rk1608"; + status = "okay"; + reg = <0>; + spi-max-frequency = <24000000>; + link-freqs = /bits/ 64 ; + clocks = <&cru SCLK_SPI0>, <&cru SCLK_VIP_OUT>, + <&cru DCLK_VOP0>, <&cru ACLK_VIP>, <&cru HCLK_VIP>, + <&cru PCLK_ISP_IN>, <&cru PCLK_ISP_IN>, + <&cru PCLK_ISP_IN>, <&cru SCLK_MIPIDSI_24M>, + <&cru PCLK_MIPI_CSI>; + clock-names = "mclk", "mipi_clk", "pd_cif", "aclk_cif", + "hclk_cif", "cif0_in", "g_pclkin_cif", + "cif0_out", "clk_mipi_24m", "hclk_mipiphy"; + reset-gpios = <&gpio6 0 GPIO_ACTIVE_HIGH>; + irq-gpios = <&gpio6 2 GPIO_ACTIVE_HIGH>; + sleepst-gpios = <&gpio6 1 GPIO_ACTIVE_HIGH>; + wakeup-gpios = <&gpio6 4 GPIO_ACTIVE_HIGH>; + powerdown-gpios = <&gpio8 0 GPIO_ACTIVE_HIGH>; + + pinctrl-names = "default"; + pinctrl-0 = <&rk1608_irq_gpios &rk1608_wake_gpios + &rk1608_sleep_gpios>; + + ports { + #address-cells = <1>; + #size-cells = <0>; + port@0 { + mipi_dphy_out0: endpoint@0 { + remote-endpoint = <&mipi_dphy_in0>; + clock-lanes = <0>; + data-lanes = <1 2 3 4>; + clock-noncontinuous; + link-frequencies = + /bits/ 64 ; + }; + }; + + port@1 { + sensor_in0: endpoint@0 { + remote-endpoint = <&sensor_out0>; + }; + /* If you have a second sensor, + * add the 'endpoint@1' node here. + */ + sensor_in1: endpoint@1 { + remote-endpoint = <&sensor_out1>; + }; + }; + }; + }; +}; diff --git a/MAINTAINERS b/MAINTAINERS index b2a98e3..04d227b 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -141,6 +141,7 @@ M: Leo Wen S: Maintained F: drivers/media/spi/rk1608.c F: drivers/media/spi/rk1608.h +F: Documentation/devicetree/bindings/media/rk1608.txt 3C59X NETWORK DRIVER M: Steffen Klassert -- 2.7.4