From patchwork Tue Sep 10 15:28:54 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Kocialkowski X-Patchwork-Id: 1160410 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-gpio-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=bootlin.com Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 46STVX61cyz9s4Y for ; Wed, 11 Sep 2019 01:29:56 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2393941AbfIJP3z (ORCPT ); Tue, 10 Sep 2019 11:29:55 -0400 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:41649 "EHLO relay3-d.mail.gandi.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727457AbfIJP3y (ORCPT ); Tue, 10 Sep 2019 11:29:54 -0400 X-Originating-IP: 86.250.200.211 Received: from localhost.localdomain (lfbn-1-17395-211.w86-250.abo.wanadoo.fr [86.250.200.211]) (Authenticated sender: paul.kocialkowski@bootlin.com) by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id 6BAFD60015; Tue, 10 Sep 2019 15:29:51 +0000 (UTC) From: Paul Kocialkowski To: linux-gpio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Linus Walleij , Bartosz Golaszewski , Rob Herring , Mark Rutland , Thomas Petazzoni , Paul Kocialkowski Subject: [PATCH 2/3] dt-bindings: gpio: Add binding document for xylon logicvc-gpio Date: Tue, 10 Sep 2019 17:28:54 +0200 Message-Id: <20190910152855.111588-2-paul.kocialkowski@bootlin.com> X-Mailer: git-send-email 2.23.0 In-Reply-To: <20190910152855.111588-1-paul.kocialkowski@bootlin.com> References: <20190910152855.111588-1-paul.kocialkowski@bootlin.com> MIME-Version: 1.0 Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org The Xylon LogiCVC display controller exports some GPIOs, which are exposed as a dedicated driver. This introduces the associated device-tree bindings documentation. Signed-off-by: Paul Kocialkowski --- .../bindings/gpio/xylon,logicvc-gpio.txt | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/gpio/xylon,logicvc-gpio.txt diff --git a/Documentation/devicetree/bindings/gpio/xylon,logicvc-gpio.txt b/Documentation/devicetree/bindings/gpio/xylon,logicvc-gpio.txt new file mode 100644 index 000000000000..4835659cb90b --- /dev/null +++ b/Documentation/devicetree/bindings/gpio/xylon,logicvc-gpio.txt @@ -0,0 +1,48 @@ +Xylon LogiCVC GPIO controller + +The Xylon LogiCVC is a display controller that contains a number of GPIO pins, +meant to be used for controlling display-related signals. + +In practice, the GPIOs can be used for any purpose they might be needed for. + +The controller exposes GPIOs from the display and power control registers, +which are mapped by the driver as follows: +- GPIO[4:0] (display control) mapped to index 0-4 +- EN_BLIGHT (power control) mapped to index 5 +- EN_VDD (power control) mapped to index 6 +- EN_VEE (power control) mapped to index 7 +- V_EN (power control) mapped to index 8 + +The driver was implemented and tested for version 3.02.a of the controller, +but should be compatible with version 4 as well. + +Required properties: +- compatible: Should contain "xylon,logicvc-3.02.a-gpio". +- gpio-controller: Marks the device node as a gpio controller. +- #gpio-cells: Should be 2. The first cell is the pin number and + the second cell is used to specify the gpio polarity: + 0 = Active high, + 1 = Active low. +- gpio,syscon-dev: Syscon phandle representing the logicvc instance. + +Example: + + logicvc: logicvc@43c00000 { + compatible = "syscon", "simple-mfd"; + reg = <0x43c00000 0x6000>; + + #address-cells = <1>; + #size-cells = <1>; + + logicvc_gpio: display-gpio@40 { + compatible = "xylon,logicvc-3.02.a-gpio"; + reg = <0x40 0x40>; + gpio-controller; + #gpio-cells = <2>; + gpio,syscon-dev = <&logicvc>; + }; + }; + +Note: the device-tree node should either be declared as a child of the logicvc +syscon node or the syscon node should be precised with the gpio,syscon-dev +property. Both are shown in the example above.