1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/rtc/rtc.yam 4 $id: http://devicetree.org/schemas/rtc/rtc.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Real Time Clock Common Properties !! 7 title: RTC Generic Binding
8 8
9 maintainers: 9 maintainers:
10 - Alexandre Belloni <alexandre.belloni@bootli 10 - Alexandre Belloni <alexandre.belloni@bootlin.com>
11 11
12 description: | 12 description: |
13 This document describes generic bindings whi 13 This document describes generic bindings which can be used to
14 describe Real Time Clock devices in a device 14 describe Real Time Clock devices in a device tree.
15 15
16 properties: 16 properties:
17 $nodename: 17 $nodename:
18 pattern: "^rtc(@.*|-([0-9]|[1-9][0-9]+))?$ !! 18 pattern: "^rtc(@.*|-[0-9a-f])*$"
19 19
20 aux-voltage-chargeable: 20 aux-voltage-chargeable:
21 $ref: /schemas/types.yaml#/definitions/uin 21 $ref: /schemas/types.yaml#/definitions/uint32
22 enum: [0, 1] 22 enum: [0, 1]
23 description: | 23 description: |
24 Tells whether the battery/supercap of th 24 Tells whether the battery/supercap of the RTC (if any) is
25 chargeable or not: 25 chargeable or not:
26 0: not chargeable 26 0: not chargeable
27 1: chargeable 27 1: chargeable
28 28
29 quartz-load-femtofarads: 29 quartz-load-femtofarads:
>> 30 $ref: /schemas/types.yaml#/definitions/uint32
30 description: 31 description:
31 The capacitive load of the quartz(x-tal) 32 The capacitive load of the quartz(x-tal), expressed in femto
32 Farad (fF). The default value shall be l 33 Farad (fF). The default value shall be listed (if optional),
33 and likewise all valid values. 34 and likewise all valid values.
34 35
35 start-year: 36 start-year:
36 $ref: /schemas/types.yaml#/definitions/uin 37 $ref: /schemas/types.yaml#/definitions/uint32
37 description: 38 description:
38 If provided, the default hardware range 39 If provided, the default hardware range supported by the RTC is
39 shifted so the first usable year is the 40 shifted so the first usable year is the specified one.
40 41
41 trickle-diode-disable: 42 trickle-diode-disable:
42 $ref: /schemas/types.yaml#/definitions/fla 43 $ref: /schemas/types.yaml#/definitions/flag
43 description: 44 description:
44 Do not use internal trickle charger diod 45 Do not use internal trickle charger diode. Should be given if
45 internal trickle charger diode should be 46 internal trickle charger diode should be disabled.
46 deprecated: true 47 deprecated: true
47 48
48 trickle-resistor-ohms: 49 trickle-resistor-ohms:
>> 50 $ref: /schemas/types.yaml#/definitions/uint32
49 description: 51 description:
50 Selected resistor for trickle charger. S 52 Selected resistor for trickle charger. Should be given
51 if trickle charger should be enabled. 53 if trickle charger should be enabled.
52 54
53 trickle-voltage-millivolt: 55 trickle-voltage-millivolt:
54 description: 56 description:
55 Selected voltage for trickle charger. Sh 57 Selected voltage for trickle charger. Should be given
56 if trickle charger should be enabled and 58 if trickle charger should be enabled and the trickle voltage is different
57 from the RTC main power supply. 59 from the RTC main power supply.
58 60
59 wakeup-source: 61 wakeup-source:
60 $ref: /schemas/types.yaml#/definitions/fla 62 $ref: /schemas/types.yaml#/definitions/flag
61 description: 63 description:
62 Enables wake up of host system on alarm. 64 Enables wake up of host system on alarm.
63 65
64 reset-source: 66 reset-source:
65 $ref: /schemas/types.yaml#/definitions/fla 67 $ref: /schemas/types.yaml#/definitions/flag
66 description: 68 description:
67 The RTC is able to reset the machine. 69 The RTC is able to reset the machine.
68 70
69 additionalProperties: true 71 additionalProperties: true
70 72
71 ... 73 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.