# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/thermal/google,gs101-tmu-top.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung Exynos ACPM Thermal Management Unit (TMU)

maintainers:
  - Tudor Ambarus <tudor.ambarus@linaro.org>

description:
  The Samsung Exynos ACPM TMU is a thermal sensor block found on Exynos
  based platforms (such as Google GS101 and Exynos850). It supports
  both direct register-level access and firmware-mediated management
  via the ACPM (Alive Clock and Power Manager) firmware.

  On these platforms, the hardware is managed in a hybrid fashion. The
  Application Processor (AP) maintains direct memory-mapped access
  exclusively to the interrupt pending registers to identify thermal
  events. All other functional aspects - including sensor
  initialization, threshold configuration, and temperature acquisition
  - are handled by the ACPM firmware. The AP coordinates these
  operations through the ACPM IPC protocol.

properties:
  compatible:
    const: google,gs101-tmu-top

  reg:
    maxItems: 1

  clocks:
    items:
      - description: APB peripheral clock (PCLK) for TMU register access.

  interrupts:
    maxItems: 1

  "#thermal-sensor-cells":
    const: 1

  samsung,acpm-ipc:
    $ref: /schemas/types.yaml#/definitions/phandle
    description: Phandle to the ACPM IPC node.

required:
  - compatible
  - reg
  - clocks
  - interrupts
  - "#thermal-sensor-cells"
  - samsung,acpm-ipc

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/clock/google,gs101.h>

    thermal-sensor@100a0000 {
        compatible = "google,gs101-tmu-top";
        reg = <0x100a0000 0x800>;
        clocks = <&cmu_misc CLK_GOUT_MISC_TMU_TOP_PCLK>;
        interrupts = <GIC_SPI 769 IRQ_TYPE_LEVEL_HIGH 0>;
        #thermal-sensor-cells = <1>;
        samsung,acpm-ipc = <&acpm_ipc>;
    };