From patchwork Mon Dec 2 15:37:11 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thierry Reding X-Patchwork-Id: 295947 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id C52B12C00AA for ; Tue, 3 Dec 2013 02:38:07 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752464Ab3LBPiG (ORCPT ); Mon, 2 Dec 2013 10:38:06 -0500 Received: from mail-bk0-f43.google.com ([209.85.214.43]:41778 "EHLO mail-bk0-f43.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752168Ab3LBPiF (ORCPT ); Mon, 2 Dec 2013 10:38:05 -0500 Received: by mail-bk0-f43.google.com with SMTP id mz12so5427353bkb.2 for ; Mon, 02 Dec 2013 07:38:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id; bh=t+X/gKiPVmq/C9Yt8yvKSyncqvIncSgNJwl78EPISzo=; b=CSCicfAD/Zh8ABJfawnX701G/SjTXU1aNTWY32w1WQob3gTr7UwQpSKEI6nw+RdEhY uheWnkJb+4DjMfJI8sgA/VyukAf/DZhfgtEepJGek+XcM1ef9/1vHavfVPyBp+/I9bpk q3VRRnSeVX7sGOG9v1bhRFJuDGmbTg6HSZxUfeaSr4+CbCP7vypBFBqdZ48uZRX/aC5s 8JhG4kTXMnWjNuzH1lLd6GhVwfCzhgVAfHxZIOtOiFbm0NBBc91nRuDcdjD5qdQVZtRP qmTZ0vinU54dqN3X4Qggx3pXAeXoKNQ3MQhHh8IyTxWuk0tIAgK7f22zlU3eCWbGVpPW xXLQ== X-Received: by 10.204.54.136 with SMTP id q8mr67580bkg.100.1385998684494; Mon, 02 Dec 2013 07:38:04 -0800 (PST) Received: from localhost (port-9610.pppoe.wtnet.de. [84.46.37.175]) by mx.google.com with ESMTPSA id bf8sm27063212bkb.14.2013.12.02.07.38.03 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 02 Dec 2013 07:38:03 -0800 (PST) From: Thierry Reding To: Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell Cc: Andrzej Hajda , Tomasz Figa , dri-devel@lists.freedesktop.org, devicetree@vger.kernel.org Subject: [PATCH] of: Add MIPI DSI bus device tree bindings Date: Mon, 2 Dec 2013 16:37:11 +0100 Message-Id: <1385998631-18515-1-git-send-email-treding@nvidia.com> X-Mailer: git-send-email 1.8.4.2 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Document the device tree bindings for the MIPI DSI bus. The MIPI Display Serial Interface specifies a serial bus and a protocol for communication between a host and up to four peripherals. Signed-off-by: Thierry Reding Reviewed-by: Tomasz Figa --- .../devicetree/bindings/mipi/dsi/mipi-dsi-bus.txt | 54 ++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 Documentation/devicetree/bindings/mipi/dsi/mipi-dsi-bus.txt diff --git a/Documentation/devicetree/bindings/mipi/dsi/mipi-dsi-bus.txt b/Documentation/devicetree/bindings/mipi/dsi/mipi-dsi-bus.txt new file mode 100644 index 000000000000..f58ca4485a2f --- /dev/null +++ b/Documentation/devicetree/bindings/mipi/dsi/mipi-dsi-bus.txt @@ -0,0 +1,54 @@ +MIPI DSI (Display Serial Interface) busses +========================================== + +The MIPI Display Serial Interface specifies a serial bus and a protocol for +communication between a host and up to four peripherals. This document will +define the syntax used to represent a DSI bus in a device tree. + +This document describes DSI bus-specific properties only or defines existing +standard properties in the context of the DSI bus. + +Each DSI host provides a DSI bus. The DSI host controller's node contains a +set of properties that characterize the bus. Child nodes describe individual +peripherals on that bus. + +DSI host +-------- + +In addition to the standard properties and those defined by the parent bus of +a DSI host, the following properties apply to a node representing a DSI host. + +Required properties: +- #address-cells: The number of cells required to represent an address on the + bus. DSI peripherals are addressed using a 2-bit virtual channel number, so + a maximum of 4 devices can be addressed on a single bus. Hence the value of + this property should be 1. +- #size-cells: Should be 0. + +DSI peripheral +-------------- + +Peripherals are represented as child nodes of the DSI host's node. Properties +described here apply to all DSI peripherals, but individual bindings may want +to define additional, device-specific properties. + +Required properties: +- reg: The virtual channel number of a DSI peripheral. Must be in the range + from 0 to 3. + +Example +------- + + dsi-host { + ... + + #address-cells = <1>; + #size-cells = <0>; + + peripheral@0 { + compatible = "..."; + reg = <0>; + }; + + ... + };