~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/devicetree/bindings/hwmon/baikal,bt1-pvt.yaml

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2 # Copyright (C) 2020 BAIKAL ELECTRONICS, JSC
  3 %YAML 1.2
  4 ---
  5 $id: http://devicetree.org/schemas/hwmon/baikal,bt1-pvt.yaml#
  6 $schema: http://devicetree.org/meta-schemas/core.yaml#
  7 
  8 title: Baikal-T1 PVT Sensor
  9 
 10 maintainers:
 11   - Serge Semin <fancer.lancer@gmail.com>
 12 
 13 description: |
 14   Baikal-T1 SoC provides an embedded process, voltage and temperature
 15   sensor to monitor an internal SoC environment (chip temperature, supply
 16   voltage and process monitor) and on time detect critical situations,
 17   which may cause the system instability and even damages. The IP-block
 18   is based on the Analog Bits PVT sensor, but is equipped with a dedicated
 19   control wrapper, which provides a MMIO registers-based access to the
 20   sensor core functionality (APB3-bus based) and exposes an additional
 21   functions like thresholds/data ready interrupts, its status and masks,
 22   measurements timeout. Its internal structure is depicted on the next
 23   diagram:
 24 
 25      Analog Bits core                     Bakal-T1 PVT control block
 26   +--------------------+                  +------------------------+
 27   | Temperature sensor |-+         +------| Sensors control        |
 28   |--------------------| |<---En---|      |------------------------|
 29   | Voltage sensor     |-|<--Mode--| +--->| Sampled data           |
 30   |--------------------| |<--Trim--+ |    |------------------------|
 31   | Low-Vt sensor      |-|           | +--| Thresholds comparator  |
 32   |--------------------| |---Data----| |  |------------------------|
 33   | High-Vt sensor     |-|           | +->| Interrupts status      |
 34   |--------------------| |--Valid--+-+ |  |------------------------|
 35   | Standard-Vt sensor |-+         +---+--| Interrupts mask        |
 36   +--------------------+                  |------------------------|
 37            ^                              | Interrupts timeout     |
 38            |                              +------------------------+
 39            |                                        ^  ^
 40   Rclk-----+----------------------------------------+  |
 41   APB3-------------------------------------------------+
 42 
 43   This bindings describes the external Baikal-T1 PVT control interfaces
 44   like MMIO registers space, interrupt request number and clocks source.
 45   These are then used by the corresponding hwmon device driver to
 46   implement the sysfs files-based access to the sensors functionality.
 47 
 48 properties:
 49   compatible:
 50     const: baikal,bt1-pvt
 51 
 52   reg:
 53     maxItems: 1
 54 
 55   interrupts:
 56     maxItems: 1
 57 
 58   clocks:
 59     items:
 60       - description: PVT reference clock
 61       - description: APB3 interface clock
 62 
 63   clock-names:
 64     items:
 65       - const: ref
 66       - const: pclk
 67 
 68   "#thermal-sensor-cells":
 69     description: Baikal-T1 can be referenced as the CPU thermal-sensor
 70     const: 0
 71 
 72   baikal,pvt-temp-offset-millicelsius:
 73     description: |
 74       Temperature sensor trimming factor. It can be used to manually adjust the
 75       temperature measurements within 7.130 degrees Celsius.
 76     default: 0
 77     minimum: 0
 78     maximum: 7130
 79 
 80 additionalProperties: false
 81 
 82 required:
 83   - compatible
 84   - reg
 85   - interrupts
 86   - clocks
 87   - clock-names
 88 
 89 examples:
 90   - |
 91     #include <dt-bindings/interrupt-controller/mips-gic.h>
 92 
 93     pvt@1f200000 {
 94       compatible = "baikal,bt1-pvt";
 95       reg = <0x1f200000 0x1000>;
 96       #thermal-sensor-cells = <0>;
 97 
 98       interrupts = <GIC_SHARED 31 IRQ_TYPE_LEVEL_HIGH>;
 99 
100       baikal,pvt-temp-offset-millicelsius = <1000>;
101 
102       clocks = <&ccu_sys>, <&ccu_sys>;
103       clock-names = "ref", "pclk";
104     };
105 ...

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php