From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7695BC433EF for ; Tue, 12 Apr 2022 13:52:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233019AbiDLNzI (ORCPT ); Tue, 12 Apr 2022 09:55:08 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50920 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1356311AbiDLNzH (ORCPT ); Tue, 12 Apr 2022 09:55:07 -0400 Received: from smtp1.axis.com (smtp1.axis.com [195.60.68.17]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 43B7B57170; Tue, 12 Apr 2022 06:52:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=axis.com; q=dns/txt; s=axis-central1; t=1649771567; x=1681307567; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=a52on8qx1rwRS1jCAPqKnMH8/yG5QTkEx/mAWQ8yWFc=; b=cFKbVsKD/RxogGZO6hCr2iml+AtlQcjHdAdoSR9BF2/2BCgZh8rfz+pT bUHMkMgSaYThJzDbQupPfG+6tpe4U7Qic9clNAoFPUZlXJCqqxjAgQtHo ZlO6X8Mkx3Y0aMN1ALvp/XulwSjUIbQyskNAGB4qGBpy4cAanQ0J2AgmW a9r/jHJQvnB7GsBnIwIfI6yFwFzCLM6Vbomk6CbZMC5YGzanlrF9vTAe8 wL1h5TQjdze546OWV9ScrPemUkLfvMLIY5gS642a6xCRyQPkM2bYOxIiq 32WB5MGQ84AT+6m/d0vXvUiYCMSR+87E6S3GXHxaCiM8SkfaaIzOv8spy A==; From: Camel Guo To: Guenter Roeck , Jean Delvare , Rob Herring , Krzysztof Kozlowski CC: Camel Guo , , , , Subject: [PATCH v2 1/2] dt-bindings: hwmon: Add TMP401, TMP411 and TMP43x Date: Tue, 12 Apr 2022 15:52:31 +0200 Message-ID: <20220412135232.1943677-2-camel.guo@axis.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220412135232.1943677-1-camel.guo@axis.com> References: <20220412135232.1943677-1-camel.guo@axis.com> MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-hwmon@vger.kernel.org Document the TMP401, TMP411 and TMP43x device devicetree bindings Signed-off-by: Camel Guo --- Notes: v2: - Fix format and describe hardware properties instead of programming models .../devicetree/bindings/hwmon/ti,tmp401.yaml | 112 ++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 113 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/ti,tmp401.yaml diff --git a/Documentation/devicetree/bindings/hwmon/ti,tmp401.yaml b/Documentation/devicetree/bindings/hwmon/ti,tmp401.yaml new file mode 100644 index 000000000000..dae4df36935e --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/ti,tmp401.yaml @@ -0,0 +1,112 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hwmon/ti,tmp401.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TMP401, TPM411 and TMP43x temperature sensor + +maintainers: + - Guenter Roeck + +description: | + ±1°C Remote and Local temperature sensor + + Datasheets: + https://www.ti.com/lit/ds/symlink/tmp401.pdf + https://www.ti.com/lit/ds/symlink/tmp411.pdf + https://www.ti.com/lit/ds/symlink/tmp431.pdf + https://www.ti.com/lit/ds/symlink/tmp435.pdf + +properties: + compatible: + enum: + - ti,tmp401 + - ti,tmp411 + - ti,tmp431 + - ti,tmp432 + - ti,tmp435 + + reg: + maxItems: 1 + + '#address-cells': + const: 1 + + '#size-cells': + const: 0 + + ti,extended-range-enable: + description: + When set, this sensor measures over extended temperature range. + type: boolean + + ti,n-factor: + description: + value to be used for converting remote channel measurements to + temperature. + $ref: /schemas/types.yaml#/definitions/uint32 + items: + minimum: 0 + maximum: 255 + + ti,beta-compensation: + description: + value to select beta correction range. + $ref: /schemas/types.yaml#/definitions/uint32 + items: + minimum: 0 + maximum: 15 + +allOf: + - if: + properties: + compatible: + contains: + enum: + - ti,tmp401 + then: + properties: + ti,n-factor: false + + - if: + properties: + compatible: + contains: + enum: + - ti,tmp401 + - ti,tmp411 + then: + properties: + ti,beta-compensation: false + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + sensor@4c { + compatible = "ti,tmp401"; + reg = <0x4c>; + }; + }; + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + sensor@4c { + compatible = "ti,tmp431"; + reg = <0x4c>; + ti,extended-range-enable; + ti,n-factor = <0x3b>; + ti,beta-compensation = <0x7>; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 61d9f114c37f..6b0d8f5cc68e 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -19838,6 +19838,7 @@ TMP401 HARDWARE MONITOR DRIVER M: Guenter Roeck L: linux-hwmon@vger.kernel.org S: Maintained +F: Documentation/devicetree/bindings/hwmon/ti,tmp401.yaml F: Documentation/hwmon/tmp401.rst F: drivers/hwmon/tmp401.c -- 2.30.2