From patchwork Mon Nov 14 14:20:22 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ramiro Oliveira X-Patchwork-Id: 9427615 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 3DA0360471 for ; Mon, 14 Nov 2016 14:22:13 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2EBFA1FFB9 for ; Mon, 14 Nov 2016 14:22:13 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2341728971; Mon, 14 Nov 2016 14:22:13 +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=unavailable 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 8D5231FFB9 for ; Mon, 14 Nov 2016 14:22:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932389AbcKNOVp (ORCPT ); Mon, 14 Nov 2016 09:21:45 -0500 Received: from us01smtprelay-2.synopsys.com ([198.182.47.9]:60072 "EHLO smtprelay.synopsys.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751481AbcKNOVl (ORCPT ); Mon, 14 Nov 2016 09:21:41 -0500 Received: from mailhost.synopsys.com (mailhost1.synopsys.com [10.12.238.239]) by smtprelay.synopsys.com (Postfix) with ESMTP id DC45324E230A; Mon, 14 Nov 2016 06:21:38 -0800 (PST) Received: from mailhost.synopsys.com (localhost [127.0.0.1]) by mailhost.synopsys.com (Postfix) with ESMTP id B7D54144; Mon, 14 Nov 2016 06:21:38 -0800 (PST) Received: from arc-dev.internal.synopsys.com (roliveir-e7470.internal.synopsys.com [10.107.25.125]) by mailhost.synopsys.com (Postfix) with ESMTP id EA24FEE; Mon, 14 Nov 2016 06:21:33 -0800 (PST) From: Ramiro Oliveira To: robh+dt@kernel.org, mark.rutland@arm.com, mchehab@kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Cc: davem@davemloft.net, gregkh@linuxfoundation.org, geert+renesas@glider.be, akpm@linux-foundation.org, linux@roeck-us.net, hverkuil@xs4all.nl, laurent.pinchart+renesas@ideasonboard.com, arnd@arndb.de, sudipm.mukherjee@gmail.com, tiffany.lin@mediatek.com, minghsiu.tsai@mediatek.com, jean-christophe.trotin@st.com, andrew-ct.chen@mediatek.com, simon.horman@netronome.com, songjun.wu@microchip.com, bparrot@ti.com, CARLOS.PALMINHA@synopsys.com, Ramiro.Oliveira@synopsys.com Subject: [PATCH 1/2] Add Documentation for Media Device, Video Device, and Synopsys DW MIPI CSI-2 Host Date: Mon, 14 Nov 2016 14:20:22 +0000 Message-Id: <160acd0770e0685330ba8e7445423c1d6f34658e.1479132355.git.roliveir@synopsys.com> X-Mailer: git-send-email 2.10.2 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 Add documentation for Media and Video Device, as well as the DW MIPI CSI-2 Host. Signed-off-by: Ramiro Oliveira --- .../devicetree/bindings/media/snps,dw-mipi-csi.txt | 27 ++++++++++++++++++++++ .../devicetree/bindings/media/snps,plat-ipk.txt | 9 ++++++++ .../bindings/media/snps,video-device.txt | 12 ++++++++++ 3 files changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/snps,dw-mipi-csi.txt create mode 100644 Documentation/devicetree/bindings/media/snps,plat-ipk.txt create mode 100644 Documentation/devicetree/bindings/media/snps,video-device.txt diff --git a/Documentation/devicetree/bindings/media/snps,dw-mipi-csi.txt b/Documentation/devicetree/bindings/media/snps,dw-mipi-csi.txt new file mode 100644 index 0000000..bec7441 --- /dev/null +++ b/Documentation/devicetree/bindings/media/snps,dw-mipi-csi.txt @@ -0,0 +1,27 @@ +Synopsys DesignWare CSI-2 Host controller + +Description +----------- + +This HW block is used to receive image coming from an MIPI CSI-2 compatible +camera. + +Required properties: +- compatible: shall be "snps,dw-mipi-csi" +- reg : physical base address and size of the device memory mapped + registers; +- interrupts : CSI-2 Host interrupt +- data-lanes : Number of lanes to be used +- output-type : Core output to be used (IPI-> 0 or IDI->1 or BOTH->2) +- phys, phy-names: List of one PHY specifier and identifier string (as defined + in Documentation/devicetree/bindings/phy/phy-bindings.txt). + +Optional properties(if in IPI mode): +- ipi-mode : Mode to be used when in IPI(Camera -> 0 or Automatic -> 1) +- ipi-color-mode: Color depth to be used in IPI (48 bits -> 0 or 16 bits -> 1) +- ipi-auto-flush: Data auto-flush (1 -> Yes or 0 -> No) +- virtual-channel: Virtual channel where data is present when in IPI + +The per-board settings: + - port sub-node describing a single endpoint connected to the dw-mipi-csi + as described in video-interfaces.txt[1]. diff --git a/Documentation/devicetree/bindings/media/snps,plat-ipk.txt b/Documentation/devicetree/bindings/media/snps,plat-ipk.txt new file mode 100644 index 0000000..2d51541 --- /dev/null +++ b/Documentation/devicetree/bindings/media/snps,plat-ipk.txt @@ -0,0 +1,9 @@ +Synopsys DesignWare CSI-2 Host IPK Media Device + +This Media Device at the moment is not totally functional, however it is a base +for the future. + +Required properties: + +- compatible: Must be "snps,plat-ipk". + diff --git a/Documentation/devicetree/bindings/media/snps,video-device.txt b/Documentation/devicetree/bindings/media/snps,video-device.txt new file mode 100644 index 0000000..d467092 --- /dev/null +++ b/Documentation/devicetree/bindings/media/snps,video-device.txt @@ -0,0 +1,12 @@ +Synopsys DesignWare CSI-2 Host video device + +This driver handles all the video handling part of this platform. + +Required properties: + +- compatible: Must be "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 "port" followed by + the port index.