summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/memory-controllers/fsl/fsl,imx-weim.yaml
blob: 3f40ca5b13f6600406c14a1723d2149a6c0cf329 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/memory-controllers/fsl/fsl,imx-weim.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: i.MX Wireless External Interface Module (WEIM)

maintainers:
  - Shawn Guo <shawnguo@kernel.org>
  - Sascha Hauer <s.hauer@pengutronix.de>

description:
  The term "wireless" does not imply that the WEIM is literally an interface
  without wires. It simply means that this module was originally designed for
  wireless and mobile applications that use low-power technology. The actual
  devices are instantiated from the child nodes of a WEIM node.

properties:
  $nodename:
    pattern: "^memory-controller@[0-9a-f]+$"

  compatible:
    oneOf:
      - enum:
          - fsl,imx1-weim
          - fsl,imx27-weim
          - fsl,imx50-weim
          - fsl,imx51-weim
          - fsl,imx6q-weim
      - items:
          - enum:
              - fsl,imx31-weim
              - fsl,imx35-weim
          - const: fsl,imx27-weim
      - items:
          - enum:
              - fsl,imx6sx-weim
              - fsl,imx6ul-weim
          - const: fsl,imx6q-weim

  "#address-cells":
    const: 2

  "#size-cells":
    const: 1

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  interrupts:
    maxItems: 1

  ranges: true

  fsl,weim-cs-gpr:
    $ref: /schemas/types.yaml#/definitions/phandle
    description: |
      Phandle to the system General Purpose Register controller that contains
      WEIM CS GPR register, e.g. IOMUXC_GPR1 on i.MX6Q. IOMUXC_GPR1[11:0]
      should be set up as one of the following 4 possible values depending on
      the CS space configuration.

      IOMUXC_GPR1[11:0]    CS0    CS1    CS2    CS3
      ---------------------------------------------
              05          128M     0M     0M     0M
              033          64M    64M     0M     0M
              0113         64M    32M    32M     0M
              01111        32M    32M    32M    32M

      In case that the property is absent, the reset value or what bootloader
      sets up in IOMUXC_GPR1[11:0] will be used.

  fsl,burst-clk-enable:
    type: boolean
    description:
      The presence of this property indicates that the weim bus should operate
      in Burst Clock Mode.

  fsl,continuous-burst-clk:
    type: boolean
    description:
      Make Burst Clock to output continuous clock. Without this option Burst
      Clock will output clock only when necessary.

patternProperties:
  "^.*@[0-7],[0-9a-f]+$":
    type: object
    description: Devices attached to chip selects are represented as subnodes.
    $ref: fsl,imx-weim-peripherals.yaml
    additionalProperties: true
    required:
      - fsl,weim-cs-timing

required:
  - compatible
  - reg
  - clocks
  - "#address-cells"
  - "#size-cells"
  - ranges

allOf:
  - if:
      properties:
        compatible:
          not:
            contains:
              enum:
                - fsl,imx50-weim
                - fsl,imx6q-weim
    then:
      properties:
        fsl,weim-cs-gpr: false
        fsl,burst-clk-enable: false
  - if:
      not:
        required:
          - fsl,burst-clk-enable
    then:
      properties:
        fsl,continuous-burst-clk: false
  - if:
      properties:
        compatible:
          contains:
            const: fsl,imx1-weim
    then:
      patternProperties:
        "^.*@[0-7],[0-9a-f]+$":
          properties:
            fsl,weim-cs-timing:
              items:
                items:
                  - description: CSxU
                  - description: CSxL
  - if:
      properties:
        compatible:
          contains:
            enum:
              - fsl,imx27-weim
              - fsl,imx31-weim
              - fsl,imx35-weim
    then:
      patternProperties:
        "^.*@[0-7],[0-9a-f]+$":
          properties:
            fsl,weim-cs-timing:
              items:
                items:
                  - description: CSCRxU
                  - description: CSCRxL
                  - description: CSCRxA
  - if:
      properties:
        compatible:
          contains:
            enum:
              - fsl,imx50-weim
              - fsl,imx51-weim
              - fsl,imx6q-weim
              - fsl,imx6sx-weim
              - fsl,imx6ul-weim
    then:
      patternProperties:
        "^.*@[0-7],[0-9a-f]+$":
          properties:
            fsl,weim-cs-timing:
              items:
                items:
                  - description: CSxGCR1
                  - description: CSxGCR2
                  - description: CSxRCR1
                  - description: CSxRCR2
                  - description: CSxWCR1
                  - description: CSxWCR2

additionalProperties: false

examples:
  - |
    memory-controller@21b8000 {
        compatible = "fsl,imx6q-weim";
        reg = <0x021b8000 0x4000>;
        clocks = <&clks 196>;
        #address-cells = <2>;
        #size-cells = <1>;
        ranges = <0 0 0x08000000 0x08000000>;
        fsl,weim-cs-gpr = <&gpr>;

        flash@0,0 {
            compatible = "cfi-flash";
            reg = <0 0 0x02000000>;
            #address-cells = <1>;
            #size-cells = <1>;
            bank-width = <2>;
            fsl,weim-cs-timing = <0x00620081 0x00000001 0x1c022000
                                  0x0000c000 0x1404a38e 0x00000000>;
        };
    };