1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/nvmem/nvmem 4 $id: http://devicetree.org/schemas/nvmem/nvmem.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: NVMEM (Non Volatile Memory) 7 title: NVMEM (Non Volatile Memory)
8 8
9 maintainers: 9 maintainers:
10 - Srinivas Kandagatla <srinivas.kandagatla@li 10 - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
11 11
12 description: | 12 description: |
13 This binding is intended to represent the lo 13 This binding is intended to represent the location of hardware
14 configuration data stored in NVMEMs like eep 14 configuration data stored in NVMEMs like eeprom, efuses and so on.
15 15
16 On a significant proportion of boards, the m 16 On a significant proportion of boards, the manufacturer has stored
17 some data on NVMEM, for the OS to be able to 17 some data on NVMEM, for the OS to be able to retrieve these
18 information and act upon it. Obviously, the 18 information and act upon it. Obviously, the OS has to know about
19 where to retrieve these data from, and where 19 where to retrieve these data from, and where they are stored on the
20 storage device. 20 storage device.
21 21
22 properties: 22 properties:
23 "#address-cells": 23 "#address-cells":
24 const: 1 24 const: 1
25 25
26 "#size-cells": 26 "#size-cells":
27 const: 1 27 const: 1
28 28
29 read-only: 29 read-only:
30 $ref: /schemas/types.yaml#/definitions/fla 30 $ref: /schemas/types.yaml#/definitions/flag
31 description: 31 description:
32 Mark the provider as read only. 32 Mark the provider as read only.
33 33
34 wp-gpios: 34 wp-gpios:
35 description: 35 description:
36 GPIO to which the write-protect pin of t 36 GPIO to which the write-protect pin of the chip is connected.
37 The write-protect GPIO is asserted, when 37 The write-protect GPIO is asserted, when it's driven high
38 (logical '1') to block the write operati 38 (logical '1') to block the write operation. It's deasserted,
39 when it's driven low (logical '0') to al 39 when it's driven low (logical '0') to allow writing.
40 maxItems: 1 40 maxItems: 1
41 41
42 nvmem-layout: 42 nvmem-layout:
43 $ref: /schemas/nvmem/layouts/nvmem-layout. 43 $ref: /schemas/nvmem/layouts/nvmem-layout.yaml
44 description: 44 description:
45 Alternative to the statically defined nv 45 Alternative to the statically defined nvmem cells, this
46 container may reference more advanced (d 46 container may reference more advanced (dynamic) layout
47 parsers. 47 parsers.
48 48
>> 49 patternProperties:
>> 50 "@[0-9a-f]+(,[0-7])?$":
>> 51 type: object
>> 52
>> 53 properties:
>> 54 reg:
>> 55 maxItems: 1
>> 56 description:
>> 57 Offset and size in bytes within the storage device.
>> 58
>> 59 bits:
>> 60 $ref: /schemas/types.yaml#/definitions/uint32-array
>> 61 items:
>> 62 - minimum: 0
>> 63 maximum: 7
>> 64 description:
>> 65 Offset in bit within the address range specified by reg.
>> 66 - minimum: 1
>> 67 description:
>> 68 Size in bit within the address range specified by reg.
>> 69
49 additionalProperties: true 70 additionalProperties: true
50 71
51 examples: 72 examples:
52 - | 73 - |
53 #include <dt-bindings/gpio/gpio.h> 74 #include <dt-bindings/gpio/gpio.h>
54 75
55 qfprom: eeprom@700000 { 76 qfprom: eeprom@700000 {
56 compatible = "qcom,msm8974-qfprom", 77 compatible = "qcom,msm8974-qfprom", "qcom,qfprom";
57 #address-cells = <1>; 78 #address-cells = <1>;
58 #size-cells = <1>; 79 #size-cells = <1>;
59 reg = <0x00700000 0x100000>; 80 reg = <0x00700000 0x100000>;
60 81
61 wp-gpios = <&gpio1 3 GPIO_ACTIVE_HIG 82 wp-gpios = <&gpio1 3 GPIO_ACTIVE_HIGH>;
62 83
63 /* ... */ 84 /* ... */
64 85
65 nvmem-layout { !! 86 /* Data cells */
66 compatible = "fixed-layout"; !! 87 tsens_calibration: calib@404 {
67 #address-cells = <1>; !! 88 reg = <0x404 0x10>;
68 #size-cells = <1>; !! 89 };
69 !! 90
70 /* Data cells */ !! 91 tsens_calibration_bckp: calib_bckp@504 {
71 tsens_calibration: calib@404 { !! 92 reg = <0x504 0x11>;
72 reg = <0x404 0x10>; !! 93 bits = <6 128>;
73 }; !! 94 };
74 !! 95
75 tsens_calibration_bckp: calib_bc !! 96 pvs_version: pvs-version@6 {
76 reg = <0x504 0x11>; !! 97 reg = <0x6 0x2>;
77 bits = <6 128>; !! 98 bits = <7 2>;
78 }; !! 99 };
79 !! 100
80 pvs_version: pvs-version@6 { !! 101 speed_bin: speed-bin@c{
81 reg = <0x6 0x2>; !! 102 reg = <0xc 0x1>;
82 bits = <7 2>; !! 103 bits = <2 3>;
83 }; <<
84 <<
85 speed_bin: speed-bin@c{ <<
86 reg = <0xc 0x1>; <<
87 bits = <2 3>; <<
88 }; <<
89 }; 104 };
90 }; 105 };
91 106
92 ... 107 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.