Documentation/devicetree/bindings/iio/afe/temperature-sense-rtd.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/iio/afe/temperature-sense-rtd.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/iio/afe/temperature-sense-rtd.yaml
Extension
.yaml
Size
2709 bytes
Lines
102
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/afe/temperature-sense-rtd.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Temperature Sense RTD

maintainers:
  - Liam Beguin <liambeguin@gmail.com>

description: |
  RTDs (Resistance Temperature Detectors) are a kind of temperature sensors
  used to get a linear voltage to temperature reading within a give range
  (usually 0 to 100 degrees Celsius).

  When an io-channel measures the output voltage across an RTD such as a
  PT1000, the interesting measurement is almost always the corresponding
  temperature, not the voltage output. This binding describes such a circuit.

  The general transfer function here is (using SI units)

    V = R(T) * iexc
    R(T) = r0 * (1 + alpha * T)
    T = 1 / (alpha * r0 * iexc) * (V - r0 * iexc)

  The following circuit matches what's in the examples section.

           5V0
          -----
            |
        +---+----+
        |  R 5k  |
        +---+----+
            |
            V 1mA
            |
            +---- Vout
            |
        +---+----+
        | PT1000 |
        +---+----+
            |
          -----
           GND

properties:
  compatible:
    const: temperature-sense-rtd

  io-channels:
    maxItems: 1
    description: |
      Channel node of a voltage io-channel.

  '#io-channel-cells':
    const: 0

  excitation-current-microamp:
    description: The current fed through the RTD sensor.

  alpha-ppm-per-celsius:
    description: |
      alpha can also be expressed in micro-ohms per ohm Celsius. It's a linear
      approximation of the resistance versus temperature relationship
      between 0 and 100 degrees Celsius.

      alpha = (R_100 - R_0) / (100 * R_0)

      Where, R_100 is the resistance of the sensor at 100 degrees Celsius, and

Annotation

Implementation Notes