Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

rtc: rtc7301: Rewrite bindings in schema

This rewrites the Epson RTC7301 bindings to use YAML schema,
and adds a property for "reg-io-width" as used in several
other bindings to account for different register strides.

The USRobotics USR8200 uses the byte IO width.

Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
Reviewed-by: Akinobu Mita <akinobu.mita@gmail.com>
Link: https://lore.kernel.org/r/20231010-rtc-7301-regwidth-v3-1-ade586b62794@linaro.org
Signed-off-by: Alexandre Belloni <alexandre.belloni@bootlin.com>

authored by

Linus Walleij and committed by
Alexandre Belloni
5ded578a f4d571b3

+51 -16
-16
Documentation/devicetree/bindings/rtc/epson,rtc7301.txt
··· 1 - EPSON TOYOCOM RTC-7301SF/DG 2 - 3 - Required properties: 4 - 5 - - compatible: Should be "epson,rtc7301sf" or "epson,rtc7301dg" 6 - - reg: Specifies base physical address and size of the registers. 7 - - interrupts: A single interrupt specifier. 8 - 9 - Example: 10 - 11 - rtc: rtc@44a00000 { 12 - compatible = "epson,rtc7301dg"; 13 - reg = <0x44a00000 0x10000>; 14 - interrupt-parent = <&axi_intc_0>; 15 - interrupts = <3 2>; 16 - };
+51
Documentation/devicetree/bindings/rtc/epson,rtc7301.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/rtc/epson,rtc7301.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Epson Toyocom RTC-7301SF/DG 8 + 9 + description: 10 + The only difference between the two variants is the packaging. 11 + The DG variant is a DIL package, and the SF variant is a flat 12 + package. 13 + 14 + maintainers: 15 + - Akinobu Mita <akinobu.mita@gmail.com> 16 + 17 + properties: 18 + compatible: 19 + enum: 20 + - epson,rtc7301dg 21 + - epson,rtc7301sf 22 + 23 + reg: 24 + maxItems: 1 25 + 26 + reg-io-width: 27 + description: 28 + The size (in bytes) of the IO accesses that should be performed 29 + on the device. 30 + enum: [1, 4] 31 + default: 4 32 + 33 + interrupts: 34 + maxItems: 1 35 + 36 + required: 37 + - compatible 38 + - reg 39 + 40 + additionalProperties: false 41 + 42 + examples: 43 + - | 44 + #include <dt-bindings/interrupt-controller/irq.h> 45 + rtc: rtc@44a00000 { 46 + compatible = "epson,rtc7301dg"; 47 + reg = <0x44a00000 0x10000>; 48 + reg-io-width = <4>; 49 + interrupt-parent = <&axi_intc_0>; 50 + interrupts = <3 2>; 51 + };