From patchwork Fri Nov 17 06:40:37 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Javier Carrasco X-Patchwork-Id: 165992 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:9910:0:b0:403:3b70:6f57 with SMTP id i16csp338259vqn; Thu, 16 Nov 2023 22:41:37 -0800 (PST) X-Google-Smtp-Source: AGHT+IFv/ZvlP/IYQxsMGr2TL7SUoQg1hXAe9QwZowt8XVQeJZT6WZSorVJvFPMR8/aU9R9IQ30r X-Received: by 2002:a05:6808:22a0:b0:3ad:f3e6:66f8 with SMTP id bo32-20020a05680822a000b003adf3e666f8mr22197003oib.41.1700203297505; Thu, 16 Nov 2023 22:41:37 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1700203297; cv=none; d=google.com; s=arc-20160816; b=dxXId1D1K54/kcciTlJuFFwo2xeiBDM19w8Cm6nvGd9KzOlIr0RqUbi0v5/fwR0FP6 fbqoOznR49E+7Z4+sfd4YL9iRyE6sRIxD/B34WemNSetrEJH/v0IPMxvN9CHsmy0znZT eBrOZcwVFgktQbjrQkGhQA358z5VrHEfaEkDE8ay6RYHt9GxqcsgvEIn4tYR+KO4oqv7 en7cEvpceEPJM/kQWubum1IjA03iWRuPjVrsOH9lJI8QJnYZJLKN0Jr8T7KyU35LUKej cYT+ogoW1cH8cOCd4QKIJpwDmG2jn+pCDSeQ6ZdOyNWUU5ydi6+q5kRr4sh67JPh7+mS w3kA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:subject:date:from :dkim-signature; bh=2dLWB4TJdmX3nxO89fsn3dhr9nJ0AUMxfWGRU8bttDU=; fh=OoA0JIoxTojNJszcxJcQZWfGSy/3Ut2NK1b7QxQqqL4=; b=lSgqqMULkNnug9k6DABKXNkNNHuxPVmHfOeQn4rBNvW3upUvnyx2eKDh0NN3LijXMY dVQh0dmBdxgYFW6il5QE2pt1hGUu42UHenM1uIGKde+lbKtGxecNfOs/PHzkS3RTbTkw zEeKudi2JGDxJho753p6eFkVz38/jTvHykK9+Z3ImcyCaJJeCki1yigt3bnyx+0DbTFq M6eFk/L1DcoFsTy3+EOQDWB1sZDDBhpYpsn45XiiwRlLXvuQ+b6WMMzDWcGzjA4dXNct cEY6OkzUouseBKOxkLCHzsJIY3gytHlbqy5n12fquk7vpXL6cUZ2Y5JB2aRAa1BbgxUo vdrg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=RpZPtz3G; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.33 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from lipwig.vger.email (lipwig.vger.email. [23.128.96.33]) by mx.google.com with ESMTPS id b17-20020a656691000000b0057942bfab4dsi1231033pgw.395.2023.11.16.22.41.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Nov 2023 22:41:37 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.33 as permitted sender) client-ip=23.128.96.33; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=RpZPtz3G; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.33 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by lipwig.vger.email (Postfix) with ESMTP id DC55A803A509; Thu, 16 Nov 2023 22:41:33 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at lipwig.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235222AbjKQGkz (ORCPT + 30 others); Fri, 17 Nov 2023 01:40:55 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38326 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234605AbjKQGks (ORCPT ); Fri, 17 Nov 2023 01:40:48 -0500 Received: from mail-ej1-x636.google.com (mail-ej1-x636.google.com [IPv6:2a00:1450:4864:20::636]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 372ACD53; Thu, 16 Nov 2023 22:40:45 -0800 (PST) Received: by mail-ej1-x636.google.com with SMTP id a640c23a62f3a-9e2838bcb5eso230434866b.0; Thu, 16 Nov 2023 22:40:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1700203243; x=1700808043; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=2dLWB4TJdmX3nxO89fsn3dhr9nJ0AUMxfWGRU8bttDU=; b=RpZPtz3G8SEcCweho9deFUd5Fn435b2pxzJDNCR9xRgWPZ47OAdDZiho2K6xS4JJ98 hHwRqnjKKYRoeRA1hDuUwfQrxqDcPXzF9JbbSIRp5zqx1Q/Vp4LTIEAg9BRStArVV57O Nr22MTO3zT0GrecvnoVblCwn03N+Ab8RwEyyOxKNmffWx5B/LzaHsQVJDihgWASrd8P0 Fj6/NzSfV1nYkddF4Mwki14hsluGnHkzcNDfdohtzqz3pVfK5oFNrxzaOePCkP0Qen+b 7x1GiaOSK+4M/n3uaDPPCnFGbVW84GJufn6DauhUyWGjkYiOA3mVvHTYWkfagLek5aYm DM8g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700203244; x=1700808044; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=2dLWB4TJdmX3nxO89fsn3dhr9nJ0AUMxfWGRU8bttDU=; b=ChgL8Sh9A1PbMvLIqNYJ/XXf4DM7vdaLpTEbQnMqsrNdh/uGx9jbCIsxg3bV1PLOcY 0EPd2X2BgED1YGYsZAGyrCuWbLLEnXw3cm2fyTLydUIhd7C/pUnBVY0EwRAHPWR9ls64 TcSa1M4qAp7jM5yLoo7+UKeAIIvszSsi0OEaTGqEWpB7PJpVqZDVWhwbQalR5Cd0JL/V 3sZlph3oGGEZl9vxVm+Bg1Hz8OKAn9cuRefUsw83TE410TSuMKwQQJnZb71yPfwtteVL 3TgZ0ILzTlny8+MK1/fXtW03O2dzjjookYpRufGeUYXyuwpGtk8++x/ep1w+yHJQq3Fn P5cA== X-Gm-Message-State: AOJu0Yw1nFl9kFWWMtcu7cyGQG86NfV2KEqGu+CgjHsVTQFFZa8MeaUk isMDIXIkcPS7aZzNvRffG2Y= X-Received: by 2002:a17:906:3049:b0:9bd:f155:eb54 with SMTP id d9-20020a170906304900b009bdf155eb54mr11432595ejd.6.1700203243693; Thu, 16 Nov 2023 22:40:43 -0800 (PST) Received: from [127.0.1.1] (91-118-163-37.static.upcbusiness.at. [91.118.163.37]) by smtp.gmail.com with ESMTPSA id v27-20020a170906489b00b009d2eb40ff9dsm447514ejq.33.2023.11.16.22.40.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Nov 2023 22:40:42 -0800 (PST) From: Javier Carrasco Date: Fri, 17 Nov 2023 07:40:37 +0100 Subject: [PATCH 4/4] ABI: sysfs-class-hwmon: document emergency/max/min temperature alarms MIME-Version: 1.0 Message-Id: <20231116-hwmon_abi-v1-4-8bfb7f51145a@gmail.com> References: <20231116-hwmon_abi-v1-0-8bfb7f51145a@gmail.com> In-Reply-To: <20231116-hwmon_abi-v1-0-8bfb7f51145a@gmail.com> To: Jean Delvare , Guenter Roeck , Greg Kroah-Hartman , Mauro Carvalho Chehab Cc: linux-hwmon@vger.kernel.org, linux-kernel@vger.kernel.org, Javier Carrasco X-Mailer: b4 0.12.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1700203237; l=1707; i=javier.carrasco.cruz@gmail.com; s=20230509; h=from:subject:message-id; bh=XY0nbZ8q1oMfM8UbOjc+Jj6bmU6olGeD0jPvrO16Ex4=; b=gpZ6fWnvWcSF5WMBQQPAbLGUSQiLsKt7w+itnCHhJ6+wYF5jzUS3z26Qyb8HWvFjY6ytARHm+ oc5X/ExoONVCGttoGl2hrmWHAEPIJNcdaglklMiYsHkQnc4WDApqm/7 X-Developer-Key: i=javier.carrasco.cruz@gmail.com; a=ed25519; pk=tIGJV7M+tCizagNijF0eGMBGcOsPD+0cWGfKjl4h6K8= X-Spam-Status: No, score=2.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_SBL_CSS, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Level: ** X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lipwig.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (lipwig.vger.email [0.0.0.0]); Thu, 16 Nov 2023 22:41:35 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1782792373008848200 X-GMAIL-MSGID: 1782792373008848200 These attributes are widely used in the hwmon subsystem, but they still must be documented. Add tempY_emergency_alarm, tempY_max_alarm and tempY_min_alarm to the ABI documentation according to their current usage and access rights in the hwmon subsystem. Signed-off-by: Javier Carrasco --- Documentation/ABI/testing/sysfs-class-hwmon | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-class-hwmon b/Documentation/ABI/testing/sysfs-class-hwmon index 3d5e6142ef0c..3dac923c9b0e 100644 --- a/Documentation/ABI/testing/sysfs-class-hwmon +++ b/Documentation/ABI/testing/sysfs-class-hwmon @@ -381,6 +381,15 @@ Description: RW +What: /sys/class/hwmon/hwmonX/tempY_max_alarm +Description: + Maximum temperature alarm flag. + + - 0: OK + - 1: temperature has reached tempY_max + + RO + What: /sys/class/hwmon/hwmonX/tempY_min Description: Temperature min value. @@ -389,6 +398,15 @@ Description: RW +What: /sys/class/hwmon/hwmonX/tempY_min_alarm +Description: + Minimum temperature alarm flag. + + - 0: OK + - 1: temperature has reached tempY_min + + RO + What: /sys/class/hwmon/hwmonX/tempY_max_hyst Description: Temperature hysteresis value for max limit. @@ -457,6 +475,15 @@ Description: RW +What: /sys/class/hwmon/hwmonX/tempY_emergency_alarm +Description: + Emergency high temperature alarm flag. + + - 0: OK + - 1: temperature has reached tempY_emergency + + RO + What: /sys/class/hwmon/hwmonX/tempY_emergency_hyst Description: Temperature hysteresis value for emergency limit.