xref: /freebsd/sys/contrib/device-tree/Bindings/nvmem/qcom,qfprom.yaml (revision 058ac3e8063366dafa634d9107642e12b038bf09) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/nvmem/qcom,qfprom.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Qualcomm Technologies Inc, QFPROM Efuse bindings
8
9maintainers:
10  - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
11
12allOf:
13  - $ref: "nvmem.yaml#"
14
15properties:
16  compatible:
17    items:
18      - enum:
19          - qcom,apq8064-qfprom
20          - qcom,apq8084-qfprom
21          - qcom,msm8974-qfprom
22          - qcom,msm8916-qfprom
23          - qcom,msm8996-qfprom
24          - qcom,msm8998-qfprom
25          - qcom,qcs404-qfprom
26          - qcom,sc7180-qfprom
27          - qcom,sc7280-qfprom
28          - qcom,sdm845-qfprom
29      - const: qcom,qfprom
30
31  reg:
32    # If the QFPROM is read-only OS image then only the corrected region
33    # needs to be provided.  If the QFPROM is writable then all 4 regions
34    # must be provided.
35    oneOf:
36      - items:
37          - description: The corrected region.
38      - items:
39          - description: The corrected region.
40          - description: The raw region.
41          - description: The config region.
42          - description: The security control region.
43
44  # Clock must be provided if QFPROM is writable from the OS image.
45  clocks:
46    maxItems: 1
47  clock-names:
48    const: core
49
50  # Supply reference must be provided if QFPROM is writable from the OS image.
51  vcc-supply:
52    description: Our power supply.
53
54  power-domains:
55    maxItems: 1
56
57  # Needed if any child nodes are present.
58  "#address-cells":
59    const: 1
60  "#size-cells":
61    const: 1
62
63required:
64  - compatible
65  - reg
66
67unevaluatedProperties: false
68
69examples:
70  - |
71    #include <dt-bindings/clock/qcom,gcc-sc7180.h>
72
73    soc {
74      #address-cells = <2>;
75      #size-cells = <2>;
76
77      efuse@784000 {
78        compatible = "qcom,sc7180-qfprom", "qcom,qfprom";
79        reg = <0 0x00784000 0 0x8ff>,
80              <0 0x00780000 0 0x7a0>,
81              <0 0x00782000 0 0x100>,
82              <0 0x00786000 0 0x1fff>;
83        clocks = <&gcc GCC_SEC_CTRL_CLK_SRC>;
84        clock-names = "core";
85        #address-cells = <1>;
86        #size-cells = <1>;
87
88        vcc-supply = <&vreg_l11a_1p8>;
89
90        hstx-trim-primary@25b {
91          reg = <0x25b 0x1>;
92          bits = <1 3>;
93        };
94      };
95    };
96
97  - |
98    soc {
99      #address-cells = <2>;
100      #size-cells = <2>;
101
102      efuse@784000 {
103        compatible = "qcom,sdm845-qfprom", "qcom,qfprom";
104        reg = <0 0x00784000 0 0x8ff>;
105        #address-cells = <1>;
106        #size-cells = <1>;
107
108        hstx-trim-primary@1eb {
109          reg = <0x1eb 0x1>;
110          bits = <1 4>;
111        };
112      };
113    };
114