Documentation/devicetree/bindings/hwmon/ti,tmp401.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/hwmon/ti,tmp401.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: TMP401, TPM411 and TMP43x temperature sensor
   8
   9 maintainers:
  10   - Guenter Roeck <linux@roeck-us.net>
  11
  12 description: |
  13   ±1°C Remote and Local temperature sensor
  14
  15   Datasheets:
  16   https://www.ti.com/lit/ds/symlink/tmp401.pdf
  17   https://www.ti.com/lit/ds/symlink/tmp411.pdf
  18   https://www.ti.com/lit/ds/symlink/tmp431.pdf
  19   https://www.ti.com/lit/ds/symlink/tmp435.pdf
  20
  21 properties:
  22   compatible:
  23     enum:
  24       - ti,tmp401
  25       - ti,tmp411
  26       - ti,tmp431
  27       - ti,tmp432
  28       - ti,tmp435
  29
  30   reg:
  31     maxItems: 1
  32
  33   ti,extended-range-enable:
  34     description:
  35       When set, this sensor measures over extended temperature range.
  36     type: boolean
  37
  38   ti,n-factor:
  39     description:
  40       value to be used for converting remote channel measurements to
  41       temperature.
  42     $ref: /schemas/types.yaml#/definitions/int32
  43     items:
  44       minimum: -128
  45       maximum: 127
  46
  47   ti,beta-compensation:
  48     description:
  49       value to select beta correction range.
  50     $ref: /schemas/types.yaml#/definitions/uint32
  51     minimum: 0
  52     maximum: 15
  53
  54 allOf:
  55   - if:
  56       properties:
  57         compatible:
  58           contains:
  59             enum:
  60               - ti,tmp401
  61     then:
  62       properties:
  63         ti,n-factor: false
  64
  65   - if:
  66       properties:
  67         compatible:
  68           contains:
  69             enum:
  70               - ti,tmp401
  71               - ti,tmp411
  72     then:
  73       properties:
  74         ti,beta-compensation: false
  75
  76 required:
  77   - compatible
  78   - reg
  79
  80 additionalProperties: false
  81
  82 examples:
  83   - |
  84     i2c {
  85       #address-cells = <1>;
  86       #size-cells = <0>;
  87
  88       sensor@4c {
  89         compatible = "ti,tmp401";
  90         reg = <0x4c>;
  91       };
  92     };
  93   - |
  94     i2c {
  95       #address-cells = <1>;
  96       #size-cells = <0>;
  97
  98       sensor@4c {
  99         compatible = "ti,tmp431";
 100         reg = <0x4c>;
 101         ti,extended-range-enable;
 102         ti,n-factor = <0x3b>;
 103         ti,beta-compensation = <0x7>;
 104       };
 105     };