From patchwork Mon Feb 13 13:28:12 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andy Shevchenko X-Patchwork-Id: 56286 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp2347966wrn; Mon, 13 Feb 2023 05:34:23 -0800 (PST) X-Google-Smtp-Source: AK7set+JgHN567UJHJooFpi58pTsjp6BMul1TQ4HXk0g1i32VXQcAHkZPooATxaXyx+vch+7NeLv X-Received: by 2002:a50:f68e:0:b0:4ac:b2cb:14d4 with SMTP id d14-20020a50f68e000000b004acb2cb14d4mr9391740edn.15.1676295263672; Mon, 13 Feb 2023 05:34:23 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1676295263; cv=none; d=google.com; s=arc-20160816; b=TcOlBatFEYYmJMK1aiq0kkQ7ViPxMsE+t23GYWKGKxrW6ifLCXbcmZpaJmKBDNExn6 +vjEAu46CFgogVxRcjJIXP80geaO+F1XAWBwZui1XUr1SPPOXILwjYpQadMdBuTV1c71 JvRAeB99xJ8CEDbFvPGY/LnC0Vh6rJL6MilzAt/xNUeXGXlyOs9qicgizlMzTHaxDkkz /jsp6H8wwqZV90+QaB+KwXnDmfY9bqMaqpvfv+C7oYywYVC3qVr/k7RA3sf2VqEkbOvI dwvBav+ZdieuXKBqfBrfAzxbdAcKQZtA9CkDDXBOwcCoNeYf5R0I7eZqpOQyv7mlQvXE kOHA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=5OVyB6A+j+ilXVlrj8WDQKCeqog0FnDTD3tIIJ4j4No=; b=MfTq1nVf5EhbgTJDhWqkk/m0jLgMerDQUoNjP8q8XM1RRP2cwA6CmaTVqbwFiFs7te fjpGl4gfH0KtoW5qDAw7Evpq7WNU7F3FCryL0D4P9asa++KZseD1ncebgMUojLRZxMzs C2KRKR+2O9pia9mf/xQgor58D/Whj7+97TtLE51SPe+wCUw9g1oVS35Vx1b0hj3tdzHq T1du7zyN/jZTbIkUlFmczLzqddwioLw+ngB0LWuP+CpKQouJrsFpsGbV+IQzP6q19M9M 7vpXf/SHJReOh2WCucfDTFLYO2MQOsU3kcSMxsjGS6+/awPEOyneev95E5dGYd/+0fiE b1Uw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=ch3xKtV0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id m10-20020aa7c48a000000b004aab47a577bsi13423108edq.65.2023.02.13.05.34.00; Mon, 13 Feb 2023 05:34:23 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=ch3xKtV0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230031AbjBMN1j (ORCPT + 99 others); Mon, 13 Feb 2023 08:27:39 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34172 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229489AbjBMN1i (ORCPT ); Mon, 13 Feb 2023 08:27:38 -0500 Received: from mga06.intel.com (mga06b.intel.com [134.134.136.31]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5D49D1A4B8; Mon, 13 Feb 2023 05:27:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1676294857; x=1707830857; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=jPQ6x6Tbwh+UqIy3KRlKxbErjK9ePbHRcwUVfTAEYgk=; b=ch3xKtV0RBv57IMykv9Ar+GEnRIqAxgMzfioNHsZR5B8gPQoLaMRElIX dVkKOeGxxFjb6GDU+v7A5lkMxa6QyJYwdZKMhW0WcwklPjDqu4Zrz6shY yeh75nLzAnxAUo9MfV0KSNCFCQy3dcp/3KBbMEEEiHD+xtjH9waukxkeT 9Z74jMzs6ptDjQwP7AWhJ/fr4cQDl0Fz4MHjaIJWFwEuLh3mgtofkd6cI x+tK6s+Hy2Jyd1j6srv8PlQPeSYWy60EGm/BNzmKu0w67aOdnnGxpUuif soYrEM6BLkBKzbmwnCR9eYGLqhhRPUeH8U7U5uCgWI+ES6Uz2jL+37b2J w==; X-IronPort-AV: E=McAfee;i="6500,9779,10620"; a="393286330" X-IronPort-AV: E=Sophos;i="5.97,294,1669104000"; d="scan'208";a="393286330" Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 13 Feb 2023 05:27:36 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10620"; a="777842510" X-IronPort-AV: E=Sophos;i="5.97,294,1669104000"; d="scan'208";a="777842510" Received: from black.fi.intel.com ([10.237.72.28]) by fmsmga002.fm.intel.com with ESMTP; 13 Feb 2023 05:27:34 -0800 Received: by black.fi.intel.com (Postfix, from userid 1003) id B31781F8; Mon, 13 Feb 2023 15:28:13 +0200 (EET) From: Andy Shevchenko To: Andy Shevchenko , linux-gpio@vger.kernel.org, linux-acpi@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Mika Westerberg , "Rafael J. Wysocki" , Len Brown , Linus Walleij , Bartosz Golaszewski Subject: [PATCH v1 1/1] Documentation: firmware-guide: gpio-properties: Clarify Explicit and Implicit Date: Mon, 13 Feb 2023 15:28:12 +0200 Message-Id: <20230213132812.38646-1-andriy.shevchenko@linux.intel.com> X-Mailer: git-send-email 2.39.1 MIME-Version: 1.0 X-Spam-Status: No, score=-4.3 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1757722982000142324?= X-GMAIL-MSGID: =?utf-8?q?1757722982000142324?= Clarify the Explicit and Implicit meanings in the table of Pull Bias. While at it, distinguish pull bias keywords used in ACPI by using bold font in the table of the respective terms. Signed-off-by: Andy Shevchenko --- .../firmware-guide/acpi/gpio-properties.rst | 25 +++++++++++-------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/Documentation/firmware-guide/acpi/gpio-properties.rst b/Documentation/firmware-guide/acpi/gpio-properties.rst index eaec732cc77c..ae87aa64cb7b 100644 --- a/Documentation/firmware-guide/acpi/gpio-properties.rst +++ b/Documentation/firmware-guide/acpi/gpio-properties.rst @@ -67,17 +67,20 @@ state of the output pin which driver should use during its initialization. Linux tries to use common sense here and derives the state from the bias and polarity settings. The table below shows the expectations: -========= ============= ============== -Pull Bias Polarity Requested... -========= ============= ============== -Implicit x AS IS (assumed firmware configured for us) -Explicit x (no _DSD) as Pull Bias (Up == High, Down == Low), - assuming non-active (Polarity = !Pull Bias) -Down Low as low, assuming active -Down High as low, assuming non-active -Up Low as high, assuming non-active -Up High as high, assuming active -========= ============= ============== +========= ============= ============== +Pull Bias Polarity Requested... +========= ============= ============== +Implicit x AS IS (assumed firmware configured it for us) +(**Default**) +Explicit x (no _DSD) as Pull Bias (**Up** == high, **Down** == low), +(**Up**, **Down**, assuming non-active (Polarity = !Pull Bias); + **None**) or AS IS (assumed firmware configured it for us) + with no Pull Bias +**Down** Low as low, assuming active +**Down** High as low, assuming non-active +**Up** Low as high, assuming non-active +**Up** High as high, assuming active +========= ============= ============== That said, for our above example the both GPIOs, since the bias setting is explicit and _DSD is present, will be treated as active with a high