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