GNU Linux-libre 6.8.9-gnu
[releases.git] / Documentation / devicetree / bindings / misc / ti,j721e-esm.yaml
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 # Copyright (C) 2022 Texas Instruments Incorporated
3 %YAML 1.2
4 ---
5 $id: http://devicetree.org/schemas/misc/ti,j721e-esm.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: Texas Instruments K3 ESM
9
10 maintainers:
11   - Neha Malcom Francis <n-francis@ti.com>
12
13 description:
14   The ESM (Error Signaling Module) is an IP block on TI K3 devices
15   that allows handling of safety events somewhat similar to what interrupt
16   controller would do. The safety signals have their separate paths within
17   the SoC, and they are handled by the ESM, which routes them to the proper
18   destination, which can be system reset, interrupt controller, etc. In the
19   simplest configuration the signals are just routed to reset the SoC.
20
21 properties:
22   compatible:
23     const: ti,j721e-esm
24
25   reg:
26     maxItems: 1
27
28   ti,esm-pins:
29     $ref: /schemas/types.yaml#/definitions/uint32-array
30     description:
31       integer array of ESM interrupt pins to route to external event pin
32       which can be used to reset the SoC.
33     minItems: 1
34     maxItems: 255
35
36 required:
37   - compatible
38   - reg
39   - ti,esm-pins
40
41 additionalProperties: false
42
43 examples:
44   - |
45     bus {
46         #address-cells = <2>;
47         #size-cells = <2>;
48         esm@700000 {
49             compatible = "ti,j721e-esm";
50             reg = <0x0 0x700000 0x0 0x1000>;
51             ti,esm-pins = <344>, <345>;
52         };
53     };