2 * Qualcomm External Bus Interface 2 (EBI2) driver
3 * an older version of the Qualcomm Parallel Interface Controller (QPIC)
5 * Copyright (C) 2016 Linaro Ltd.
7 * Author: Linus Walleij <linus.walleij@linaro.org>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2, as
11 * published by the Free Software Foundation.
13 * See the device tree bindings for this block for more details on the
17 #include <linux/module.h>
18 #include <linux/clk.h>
19 #include <linux/err.h>
22 #include <linux/of_platform.h>
23 #include <linux/init.h>
25 #include <linux/slab.h>
26 #include <linux/platform_device.h>
27 #include <linux/bitops.h>
30 * CS0, CS1, CS4 and CS5 are two bits wide, CS2 and CS3 are one bit.
32 #define EBI2_CS0_ENABLE_MASK BIT(0)|BIT(1)
33 #define EBI2_CS1_ENABLE_MASK BIT(2)|BIT(3)
34 #define EBI2_CS2_ENABLE_MASK BIT(4)
35 #define EBI2_CS3_ENABLE_MASK BIT(5)
36 #define EBI2_CS4_ENABLE_MASK BIT(6)|BIT(7)
37 #define EBI2_CS5_ENABLE_MASK BIT(8)|BIT(9)
38 #define EBI2_CSN_MASK GENMASK(9, 0)
40 #define EBI2_XMEM_CFG 0x0000 /* Power management etc */
45 * Bits 31-28: RECOVERY recovery cycles (0 = 1, 1 = 2 etc) this is the time the
46 * memory continues to drive the data bus after OE is de-asserted.
47 * Inserted when reading one CS and switching to another CS or read
48 * followed by write on the same CS. Valid values 0 thru 15.
49 * Bits 27-24: WR_HOLD write hold cycles, these are extra cycles inserted after
50 * every write minimum 1. The data out is driven from the time WE is
51 * asserted until CS is asserted. With a hold of 1, the CS stays
52 * active for 1 extra cycle etc. Valid values 0 thru 15.
53 * Bits 23-16: WR_DELTA initial latency for write cycles inserted for the first
54 * write to a page or burst memory
55 * Bits 15-8: RD_DELTA initial latency for read cycles inserted for the first
56 * read to a page or burst memory
57 * Bits 7-4: WR_WAIT number of wait cycles for every write access, 0=1 cycle
58 * so 1 thru 16 cycles.
59 * Bits 3-0: RD_WAIT number of wait cycles for every read access, 0=1 cycle
60 * so 1 thru 16 cycles.
62 #define EBI2_XMEM_CS0_SLOW_CFG 0x0008
63 #define EBI2_XMEM_CS1_SLOW_CFG 0x000C
64 #define EBI2_XMEM_CS2_SLOW_CFG 0x0010
65 #define EBI2_XMEM_CS3_SLOW_CFG 0x0014
66 #define EBI2_XMEM_CS4_SLOW_CFG 0x0018
67 #define EBI2_XMEM_CS5_SLOW_CFG 0x001C
69 #define EBI2_XMEM_RECOVERY_SHIFT 28
70 #define EBI2_XMEM_WR_HOLD_SHIFT 24
71 #define EBI2_XMEM_WR_DELTA_SHIFT 16
72 #define EBI2_XMEM_RD_DELTA_SHIFT 8
73 #define EBI2_XMEM_WR_WAIT_SHIFT 4
74 #define EBI2_XMEM_RD_WAIT_SHIFT 0
79 * Bits 27-24: RD_HOLD: the length in cycles of the first segment of a read
80 * transfer. For a single read trandfer this will be the time
81 * from CS assertion to OE assertion.
83 * Bits 17-16: ADV_OE_RECOVERY, the number of cycles elapsed before an OE
84 * assertion, with respect to the cycle where ADV is asserted.
85 * 2 means 2 cycles between ADV and OE. Values 0, 1, 2 or 3.
86 * Bits 5: ADDR_HOLD_ENA, The address is held for an extra cycle to meet
87 * hold time requirements with ADV assertion.
89 * The manual mentions "write precharge cycles" and "precharge cycles".
90 * We have not been able to figure out which bit fields these correspond to
91 * in the hardware, or what valid values exist. The current hypothesis is that
92 * this is something just used on the FAST chip selects. There is also a "byte
93 * device enable" flag somewhere for 8bit memories.
95 #define EBI2_XMEM_CS0_FAST_CFG 0x0028
96 #define EBI2_XMEM_CS1_FAST_CFG 0x002C
97 #define EBI2_XMEM_CS2_FAST_CFG 0x0030
98 #define EBI2_XMEM_CS3_FAST_CFG 0x0034
99 #define EBI2_XMEM_CS4_FAST_CFG 0x0038
100 #define EBI2_XMEM_CS5_FAST_CFG 0x003C
102 #define EBI2_XMEM_RD_HOLD_SHIFT 24
103 #define EBI2_XMEM_ADV_OE_RECOVERY_SHIFT 16
104 #define EBI2_XMEM_ADDR_HOLD_ENA_SHIFT 5
107 * struct cs_data - struct with info on a chipselect setting
108 * @enable_mask: mask to enable the chipselect in the EBI2 config
109 * @slow_cfg0: offset to XMEMC slow CS config
110 * @fast_cfg1: offset to XMEMC fast CS config
118 static const struct cs_data cs_info
[] = {
121 .enable_mask
= EBI2_CS0_ENABLE_MASK
,
122 .slow_cfg
= EBI2_XMEM_CS0_SLOW_CFG
,
123 .fast_cfg
= EBI2_XMEM_CS0_FAST_CFG
,
127 .enable_mask
= EBI2_CS1_ENABLE_MASK
,
128 .slow_cfg
= EBI2_XMEM_CS1_SLOW_CFG
,
129 .fast_cfg
= EBI2_XMEM_CS1_FAST_CFG
,
133 .enable_mask
= EBI2_CS2_ENABLE_MASK
,
134 .slow_cfg
= EBI2_XMEM_CS2_SLOW_CFG
,
135 .fast_cfg
= EBI2_XMEM_CS2_FAST_CFG
,
139 .enable_mask
= EBI2_CS3_ENABLE_MASK
,
140 .slow_cfg
= EBI2_XMEM_CS3_SLOW_CFG
,
141 .fast_cfg
= EBI2_XMEM_CS3_FAST_CFG
,
145 .enable_mask
= EBI2_CS4_ENABLE_MASK
,
146 .slow_cfg
= EBI2_XMEM_CS4_SLOW_CFG
,
147 .fast_cfg
= EBI2_XMEM_CS4_FAST_CFG
,
151 .enable_mask
= EBI2_CS5_ENABLE_MASK
,
152 .slow_cfg
= EBI2_XMEM_CS5_SLOW_CFG
,
153 .fast_cfg
= EBI2_XMEM_CS5_FAST_CFG
,
158 * struct ebi2_xmem_prop - describes an XMEM config property
159 * @prop: the device tree binding name
160 * @max: maximum value for the property
161 * @slowreg: true if this property is in the SLOW CS config register
162 * else it is assumed to be in the FAST config register
163 * @shift: the bit field start in the SLOW or FAST register for this
166 struct ebi2_xmem_prop
{
173 static const struct ebi2_xmem_prop xmem_props
[] = {
175 .prop
= "qcom,xmem-recovery-cycles",
178 .shift
= EBI2_XMEM_RECOVERY_SHIFT
,
181 .prop
= "qcom,xmem-write-hold-cycles",
184 .shift
= EBI2_XMEM_WR_HOLD_SHIFT
,
187 .prop
= "qcom,xmem-write-delta-cycles",
190 .shift
= EBI2_XMEM_WR_DELTA_SHIFT
,
193 .prop
= "qcom,xmem-read-delta-cycles",
196 .shift
= EBI2_XMEM_RD_DELTA_SHIFT
,
199 .prop
= "qcom,xmem-write-wait-cycles",
202 .shift
= EBI2_XMEM_WR_WAIT_SHIFT
,
205 .prop
= "qcom,xmem-read-wait-cycles",
208 .shift
= EBI2_XMEM_RD_WAIT_SHIFT
,
211 .prop
= "qcom,xmem-address-hold-enable",
212 .max
= 1, /* boolean prop */
214 .shift
= EBI2_XMEM_ADDR_HOLD_ENA_SHIFT
,
217 .prop
= "qcom,xmem-adv-to-oe-recovery-cycles",
220 .shift
= EBI2_XMEM_ADV_OE_RECOVERY_SHIFT
,
223 .prop
= "qcom,xmem-read-hold-cycles",
226 .shift
= EBI2_XMEM_RD_HOLD_SHIFT
,
230 static void qcom_ebi2_setup_chipselect(struct device_node
*np
,
232 void __iomem
*ebi2_base
,
233 void __iomem
*ebi2_xmem
,
236 const struct cs_data
*csd
;
237 u32 slowcfg
, fastcfg
;
242 csd
= &cs_info
[csindex
];
243 val
= readl(ebi2_base
);
244 val
|= csd
->enable_mask
;
245 writel(val
, ebi2_base
);
246 dev_dbg(dev
, "enabled CS%u\n", csindex
);
248 /* Next set up the XMEMC */
252 for (i
= 0; i
< ARRAY_SIZE(xmem_props
); i
++) {
253 const struct ebi2_xmem_prop
*xp
= &xmem_props
[i
];
255 /* All are regular u32 values */
256 ret
= of_property_read_u32(np
, xp
->prop
, &val
);
258 dev_dbg(dev
, "could not read %s for CS%d\n",
263 /* First check boolean props */
264 if (xp
->max
== 1 && val
) {
266 slowcfg
|= BIT(xp
->shift
);
268 fastcfg
|= BIT(xp
->shift
);
269 dev_dbg(dev
, "set %s flag\n", xp
->prop
);
273 /* We're dealing with an u32 */
276 "too high value for %s: %u, capped at %u\n",
277 xp
->prop
, val
, xp
->max
);
281 slowcfg
|= (val
<< xp
->shift
);
283 fastcfg
|= (val
<< xp
->shift
);
284 dev_dbg(dev
, "set %s to %u\n", xp
->prop
, val
);
287 dev_info(dev
, "CS%u: SLOW CFG 0x%08x, FAST CFG 0x%08x\n",
288 csindex
, slowcfg
, fastcfg
);
291 writel(slowcfg
, ebi2_xmem
+ csd
->slow_cfg
);
293 writel(fastcfg
, ebi2_xmem
+ csd
->fast_cfg
);
296 static int qcom_ebi2_probe(struct platform_device
*pdev
)
298 struct device_node
*np
= pdev
->dev
.of_node
;
299 struct device_node
*child
;
300 struct device
*dev
= &pdev
->dev
;
301 struct resource
*res
;
302 void __iomem
*ebi2_base
;
303 void __iomem
*ebi2_xmem
;
304 struct clk
*ebi2xclk
;
306 bool have_children
= false;
310 ebi2xclk
= devm_clk_get(dev
, "ebi2x");
311 if (IS_ERR(ebi2xclk
))
312 return PTR_ERR(ebi2xclk
);
314 ret
= clk_prepare_enable(ebi2xclk
);
316 dev_err(dev
, "could not enable EBI2X clk (%d)\n", ret
);
320 ebi2clk
= devm_clk_get(dev
, "ebi2");
321 if (IS_ERR(ebi2clk
)) {
322 ret
= PTR_ERR(ebi2clk
);
323 goto err_disable_2x_clk
;
326 ret
= clk_prepare_enable(ebi2clk
);
328 dev_err(dev
, "could not enable EBI2 clk\n");
329 goto err_disable_2x_clk
;
332 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
333 ebi2_base
= devm_ioremap_resource(dev
, res
);
334 if (IS_ERR(ebi2_base
)) {
335 ret
= PTR_ERR(ebi2_base
);
336 goto err_disable_clk
;
339 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 1);
340 ebi2_xmem
= devm_ioremap_resource(dev
, res
);
341 if (IS_ERR(ebi2_xmem
)) {
342 ret
= PTR_ERR(ebi2_xmem
);
343 goto err_disable_clk
;
346 /* Allegedly this turns the power save mode off */
347 writel(0UL, ebi2_xmem
+ EBI2_XMEM_CFG
);
349 /* Disable all chipselects */
350 val
= readl(ebi2_base
);
351 val
&= ~EBI2_CSN_MASK
;
352 writel(val
, ebi2_base
);
354 /* Walk over the child nodes and see what chipselects we use */
355 for_each_available_child_of_node(np
, child
) {
358 /* Figure out the chipselect */
359 ret
= of_property_read_u32(child
, "reg", &csindex
);
365 "invalid chipselect %u, we only support 0-5\n",
370 qcom_ebi2_setup_chipselect(child
,
376 /* We have at least one child */
377 have_children
= true;
381 return of_platform_default_populate(np
, NULL
, dev
);
385 clk_disable_unprepare(ebi2clk
);
387 clk_disable_unprepare(ebi2xclk
);
392 static const struct of_device_id qcom_ebi2_of_match
[] = {
393 { .compatible
= "qcom,msm8660-ebi2", },
394 { .compatible
= "qcom,apq8060-ebi2", },
398 static struct platform_driver qcom_ebi2_driver
= {
399 .probe
= qcom_ebi2_probe
,
402 .of_match_table
= qcom_ebi2_of_match
,
405 module_platform_driver(qcom_ebi2_driver
);
406 MODULE_AUTHOR("Linus Walleij <linus.walleij@linaro.org>");
407 MODULE_DESCRIPTION("Qualcomm EBI2 driver");
408 MODULE_LICENSE("GPL");