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 bindings
   8
   9 maintainers:
  10   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
  11
  12 allOf:
  13   - $ref: "nvmem.yaml#"
  14
  15 properties:
  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
  63 required:
  64   - compatible
  65   - reg
  66
  67 unevaluatedProperties: false
  68
  69 examples:
  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     };