xref: /linux/Documentation/devicetree/bindings/rtc/sophgo,cv1800b-rtc.yaml (revision 590951f908f25c7e4d6822f0109e7e230d7b0a89)
176517429SJingbao Qiu# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
276517429SJingbao Qiu%YAML 1.2
376517429SJingbao Qiu---
4*590951f9SRob Herring (Arm)$id: http://devicetree.org/schemas/rtc/sophgo,cv1800b-rtc.yaml#
576517429SJingbao Qiu$schema: http://devicetree.org/meta-schemas/core.yaml#
676517429SJingbao Qiu
776517429SJingbao Qiutitle: Real Time Clock of the Sophgo CV1800 SoC
876517429SJingbao Qiu
976517429SJingbao Qiudescription:
1076517429SJingbao Qiu  The RTC (Real Time Clock) is an independently powered module in the chip. It
1176517429SJingbao Qiu  contains a 32KHz oscillator and a Power-On-Reset (POR) sub-module, which can
1276517429SJingbao Qiu  be used for time display and scheduled alarm produce. In addition, the
1376517429SJingbao Qiu  hardware state machine provides triggering and timing control for chip
1476517429SJingbao Qiu  power-on, power-off and reset.
1576517429SJingbao Qiu
1676517429SJingbao Qiu  Furthermore, the 8051 subsystem is located within RTCSYS and is independently
1776517429SJingbao Qiu  powered. System software can use the 8051 to manage wake conditions and wake
1876517429SJingbao Qiu  the system while the system is asleep, and communicate with external devices
1976517429SJingbao Qiu  through peripheral controllers.
2076517429SJingbao Qiu
2176517429SJingbao Qiu  Technical Reference Manual available at
2276517429SJingbao Qiu    https://github.com/sophgo/sophgo-doc/tree/main/SG200X/TRM
2376517429SJingbao Qiu
2476517429SJingbao Qiumaintainers:
2576517429SJingbao Qiu  - sophgo@lists.linux.dev
2676517429SJingbao Qiu
2776517429SJingbao QiuallOf:
2876517429SJingbao Qiu  - $ref: /schemas/rtc/rtc.yaml#
2976517429SJingbao Qiu
3076517429SJingbao Qiuproperties:
3176517429SJingbao Qiu  compatible:
3276517429SJingbao Qiu    items:
3376517429SJingbao Qiu      - const: sophgo,cv1800b-rtc
3476517429SJingbao Qiu      - const: syscon
3576517429SJingbao Qiu
3676517429SJingbao Qiu  reg:
3776517429SJingbao Qiu    maxItems: 1
3876517429SJingbao Qiu
3976517429SJingbao Qiu  interrupts:
4076517429SJingbao Qiu    items:
4176517429SJingbao Qiu      - description: RTC Alarm
4276517429SJingbao Qiu      - description: RTC Longpress
4376517429SJingbao Qiu      - description: VBAT DET
4476517429SJingbao Qiu
4576517429SJingbao Qiu  interrupt-names:
4676517429SJingbao Qiu    items:
4776517429SJingbao Qiu      - const: alarm
4876517429SJingbao Qiu      - const: longpress
4976517429SJingbao Qiu      - const: vbat
5076517429SJingbao Qiu
5176517429SJingbao Qiu  clocks:
5276517429SJingbao Qiu    items:
5376517429SJingbao Qiu      - description: RTC clock source
5476517429SJingbao Qiu      - description: DW8051 MCU clock source
5576517429SJingbao Qiu
5676517429SJingbao Qiu  clock-names:
5776517429SJingbao Qiu    items:
5876517429SJingbao Qiu      - const: rtc
5976517429SJingbao Qiu      - const: mcu
6076517429SJingbao Qiu
6176517429SJingbao Qiurequired:
6276517429SJingbao Qiu  - compatible
6376517429SJingbao Qiu  - reg
6476517429SJingbao Qiu  - interrupts
6576517429SJingbao Qiu  - interrupt-names
6676517429SJingbao Qiu  - clocks
6776517429SJingbao Qiu  - clock-names
6876517429SJingbao Qiu
6976517429SJingbao QiuunevaluatedProperties: false
7076517429SJingbao Qiu
7176517429SJingbao Qiuexamples:
7276517429SJingbao Qiu  - |
7376517429SJingbao Qiu    #include <dt-bindings/clock/sophgo,cv1800.h>
7476517429SJingbao Qiu    #include <dt-bindings/interrupt-controller/irq.h>
7576517429SJingbao Qiu
7676517429SJingbao Qiu    rtc@5025000 {
7776517429SJingbao Qiu        compatible = "sophgo,cv1800b-rtc", "syscon";
7876517429SJingbao Qiu        reg = <0x5025000 0x2000>;
7976517429SJingbao Qiu        interrupts = <17 IRQ_TYPE_LEVEL_HIGH>,
8076517429SJingbao Qiu                     <18 IRQ_TYPE_LEVEL_HIGH>,
8176517429SJingbao Qiu                     <19 IRQ_TYPE_LEVEL_HIGH>;
8276517429SJingbao Qiu        interrupt-names = "alarm", "longpress", "vbat";
8376517429SJingbao Qiu        clocks = <&clk CLK_RTC_25M>,
8476517429SJingbao Qiu                 <&clk CLK_SRC_RTC_SYS_0>;
8576517429SJingbao Qiu        clock-names = "rtc", "mcu";
8676517429SJingbao Qiu    };
87