xref: /linux/Documentation/devicetree/bindings/firmware/thead,th1520-aon.yaml (revision e7e86d7697c6ed1dbbde18d7185c35b6967945ed) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/firmware/thead,th1520-aon.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: T-HEAD TH1520 AON (Always-On) Firmware
8
9description: |
10  The Always-On (AON) subsystem in the TH1520 SoC is responsible for managing
11  low-power states, system wakeup events, and power management tasks. It is
12  designed to operate independently in a dedicated power domain, allowing it to
13  remain functional even during the SoC's deep sleep states.
14
15  At the heart of the AON subsystem is the E902, a low-power core that executes
16  firmware responsible for coordinating tasks such as power domain control,
17  clock management, and system wakeup signaling. Communication between the main
18  SoC and the AON subsystem is handled through a mailbox interface, which
19  enables message-based interactions with the AON firmware.
20
21maintainers:
22  - Michal Wilczynski <m.wilczynski@samsung.com>
23
24properties:
25  compatible:
26    const: thead,th1520-aon
27
28  mboxes:
29    maxItems: 1
30
31  mbox-names:
32    items:
33      - const: aon
34
35  resets:
36    maxItems: 1
37
38  reset-names:
39    items:
40      - const: gpu-clkgen
41
42  "#power-domain-cells":
43    const: 1
44
45required:
46  - compatible
47  - mboxes
48  - mbox-names
49  - "#power-domain-cells"
50
51additionalProperties: false
52
53examples:
54  - |
55    aon: aon {
56        compatible = "thead,th1520-aon";
57        mboxes = <&mbox_910t 1>;
58        mbox-names = "aon";
59        #power-domain-cells = <1>;
60    };
61