162306a36Sopenharmony_ci# SPDX-License-Identifier: GPL-2.0
262306a36Sopenharmony_ci%YAML 1.2
362306a36Sopenharmony_ci---
462306a36Sopenharmony_ci$id: http://devicetree.org/schemas/rtc/rtc.yaml#
562306a36Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
662306a36Sopenharmony_ci
762306a36Sopenharmony_cititle: Real Time Clock Common Properties
862306a36Sopenharmony_ci
962306a36Sopenharmony_cimaintainers:
1062306a36Sopenharmony_ci  - Alexandre Belloni <alexandre.belloni@bootlin.com>
1162306a36Sopenharmony_ci
1262306a36Sopenharmony_cidescription: |
1362306a36Sopenharmony_ci  This document describes generic bindings which can be used to
1462306a36Sopenharmony_ci  describe Real Time Clock devices in a device tree.
1562306a36Sopenharmony_ci
1662306a36Sopenharmony_ciproperties:
1762306a36Sopenharmony_ci  $nodename:
1862306a36Sopenharmony_ci    pattern: "^rtc(@.*|-([0-9]|[1-9][0-9]+))?$"
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_ci  aux-voltage-chargeable:
2162306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
2262306a36Sopenharmony_ci    enum: [0, 1]
2362306a36Sopenharmony_ci    description: |
2462306a36Sopenharmony_ci      Tells whether the battery/supercap of the RTC (if any) is
2562306a36Sopenharmony_ci      chargeable or not:
2662306a36Sopenharmony_ci      0: not chargeable
2762306a36Sopenharmony_ci      1: chargeable
2862306a36Sopenharmony_ci
2962306a36Sopenharmony_ci  quartz-load-femtofarads:
3062306a36Sopenharmony_ci    description:
3162306a36Sopenharmony_ci      The capacitive load of the quartz(x-tal), expressed in femto
3262306a36Sopenharmony_ci      Farad (fF). The default value shall be listed (if optional),
3362306a36Sopenharmony_ci      and likewise all valid values.
3462306a36Sopenharmony_ci
3562306a36Sopenharmony_ci  start-year:
3662306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
3762306a36Sopenharmony_ci    description:
3862306a36Sopenharmony_ci      If provided, the default hardware range supported by the RTC is
3962306a36Sopenharmony_ci      shifted so the first usable year is the specified one.
4062306a36Sopenharmony_ci
4162306a36Sopenharmony_ci  trickle-diode-disable:
4262306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/flag
4362306a36Sopenharmony_ci    description:
4462306a36Sopenharmony_ci      Do not use internal trickle charger diode. Should be given if
4562306a36Sopenharmony_ci      internal trickle charger diode should be disabled.
4662306a36Sopenharmony_ci    deprecated: true
4762306a36Sopenharmony_ci
4862306a36Sopenharmony_ci  trickle-resistor-ohms:
4962306a36Sopenharmony_ci    description:
5062306a36Sopenharmony_ci      Selected resistor for trickle charger. Should be given
5162306a36Sopenharmony_ci      if trickle charger should be enabled.
5262306a36Sopenharmony_ci
5362306a36Sopenharmony_ci  trickle-voltage-millivolt:
5462306a36Sopenharmony_ci    description:
5562306a36Sopenharmony_ci      Selected voltage for trickle charger. Should be given
5662306a36Sopenharmony_ci      if trickle charger should be enabled and the trickle voltage is different
5762306a36Sopenharmony_ci      from the RTC main power supply.
5862306a36Sopenharmony_ci
5962306a36Sopenharmony_ci  wakeup-source:
6062306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/flag
6162306a36Sopenharmony_ci    description:
6262306a36Sopenharmony_ci      Enables wake up of host system on alarm.
6362306a36Sopenharmony_ci
6462306a36Sopenharmony_ci  reset-source:
6562306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/flag
6662306a36Sopenharmony_ci    description:
6762306a36Sopenharmony_ci      The RTC is able to reset the machine.
6862306a36Sopenharmony_ci
6962306a36Sopenharmony_ciadditionalProperties: true
7062306a36Sopenharmony_ci
7162306a36Sopenharmony_ci...
72