xref: /linux/Documentation/devicetree/bindings/firmware/thead,th1520-aon.yaml (revision 115e74a29b530d121891238e9551c4bcdf7b04b5) 
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