From patchwork Sat Jul 25 07:11:57 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dirk Behme X-Patchwork-Id: 499910 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 D093814031D for ; Sat, 25 Jul 2015 17:12:06 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b=up0x0N2O; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753590AbbGYHMG (ORCPT ); Sat, 25 Jul 2015 03:12:06 -0400 Received: from mail-wi0-f171.google.com ([209.85.212.171]:35816 "EHLO mail-wi0-f171.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750870AbbGYHMF (ORCPT ); Sat, 25 Jul 2015 03:12:05 -0400 Received: by wibxm9 with SMTP id xm9so51593442wib.0 for ; Sat, 25 Jul 2015 00:12:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id; bh=K7n2TrsbcH/Hr/xVBASuTEKs+sBOV2BfNfXrCdbf9iM=; b=up0x0N2O7Y7MHSwb9n8JN1hwjphjIDwFqCtowe/n8JQr13gByHaoAxd9vYFnZvEIpP QxDUGJEhhW46xJWf6LKm/gScCG71wGHHr0z5/gEttjr+R3OlCGh6oNedNNf3o4Yoy9JU lJX76rwxU8nRclJ3kD2xp2/0wjDJoBVAi4kH36E5u+iui53NU2O//yJjNIUEiE7SnX0+ XCM6eudgG8IJD6TDuILzwxk91XFkt1/2eqILRE5Z2SESqmBFzoGbsg2ZxnW1YnV3d+W6 yTFTRk96PA4bIVVA+Rz8FfNFhheX0ZII22/PbGdZtqNu6IVMX4DRfTP2A8SIMrBG2U3O 0U5Q== X-Received: by 10.180.75.78 with SMTP id a14mr4059767wiw.43.1437808323091; Sat, 25 Jul 2015 00:12:03 -0700 (PDT) Received: from localhost.localdomain (p4FEE091B.dip0.t-ipconnect.de. [79.238.9.27]) by smtp.gmail.com with ESMTPSA id ck7sm16200393wjc.43.2015.07.25.00.12.01 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Sat, 25 Jul 2015 00:12:02 -0700 (PDT) From: Dirk Behme To: linux-gpio@vger.kernel.org Cc: Alexandre Courbot , Dirk Behme Subject: [PATCH 1/2] Documentation: gpio: board: add flags parameter to gpiod_get*() functions Date: Sat, 25 Jul 2015 09:11:57 +0200 Message-Id: <1437808318-4453-1-git-send-email-dirk.behme@gmail.com> X-Mailer: git-send-email 2.4.6 Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org With commit 39b2bbe3d715 ("gpio: add flags argument to gpiod_get*() functions") the gpiod_get*() functions got a 'flags' parameter. Reflect this in the documentation, too. Signed-off-by: Dirk Behme --- Documentation/gpio/board.txt | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/Documentation/gpio/board.txt b/Documentation/gpio/board.txt index b80606d..7605773 100644 --- a/Documentation/gpio/board.txt +++ b/Documentation/gpio/board.txt @@ -39,11 +39,11 @@ This property will make GPIOs 15, 16 and 17 available to the driver under the struct gpio_desc *red, *green, *blue, *power; - red = gpiod_get_index(dev, "led", 0); - green = gpiod_get_index(dev, "led", 1); - blue = gpiod_get_index(dev, "led", 2); + red = gpiod_get_index(dev, "led", 0, GPIOD_OUT_HIGH); + green = gpiod_get_index(dev, "led", 1, GPIOD_OUT_HIGH); + blue = gpiod_get_index(dev, "led", 2, GPIOD_OUT_HIGH); - power = gpiod_get(dev, "power"); + power = gpiod_get(dev, "power", GPIOD_OUT_HIGH); The led GPIOs will be active-high, while the power GPIO will be active-low (i.e. gpiod_is_active_low(power) will be true). @@ -142,12 +142,11 @@ The driver controlling "foo.0" will then be able to obtain its GPIOs as follows: struct gpio_desc *red, *green, *blue, *power; - red = gpiod_get_index(dev, "led", 0); - green = gpiod_get_index(dev, "led", 1); - blue = gpiod_get_index(dev, "led", 2); + red = gpiod_get_index(dev, "led", 0, GPIOD_OUT_HIGH); + green = gpiod_get_index(dev, "led", 1, GPIOD_OUT_HIGH); + blue = gpiod_get_index(dev, "led", 2, GPIOD_OUT_HIGH); - power = gpiod_get(dev, "power"); - gpiod_direction_output(power, 1); + power = gpiod_get(dev, "power", GPIOD_OUT_HIGH); Since the "power" GPIO is mapped as active-low, its actual signal will be 0 after this code. Contrary to the legacy integer GPIO interface, the active-low