Documentation/devicetree/bindings/nvmem/qcom,qfprom.yaml

   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
   7 title: Qualcomm Technologies Inc, QFPROM Efuse
   8
   9 maintainers:
  10   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
  11
  12 allOf:
  13   - $ref: nvmem.yaml#
  14   - $ref: nvmem-deprecated-cells.yaml#
  15
  16 properties:
  17   compatible:
  18     items:
  19       - enum:
  20           - qcom,apq8064-qfprom
  21           - qcom,apq8084-qfprom
  22           - qcom,ipq5332-qfprom
  23           - qcom,ipq6018-qfprom
  24           - qcom,ipq8064-qfprom
  25           - qcom,ipq8074-qfprom
  26           - qcom,ipq9574-qfprom
  27           - qcom,msm8226-qfprom
  28           - qcom,msm8916-qfprom
  29           - qcom,msm8974-qfprom
  30           - qcom,msm8976-qfprom
  31           - qcom,msm8996-qfprom
  32           - qcom,msm8998-qfprom
  33           - qcom,qcm2290-qfprom
  34           - qcom,qcs404-qfprom
  35           - qcom,sc7180-qfprom
  36           - qcom,sc7280-qfprom
  37           - qcom,sdm630-qfprom
  38           - qcom,sdm670-qfprom
  39           - qcom,sdm845-qfprom
  40           - qcom,sm6115-qfprom
  41           - qcom,sm6350-qfprom
  42           - qcom,sm6375-qfprom
  43           - qcom,sm8150-qfprom
  44           - qcom,sm8250-qfprom
  45       - const: qcom,qfprom
  46
  47   reg:
  48     # If the QFPROM is read-only OS image then only the corrected region
  49     # needs to be provided.  If the QFPROM is writable then all 4 regions
  50     # must be provided.
  51     oneOf:
  52       - items:
  53           - description: The corrected region.
  54       - items:
  55           - description: The corrected region.
  56           - description: The raw region.
  57           - description: The config region.
  58           - description: The security control region.
  59
  60   # Clock must be provided if QFPROM is writable from the OS image.
  61   clocks:
  62     maxItems: 1
  63   clock-names:
  64     const: core
  65
  66   # Supply reference must be provided if QFPROM is writable from the OS image.
  67   vcc-supply:
  68     description: Our power supply.
  69
  70   power-domains:
  71     maxItems: 1
  72
  73 required:
  74   - compatible
  75   - reg
  76
  77 unevaluatedProperties: false
  78
  79 examples:
  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     };