[PATCH v3] dt-bindings: rtc: haoyu,hym8563: document vdd-supply

From: pjh456

Date: Thu Nov 19 2026 - 07:52:06 EST


VDD is the HYM8563's main supply pin. Describe it so boards can
express the regulator feeding the RTC; the property is optional
because many boards hardwire VDD to an always-on rail. A side effect
of describing it is that fw_devlink orders the RTC probe after its
supply. The Purple Pi OH board DTS (posted separately) relies on
that ordering.

AI assistance: the supply description was cross-checked against the
vendor schematic with Gemini 4 Hydrogen (Google AI Studio); the binding
change and this changelog were drafted with assistance from the
Qwen3.8 Flash Next and DeepSeek V4.1 Flash language models, driven
through the OpenCode coding agent, using the HYM8563 datasheet as
input; the submitter reviewed every line, validated the result with
dt_binding_check and on the affected board, and takes full
responsibility for it.

Link: https://lore.kernel.org/all/tencent_B11DE1495C3C54CE186ED508E2CE5CE41106@xxxxxx/
Link: https://lore.kernel.org/all/tencent_9B1CC4BF39DFA325C2B5384EA8B0319BAA07@xxxxxx/
Signed-off-by: pjh456 <pengjunhao409@xxxxxxxxx>
---
v3: use the generic "vdd-supply: true" form and show the supply in the
example; reword the rationale around the hardware instead of the
fw_devlink ordering; replace the non-standard "Assisted-by:"
trailers with a disclosure paragraph in the commit message.
v2: rename vcc-supply to vdd-supply, matching the datasheet pin name
(Sashiko review).

Documentation/devicetree/bindings/rtc/haoyu,hym8563.yaml | 3 +++
1 file changed, 3 insertions(+)

diff --git a/Documentation/devicetree/bindings/rtc/haoyu,hym8563.yaml b/Documentation/devicetree/bindings/rtc/haoyu,hym8563.yaml
index 0b9f39ef0edc..ce9712e2c406 100644
--- a/Documentation/devicetree/bindings/rtc/haoyu,hym8563.yaml
+++ b/Documentation/devicetree/bindings/rtc/haoyu,hym8563.yaml
@@ -29,6 +29,8 @@ properties:
wakeup-source:
description: Enables wake up of host system on alarm.

+ vdd-supply: true
+
allOf:
- $ref: rtc.yaml

@@ -52,5 +54,6 @@ examples:
reg = <0x51>;
interrupts = <13 IRQ_TYPE_EDGE_FALLING>;
#clock-cells = <0>;
+ vdd-supply = <&rtc_vdd>;
};
};

base-commit: 7e1392a42ea288d70a266f6553fe06f57f8647ea
--
2.56.1