xref: /freebsd/sys/contrib/device-tree/Bindings/nvmem/qcom,qfprom.yaml (revision a0409676120c1e558d0ade943019934e0f15118d) 
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    const: qcom,qfprom
18
19  reg:
20    # If the QFPROM is read-only OS image then only the corrected region
21    # needs to be provided.  If the QFPROM is writable then all 4 regions
22    # must be provided.
23    oneOf:
24      - items:
25          - description: The corrected region.
26      - items:
27          - description: The corrected region.
28          - description: The raw region.
29          - description: The config region.
30          - description: The security control region.
31
32  # Clock must be provided if QFPROM is writable from the OS image.
33  clocks:
34    maxItems: 1
35  clock-names:
36    const: core
37
38  # Supply reference must be provided if QFPROM is writable from the OS image.
39  vcc-supply:
40    description: Our power supply.
41
42  # Needed if any child nodes are present.
43  "#address-cells":
44    const: 1
45  "#size-cells":
46    const: 1
47
48required:
49  - compatible
50  - reg
51
52examples:
53  - |
54    #include <dt-bindings/clock/qcom,gcc-sc7180.h>
55
56    soc {
57      #address-cells = <2>;
58      #size-cells = <2>;
59
60      efuse@784000 {
61        compatible = "qcom,qfprom";
62        reg = <0 0x00784000 0 0x8ff>,
63              <0 0x00780000 0 0x7a0>,
64              <0 0x00782000 0 0x100>,
65              <0 0x00786000 0 0x1fff>;
66        clocks = <&gcc GCC_SEC_CTRL_CLK_SRC>;
67        clock-names = "core";
68        #address-cells = <1>;
69        #size-cells = <1>;
70
71        vcc-supply = <&vreg_l11a_1p8>;
72
73        hstx-trim-primary@25b {
74          reg = <0x25b 0x1>;
75          bits = <1 3>;
76        };
77      };
78    };
79
80  - |
81    soc {
82      #address-cells = <2>;
83      #size-cells = <2>;
84
85      efuse@784000 {
86        compatible = "qcom,qfprom";
87        reg = <0 0x00784000 0 0x8ff>;
88        #address-cells = <1>;
89        #size-cells = <1>;
90
91        hstx-trim-primary@1eb {
92          reg = <0x1eb 0x1>;
93          bits = <1 4>;
94        };
95      };
96    };
97