[PATCH v3 1/2] dt-bindings: rtc: pcf2127: Add nxp,battery-backed flag

[Philipp Rosenberger <p.rosenberger@kunbus.com>]

This commit introduces the nxp,battery-backed property to the
nxp,pcf2127 Device Tree bindings. This flag indicates that the
RTC is battery-backed and forces the driver to enable the
battery switch-over function, but only if no other mode is already
configured.

With the PCF2131, the battery switch-over is disabled by default.
If the battery switch-over is not enabled by the bootloader or
firmware, this property ensures that the RTC can function correctly
when powered by the battery.

Signed-off-by: Philipp Rosenberger <p.rosenberger@kunbus.com>
---
 Documentation/devicetree/bindings/rtc/nxp,pcf2127.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/Documentation/devicetree/bindings/rtc/nxp,pcf2127.yaml b/Documentation/devicetree/bindings/rtc/nxp,pcf2127.yaml
index 2d9fe5a75b06..87ba16346fb4 100644
--- a/Documentation/devicetree/bindings/rtc/nxp,pcf2127.yaml
+++ b/Documentation/devicetree/bindings/rtc/nxp,pcf2127.yaml
@@ -30,6 +30,13 @@ properties:
 
   reset-source: true
 
+  nxp,battery-backed:
+    description: |
+      Indicates that the RTC is battery-backed. This property forces
+      the driver to enable the battery switch-over function, but only if
+      no other mode is already configured.
+    $ref: /schemas/types.yaml#/definitions/flag
+
 required:
   - compatible
   - reg
-- 
2.39.5