From patchwork Fri Aug 19 12:44:10 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Jeffery X-Patchwork-Id: 660845 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3sG2lc522fz9t0M for ; Fri, 19 Aug 2016 22:46:36 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=aj.id.au header.i=@aj.id.au header.b=S2YT6cAt; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=messagingengine.com header.i=@messagingengine.com header.b=MtZYBWJx; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755012AbcHSMo6 (ORCPT ); Fri, 19 Aug 2016 08:44:58 -0400 Received: from out2-smtp.messagingengine.com ([66.111.4.26]:33233 "EHLO out2-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754998AbcHSMo4 (ORCPT ); Fri, 19 Aug 2016 08:44:56 -0400 Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailout.nyi.internal (Postfix) with ESMTP id 1FD1B2058E; Fri, 19 Aug 2016 08:44:55 -0400 (EDT) Received: from frontend2 ([10.202.2.161]) by compute7.internal (MEProxy); Fri, 19 Aug 2016 08:44:55 -0400 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=aj.id.au; h=cc :date:from:in-reply-to:message-id:references:subject:to :x-sasl-enc:x-sasl-enc; s=mesmtp; bh=m0DkzplLokV27T6xVJFkJSd+Mmw =; b=S2YT6cAtjxE0Pz/m4CkJ06OGfQYHofb4POStxOpo8RpKCGSb0J1vcmcjwjS N1hvgrrV5oB8Qm6/qgINoyttmKm0vljcajhvB03Th/hGIjAXoQZbr3HdjK4yZzXQ L+ZbLZpHS6kjpGnlyhCoUi3iuHfipjF9NzAYphfU3CyIlWqU= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=cc:date:from:in-reply-to:message-id :references:subject:to:x-sasl-enc:x-sasl-enc; s=smtpout; bh=m0Dk zplLokV27T6xVJFkJSd+Mmw=; b=MtZYBWJxebKT2YvYuHJP9Srh8+TbZf3hrYQY CBZB9RjbDAXq6ROzR3kEZrRshjRIvgje70RUWSi5cnFP8C/sEQG9TPcDGwgL84EH 0ntKZcbWTvK4V+SBeFZRxfRlG4K2GRzwRbnxdwAqA5sIMu00ObLQSSl4z/WF1nV0 Djbn1Dg= X-Sasl-enc: YiGkIxTyujCsxF/SJqBnDDxN9k9chGTQiBIgX8qXep82 1471610694 Received: from keelia.au.ibm.com (ppp203-122-213-247.static.internode.on.net [203.122.213.247]) by mail.messagingengine.com (Postfix) with ESMTPA id CDB32CCD84; Fri, 19 Aug 2016 08:44:49 -0400 (EDT) From: Andrew Jeffery To: Linus Walleij , Joel Stanley Cc: Alexandre Courbot , Mark Rutland , Rob Herring , Benjamin Herrenschmidt , Jeremy Kerr , linux-gpio@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Andrew Jeffery Subject: [PATCH v2 4/8] gpio: dt-bindings: Add documentation for Aspeed GPIO controllers Date: Fri, 19 Aug 2016 22:14:10 +0930 Message-Id: <20160819124414.24242-5-andrew@aj.id.au> X-Mailer: git-send-email 2.9.3 In-Reply-To: <20160819124414.24242-1-andrew@aj.id.au> References: <20160819124414.24242-1-andrew@aj.id.au> Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org Signed-off-by: Andrew Jeffery Acked-by: Joel Stanley --- Since v1: Rob: I haven't added your Acked-by here as I've made the following changes and wanted to get your input: * Remove interrupt-controller as an optional property * Defer to interrupt-controller bindings document for sub-node properties I had a discussion with Joel about whether the interrupt-controller capability should be optional and the conclusion was that it should always be configured by the driver. This makes an optional interrupt-controller property feel redundant (and possibly inaccurate if left out) so I've removed it. .../devicetree/bindings/gpio/gpio-aspeed.txt | 34 ++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 Documentation/devicetree/bindings/gpio/gpio-aspeed.txt diff --git a/Documentation/devicetree/bindings/gpio/gpio-aspeed.txt b/Documentation/devicetree/bindings/gpio/gpio-aspeed.txt new file mode 100644 index 000000000000..a5ad1eb93ce0 --- /dev/null +++ b/Documentation/devicetree/bindings/gpio/gpio-aspeed.txt @@ -0,0 +1,34 @@ +Aspeed GPIO controller Device Tree Bindings +------------------------------------------- + +Required properties: +- #gpio-cells : Should be two + - First cell is the GPIO line number + - Second cell is used to specify optional + parameters (unused) + +- compatible : Either "aspeed,ast2400-gpio" or "aspeed,ast2500-gpio" + +- reg : Address and length of the register set for the device +- gpio-controller : Marks the device node as a GPIO controller. +- interrupts : Interrupt specifier (see interrupt bindings for + details) + +Optional properties: + +- interrupt-parent : The parent interrupt controller, optional if inherited + +The gpio and interrupt properties are further described in their respective +bindings documentation: + +- Documentation/devicetree/bindings/gpio/gpio.txt +- Documentation/devicetree/bindings/interrupt-controller/interrupts.txt + + Example: + gpio@1e780000 { + #gpio-cells = <2>; + compatible = "aspeed,ast2400-gpio" + gpio-controller; + interrupts = <20>; + reg = <0x1e780000 0x1000>; + };