0001 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004
0005 $id: http://devicetree.org/schemas/hwmon/ti,tmp513.yaml#
0006 $schema: http://devicetree.org/meta-schemas/core.yaml#
0007
0008 title: TMP513/512 system monitor sensor
0009
0010 maintainers:
0011 - Eric Tremblay <etremblay@distech-controls.com>
0012
0013 description: |
0014 The TMP512 (dual-channel) and TMP513 (triple-channel) are system monitors
0015 that include remote sensors, a local temperature sensor, and a high-side
0016 current shunt monitor. These system monitors have the capability of measuring
0017 remote temperatures, on-chip temperatures, and system voltage/power/current
0018 consumption.
0019
0020 Datasheets:
0021 https://www.ti.com/lit/gpn/tmp513
0022 https://www.ti.com/lit/gpn/tmp512
0023
0024
0025 properties:
0026 compatible:
0027 enum:
0028 - ti,tmp512
0029 - ti,tmp513
0030
0031 reg:
0032 maxItems: 1
0033
0034 shunt-resistor-micro-ohms:
0035 description: |
0036 If 0, the calibration process will be skiped and the current and power
0037 measurement engine will not work. Temperature and voltage measurement
0038 will continue to work. The shunt value also need to respect:
0039 rshunt <= pga-gain * 40 * 1000 * 1000.
0040 If not, it's not possible to compute a valid calibration value.
0041 default: 1000
0042
0043 ti,pga-gain:
0044 description: |
0045 The gain value for the PGA function. This is 8, 4, 2 or 1.
0046 The PGA gain affect the shunt voltage range.
0047 The range will be equal to: pga-gain * 40mV
0048 $ref: /schemas/types.yaml#/definitions/uint32
0049 enum: [1, 2, 4, 8]
0050 default: 8
0051
0052 ti,bus-range-microvolt:
0053 description: |
0054 This is the operating range of the bus voltage in microvolt
0055 enum: [16000000, 32000000]
0056 default: 32000000
0057
0058 ti,nfactor:
0059 description: |
0060 Array of three(TMP513) or two(TMP512) n-Factor value for each remote
0061 temperature channel.
0062 See datasheet Table 11 for n-Factor range list and value interpretation.
0063 $ref: /schemas/types.yaml#/definitions/uint32-array
0064 minItems: 2
0065 maxItems: 3
0066 items:
0067 default: 0x00
0068 minimum: 0x00
0069 maximum: 0xFF
0070
0071 required:
0072 - compatible
0073 - reg
0074
0075 additionalProperties: false
0076
0077 examples:
0078 - |
0079 i2c {
0080 #address-cells = <1>;
0081 #size-cells = <0>;
0082
0083 tmp513@5c {
0084 compatible = "ti,tmp513";
0085 reg = <0x5C>;
0086 shunt-resistor-micro-ohms = <330000>;
0087 ti,bus-range-microvolt = <32000000>;
0088 ti,pga-gain = <8>;
0089 ti,nfactor = <0x1 0xF3 0x00>;
0090 };
0091 };
