From: Sudheendra Sampath <giveback4fun@gmail.com>
To: alexandre.belloni@bootlin.com, ynvich@gmail.com
Cc: devicetree@vger.kernel.org, skhan@linuxfoundation.org,
me@brighamcampbell.com, jkoolstra@xs4all.nl,
linux-kernel@vger.kernel.org, linux-rtc@vger.kernel.org,
Sudheendra Sampath <giveback4fun@gmail.com>
Subject: [PATCH v2 - dt-bindings: maxim-ds1302: Convert to dt schema v2] dt-bindings: maxim-ds1302: Convert to dt schema
Date: Tue, 8 Sep 2026 12:01:37 -0700 [thread overview]
Message-ID: <20260908190137.1168904-1-giveback4fun@gmail.com> (raw)
Convert Maxim DS1302 real-time clock binding to DT schema.
Changes based on code review comments.
Signed-off-by: Sudheendra Sampath <giveback4fun@gmail.com>
---
.../devicetree/bindings/rtc/maxim-ds1302.txt | 46 -----------------
.../devicetree/bindings/rtc/maxim-ds1302.yaml | 50 +++++++++++++++++++
2 files changed, 50 insertions(+), 46 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/rtc/maxim-ds1302.txt
create mode 100644 Documentation/devicetree/bindings/rtc/maxim-ds1302.yaml
diff --git a/Documentation/devicetree/bindings/rtc/maxim-ds1302.txt b/Documentation/devicetree/bindings/rtc/maxim-ds1302.txt
deleted file mode 100644
index ba470c56cdec..000000000000
--- a/Documentation/devicetree/bindings/rtc/maxim-ds1302.txt
+++ /dev/null
@@ -1,46 +0,0 @@
-* Maxim/Dallas Semiconductor DS-1302 RTC
-
-Simple device which could be used to store date/time between reboots.
-
-The device uses the standard MicroWire half-duplex transfer timing.
-Master output is set on low clock and sensed by the RTC on the rising
-edge. Master input is set by the RTC on the trailing edge and is sensed
-by the master on low clock.
-
-Required properties:
-
-- compatible : Should be "maxim,ds1302"
-
-Required SPI properties:
-
-- reg : Should be address of the device chip select within
- the controller.
-
-- spi-max-frequency : DS-1302 has 500 kHz if powered at 2.2V,
- and 2MHz if powered at 5V.
-
-- spi-3wire : The device has a shared signal IN/OUT line.
-
-- spi-lsb-first : DS-1302 requires least significant bit first
- transfers.
-
-- spi-cs-high: DS-1302 has active high chip select line. This is
- required unless inverted in hardware.
-
-Example:
-
-spi@901c {
- #address-cells = <1>;
- #size-cells = <0>;
- compatible = "icpdas,lp8841-spi-rtc";
- reg = <0x901c 0x1>;
-
- rtc@0 {
- compatible = "maxim,ds1302";
- reg = <0>;
- spi-max-frequency = <500000>;
- spi-3wire;
- spi-lsb-first;
- spi-cs-high;
- };
-};
diff --git a/Documentation/devicetree/bindings/rtc/maxim-ds1302.yaml b/Documentation/devicetree/bindings/rtc/maxim-ds1302.yaml
new file mode 100644
index 000000000000..54a2fcf7f8e7
--- /dev/null
+++ b/Documentation/devicetree/bindings/rtc/maxim-ds1302.yaml
@@ -0,0 +1,50 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/rtc/maxim-ds1302.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Maxim/Dallas Semiconductor DS-1302 RTC
+
+maintainers:
+ - Alexandre Belloni <alexandre.belloni@bootlin.com>
+ - Sergey Yanovich <ynvich@gmail.com>
+
+description: |
+ Simple device which could be used to store date/time between reboots.
+
+ The device uses the standard MicroWire half-duplex transfer timing.
+ Master output is set on low clock and sensed by the RTC on the rising
+ edge. Master input is set by the RTC on the trailing edge and is sensed
+ by the master on low clock.
+
+properties:
+ compatible:
+ items:
+ - const: maxim,ds1302
+
+ reg:
+ maxItems: 1
+
+ spi-max-frequency:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description: DS-1302 has 500 kHz if powered at 2.2V, and 2MHz if powered at 5V
+ enum:
+ - 500000
+ - 2000000
+
+ spi-3wire: true
+
+ spi-lsb-first: true
+
+ spi-cs-high: true
+
+required:
+ - compatible
+ - reg
+ - spi-max-frequency
+ - spi-3wire
+ - spi-lsb-first
+ - spi-cs-high
+
+additionalProperties: false
--
2.47.3
next reply other threads:[~2026-09-08 19:00 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-08 19:01 Sudheendra Sampath [this message]
2026-09-08 19:06 ` [PATCH v2 - dt-bindings: maxim-ds1302: Convert to dt schema v2] dt-bindings: maxim-ds1302: Convert to dt schema sashiko-bot
2026-09-09 9:37 ` Krzysztof Kozlowski
2026-09-09 9:38 ` Krzysztof Kozlowski
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260908190137.1168904-1-giveback4fun@gmail.com \
--to=giveback4fun@gmail.com \
--cc=alexandre.belloni@bootlin.com \
--cc=devicetree@vger.kernel.org \
--cc=jkoolstra@xs4all.nl \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-rtc@vger.kernel.org \
--cc=me@brighamcampbell.com \
--cc=skhan@linuxfoundation.org \
--cc=ynvich@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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.