xref: /freebsd/sys/contrib/device-tree/Bindings/soc/ti/ti,j784s4-bist.yaml (revision 833e5d42ab135b0238e61c5b3c19b8619677cbfa) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (C) 2025 Texas Instruments Incorporated
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/soc/ti/ti,j784s4-bist.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Texas Instruments K3 BIST
9
10maintainers:
11  - Neha Malcom Francis <n-francis@ti.com>
12
13allOf:
14  - $ref: /schemas/arm/keystone/ti,k3-sci-common.yaml#
15
16description:
17  The BIST (Built-In Self Test) module is an IP block present in K3 devices
18  that support triggering of BIST tests, both PBIST (Memory BIST) and LBIST
19  (Logic BIST) on a core. Both tests are destructive in nature. At boot, BIST
20  is executed by hardware for the MCU domain automatically as part of HW POST.
21
22properties:
23  compatible:
24    const: ti,j784s4-bist
25
26  reg:
27    maxItems: 2
28
29  reg-names:
30    items:
31      - const: cfg
32      - const: ctrl_mmr
33
34  clocks:
35    maxItems: 1
36
37  power-domains:
38    maxItems: 1
39
40required:
41  - compatible
42  - reg
43  - reg-names
44  - ti,sci-dev-id
45
46unevaluatedProperties: false
47
48examples:
49  - |
50    #include <dt-bindings/soc/ti,sci_pm_domain.h>
51    bus {
52        #address-cells = <2>;
53        #size-cells = <2>;
54        safety-selftest@33c0000 {
55            compatible = "ti,j784s4-bist";
56            reg = <0x00 0x033c0000 0x00 0x400>,
57                  <0x00 0x0010c1a0 0x00 0x01c>;
58            reg-names = "cfg", "ctrl_mmr";
59            clocks = <&k3_clks 237 7>;
60            power-domains = <&k3_pds 237 TI_SCI_PD_EXCLUSIVE>;
61            ti,sci-dev-id = <234>;
62        };
63    };
64