From patchwork Tue Mar 7 14:37:50 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ramiro Oliveira X-Patchwork-Id: 9609053 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 5B378604DD for ; Tue, 7 Mar 2017 14:44:37 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5660C28515 for ; Tue, 7 Mar 2017 14:44:37 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 4AF6D28518; Tue, 7 Mar 2017 14:44:37 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D07DC28515 for ; Tue, 7 Mar 2017 14:44:36 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755751AbdCGOoe (ORCPT ); Tue, 7 Mar 2017 09:44:34 -0500 Received: from smtprelay.synopsys.com ([198.182.47.9]:45064 "EHLO smtprelay.synopsys.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755588AbdCGOns (ORCPT ); Tue, 7 Mar 2017 09:43:48 -0500 Received: from mailhost.synopsys.com (mailhost1.synopsys.com [10.12.238.239]) by smtprelay.synopsys.com (Postfix) with ESMTP id 6C95124E09D3; Tue, 7 Mar 2017 06:43:13 -0800 (PST) Received: from mailhost.synopsys.com (localhost [127.0.0.1]) by mailhost.synopsys.com (Postfix) with ESMTP id 3B345E2; Tue, 7 Mar 2017 06:43:13 -0800 (PST) Received: from arc-dev.internal.synopsys.com (roliveir-e7470.internal.synopsys.com [10.107.25.136]) by mailhost.synopsys.com (Postfix) with ESMTP id D1FB7FCA; Tue, 7 Mar 2017 06:43:07 -0800 (PST) From: Ramiro Oliveira To: linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, devicetree@vger.kernel.org Cc: CARLOS.PALMINHA@synopsys.com, Ramiro Oliveira , Andrew-CT Chen , Andrew Morton , Arnd Bergmann , Benoit Parrot , "David S. Miller" , Geert Uytterhoeven , Greg Kroah-Hartman , Guenter Roeck , Hans Verkuil , Hugues Fruchet , Jean-Christophe Trotin , Kamil Debski , Laurent Pinchart , Mark Rutland , Mauro Carvalho Chehab , Minghsiu Tsai , =?UTF-8?q?Niklas=20S=C3=B6derlund?= , Peter Griffin , Rick Chang , Rob Herring , Simon Horman , Tiffany Lin Subject: [PATCH 3/4] Documentation: dt: Add bindings documentation for CSI-2 Host Video Platform Date: Tue, 7 Mar 2017 14:37:50 +0000 Message-Id: <95825021f5eae29a118ce0a2570c5c1886023110.1488885081.git.roliveir@synopsys.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: References: In-Reply-To: References: Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Create device tree bindings documentation for the CSI-2 Host Video platform. Signed-off-by: Ramiro Oliveira --- .../devicetree/bindings/media/snps,plat-csi2.txt | 77 ++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/snps,plat-csi2.txt diff --git a/Documentation/devicetree/bindings/media/snps,plat-csi2.txt b/Documentation/devicetree/bindings/media/snps,plat-csi2.txt new file mode 100644 index 000000000000..f559257a0a44 --- /dev/null +++ b/Documentation/devicetree/bindings/media/snps,plat-csi2.txt @@ -0,0 +1,77 @@ +Synopsys DesignWare CSI-2 Host Video Platform + +The Synopsys DesignWare CSI-2 Host Video Device subsystem comprises of multiple +sub-devices represented by separate device tree nodes. Currently this includes: +plat-csi2, video-device, and dw-mipi-csi. + +The sub-subdevices are defined as child nodes of the common 'camera'. + +Common 'camera' node +-------------------- + +Required properties: + +- compatible: must be "snps,plat-csi2", "simple-bus" + +The 'camera' node must include at least one 'video-device' and one 'dw-mipi-csi' +child node. + +'video-device' device nodes +------------------- + +Required properties: + +- compatible: "snps,video-device" +- dmas, dma-names: List of one DMA specifier and identifier string (as defined + in Documentation/devicetree/bindings/dma/dma.txt) per port. Each port + requires a DMA channel with the identifier string set to "vdma" followed by + the port index. + +Image sensor nodes +------------------ + +The sensor device nodes should be added to their control bus controller (e.g. +I2C0) nodes and linked to a port node in the dw-mipi-csi,using the common video +interfaces bindings, defined in video-interfaces.txt. + +Example: + + + camera { + compatible = "snps,plat-csi2", "simple-bus"; + #address-cells = <1>; + #size-cells = <1>; + ranges; + video_device: video-device@0x10000 { + compatible = "snps,video-device"; + dmas = <&axi_vdma_0 0>; + dma-names = "vdma0"; + }; + + csi2: csi2@0x03000 { + compatible = "snps,dw-mipi-csi"; + #address-cells = <1>; + #size-cells = <0>; + reg = < 0x03000 0x7FF>; + interrupts = <2>; + phys = <&mipi_phy_ctrl1 0>; + resets = <&csi2_rst 1>; + + output-type = <2>; + ipi-mode = <0>; + ipi-color-mode = <0>; + ipi-auto-flush = <1>; + virtual-channel = <0>; + + port@1 { + reg = <1>; + csi1_ep1: endpoint { + remote-endpoint = <&camera>; + data-lanes = <1 2>; + }; + }; + }; + }; + }; + +The dw-mipi-csi device binding is defined in snps,dw-mipi-csi.txt.