xref: /freebsd-src/sys/contrib/device-tree/Bindings/rtc/amlogic,meson-vrtc.yaml (revision cb7aa33ac6cd46a5434798e50363136e64f3ae98)
1*cb7aa33aSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*cb7aa33aSEmmanuel Vadot%YAML 1.2
3*cb7aa33aSEmmanuel Vadot---
4*cb7aa33aSEmmanuel Vadot$id: http://devicetree.org/schemas/rtc/amlogic,meson-vrtc.yaml#
5*cb7aa33aSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*cb7aa33aSEmmanuel Vadot
7*cb7aa33aSEmmanuel Vadottitle: Amlogic Virtual RTC (VRTC)
8*cb7aa33aSEmmanuel Vadot
9*cb7aa33aSEmmanuel Vadotmaintainers:
10*cb7aa33aSEmmanuel Vadot  - Neil Armstrong <neil.armstrong@linaro.org>
11*cb7aa33aSEmmanuel Vadot
12*cb7aa33aSEmmanuel Vadotdescription: |
13*cb7aa33aSEmmanuel Vadot  This is a Linux interface to an RTC managed by firmware, hence it's
14*cb7aa33aSEmmanuel Vadot  virtual from a Linux perspective.  The interface is 1 register where
15*cb7aa33aSEmmanuel Vadot  an alarm time (in seconds) is to be written.
16*cb7aa33aSEmmanuel Vadot  The alarm register is a simple scratch register shared between the
17*cb7aa33aSEmmanuel Vadot  application processors (AP) and the secure co-processor (SCP.)  When
18*cb7aa33aSEmmanuel Vadot  the AP suspends, the SCP will use the value of this register to
19*cb7aa33aSEmmanuel Vadot  program an always-on timer before going sleep. When the timer expires,
20*cb7aa33aSEmmanuel Vadot  the SCP will wake up and will then wake the AP.
21*cb7aa33aSEmmanuel Vadot
22*cb7aa33aSEmmanuel VadotallOf:
23*cb7aa33aSEmmanuel Vadot  - $ref: rtc.yaml#
24*cb7aa33aSEmmanuel Vadot
25*cb7aa33aSEmmanuel Vadotproperties:
26*cb7aa33aSEmmanuel Vadot  compatible:
27*cb7aa33aSEmmanuel Vadot    enum:
28*cb7aa33aSEmmanuel Vadot      - amlogic,meson-vrtc
29*cb7aa33aSEmmanuel Vadot
30*cb7aa33aSEmmanuel Vadot  reg:
31*cb7aa33aSEmmanuel Vadot    maxItems: 1
32*cb7aa33aSEmmanuel Vadot
33*cb7aa33aSEmmanuel Vadotrequired:
34*cb7aa33aSEmmanuel Vadot  - compatible
35*cb7aa33aSEmmanuel Vadot  - reg
36*cb7aa33aSEmmanuel Vadot
37*cb7aa33aSEmmanuel VadotadditionalProperties: false
38*cb7aa33aSEmmanuel Vadot
39*cb7aa33aSEmmanuel Vadotexamples:
40*cb7aa33aSEmmanuel Vadot  - |
41*cb7aa33aSEmmanuel Vadot    rtc@a8 {
42*cb7aa33aSEmmanuel Vadot      compatible = "amlogic,meson-vrtc";
43*cb7aa33aSEmmanuel Vadot      reg = <0x000a8 0x4>;
44*cb7aa33aSEmmanuel Vadot    };
45