Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d2be279b authored by Amelie Delaunay's avatar Amelie Delaunay Committed by Alexandre Belloni
Browse files

dt-bindings: rtc: stm32: add support for STM32H7 



This patch documents support for STM32H7 Real Time Clock.
It introduces a new compatible and rework clock definitions.
On STM32H7 we have a 'pclk' clock for register access, in addition to
the 'rtc_ck' clock.

Acked-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarAmelie Delaunay <amelie.delaunay@st.com>
Signed-off-by: default avatarAlexandre Belloni <alexandre.belloni@free-electrons.com>
parent 300a7735

Documentation/devicetree/bindings/rtc/st,stm32-rtc.txt

+27 −5
Original line number Diff line number Diff line 
STM32 Real Time Clock



Required properties:

- compatible: "st,stm32-rtc".

- compatible: can be either "st,stm32-rtc" or "st,stm32h7-rtc", depending on

  the device is compatible with stm32(f4/f7) or stm32h7.

- reg: address range of rtc register set.

- clocks: reference to the clock entry ck_rtc.

- clocks: can use up to two clocks, depending on part used:

  - "rtc_ck": RTC clock source.

    It is required on stm32(f4/f7) and stm32h7.

  - "pclk": RTC APB interface clock.

    It is not present on stm32(f4/f7).

    It is required on stm32h7.

- clock-names: must be "rtc_ck" and "pclk".

    It is required only on stm32h7.

- interrupt-parent: phandle for the interrupt controller.

- interrupts: rtc alarm interrupt.

- st,syscfg: phandle for pwrcfg, mandatory to disable/enable backup domain

  (RTC registers) write protection.



Optional properties (to override default ck_rtc parent clock):

- assigned-clocks: reference to the ck_rtc clock entry.

- assigned-clock-parents: phandle of the new parent clock of ck_rtc.

Optional properties (to override default rtc_ck parent clock):

- assigned-clocks: reference to the rtc_ck clock entry.

- assigned-clock-parents: phandle of the new parent clock of rtc_ck.



Example:
@@ -25,3 +33,17 @@ Example: 
		interrupts = <17 1>;

		st,syscfg = <&pwrcfg>;

	};



	rtc: rtc@58004000 {

		compatible = "st,stm32h7-rtc";

		reg = <0x58004000 0x400>;

		clocks = <&rcc RTCAPB_CK>, <&rcc RTC_CK>;

		clock-names = "pclk", "rtc_ck";

		assigned-clocks = <&rcc RTC_CK>;

		assigned-clock-parents = <&rcc LSE_CK>;

		interrupt-parent = <&exti>;

		interrupts = <17 1>;

		interrupt-names = "alarm";

		st,syscfg = <&pwrcfg>;

		status = "disabled";

	};