From patchwork Fri Nov 17 06:40:34 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Javier Carrasco X-Patchwork-Id: 13458393 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="lN/JORR3" Received: from mail-lf1-x12c.google.com (mail-lf1-x12c.google.com [IPv6:2a00:1450:4864:20::12c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7B355D50; Thu, 16 Nov 2023 22:40:41 -0800 (PST) Received: by mail-lf1-x12c.google.com with SMTP id 2adb3069b0e04-50a6ff9881fso2416659e87.1; Thu, 16 Nov 2023 22:40:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1700203239; x=1700808039; 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=k/sCa8Bm+oY1XaUfCpz6tqc6AYL6sOvOOzJItSekXLU=; b=lN/JORR3f77j1TQ/YbdHtElLV0LvIRS+Nj7BV38JtrHlHRwldeVXRzaq4dXxx9iFpQ giAWiLWjhyb3QB+S/6dfBkMoXDrookAdm1fBN3pKkSIW30evGK6Ka3vExWkst0500Paf J2h07XpFYvEB7iiu7/8LR4TSkdGZAUPWzmJ18InT8LmesXc0bXZxiVahCP5850W1nYTQ 24xHzPP/ku8gJFpc4nYJEERBKzzVbYsGg4CaTCTOwxB8aBtAWUFSRob/0m0HDPeAPz1I 7oxG15SkU4ttuW+wokz4rtWZHDqmEc1OuHoIpJfvWCC5b03aE6E7Cdc6X8fG1ejLAw+3 20Wg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700203239; x=1700808039; 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=k/sCa8Bm+oY1XaUfCpz6tqc6AYL6sOvOOzJItSekXLU=; b=Mi9AlCcYRlDCclipGGi5fgS8hAKG+JT42ch5MgEhN3bgCiNN+cYXCpvrvYKV64JBPA RURbC8mHXPBO7kPxXo6DOQxqs/Zpk8Z4xiYCQodEC1NVB5wAS4j6rF+T95Iy/l9hWGnC LwtZuLJzQKpbjxZZhArMnNI+MdtyUXVUQk3XT+HfwZ85v8Yhy41XAhGd9LlX3V0NmxUn XrSs0GOmz2d4N2tdJRZhggyoBxn72OgZFdX/EwCey/ldPOcd1CNCNl7ZxTTjglM0V/l7 VdoDtwaGTmNSV+ywKV6GsGvA0SR8LoHxb+JDOQcO2W9UF824d7Q+47fTJGCmc+OwMH/4 25pg== X-Gm-Message-State: AOJu0Yz9hhjcUno1Dv8cDIKOYsQwfLl8rp14elsN3QlhuMkjVmXnMPgp Nf+81iUR3Da+KVkQ6HHn/TU= X-Google-Smtp-Source: AGHT+IHgKxDDTh/Gqo+grMp01RdHJlHAiHR1jupvfKOtSnSE4+LreZ/kyhsTc7acW+25nkTfWgpKfw== X-Received: by 2002:ac2:5475:0:b0:507:9b70:1f0e with SMTP id e21-20020ac25475000000b005079b701f0emr12110426lfn.24.1700203239269; Thu, 16 Nov 2023 22:40:39 -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.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Nov 2023 22:40:38 -0800 (PST) From: Javier Carrasco Date: Fri, 17 Nov 2023 07:40:34 +0100 Subject: [PATCH 1/4] ABI: sysfs-class-hwmon: rearrange humidity attributes alphabetically Precedence: bulk X-Mailing-List: linux-hwmon@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20231116-hwmon_abi-v1-1-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=1384; i=javier.carrasco.cruz@gmail.com; s=20230509; h=from:subject:message-id; bh=AUAGi/qOoExr3Pui4zFOuuEaMbHFWY7lD1IotDyo1SU=; b=Maru+tzEBZzNL8Sf5c/1lQzvtEyadue6xnFarIEWDQKRbolBAWkONQI6AjBpFCYHEqtUQHAJ1 F1Vchf8whMbA327hPcmloNxDnYMBRMRodjgGyZtep1wLWQxYl/I2w/d X-Developer-Key: i=javier.carrasco.cruz@gmail.com; a=ed25519; pk=tIGJV7M+tCizagNijF0eGMBGcOsPD+0cWGfKjl4h6K8= X-Spam-Level: * Preliminary step to add the missing humidity attributes in the ABI documentation. Adding new elements alphabetically is a common practice that has been loosely followed in the sysfs-class-hwmon documentation. Since most of the humidity attributes must be added to the file, a single attribute needs to be rearranged to reinforce alphabetical order. Signed-off-by: Javier Carrasco --- Documentation/ABI/testing/sysfs-class-hwmon | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-class-hwmon b/Documentation/ABI/testing/sysfs-class-hwmon index 638f4c6d4ec7..b998a42add95 100644 --- a/Documentation/ABI/testing/sysfs-class-hwmon +++ b/Documentation/ABI/testing/sysfs-class-hwmon @@ -887,15 +887,6 @@ Description: RW -What: /sys/class/hwmon/hwmonX/humidityY_input -Description: - Humidity - - Unit: milli-percent (per cent mille, pcm) - - RO - - What: /sys/class/hwmon/hwmonX/humidityY_enable Description: Enable or disable the sensors @@ -908,6 +899,14 @@ Description: RW +What: /sys/class/hwmon/hwmonX/humidityY_input +Description: + Humidity + + Unit: milli-percent (per cent mille, pcm) + + RO + What: /sys/class/hwmon/hwmonX/humidityY_rated_min Description: Minimum rated humidity. From patchwork Fri Nov 17 06:40:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Javier Carrasco X-Patchwork-Id: 13458394 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="LVYJxwC3" Received: from mail-ed1-x532.google.com (mail-ed1-x532.google.com [IPv6:2a00:1450:4864:20::532]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 217E9D51; Thu, 16 Nov 2023 22:40:42 -0800 (PST) Received: by mail-ed1-x532.google.com with SMTP id 4fb4d7f45d1cf-5480edd7026so1829375a12.0; Thu, 16 Nov 2023 22:40:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1700203240; x=1700808040; 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=wJxvgI9i9l4IaqoW7P3lNFiG+zzz8tjNlzjKlxr/b2E=; b=LVYJxwC3q5LbsLzR7h6+6EeT+UoN9uuVzr3DgTasGNXdw7s+80w6PbOsrkd137GhXY 93cZiJubnuxpwoSGxF0pDSYADufBXBFFaAIJBVfkSKU17iF4re8orhtXsF9zW+a4icJE ya81PXSpS+31Eta3FQlnQjXqvSSguT61Fn37xP8RIKJdRCMZ7o852id2bDUq613DmSpk KCACtklKs3kQJ/NKYiJD6vEVRLOuM/WOKlwd9K4ol/rkY48FSVl2i4P/0uf8wlyYZr6s qSvgxI+NZjDdTZ/G8MrGr8B35xZxNWa3mJiQMkL/b9U899P54z8gQL9cjb0OqHNW4NCQ f5zA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700203240; x=1700808040; 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=wJxvgI9i9l4IaqoW7P3lNFiG+zzz8tjNlzjKlxr/b2E=; b=R15Vs9uwOp0Z0x/dfqbddoa1PjB485uAgHBgzREIYVEwXTaVeWZneLzK2I1VRiZId+ 9CuDZUT3F0dJqsd+R2UrG+sMuCchedNpfvqQHKW1/0vpuQF7ng5spjK91N1m+oGMZfAq tfW61gUPnQa4j8mnb471PbB2GjdWUlBYDJPw5tzCvPSsHVcGmqcWB1y+Dpm6oYHwCFYV 8sklIPd107tJkXmm0PNPJGsU4CRg6o5blgAHqdNkcixrPK/mRcCMNypA7dvEiQCcYFH8 aYndRXz2r8Sb7fOIv/qfAtxJNdnQ9kqYJpi6SS2zhLA9y0lP6jYKBTJ1RhMDglKsZAHj fnyA== X-Gm-Message-State: AOJu0YyjqQNp0GMvuPmqabDongBmDJLQ6etRkJGNZcZ5w8Ka3voF9JZ4 jbAZlsURIUbORp0AcSiDsEU= X-Google-Smtp-Source: AGHT+IFOrpU25XrNR3nupY/bjkhARm3+EwaICdUnXky/72dd0BPMuOx3hAcLXpBntM1uVwobzCaRfA== X-Received: by 2002:a17:906:18e1:b0:9e0:2319:16f0 with SMTP id e1-20020a17090618e100b009e0231916f0mr3941019ejf.65.1700203240514; Thu, 16 Nov 2023 22:40:40 -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.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Nov 2023 22:40:39 -0800 (PST) From: Javier Carrasco Date: Fri, 17 Nov 2023 07:40:35 +0100 Subject: [PATCH 2/4] ABI: sysfs-class-hwmon: document missing humidity attributes Precedence: bulk X-Mailing-List: linux-hwmon@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20231116-hwmon_abi-v1-2-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=2753; i=javier.carrasco.cruz@gmail.com; s=20230509; h=from:subject:message-id; bh=Cz+uGSmEvNxYiJra9hc4k5xY8AQoDk7mM0es6NtamR4=; b=+58ZzPaTZ2R5I5UWBrwjTwtE5eyOF2ev+T+eTDKkDmU10zs+FameNPN82EcVYp8W8gxFSpfOs rxoDZPG3jBuA12wKokQpeHXVGrME2gZhFqleiDFixoLDULBZPxuWKat X-Developer-Key: i=javier.carrasco.cruz@gmail.com; a=ed25519; pk=tIGJV7M+tCizagNijF0eGMBGcOsPD+0cWGfKjl4h6K8= X-Spam-Level: * All these attributes already exist and are used by the hwmon subsystem, but they still must be documented. The missing attributes are the following: - humidityY_alarm - humidityY_fault - humidityY_label - humidityY_max - humidityY_max_hyst - humidityY_min - humidityY_min_hyst Add the missing humidity attributes 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 | 69 +++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-class-hwmon b/Documentation/ABI/testing/sysfs-class-hwmon index b998a42add95..dccbcdc2dad8 100644 --- a/Documentation/ABI/testing/sysfs-class-hwmon +++ b/Documentation/ABI/testing/sysfs-class-hwmon @@ -887,6 +887,15 @@ Description: RW +What: /sys/class/hwmon/hwmonX/humidityY_alarm +Description: + Humidity limit detection + + - 0: OK + - 1: Humidity limit has been reached + + RO + What: /sys/class/hwmon/hwmonX/humidityY_enable Description: Enable or disable the sensors @@ -899,6 +908,15 @@ Description: RW +What: /sys/class/hwmon/hwmonX/humidityY_fault +Description: + Reports a humidity sensor failure. + + - 1: Failed + - 0: Ok + + RO + What: /sys/class/hwmon/hwmonX/humidityY_input Description: Humidity @@ -907,6 +925,57 @@ Description: RO +What: /sys/class/hwmon/hwmonX/humidityY_label +Description: + Suggested humidity channel label. + + Text string + + Should only be created if the driver has hints about what + this humidity channel is being used for, and user-space + doesn't. In all other cases, the label is provided by + user-space. + + RO + +What: /sys/class/hwmon/hwmonX/humidityY_max +Description: + Humidity max value. + + Unit: milli-percent (per cent mille, pcm) + + RW + +What: /sys/class/hwmon/hwmonX/humidityY_max_hyst +Description: + Humidity hysteresis value for max limit. + + Unit: milli-percent (per cent mille, pcm) + + Must be reported as an absolute humidity, NOT a delta + from the max value. + + RW + +What: /sys/class/hwmon/hwmonX/humidityY_min +Description: + Humidity min value. + + Unit: milli-percent (per cent mille, pcm) + + RW + +What: /sys/class/hwmon/hwmonX/humidityY_min_hyst +Description: + Humidity hysteresis value for min limit. + + Unit: milli-percent (per cent mille, pcm) + + Must be reported as an absolute humidity, NOT a delta + from the min value. + + RW + What: /sys/class/hwmon/hwmonX/humidityY_rated_min Description: Minimum rated humidity. From patchwork Fri Nov 17 06:40:36 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Javier Carrasco X-Patchwork-Id: 13458395 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="JSRGMuM+" Received: from mail-ej1-x631.google.com (mail-ej1-x631.google.com [IPv6:2a00:1450:4864:20::631]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9D6E6D52; Thu, 16 Nov 2023 22:40:43 -0800 (PST) Received: by mail-ej1-x631.google.com with SMTP id a640c23a62f3a-9bf86b77a2aso228590966b.0; Thu, 16 Nov 2023 22:40:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1700203242; x=1700808042; 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=YsHnJGv78zqzqvzSBU7Yn+nGTyU2xuEXFjTMy+L46O8=; b=JSRGMuM+1ltvy84Ef1mjYthje2YFCDMaGRAv8aE88OVUGuFjR+KMGaVvOpd05YRz57 sGxs74Zg4YHQaY4UTiCSPxzzSnAVJCgRM/jbNQy/UmzaCCLl9/a+sALseC9NM+aI6WuZ e7JRhZdvhr6WpsDcBG29JELmigAIDNrcIyBJgpwSoHvwlo+rA4+WrEI4awLSysJr6BXG vzCC2MYr3HdwKxwf+2EN71zi9bKv801dTexeF9UT4OSPgnnzQLnUaSzaBxYlv7rEqpRQ 30pZu7E5J4pQOw35L4+8BXzpVrhhhPWOGkqV0E5zujDIhVZG5VYezH74YpSSz9RJ+tg+ gbsg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700203242; x=1700808042; 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=YsHnJGv78zqzqvzSBU7Yn+nGTyU2xuEXFjTMy+L46O8=; b=h+dnfeq38Q4GNyh0JDsR2NMiNvspmZgMJxreXaNGIoFAVMyH1TNuoVia1LzBCpx9qG /USuy2eJCDs0C2G5m0h5HgoV+og+rX5tiEuCJsTAQCKNJvfy5QhCXMpygY6MJQU2JQQQ BOqiQtVmGLKGrtHX8qr5jDnFO1N0us1NruNCw/YzM18ZH4qNk/8Wr5u4QSelwKE/a/Mr DjemEOX5ZArjHm0nq5foWYKEKpakkiy31ZC4J4jVyo8l9QkhqIrKgD3dd/yeckkMNDtj xgFqLv7ifKULirdxyPstAMvb17a/luFioG/WkCJQp5MYSWJcjHmEqOeYgnRXnZnQHrSj jGdQ== X-Gm-Message-State: AOJu0YwDrA7jqmewCSOW4I/t+VY4lFRSSzMboMHivoQKP1YDXdYTNGXa 3zOlmuUMyOHH++xtsMrwwxE= X-Google-Smtp-Source: AGHT+IFklLfJ/0lws8a+VAe6MfS2TsLhh5FiUGEMmj0AlJRoWQaURcRg3TiQ7ii6v8ZCQGiOzahTwQ== X-Received: by 2002:a17:907:984:b0:9e0:dcf:17d8 with SMTP id bf4-20020a170907098400b009e00dcf17d8mr15777550ejc.71.1700203242014; Thu, 16 Nov 2023 22:40:42 -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.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Nov 2023 22:40:41 -0800 (PST) From: Javier Carrasco Date: Fri, 17 Nov 2023 07:40:36 +0100 Subject: [PATCH 3/4] ABI: sysfs-class-hwmon: fix tempY_crit_alarm access rights Precedence: bulk X-Mailing-List: linux-hwmon@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20231116-hwmon_abi-v1-3-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=1409; i=javier.carrasco.cruz@gmail.com; s=20230509; h=from:subject:message-id; bh=FAaz0JyjLpwKKeXAsKli/EtU8qFxsDz77oHVb7sXDBA=; b=pFYkFaTT6FBXwHOfIomatXJrB4ld5btqjXF2rTDe7xfDie6Flj2CDCyDYQZKMmf7Aa+GzF5lO etcDxJBZNM0C434q+vBAIOS8zXF+6CLuVfgpvmOM+bMLvaEhs+CsFRs X-Developer-Key: i=javier.carrasco.cruz@gmail.com; a=ed25519; pk=tIGJV7M+tCizagNijF0eGMBGcOsPD+0cWGfKjl4h6K8= X-Spam-Level: * This attribute is defined as read-only by all drivers that support it. It seems that the access rights and description for this attribute were copied from the intrusionY_alarm, which has indeed RW rights and must be cleared by the user. These are the modules that currently use this attribute: - adt7x10 - i5500_temp - jc42 - lm83 - lm90 - lm95245 - max31760 - max6621 - mc34vr500 - tmp401 - tmp464 - tmp513 Fix the attribute description and make it read-only. Fixes: 365b5d63a505 ("ABI: sysfs-class-hwmon: add a description for tempY_crit_alarm") Signed-off-by: Javier Carrasco --- Documentation/ABI/testing/sysfs-class-hwmon | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-class-hwmon b/Documentation/ABI/testing/sysfs-class-hwmon index dccbcdc2dad8..3d5e6142ef0c 100644 --- a/Documentation/ABI/testing/sysfs-class-hwmon +++ b/Documentation/ABI/testing/sysfs-class-hwmon @@ -434,12 +434,7 @@ Description: - 0: OK - 1: temperature has reached tempY_crit - RW - - Contrary to regular alarm flags which clear themselves - automatically when read, this one sticks until cleared by - the user. This is done by writing 0 to the file. Writing - other values is unsupported. + RO What: /sys/class/hwmon/hwmonX/tempY_crit_hyst Description: 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: 13458396 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="RpZPtz3G" 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-Google-Smtp-Source: AGHT+IEKw7KYfOCKyRNhrlh7MbrkD1uStIMlwBFq5y8eJmTBJCIpSoK6WrsCfOROQvePB4g/9BvBvw== 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 Precedence: bulk X-Mailing-List: linux-hwmon@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: 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-Level: * 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.