Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
IronPort-SDR: aebdnUXhWguseF0hbDkrIl58kxBxO+x8m69vayp4ctYS1pEAhgvo9C0KYHws2YfwBETUd1jQir
 go/L/pfItSkA==
IronPort-SDR: A2pS92KjskX42teMy8OBr0+DgsfyhhI6k/ARncuQvFheS04pkMisR8JGc3ggL9z3gIoG4BEZE3
 5jzTsVcE5sLw==
From:   mgross@linux.intel.com
To:     markgross@kernel.org, mgross@linux.intel.com, arnd@arndb.de,
        bp@suse.de, damien.lemoal@wdc.com, dragan.cvetic@xilinx.com,
        gregkh@linuxfoundation.org, corbet@lwn.net,
        palmerdabbelt@google.com, paul.walmsley@sifive.com,
        peng.fan@nxp.com, robh+dt@kernel.org, shawnguo@kernel.org,
        jassisinghbrar@gmail.com
Cc:     linux-kernel@vger.kernel.org,
        "C, Udhayakumar" <udhayakumar.c@intel.com>
Subject: [PATCH v5 26/34] dt-bindings: misc: intel_tsens: Add tsens thermal bindings documentation
Date:   Fri,  5 Feb 2021 14:51:56 -0800
Message-Id: <20210205225204.32902-27-mgross@linux.intel.com>
In-Reply-To: <20210205225204.32902-1-mgross@linux.intel.com>
References: <20210205225204.32902-1-mgross@linux.intel.com>
Precedence: bulk

From: "C, Udhayakumar" <udhayakumar.c@intel.com>

Add device tree bindings for local host thermal sensors
Intel Edge.AI Computer Vision platforms.

The tsens module enables reading of on chip sensors present
in the Intel Bay series SoC. In the tsens module various junction
temperature and SoC temperature are reported using thermal subsystem
and i2c subsystem.

Temperature data reported using thermal subsystem will be used for
various cooling agents such as DVFS, fan control and shutdown the
system in case of critical temperature.

Temperature data reported using i2c subsytem will be used by
platform manageability software running in remote host.

Acked-by: mark gross <mgross@linux.intel.com>
Signed-off-by: C Udhayakumar <udhayakumar.c@intel.com>
Signed-off-by: Mark Gross <mgross@linux.intel.com>
---
 .../bindings/misc/intel,intel-tsens.yaml      | 122 ++++++++++++++++++
 1 file changed, 122 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/intel,intel-tsens.yaml

diff --git a/Documentation/devicetree/bindings/misc/intel,intel-tsens.yaml b/Documentation/devicetree/bindings/misc/intel,intel-tsens.yaml
new file mode 100644
index 000000000000..f307dc6d2012
--- /dev/null
+++ b/Documentation/devicetree/bindings/misc/intel,intel-tsens.yaml
@@ -0,0 +1,122 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: "http://devicetree.org/schemas/misc/intel,intel-tsens.yaml#"
+$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+
+title: Intel Temperature sensors in Bay series
+
+maintainers:
+  - Udhayakumar C <udhayakumar.c@intel.com>
+
+description: |
+  The tsens driver enables reading of onchip sensors present
+  in the Intel Bay SoC.
+  Each subnode of the tsens represents sensors available
+  on the soc.
+
+select: false
+
+properties:
+  compatible:
+    items:
+      - const: intel,intel-tsens
+
+  plat_name:
+    contains:
+      enum:
+        - intel,keembay_thermal
+
+  reg:
+    minItems: 1
+    maxItems: 2
+
+  clocks:
+    items:
+      - description: thermal sensor clock
+
+  clk-rate:
+    items:
+      - description: thermal sensor clock freq
+
+  sensor_name:
+    type: object
+    description:
+      Details to configure sensor trip points and its types.
+
+    properties:
+      passive_delay:
+        minItems: 1
+        maxItems: 1
+        description: number of milliseconds to wait between polls when
+                     performing passive cooling
+
+      polling_delay:
+        minItems: 1
+        maxItems: 1
+        description: number of milliseconds to wait between polls when checking
+                     whether trip points have been crossed (0 for interrupt
+                     driven systems)
+
+      trip_temp:
+        minItems: 1
+        description: temperature for trip points
+
+      trip_type:
+        minItems: 1
+        description: trip type list for trip points
+
+    required:
+      - passive_delay
+      - polling_delay
+      - trip_temp
+      - trip_type
+
+required:
+  - compatible
+
+additionalProperties: false
+
+examples:
+  - |
+    tsens {
+        #address-cells = <2>;
+        #size-cells = <2>;
+
+        tsens@20260000 {
+                compatible = "intel,intel-tsens";
+                status = "disabled";
+                plat_name = "intel,keembay_thermal";
+                reg = <0x0 0x20260000 0x0 0x100>;
+                clocks = <&scmi_clk>;
+                clk-rate = <1250000>;
+
+                mss {
+                        passive_delay = <1000>;
+                        polling_delay = <2000>;
+                        trip_temp = <40000 80000 1000000>;
+                        trip_type = "passive", "passive", "critical";
+                };
+
+                css {
+                        passive_delay = <1000>;
+                        polling_delay = <2000>;
+                        trip_temp = <40000 80000 1000000>;
+                        trip_type = "passive", "passive", "critical";
+                };
+
+                nce {
+                        passive_delay = <1000>;
+                        polling_delay = <2000>;
+                        trip_temp = <40000 80000 1000000>;
+                        trip_type = "passive", "passive", "critical";
+                };
+
+                soc {
+                        passive_delay = <1000>;
+                        polling_delay = <2000>;
+                        trip_temp = <40000 80000 1000000>;
+                        trip_type = "passive", "passive", "critical";
+                };
+        };
+    };
-- 
2.17.1