18c2ecf20Sopenharmony_ci# SPDX-License-Identifier: GPL-2.0
28c2ecf20Sopenharmony_ci%YAML 1.2
38c2ecf20Sopenharmony_ci---
48c2ecf20Sopenharmony_ci$id: http://devicetree.org/schemas/rtc/rtc.yaml#
58c2ecf20Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_cititle: RTC Generic Binding
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_cimaintainers:
108c2ecf20Sopenharmony_ci  - Alexandre Belloni <alexandre.belloni@bootlin.com>
118c2ecf20Sopenharmony_ci
128c2ecf20Sopenharmony_cidescription: |
138c2ecf20Sopenharmony_ci  This document describes generic bindings which can be used to
148c2ecf20Sopenharmony_ci  describe Real Time Clock devices in a device tree.
158c2ecf20Sopenharmony_ci
168c2ecf20Sopenharmony_ciproperties:
178c2ecf20Sopenharmony_ci  $nodename:
188c2ecf20Sopenharmony_ci    pattern: "^rtc(@.*|-[0-9a-f])*$"
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci  aux-voltage-chargeable:
218c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
228c2ecf20Sopenharmony_ci    enum: [0, 1]
238c2ecf20Sopenharmony_ci    description: |
248c2ecf20Sopenharmony_ci      Tells whether the battery/supercap of the RTC (if any) is
258c2ecf20Sopenharmony_ci      chargeable or not:
268c2ecf20Sopenharmony_ci      0: not chargeable
278c2ecf20Sopenharmony_ci      1: chargeable
288c2ecf20Sopenharmony_ci
298c2ecf20Sopenharmony_ci  quartz-load-femtofarads:
308c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
318c2ecf20Sopenharmony_ci    description:
328c2ecf20Sopenharmony_ci      The capacitive load of the quartz(x-tal), expressed in femto
338c2ecf20Sopenharmony_ci      Farad (fF). The default value shall be listed (if optional),
348c2ecf20Sopenharmony_ci      and likewise all valid values.
358c2ecf20Sopenharmony_ci
368c2ecf20Sopenharmony_ci  start-year:
378c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
388c2ecf20Sopenharmony_ci    description:
398c2ecf20Sopenharmony_ci      If provided, the default hardware range supported by the RTC is
408c2ecf20Sopenharmony_ci      shifted so the first usable year is the specified one.
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ci  trickle-diode-disable:
438c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/flag
448c2ecf20Sopenharmony_ci    description:
458c2ecf20Sopenharmony_ci      Do not use internal trickle charger diode. Should be given if
468c2ecf20Sopenharmony_ci      internal trickle charger diode should be disabled.
478c2ecf20Sopenharmony_ci    deprecated: true
488c2ecf20Sopenharmony_ci
498c2ecf20Sopenharmony_ci  trickle-resistor-ohms:
508c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
518c2ecf20Sopenharmony_ci    description:
528c2ecf20Sopenharmony_ci      Selected resistor for trickle charger. Should be given
538c2ecf20Sopenharmony_ci      if trickle charger should be enabled.
548c2ecf20Sopenharmony_ci
558c2ecf20Sopenharmony_ci  trickle-voltage-millivolt:
568c2ecf20Sopenharmony_ci    description:
578c2ecf20Sopenharmony_ci      Selected voltage for trickle charger. Should be given
588c2ecf20Sopenharmony_ci      if trickle charger should be enabled and the trickle voltage is different
598c2ecf20Sopenharmony_ci      from the RTC main power supply.
608c2ecf20Sopenharmony_ci
618c2ecf20Sopenharmony_ci  wakeup-source:
628c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/flag
638c2ecf20Sopenharmony_ci    description:
648c2ecf20Sopenharmony_ci      Enables wake up of host system on alarm.
658c2ecf20Sopenharmony_ci
668c2ecf20Sopenharmony_ci  reset-source:
678c2ecf20Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/flag
688c2ecf20Sopenharmony_ci    description:
698c2ecf20Sopenharmony_ci      The RTC is able to reset the machine.
708c2ecf20Sopenharmony_ci
718c2ecf20Sopenharmony_ciadditionalProperties: true
728c2ecf20Sopenharmony_ci
738c2ecf20Sopenharmony_ci...
74