From patchwork Mon Dec 4 16:50:03 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Gloor X-Patchwork-Id: 173462 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:bcd1:0:b0:403:3b70:6f57 with SMTP id r17csp2892824vqy; Mon, 4 Dec 2023 08:52:21 -0800 (PST) X-Google-Smtp-Source: AGHT+IF6sF7UXEJRJRE5Gfwy5LwzlUbzTM5E+4wtUyS9jGKQL1YcknbtJ/m7rV9CX2tG7TaS4tEe X-Received: by 2002:a05:6a20:5151:b0:18c:651:c40e with SMTP id b17-20020a056a20515100b0018c0651c40emr4090336pzc.50.1701708741212; Mon, 04 Dec 2023 08:52:21 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1701708741; cv=none; d=google.com; s=arc-20160816; b=ofW/onqWyeXEs3ULgK47tfvtBxCJIF7ZeTaSOZ4vLP1bgWfka3ysHigTpQKMPFpDty n9GxS8aDfchsDy5xu+pU0cuyTH3ubYeIPM2qBbsVqfsYVvEl4RXgAVeQo3VMBfyw+lm4 Q/CHHtIBi9p7McN9d9OvoSMn6SoPQr/SNvFvSMdw4509m5bOTSqTXSI10gfml4mTFq/A djEISqUJN0w8AAcsHei6/Qt7hzlmSCbcBJ/RAyqVhxBvohwZ6i4nMCX6Rj4slAI1elLt Lip/M6Uq7/FCTBRS8VeKgjbNN2DqY0V0tCYVmscWy8dw5x58qSEf5TYERwwmtxM0GirJ bEPQ== 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 :references:in-reply-to:message-id:date:subject:cc:to:from; bh=eUmRc1qv4lJFw0jikkqXdpFyDJspUjwfKoRI9Ht+6BA=; fh=fjNSoY0LvOsWcORqEKQpjzRbUZLsws7xZhkeCHIPeqI=; b=qwewjmt+cnA7Wzd8X+2ZljyH2ZJWNv3oSm1qEsAY6ASi5HE+bDSlz0kRTrvj/nDABD RemRTRSX6HJENfEeMvHKtmHqBzgsds7ve2/2Tn/frvC9aDRdIXijpTpwfddvmTYjrb5d eVTqcmm02yXjCr/NK4RxXVgjPIVr1VBWz6RakKScQY/x1v1cY47PypkcJuB+PR/gbTMM w5xSxQ+h4KEllQwfIDuNPrC5EmpQdXMUvVnZswkerN8wr2BnhjOzsUGRNy4YAPc6iz6q ipWXjmxow+r2DI98Lh3pgs5NY9WXXbC++HWMtno7f+1WjFLJqxgk+/Rrlu9UJ7aMUZxv dQEw== ARC-Authentication-Results: i=1; mx.google.com; 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 Received: from lipwig.vger.email (lipwig.vger.email. [23.128.96.33]) by mx.google.com with ESMTPS id m2-20020a63ed42000000b005c6617f183fsi4013085pgk.303.2023.12.04.08.52.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 04 Dec 2023 08:52:21 -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; 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 Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by lipwig.vger.email (Postfix) with ESMTP id 6F42E80A4A30; Mon, 4 Dec 2023 08:52:18 -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 S235441AbjLDQvu (ORCPT + 99 others); Mon, 4 Dec 2023 11:51:50 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49078 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229513AbjLDQvn (ORCPT ); Mon, 4 Dec 2023 11:51:43 -0500 Received: from mxout017.mail.hostpoint.ch (mxout017.mail.hostpoint.ch [IPv6:2a00:d70:0:e::317]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2B0F2BB; Mon, 4 Dec 2023 08:51:48 -0800 (PST) Received: from [10.0.2.46] (helo=asmtp013.mail.hostpoint.ch) by mxout017.mail.hostpoint.ch with esmtps (TLS1.3) tls TLS_AES_256_GCM_SHA384 (Exim 4.96.2 (FreeBSD)) (envelope-from ) id 1rACAV-000EP4-1k; Mon, 04 Dec 2023 17:51:39 +0100 Received: from 157.20.79.83.dynamic.wline.res.cust.swisscom.ch ([83.79.20.157] helo=thinkpad.localdomain) by asmtp013.mail.hostpoint.ch with esmtpa (Exim 4.96.2 (FreeBSD)) (envelope-from ) id 1rACAV-000JX2-1G; Mon, 04 Dec 2023 17:51:39 +0100 X-Authenticated-Sender-Id: code@stefan-gloor.ch From: Stefan Gloor To: jdelvare@suse.com, linux@roeck-us.net, corbet@lwn.net, linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Stefan Gloor Subject: [PATCH v2 1/2] hwmon: sht3x: add sts3x support Date: Mon, 4 Dec 2023 17:50:03 +0100 Message-ID: <20231204165004.8491-2-code@stefan-gloor.ch> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20231204165004.8491-1-code@stefan-gloor.ch> References: <20231204165004.8491-1-code@stefan-gloor.ch> MIME-Version: 1.0 X-Vs-State: 0 X-Spam-Status: No, score=-0.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 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]); Mon, 04 Dec 2023 08:52:18 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1784370944991360336 X-GMAIL-MSGID: 1784370944991360336 Add information regarding the existing support for sts3x series and update the datasheet links. Signed-off-by: Stefan Gloor --- Documentation/hwmon/sht3x.rst | 29 +++++++++++++++++++++-------- 1 file changed, 21 insertions(+), 8 deletions(-) diff --git a/Documentation/hwmon/sht3x.rst b/Documentation/hwmon/sht3x.rst index 87864ffd1777..957c854f5d08 100644 --- a/Documentation/hwmon/sht3x.rst +++ b/Documentation/hwmon/sht3x.rst @@ -9,7 +9,19 @@ Supported chips: Addresses scanned: none - Datasheet: https://www.sensirion.com/file/datasheet_sht3x_digital + Datasheets: + - https://sensirion.com/media/documents/213E6A3B/63A5A569/Datasheet_SHT3x_DIS.pdf + - https://sensirion.com/media/documents/051DF50B/639C8101/Sensirion_Humidity_and_Temperature_Sensors_Datasheet_SHT33.pdf + + * Sensirion STS3x-DIS + + Prefix: 'sts3x' + + Addresses scanned: none + + Datasheets: + - https://sensirion.com/media/documents/1DA31AFD/61641F76/Sensirion_Temperature_Sensors_STS3x_Datasheet.pdf + - https://sensirion.com/media/documents/292A335C/65537BAF/Sensirion_Datasheet_STS32_STS33.pdf Author: @@ -19,16 +31,17 @@ Author: Description ----------- -This driver implements support for the Sensirion SHT3x-DIS chip, a humidity -and temperature sensor. Temperature is measured in degrees celsius, relative -humidity is expressed as a percentage. In the sysfs interface, all values are -scaled by 1000, i.e. the value for 31.5 degrees celsius is 31500. +This driver implements support for the Sensirion SHT3x-DIS and STS3x-DIS +series of humidity and temperature sensors. Temperature is measured in degrees +celsius, relative humidity is expressed as a percentage. In the sysfs interface, +all values are scaled by 1000, i.e. the value for 31.5 degrees celsius is 31500. The device communicates with the I2C protocol. Sensors can have the I2C -addresses 0x44 or 0x45, depending on the wiring. See -Documentation/i2c/instantiating-devices.rst for methods to instantiate the device. +addresses 0x44 or 0x45 (0x4a or 0x4b for sts3x), depending on the wiring. See +Documentation/i2c/instantiating-devices.rst for methods to instantiate the +device. -Even if sht3x sensor supports clock-strech(blocking mode) and non-strench +Even if sht3x sensor supports clock-stretch (blocking mode) and non-stretch (non-blocking mode) in single-shot mode, this driver only supports the latter. The sht3x sensor supports a single shot mode as well as 5 periodic measure