[PATCH 1/2] dt-bindings: rtc: Convert TI Palmas RTC to DT schema

From: Eduard Bostina

Date: Sun Jul 19 2026 - 10:10:59 EST


Convert the Texas Instruments Palmas RTC controller bindings
to DT schema.

As part of the conversion, declare 'wakeup-source: true'.
This documents the Palmas PMIC's capability to wake the system.

Signed-off-by: Eduard Bostina <egbostina@xxxxxxxxx>
---
.../devicetree/bindings/rtc/rtc-palmas.txt | 32 -----------
.../bindings/rtc/ti,palmas-rtc.yaml | 57 +++++++++++++++++++
2 files changed, 57 insertions(+), 32 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/rtc/rtc-palmas.txt
create mode 100644 Documentation/devicetree/bindings/rtc/ti,palmas-rtc.yaml

diff --git a/Documentation/devicetree/bindings/rtc/rtc-palmas.txt b/Documentation/devicetree/bindings/rtc/rtc-palmas.txt
deleted file mode 100644
index c6cf37758a77..000000000000
--- a/Documentation/devicetree/bindings/rtc/rtc-palmas.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-Palmas RTC controller bindings
-
-Required properties:
-- compatible:
- - "ti,palmas-rtc" for palma series of the RTC controller
-- interrupts: Interrupt number of RTC submodule on device.
-
-Optional properties:
-
-- ti,backup-battery-chargeable: The Palmas series device like TPS65913 or
- TPS80036 supports the backup battery for powering the RTC when main
- battery is removed or in very low power state. The backup battery
- can be chargeable or non-chargeable. This flag will tells whether
- battery is chargeable or not. If charging battery then driver can
- enable the charging.
-- ti,backup-battery-charge-high-current: Enable high current charging in
- backup battery. Device supports the < 100uA and > 100uA charging.
- The high current will be > 100uA. Absence of this property will
- charge battery to lower current i.e. < 100uA.
-
-Example:
- palmas: tps65913@58 {
- ...
- palmas_rtc: rtc {
- compatible = "ti,palmas-rtc";
- interrupt-parent = <&palmas>;
- interrupts = <8 0>;
- ti,backup-battery-chargeable;
- ti,backup-battery-charge-high-current;
- };
- ...
- };
diff --git a/Documentation/devicetree/bindings/rtc/ti,palmas-rtc.yaml b/Documentation/devicetree/bindings/rtc/ti,palmas-rtc.yaml
new file mode 100644
index 000000000000..ac64f0589c84
--- /dev/null
+++ b/Documentation/devicetree/bindings/rtc/ti,palmas-rtc.yaml
@@ -0,0 +1,57 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/rtc/ti,palmas-rtc.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments Palmas RTC
+
+maintainers:
+ - Eduard Bostina <egbostina@xxxxxxxxx>
+
+allOf:
+ - $ref: /schemas/rtc/rtc.yaml#
+
+properties:
+ compatible:
+ const: ti,palmas-rtc
+
+ interrupts:
+ maxItems: 1
+
+ wakeup-source: true
+
+ ti,backup-battery-chargeable:
+ type: boolean
+ description:
+ The backup battery can be chargeable or non-chargeable. This flag
+ indicates whether the battery is chargeable. If present, the driver
+ can enable charging.
+
+ ti,backup-battery-charge-high-current:
+ type: boolean
+ description:
+ Enable high current charging in the backup battery.
+ Device supports the < 100uA and > 100uA charging. The high current will
+ be > 100uA. Absence of this property will charge battery to lower
+ current i.e. < 100uA.
+
+required:
+ - compatible
+ - interrupts
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ pmic {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ rtc {
+ compatible = "ti,palmas-rtc";
+ interrupts = <8 0>;
+ ti,backup-battery-chargeable;
+ ti,backup-battery-charge-high-current;
+ };
+ };
--
2.43.0