From patchwork Sun Aug 30 09:15:55 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dirk Behme X-Patchwork-Id: 512195 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 39C0C1401F6 for ; Sun, 30 Aug 2015 19:16:04 +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=JYwybjIG; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753313AbbH3JQD (ORCPT ); Sun, 30 Aug 2015 05:16:03 -0400 Received: from mail-wi0-f172.google.com ([209.85.212.172]:38799 "EHLO mail-wi0-f172.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752088AbbH3JQB (ORCPT ); Sun, 30 Aug 2015 05:16:01 -0400 Received: by wicpl12 with SMTP id pl12so3181154wic.1 for ; Sun, 30 Aug 2015 02:16:00 -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:in-reply-to:references; bh=bipqMXmUpsWFR3griTdIPJrsWSXMfo2c/cA/FP1Fwyc=; b=JYwybjIG5mDPEbFA9++/eDXcqtSOmlaJB4eHvzFFqWk+H/uo1tJnQXvmjsjMmzVszL yHDQ6J46U7nTOtHzd8JenVTqVf/ZE8M5qQ1wn+gojGxwdgytkDKFvbzfsePQPaPuND9m +Xy8Ga/KcvCsmWDjR23iGz8q6zM3l5FZVstUf46YdsnImdj7pw0bTUnNF4g6I0jjg9M/ zqUxnIB0XcLC0WKdlmv9XVeoO0VthGqgQL6aDT7lYZ8dhKA6cXI9N+0L25uHmz0ZFNUC BFgKbXeFU5HZ0CawS8TCeQXIk4/u6ffZsKCSrYDkP3M5jQ+t1kLFcqcShfcIM2QAXowI sFoA== X-Received: by 10.194.9.42 with SMTP id w10mr19691761wja.146.1440926160865; Sun, 30 Aug 2015 02:16:00 -0700 (PDT) Received: from localhost.localdomain (p4FEE0D0A.dip0.t-ipconnect.de. [79.238.13.10]) by smtp.gmail.com with ESMTPSA id bi6sm16517041wjc.25.2015.08.30.02.15.59 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Sun, 30 Aug 2015 02:16:00 -0700 (PDT) From: Dirk Behme To: Alexandre Courbot Cc: linux-gpio@vger.kernel.org, Dirk Behme Subject: [PATCH 2/2 v2] Documentation: gpio: board: describe the con_id parameter Date: Sun, 30 Aug 2015 11:15:55 +0200 Message-Id: <1440926155-7183-2-git-send-email-dirk.behme@gmail.com> X-Mailer: git-send-email 2.5.1 In-Reply-To: <1440926155-7183-1-git-send-email-dirk.behme@gmail.com> References: <1440926155-7183-1-git-send-email-dirk.behme@gmail.com> Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org The con_id parameter has to match the GPIO description and is automatically extended by the GPIO suffix if not NULL. I had to look into the code to understand this and properly find the GPIO I've been looking for, so document this. Signed-off-by: Dirk Behme Acked-by: Alexandre Courbot --- Changes in v2: Using the "gpios" property without prefix is considered deprecated, therefore don't describe it. Documentation/gpio/board.txt | 9 +++++++++ Documentation/gpio/consumer.txt | 3 +++ 2 files changed, 12 insertions(+) diff --git a/Documentation/gpio/board.txt b/Documentation/gpio/board.txt index 7605773..0bfc455 100644 --- a/Documentation/gpio/board.txt +++ b/Documentation/gpio/board.txt @@ -48,6 +48,15 @@ This property will make GPIOs 15, 16 and 17 available to the driver under the 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). +The second parameter of the gpiod_get() functions, the con_id string, has to be +the -prefix of the GPIO suffixes ("gpios" or "gpio", automatically +looked up by the gpiod functions internally) used in the device tree. With above +"led-gpios" example, use the prefix without the "-" as con_id parameter: "led". + +Internally, the GPIO subsystem prefixes the GPIO suffix ("gpios" or "gpio") +with the string passed in con_id to get the resulting string +(snprintf(... "%s-%s", con_id, gpio_suffixes[]). + ACPI ---- ACPI also supports function names for GPIOs in a similar fashion to DT. diff --git a/Documentation/gpio/consumer.txt b/Documentation/gpio/consumer.txt index 75542b9..47ce4fd 100644 --- a/Documentation/gpio/consumer.txt +++ b/Documentation/gpio/consumer.txt @@ -39,6 +39,9 @@ device that displays digits), an additional index argument can be specified: const char *con_id, unsigned int idx, enum gpiod_flags flags) +For a more detailed description of the con_id parameter in the DeviceTree case +see Documentation/gpio/board.txt + The flags parameter is used to optionally specify a direction and initial value for the GPIO. Values can be: