# 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>;
};