From patchwork Mon Feb 12 09:34:20 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kent Gibson X-Patchwork-Id: 199628 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:50ea:b0:106:860b:bbdd with SMTP id r10csp2323833dyd; Mon, 12 Feb 2024 01:35:25 -0800 (PST) X-Google-Smtp-Source: AGHT+IEuEx2oa2MX1r8IWNjpX54iPjFhjaR6iNcEYFmbqZ0dTzxtMt8L/+Q+1nT+jBQS/w2kE7sj X-Received: by 2002:a17:90a:d154:b0:297:190d:5a37 with SMTP id t20-20020a17090ad15400b00297190d5a37mr2495276pjw.8.1707730525269; Mon, 12 Feb 2024 01:35:25 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1707730525; cv=pass; d=google.com; s=arc-20160816; b=pM2iJiqDdNWSXjbZGCMyzuGEepOeyboeH/zMVM8sgencUEObncR4HeGO4bzgL6hnQN 3/WqzOnbGn8nj7q7Voxjtk7JTomO+7QGlXdaUaOY0hH+iLuZhr5Ohz22f4fQ3pVFqamj K73lz7sIe+vVYEYf0VPS6tIg3KyYNnobcYhaZhknBgoUtfvmk8DKdDPjWU8YRJ1nKmsU xhpejA/sXOGjoD0g6P50uVFXcNuNjJl+tZNZISGFsijD7pSJ4uXHuQRpM0rMNM0bIuc3 +XT8ePG5wtr91I+nKSEoQkbLW5aQAATtRKAeZfuSCX+5q2AQQp2IC/iGLUdhwEUALNul BMlg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=dnKx8M7/sfj+9SE79BBw1FFhj3SBdGNF9ih2TYOEbAo=; fh=qk0siN5kG+JPhCcIl1dZhzo13CXzBSzUvAB0kkQLiEU=; b=FeNciNBoPQoQ7+vdVvzZATQwP5Mj7Z8BGjUsaP5LZhmHNTnSIibUXuDpg+XCsLwFkW TWIO+e3/34aIGnyzFdHYvI6TjV+MSehz/Cfhq7C5yAwhK1Lz+SfJIDQrBspPwWOoBQjh DG/fbrUCszdMqDs5HwwRn6+HNz08SbpESbn+0GJXGwFVZ5LLtIY7R9dLrLq4tHWnEpTW Hj5MqZmrYROAFqiWJrMm7qaphTsE4hlak4LZgWuPj8IRl/ZDP5ipyhz/g2tLNvIwoPSl lAJpIcuiQOPra5SUlH4RsQv4P4KH3SZXb2qG0e/BkXTmNK8hglngI+Io9eaDbA0GxXLv rHAw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=FBI57cVj; arc=pass (i=1 spf=pass spfdomain=gmail.com dkim=pass dkdomain=gmail.com dmarc=pass fromdomain=gmail.com); spf=pass (google.com: domain of linux-kernel+bounces-61249-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-61249-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com X-Forwarded-Encrypted: i=2; AJvYcCUpPl7G2XU7+oYwYHlH5r4SSPaLxIew+hVpeOBl8+LVoKyzN/exe+6HFNyaeGsp2hSLJGOe7e5cLcnL6bCy7SWzk+ZVLw== Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id fz12-20020a17090b024c00b002970cd04f2dsi18398pjb.119.2024.02.12.01.35.24 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Feb 2024 01:35:25 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-61249-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=FBI57cVj; arc=pass (i=1 spf=pass spfdomain=gmail.com dkim=pass dkdomain=gmail.com dmarc=pass fromdomain=gmail.com); spf=pass (google.com: domain of linux-kernel+bounces-61249-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-61249-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 9C199B213D2 for ; Mon, 12 Feb 2024 09:34:49 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 2D6DC17BD3; Mon, 12 Feb 2024 09:34:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="FBI57cVj" Received: from mail-pf1-f173.google.com (mail-pf1-f173.google.com [209.85.210.173]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 450D212B72; Mon, 12 Feb 2024 09:34:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.173 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707730474; cv=none; b=ZNE4uBnVxoPMH1rTvTr99KsOU237QuUzMOlqwjfjXEnUHH+z3hmboVEJnSvVzbrOATVX2i1do1mq9jHUq2zaLYvtuBy5AeLOaOAXoS7Lo87YR+BSG742aGClVTXnp/cor2B7+U3U7v/Tx1FdUaBJadfb2ziW7ozLkIOlA/Cw+qA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707730474; c=relaxed/simple; bh=ViKQiSWcWYCkXU6A9PDOO1oKjlvMExVCKTXkGh9et6w=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=Hx+SStRT23HI88Om7M6wzYXUoTGKpMLMvywgFvwPQRnCZRsowPO4bj4gGZwmNmxKVb7k6GV1giv+8J/CFOlnDLdVGloR/Ch16rpwp+teIMIA5q/4McILDNA6BMxCHV6tH1vyL/2Ry7JKse8iKZuUCmiD4Sh2b4Veo7FfBoQUuSM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=FBI57cVj; arc=none smtp.client-ip=209.85.210.173 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-pf1-f173.google.com with SMTP id d2e1a72fcca58-6e09ea155c5so1239650b3a.2; Mon, 12 Feb 2024 01:34:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1707730472; x=1708335272; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=dnKx8M7/sfj+9SE79BBw1FFhj3SBdGNF9ih2TYOEbAo=; b=FBI57cVjJ5XmXKdobSrrb1v+5uFZmiMNboYz7AJLWCCXJt0c0RxErvXmSRWU/srND6 hZ+puDPs1BRe6p8hXcuK8ijh9xioqcYFVSOoeyA4nIKJtCm7XCVU7SrQELWd40MeB16/ BXMdF2aruYZeCsu619+/KS2MVqVEALPNm+r0KtU+SMxTUFt4riVXq/GX/wW9Fb+T+SDT 0fo2V/L4wnPlFeEILzRAkc5F5yHhK8o68rzkDNjKwGDCguogCqEn/7pmwyfxE3MTNWu4 21VEhvkJJ4aDvxJEIBcC+OMd85mtdQrFGFzJZ+Uegs/zxgns569+s8BZMf+x9vMWeOVx jOOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1707730472; x=1708335272; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=dnKx8M7/sfj+9SE79BBw1FFhj3SBdGNF9ih2TYOEbAo=; b=lDanZW4fqxxrKP/juua1gElfR9/BS5Hx4Y2+IQxMoC6uNwXDcSsOqZl+otj0nwWyp9 ZYEAUS8JMB+XNRVEIbKd7P1hEK9P01I1JGTNBvAuCYTyhdyz7tzW47t0lUIKF8JtPEbd 0Hsxge+Aov2xE+4G7vWYFZwt8CorvycAma739vI2N9MFuSluww4JjBE6upjfy+7y3Azm uL/pan7UKN21m3bAOpmzgKk67frH/6VcMJqJx5l/zEuA2wSHC9uKqA92N016GvHFDgaA Nh/vC9EPI4c5CaVhcH47CwUAqJ43L1ZjJ6Tuk+7FcLM5dxCr/cH3PsiVngXxC/Af/YBo 7iUg== X-Gm-Message-State: AOJu0YyogVEF2sXkKdx5GG49gusTUXfsrtBF+GJ2ifwReDwPX3+J0wif 4oQyOIlIJuPeeDeiZYq+6DdSDmTgXReKw1I8kBo5wtfZ8e6TX8Zx0WhCIlAJ X-Received: by 2002:a05:6a00:2d82:b0:6e0:d220:4463 with SMTP id fb2-20020a056a002d8200b006e0d2204463mr3677645pfb.24.1707730472307; Mon, 12 Feb 2024 01:34:32 -0800 (PST) X-Forwarded-Encrypted: i=1; AJvYcCXr/ObyCQ014DXM2/K0oQu3x9cHR3rK+8sdyF1ijMmVZwwLkg/BF1Cac1Z9/4ukKdD9RKF7CpX3bG6QY+0pL/GHSaXpeX73nhZUpsddlFF/HbeDbZYxwlU9PAuZC3HhKQBxbjMAvDRJMPFut2awTqJV1TXm6mT651d8LT+XsCWIEHgjxnkp3crCd3K73V3JR79PYjTy3KBDmH6p64LVxcKJufIcorpuBw7Dpyh9u5E1 Received: from rigel.home.arpa ([220.235.35.85]) by smtp.gmail.com with ESMTPSA id p19-20020a056a0026d300b006e0e3ef5f23sm1042222pfw.101.2024.02.12.01.34.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Feb 2024 01:34:32 -0800 (PST) From: Kent Gibson To: linux-kernel@vger.kernel.org, linux-gpio@vger.kernel.org, linux-doc@vger.kernel.org, brgl@bgdev.pl, linus.walleij@linaro.org, andy@kernel.org, corbet@lwn.net Cc: Kent Gibson Subject: [PATCH] Documentation: gpio: clarify sysfs line values are logical Date: Mon, 12 Feb 2024 17:34:20 +0800 Message-Id: <20240212093420.381575-1-warthog618@gmail.com> X-Mailer: git-send-email 2.39.2 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1790685243417368854 X-GMAIL-MSGID: 1790685243417368854 Clarify that line values are logical, not physical, by replacing high/low terminology with active/inactive. Signed-off-by: Kent Gibson Reviewed-by: Andy Shevchenko --- Documentation/userspace-api/gpio/sysfs.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/userspace-api/gpio/sysfs.rst b/Documentation/userspace-api/gpio/sysfs.rst index e12037a0f2b4..116921048b18 100644 --- a/Documentation/userspace-api/gpio/sysfs.rst +++ b/Documentation/userspace-api/gpio/sysfs.rst @@ -87,9 +87,9 @@ and have the following read/write attributes: allow userspace to reconfigure this GPIO's direction. "value" ... - reads as either 0 (low) or 1 (high). If the GPIO + reads as either 0 (inactive) or 1 (active). If the GPIO is configured as an output, this value may be written; - any nonzero value is treated as high. + any nonzero value is treated as active. If the pin can be configured as interrupt-generating interrupt and if it has been configured to generate interrupts (see the