17bdcb8e0SMaxime Ripard# SPDX-License-Identifier: GPL-2.0
27bdcb8e0SMaxime Ripard%YAML 1.2
37bdcb8e0SMaxime Ripard---
47bdcb8e0SMaxime Ripard$id: http://devicetree.org/schemas/rtc/rtc.yaml#
57bdcb8e0SMaxime Ripard$schema: http://devicetree.org/meta-schemas/core.yaml#
67bdcb8e0SMaxime Ripard
7ab040c42SKrzysztof Kozlowskititle: Real Time Clock Common Properties
87bdcb8e0SMaxime Ripard
97bdcb8e0SMaxime Ripardmaintainers:
107bdcb8e0SMaxime Ripard  - Alexandre Belloni <alexandre.belloni@bootlin.com>
117bdcb8e0SMaxime Ripard
127bdcb8e0SMaxime Riparddescription: |
137bdcb8e0SMaxime Ripard  This document describes generic bindings which can be used to
147bdcb8e0SMaxime Ripard  describe Real Time Clock devices in a device tree.
157bdcb8e0SMaxime Ripard
167bdcb8e0SMaxime Ripardproperties:
177bdcb8e0SMaxime Ripard  $nodename:
18*93eff1e0SKrzysztof Kozlowski    pattern: "^rtc(@.*|-([0-9]|[1-9][0-9]+))?$"
197bdcb8e0SMaxime Ripard
20965fe1ceSBastian Krause  aux-voltage-chargeable:
21965fe1ceSBastian Krause    $ref: /schemas/types.yaml#/definitions/uint32
22965fe1ceSBastian Krause    enum: [0, 1]
23965fe1ceSBastian Krause    description: |
24965fe1ceSBastian Krause      Tells whether the battery/supercap of the RTC (if any) is
25965fe1ceSBastian Krause      chargeable or not:
26965fe1ceSBastian Krause      0: not chargeable
27965fe1ceSBastian Krause      1: chargeable
28965fe1ceSBastian Krause
297bdcb8e0SMaxime Ripard  quartz-load-femtofarads:
307bdcb8e0SMaxime Ripard    description:
317bdcb8e0SMaxime Ripard      The capacitive load of the quartz(x-tal), expressed in femto
327bdcb8e0SMaxime Ripard      Farad (fF). The default value shall be listed (if optional),
337bdcb8e0SMaxime Ripard      and likewise all valid values.
347bdcb8e0SMaxime Ripard
357bdcb8e0SMaxime Ripard  start-year:
367bdcb8e0SMaxime Ripard    $ref: /schemas/types.yaml#/definitions/uint32
377bdcb8e0SMaxime Ripard    description:
387bdcb8e0SMaxime Ripard      If provided, the default hardware range supported by the RTC is
397bdcb8e0SMaxime Ripard      shifted so the first usable year is the specified one.
407bdcb8e0SMaxime Ripard
417bdcb8e0SMaxime Ripard  trickle-diode-disable:
427bdcb8e0SMaxime Ripard    $ref: /schemas/types.yaml#/definitions/flag
437bdcb8e0SMaxime Ripard    description:
447bdcb8e0SMaxime Ripard      Do not use internal trickle charger diode. Should be given if
457bdcb8e0SMaxime Ripard      internal trickle charger diode should be disabled.
46965fe1ceSBastian Krause    deprecated: true
477bdcb8e0SMaxime Ripard
487bdcb8e0SMaxime Ripard  trickle-resistor-ohms:
497bdcb8e0SMaxime Ripard    description:
507bdcb8e0SMaxime Ripard      Selected resistor for trickle charger. Should be given
517bdcb8e0SMaxime Ripard      if trickle charger should be enabled.
527bdcb8e0SMaxime Ripard
5361ee0674SAlexandre Belloni  trickle-voltage-millivolt:
5461ee0674SAlexandre Belloni    description:
5561ee0674SAlexandre Belloni      Selected voltage for trickle charger. Should be given
5661ee0674SAlexandre Belloni      if trickle charger should be enabled and the trickle voltage is different
5761ee0674SAlexandre Belloni      from the RTC main power supply.
5861ee0674SAlexandre Belloni
597bdcb8e0SMaxime Ripard  wakeup-source:
607bdcb8e0SMaxime Ripard    $ref: /schemas/types.yaml#/definitions/flag
617bdcb8e0SMaxime Ripard    description:
627bdcb8e0SMaxime Ripard      Enables wake up of host system on alarm.
637bdcb8e0SMaxime Ripard
64320d159eSRasmus Villemoes  reset-source:
65320d159eSRasmus Villemoes    $ref: /schemas/types.yaml#/definitions/flag
66320d159eSRasmus Villemoes    description:
67320d159eSRasmus Villemoes      The RTC is able to reset the machine.
68320d159eSRasmus Villemoes
696a0e321eSRob HerringadditionalProperties: true
706a0e321eSRob Herring
717bdcb8e0SMaxime Ripard...
72