All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH v2 01/11] dt-bindings: rtc: Add YAML schemas for the generic RTC bindings
@ 2019-05-28 20:30 ` Maxime Ripard
  0 siblings, 0 replies; 35+ messages in thread
From: Maxime Ripard @ 2019-05-28 20:30 UTC (permalink / raw)
  To: Alexandre Belloni, Mark Rutland, Rob Herring, Frank Rowand,
	Chen-Yu Tsai, Maxime Ripard
  Cc: devicetree, linux-arm-kernel, linux-rtc

The real time clocks have a bunch of generic properties that are needed in
a device tree. Add a YAML schemas for those.

Signed-off-by: Maxime Ripard <maxime.ripard@bootlin.com>
---
 Documentation/devicetree/bindings/rtc/rtc.txt  | 34 +-------------
 Documentation/devicetree/bindings/rtc/rtc.yaml | 50 +++++++++++++++++++-
 2 files changed, 51 insertions(+), 33 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/rtc/rtc.yaml

diff --git a/Documentation/devicetree/bindings/rtc/rtc.txt b/Documentation/devicetree/bindings/rtc/rtc.txt
index a97fc6a9a75e..4d6f81dccc68 100644
--- a/Documentation/devicetree/bindings/rtc/rtc.txt
+++ b/Documentation/devicetree/bindings/rtc/rtc.txt
@@ -1,36 +1,4 @@
-Generic device tree bindings for Real Time Clock devices
-========================================================
-
-This document describes generic bindings which can be used to describe Real Time
-Clock devices in a device tree.
-
-Required properties
--------------------
-
-- compatible : name of RTC device following generic names recommended practice.
-
-For other required properties e.g. to describe register sets,
-clocks, etc. check the binding documentation of the specific driver.
-
-Optional properties
--------------------
-
-- start-year : if provided, the default hardware range supported by the RTC is
-               shifted so the first usable year is the specified one.
-
-The following properties may not be supported by all drivers. However, if a
-driver wants to support one of the below features, it should adapt the bindings
-below.
-- trickle-resistor-ohms :   Selected resistor for trickle charger. Should be given
-                            if trickle charger should be enabled
-- trickle-diode-disable :   Do not use internal trickle charger diode Should be
-                            given if internal trickle charger diode should be
-                            disabled
-- wakeup-source :           Enables wake up of host system on alarm
-- quartz-load-femtofarads : The capacitive load of the quartz(x-tal),
-                            expressed in femto Farad (fF).
-                            The default value shall be listed (if optional),
-                            and likewise all valid values.
+This file has been moved to rtc.yaml.
 
 Trivial RTCs
 ------------
diff --git a/Documentation/devicetree/bindings/rtc/rtc.yaml b/Documentation/devicetree/bindings/rtc/rtc.yaml
new file mode 100644
index 000000000000..ee237b2ed66a
--- /dev/null
+++ b/Documentation/devicetree/bindings/rtc/rtc.yaml
@@ -0,0 +1,50 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/rtc/rtc.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: RTC Generic Binding
+
+maintainers:
+  - Alexandre Belloni <alexandre.belloni@bootlin.com>
+
+description: |
+  This document describes generic bindings which can be used to
+  describe Real Time Clock devices in a device tree.
+
+properties:
+  $nodename:
+    pattern: "^rtc(@.*|-[0-9a-f])*$"
+
+  quartz-load-femtofarads:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      The capacitive load of the quartz(x-tal), expressed in femto
+      Farad (fF). The default value shall be listed (if optional),
+      and likewise all valid values.
+
+  start-year:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      If provided, the default hardware range supported by the RTC is
+      shifted so the first usable year is the specified one.
+
+  trickle-diode-disable:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description:
+      Do not use internal trickle charger diode. Should be given if
+      internal trickle charger diode should be disabled.
+
+  trickle-resistor-ohms:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      Selected resistor for trickle charger. Should be given
+      if trickle charger should be enabled.
+
+  wakeup-source:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description:
+      Enables wake up of host system on alarm.
+
+...

base-commit: 531b0a360899269bd99a38ba9852a8ba46852bcd
-- 
git-series 0.9.1

^ permalink raw reply related	[flat|nested] 35+ messages in thread

end of thread, other threads:[~2019-06-06 10:04 UTC | newest]

Thread overview: 35+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-05-28 20:30 [PATCH v2 01/11] dt-bindings: rtc: Add YAML schemas for the generic RTC bindings Maxime Ripard
2019-05-28 20:30 ` Maxime Ripard
2019-05-28 20:30 ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 02/11] dt-bindings: rtc: Move trivial RTC over to a schemas of their own Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 03/11] dt-bindings: rtc: Convert Allwinner A10 RTC to a schema Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 04/11] dt-bindings: rtc: Convert Allwinner A31 " Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 05/11] dt-bindings: rtc: sun6i: Add the R40 RTC compatible Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 06/11] rtc: sun6i: Add R40 compatible Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 07/11] ARM: dts: sun6i: Fix RTC node Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 08/11] ARM: dts: sun6i: Add external crystals accuracy Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 09/11] ARM: dts: sun8i: v3s: Fix the RTC node Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 10/11] ARM: dts: sun8i: v3s: Add external crystals accuracy Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30 ` [PATCH v2 11/11] ARM: dts: sun8i: r40: Change the RTC compatible Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-05-28 20:30   ` Maxime Ripard
2019-06-06 10:01 ` [PATCH v2 01/11] dt-bindings: rtc: Add YAML schemas for the generic RTC bindings Alexandre Belloni
2019-06-06 10:01   ` Alexandre Belloni
2019-06-06 10:01   ` Alexandre Belloni

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.