| # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) |
| %YAML 1.2 |
| --- |
| $id: http://devicetree.org/schemas/rtc/st,stm32-rtc.yaml# |
| $schema: http://devicetree.org/meta-schemas/core.yaml# |
| |
| title: STMicroelectronics STM32 Real Time Clock |
| |
| maintainers: |
| - Gabriel Fernandez <gabriel.fernandez@foss.st.com> |
| |
| properties: |
| compatible: |
| enum: |
| - st,stm32-rtc |
| - st,stm32h7-rtc |
| - st,stm32mp1-rtc |
| - st,stm32mp25-rtc |
| |
| reg: |
| maxItems: 1 |
| |
| clocks: |
| minItems: 1 |
| maxItems: 2 |
| |
| clock-names: |
| items: |
| - const: pclk |
| - const: rtc_ck |
| |
| interrupts: |
| maxItems: 1 |
| |
| st,syscfg: |
| $ref: /schemas/types.yaml#/definitions/phandle-array |
| items: |
| minItems: 3 |
| maxItems: 3 |
| description: | |
| Phandle/offset/mask triplet. The phandle to pwrcfg used to |
| access control register at offset, and change the dbp (Disable Backup |
| Protection) bit represented by the mask, mandatory to disable/enable backup |
| domain (RTC registers) write protection. |
| |
| assigned-clocks: |
| description: | |
| override default rtc_ck parent clock reference to the rtc_ck clock entry |
| maxItems: 1 |
| |
| assigned-clock-parents: |
| description: | |
| override default rtc_ck parent clock phandle of the new parent clock of rtc_ck |
| maxItems: 1 |
| |
| patternProperties: |
| "^rtc-[a-z]+-[0-9]+$": |
| type: object |
| $ref: /schemas/pinctrl/pinmux-node.yaml |
| description: | |
| Configuration of STM32 RTC pins description. STM32 RTC is able to output |
| some signals on specific pins: |
| - LSCO (Low Speed Clock Output) that allow to output LSE clock on a pin. |
| - Alarm out that allow to send a pulse on a pin when alarm A of the RTC |
| expires. |
| additionalProperties: false |
| properties: |
| function: |
| enum: |
| - lsco |
| - alarm-a |
| pins: |
| enum: |
| - out1 |
| - out2 |
| - out2_rmp |
| |
| allOf: |
| - if: |
| properties: |
| compatible: |
| contains: |
| const: st,stm32-rtc |
| |
| then: |
| properties: |
| clocks: |
| minItems: 1 |
| maxItems: 1 |
| |
| clock-names: false |
| |
| patternProperties: |
| "^rtc-[a-z]+-[0-9]+$": false |
| |
| required: |
| - st,syscfg |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| const: st,stm32h7-rtc |
| |
| then: |
| properties: |
| clocks: |
| minItems: 2 |
| maxItems: 2 |
| |
| patternProperties: |
| "^rtc-[a-z]+-[0-9]+$": false |
| |
| required: |
| - clock-names |
| - st,syscfg |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - st,stm32mp1-rtc |
| - st,stm32mp25-rtc |
| |
| then: |
| properties: |
| clocks: |
| minItems: 2 |
| maxItems: 2 |
| |
| assigned-clocks: false |
| assigned-clock-parents: false |
| |
| required: |
| - clock-names |
| |
| required: |
| - compatible |
| - reg |
| - clocks |
| - interrupts |
| |
| additionalProperties: false |
| |
| examples: |
| - | |
| #include <dt-bindings/mfd/stm32f4-rcc.h> |
| #include <dt-bindings/clock/stm32fx-clock.h> |
| rtc@40002800 { |
| compatible = "st,stm32-rtc"; |
| reg = <0x40002800 0x400>; |
| clocks = <&rcc 1 CLK_RTC>; |
| assigned-clocks = <&rcc 1 CLK_RTC>; |
| assigned-clock-parents = <&rcc 1 CLK_LSE>; |
| interrupt-parent = <&exti>; |
| interrupts = <17 1>; |
| st,syscfg = <&pwrcfg 0x00 0x100>; |
| }; |
| |
| - | |
| #include <dt-bindings/interrupt-controller/arm-gic.h> |
| #include <dt-bindings/clock/stm32mp1-clks.h> |
| rtc@5c004000 { |
| compatible = "st,stm32mp1-rtc"; |
| reg = <0x5c004000 0x400>; |
| clocks = <&rcc RTCAPB>, <&rcc RTC>; |
| clock-names = "pclk", "rtc_ck"; |
| interrupts = <GIC_SPI 3 IRQ_TYPE_LEVEL_HIGH>; |
| }; |
| |
| ... |
