Document an optional second I2C address for the PMIC's RTC device, to be
used if the RTC is located at a non-default I2C address

Signed-off-by: Svyatoslav Ryhel <clamor95@gmail.com>
---
 .../devicetree/bindings/mfd/maxim,max77686.yaml   | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/mfd/maxim,max77686.yaml b/Documentation/devicetree/bindings/mfd/maxim,max77686.yaml
index c13d51e462ba..2d4aad8feaeb 100644
--- a/Documentation/devicetree/bindings/mfd/maxim,max77686.yaml
+++ b/Documentation/devicetree/bindings/mfd/maxim,max77686.yaml
@@ -32,7 +32,17 @@ properties:
     maxItems: 1
 
   reg:
-    maxItems: 1
+    description:
+      Can contain an optional second I2C address pointing to the PMIC's
+      RTC device. If no RTC address is provided, a default address specific
+      to this PMIC will be used.
+    minItems: 1
+    maxItems: 2
+
+  reg-names:
+    items:
+      - const: pmic
+      - const: rtc
 
   voltage-regulators:
     $ref: /schemas/regulator/maxim,max77686.yaml
@@ -59,7 +69,8 @@ examples:
 
         max77686: pmic@9 {
             compatible = "maxim,max77686";
-            reg = <0x09>;
+            reg = <0x09>, <0x06>;
+            reg-names = "pmic", "rtc";
 
             interrupt-parent = <&gpx0>;
             interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
-- 
2.51.0

On 11/02/2026 19:49, Svyatoslav Ryhel wrote:
> Document an optional second I2C address for the PMIC's RTC device, to be
> used if the RTC is located at a non-default I2C address

MAX77686 did not allow changing the I2C address and there are no other
devices in the bindings.


Best regards,
Krzysztof

12 лютого 2026 р. 09:26:33 GMT+02:00, Krzysztof Kozlowski <krzk@kernel.org> пише:
>On 11/02/2026 19:49, Svyatoslav Ryhel wrote:
>> Document an optional second I2C address for the PMIC's RTC device, to be
>> used if the RTC is located at a non-default I2C address
>
>MAX77686 did not allow changing the I2C address and there are no other
>devices in the bindings.
>

That is true, MAX77663 RTC does this, should I adjust Documentation/devicetree/bindings/mfd/max77620.txt instead?

>
>Best regards,
>Krzysztof

On 12/02/2026 09:08, Svyatoslav Ryhel wrote:
> 
> 
> 12 лютого 2026 р. 09:26:33 GMT+02:00, Krzysztof Kozlowski <krzk@kernel.org> пише:
>> On 11/02/2026 19:49, Svyatoslav Ryhel wrote:
>>> Document an optional second I2C address for the PMIC's RTC device, to be
>>> used if the RTC is located at a non-default I2C address
>>
>> MAX77686 did not allow changing the I2C address and there are no other
>> devices in the bindings.
>>
> 
> That is true, MAX77663 RTC does this, should I adjust Documentation/devicetree/bindings/mfd/max77620.txt instead?

I don't know which binding you should update instead, but I know that it
must not be max77686. Please update the binding for the device you are
actually changing, not some other devices.

Best regards,
Krzysztof