xref: /freebsd/sys/contrib/device-tree/Bindings/nvmem/qcom,qfprom.yaml (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
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
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,ipq8064-qfprom
22          - qcom,ipq8074-qfprom
23          - qcom,msm8916-qfprom
24          - qcom,msm8974-qfprom
25          - qcom,msm8976-qfprom
26          - qcom,msm8996-qfprom
27          - qcom,msm8998-qfprom
28          - qcom,qcs404-qfprom
29          - qcom,sc7180-qfprom
30          - qcom,sc7280-qfprom
31          - qcom,sdm630-qfprom
32          - qcom,sdm670-qfprom
33          - qcom,sdm845-qfprom
34          - qcom,sm6115-qfprom
35          - qcom,sm6350-qfprom
36          - qcom,sm6375-qfprom
37          - qcom,sm8150-qfprom
38          - qcom,sm8250-qfprom
39      - const: qcom,qfprom
40
41  reg:
42    # If the QFPROM is read-only OS image then only the corrected region
43    # needs to be provided.  If the QFPROM is writable then all 4 regions
44    # must be provided.
45    oneOf:
46      - items:
47          - description: The corrected region.
48      - items:
49          - description: The corrected region.
50          - description: The raw region.
51          - description: The config region.
52          - description: The security control region.
53
54  # Clock must be provided if QFPROM is writable from the OS image.
55  clocks:
56    maxItems: 1
57  clock-names:
58    const: core
59
60  # Supply reference must be provided if QFPROM is writable from the OS image.
61  vcc-supply:
62    description: Our power supply.
63
64  power-domains:
65    maxItems: 1
66
67  # Needed if any child nodes are present.
68  "#address-cells":
69    const: 1
70  "#size-cells":
71    const: 1
72
73required:
74  - compatible
75  - reg
76
77unevaluatedProperties: false
78
79examples:
80  - |
81    #include <dt-bindings/clock/qcom,gcc-sc7180.h>
82
83    soc {
84      #address-cells = <2>;
85      #size-cells = <2>;
86
87      efuse@784000 {
88        compatible = "qcom,sc7180-qfprom", "qcom,qfprom";
89        reg = <0 0x00784000 0 0x8ff>,
90              <0 0x00780000 0 0x7a0>,
91              <0 0x00782000 0 0x100>,
92              <0 0x00786000 0 0x1fff>;
93        clocks = <&gcc GCC_SEC_CTRL_CLK_SRC>;
94        clock-names = "core";
95        #address-cells = <1>;
96        #size-cells = <1>;
97
98        vcc-supply = <&vreg_l11a_1p8>;
99
100        hstx-trim-primary@25b {
101          reg = <0x25b 0x1>;
102          bits = <1 3>;
103        };
104      };
105    };
106
107  - |
108    soc {
109      #address-cells = <2>;
110      #size-cells = <2>;
111
112      efuse@784000 {
113        compatible = "qcom,sdm845-qfprom", "qcom,qfprom";
114        reg = <0 0x00784000 0 0x8ff>;
115        #address-cells = <1>;
116        #size-cells = <1>;
117
118        hstx-trim-primary@1eb {
119          reg = <0x1eb 0x1>;
120          bits = <1 4>;
121        };
122      };
123    };
124