mei: fix KDoc documentation formatting
[linux/fpc-iii.git] / drivers / memory / mvebu-devbus.c
blobff7138fd66d14378ff2adef5f6d1a4901be994b5
1 /*
2 * Marvell EBU SoC Device Bus Controller
3 * (memory controller for NOR/NAND/SRAM/FPGA devices)
5 * Copyright (C) 2013-2014 Marvell
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation version 2 of the License.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include <linux/kernel.h>
22 #include <linux/module.h>
23 #include <linux/slab.h>
24 #include <linux/err.h>
25 #include <linux/io.h>
26 #include <linux/clk.h>
27 #include <linux/mbus.h>
28 #include <linux/of_platform.h>
29 #include <linux/of_address.h>
30 #include <linux/platform_device.h>
32 /* Register definitions */
33 #define ARMADA_DEV_WIDTH_SHIFT 30
34 #define ARMADA_BADR_SKEW_SHIFT 28
35 #define ARMADA_RD_HOLD_SHIFT 23
36 #define ARMADA_ACC_NEXT_SHIFT 17
37 #define ARMADA_RD_SETUP_SHIFT 12
38 #define ARMADA_ACC_FIRST_SHIFT 6
40 #define ARMADA_SYNC_ENABLE_SHIFT 24
41 #define ARMADA_WR_HIGH_SHIFT 16
42 #define ARMADA_WR_LOW_SHIFT 8
44 #define ARMADA_READ_PARAM_OFFSET 0x0
45 #define ARMADA_WRITE_PARAM_OFFSET 0x4
47 #define ORION_RESERVED (0x2 << 30)
48 #define ORION_BADR_SKEW_SHIFT 28
49 #define ORION_WR_HIGH_EXT_BIT BIT(27)
50 #define ORION_WR_HIGH_EXT_MASK 0x8
51 #define ORION_WR_LOW_EXT_BIT BIT(26)
52 #define ORION_WR_LOW_EXT_MASK 0x8
53 #define ORION_ALE_WR_EXT_BIT BIT(25)
54 #define ORION_ALE_WR_EXT_MASK 0x8
55 #define ORION_ACC_NEXT_EXT_BIT BIT(24)
56 #define ORION_ACC_NEXT_EXT_MASK 0x10
57 #define ORION_ACC_FIRST_EXT_BIT BIT(23)
58 #define ORION_ACC_FIRST_EXT_MASK 0x10
59 #define ORION_TURN_OFF_EXT_BIT BIT(22)
60 #define ORION_TURN_OFF_EXT_MASK 0x8
61 #define ORION_DEV_WIDTH_SHIFT 20
62 #define ORION_WR_HIGH_SHIFT 17
63 #define ORION_WR_HIGH_MASK 0x7
64 #define ORION_WR_LOW_SHIFT 14
65 #define ORION_WR_LOW_MASK 0x7
66 #define ORION_ALE_WR_SHIFT 11
67 #define ORION_ALE_WR_MASK 0x7
68 #define ORION_ACC_NEXT_SHIFT 7
69 #define ORION_ACC_NEXT_MASK 0xF
70 #define ORION_ACC_FIRST_SHIFT 3
71 #define ORION_ACC_FIRST_MASK 0xF
72 #define ORION_TURN_OFF_SHIFT 0
73 #define ORION_TURN_OFF_MASK 0x7
75 struct devbus_read_params {
76 u32 bus_width;
77 u32 badr_skew;
78 u32 turn_off;
79 u32 acc_first;
80 u32 acc_next;
81 u32 rd_setup;
82 u32 rd_hold;
85 struct devbus_write_params {
86 u32 sync_enable;
87 u32 wr_high;
88 u32 wr_low;
89 u32 ale_wr;
92 struct devbus {
93 struct device *dev;
94 void __iomem *base;
95 unsigned long tick_ps;
98 static int get_timing_param_ps(struct devbus *devbus,
99 struct device_node *node,
100 const char *name,
101 u32 *ticks)
103 u32 time_ps;
104 int err;
106 err = of_property_read_u32(node, name, &time_ps);
107 if (err < 0) {
108 dev_err(devbus->dev, "%s has no '%s' property\n",
109 name, node->full_name);
110 return err;
113 *ticks = (time_ps + devbus->tick_ps - 1) / devbus->tick_ps;
115 dev_dbg(devbus->dev, "%s: %u ps -> 0x%x\n",
116 name, time_ps, *ticks);
117 return 0;
120 static int devbus_get_timing_params(struct devbus *devbus,
121 struct device_node *node,
122 struct devbus_read_params *r,
123 struct devbus_write_params *w)
125 int err;
127 err = of_property_read_u32(node, "devbus,bus-width", &r->bus_width);
128 if (err < 0) {
129 dev_err(devbus->dev,
130 "%s has no 'devbus,bus-width' property\n",
131 node->full_name);
132 return err;
136 * The bus width is encoded into the register as 0 for 8 bits,
137 * and 1 for 16 bits, so we do the necessary conversion here.
139 if (r->bus_width == 8)
140 r->bus_width = 0;
141 else if (r->bus_width == 16)
142 r->bus_width = 1;
143 else {
144 dev_err(devbus->dev, "invalid bus width %d\n", r->bus_width);
145 return -EINVAL;
148 err = get_timing_param_ps(devbus, node, "devbus,badr-skew-ps",
149 &r->badr_skew);
150 if (err < 0)
151 return err;
153 err = get_timing_param_ps(devbus, node, "devbus,turn-off-ps",
154 &r->turn_off);
155 if (err < 0)
156 return err;
158 err = get_timing_param_ps(devbus, node, "devbus,acc-first-ps",
159 &r->acc_first);
160 if (err < 0)
161 return err;
163 err = get_timing_param_ps(devbus, node, "devbus,acc-next-ps",
164 &r->acc_next);
165 if (err < 0)
166 return err;
168 if (of_device_is_compatible(devbus->dev->of_node, "marvell,mvebu-devbus")) {
169 err = get_timing_param_ps(devbus, node, "devbus,rd-setup-ps",
170 &r->rd_setup);
171 if (err < 0)
172 return err;
174 err = get_timing_param_ps(devbus, node, "devbus,rd-hold-ps",
175 &r->rd_hold);
176 if (err < 0)
177 return err;
179 err = of_property_read_u32(node, "devbus,sync-enable",
180 &w->sync_enable);
181 if (err < 0) {
182 dev_err(devbus->dev,
183 "%s has no 'devbus,sync-enable' property\n",
184 node->full_name);
185 return err;
189 err = get_timing_param_ps(devbus, node, "devbus,ale-wr-ps",
190 &w->ale_wr);
191 if (err < 0)
192 return err;
194 err = get_timing_param_ps(devbus, node, "devbus,wr-low-ps",
195 &w->wr_low);
196 if (err < 0)
197 return err;
199 err = get_timing_param_ps(devbus, node, "devbus,wr-high-ps",
200 &w->wr_high);
201 if (err < 0)
202 return err;
204 return 0;
207 static void devbus_orion_set_timing_params(struct devbus *devbus,
208 struct device_node *node,
209 struct devbus_read_params *r,
210 struct devbus_write_params *w)
212 u32 value;
215 * The hardware designers found it would be a good idea to
216 * split most of the values in the register into two fields:
217 * one containing all the low-order bits, and another one
218 * containing just the high-order bit. For all of those
219 * fields, we have to split the value into these two parts.
221 value = (r->turn_off & ORION_TURN_OFF_MASK) << ORION_TURN_OFF_SHIFT |
222 (r->acc_first & ORION_ACC_FIRST_MASK) << ORION_ACC_FIRST_SHIFT |
223 (r->acc_next & ORION_ACC_NEXT_MASK) << ORION_ACC_NEXT_SHIFT |
224 (w->ale_wr & ORION_ALE_WR_MASK) << ORION_ALE_WR_SHIFT |
225 (w->wr_low & ORION_WR_LOW_MASK) << ORION_WR_LOW_SHIFT |
226 (w->wr_high & ORION_WR_HIGH_MASK) << ORION_WR_HIGH_SHIFT |
227 r->bus_width << ORION_DEV_WIDTH_SHIFT |
228 ((r->turn_off & ORION_TURN_OFF_EXT_MASK) ? ORION_TURN_OFF_EXT_BIT : 0) |
229 ((r->acc_first & ORION_ACC_FIRST_EXT_MASK) ? ORION_ACC_FIRST_EXT_BIT : 0) |
230 ((r->acc_next & ORION_ACC_NEXT_EXT_MASK) ? ORION_ACC_NEXT_EXT_BIT : 0) |
231 ((w->ale_wr & ORION_ALE_WR_EXT_MASK) ? ORION_ALE_WR_EXT_BIT : 0) |
232 ((w->wr_low & ORION_WR_LOW_EXT_MASK) ? ORION_WR_LOW_EXT_BIT : 0) |
233 ((w->wr_high & ORION_WR_HIGH_EXT_MASK) ? ORION_WR_HIGH_EXT_BIT : 0) |
234 (r->badr_skew << ORION_BADR_SKEW_SHIFT) |
235 ORION_RESERVED;
237 writel(value, devbus->base);
240 static void devbus_armada_set_timing_params(struct devbus *devbus,
241 struct device_node *node,
242 struct devbus_read_params *r,
243 struct devbus_write_params *w)
245 u32 value;
247 /* Set read timings */
248 value = r->bus_width << ARMADA_DEV_WIDTH_SHIFT |
249 r->badr_skew << ARMADA_BADR_SKEW_SHIFT |
250 r->rd_hold << ARMADA_RD_HOLD_SHIFT |
251 r->acc_next << ARMADA_ACC_NEXT_SHIFT |
252 r->rd_setup << ARMADA_RD_SETUP_SHIFT |
253 r->acc_first << ARMADA_ACC_FIRST_SHIFT |
254 r->turn_off;
256 dev_dbg(devbus->dev, "read parameters register 0x%p = 0x%x\n",
257 devbus->base + ARMADA_READ_PARAM_OFFSET,
258 value);
260 writel(value, devbus->base + ARMADA_READ_PARAM_OFFSET);
262 /* Set write timings */
263 value = w->sync_enable << ARMADA_SYNC_ENABLE_SHIFT |
264 w->wr_low << ARMADA_WR_LOW_SHIFT |
265 w->wr_high << ARMADA_WR_HIGH_SHIFT |
266 w->ale_wr;
268 dev_dbg(devbus->dev, "write parameters register: 0x%p = 0x%x\n",
269 devbus->base + ARMADA_WRITE_PARAM_OFFSET,
270 value);
272 writel(value, devbus->base + ARMADA_WRITE_PARAM_OFFSET);
275 static int mvebu_devbus_probe(struct platform_device *pdev)
277 struct device *dev = &pdev->dev;
278 struct device_node *node = pdev->dev.of_node;
279 struct devbus_read_params r;
280 struct devbus_write_params w;
281 struct devbus *devbus;
282 struct resource *res;
283 struct clk *clk;
284 unsigned long rate;
285 int err;
287 devbus = devm_kzalloc(&pdev->dev, sizeof(struct devbus), GFP_KERNEL);
288 if (!devbus)
289 return -ENOMEM;
291 devbus->dev = dev;
292 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
293 devbus->base = devm_ioremap_resource(&pdev->dev, res);
294 if (IS_ERR(devbus->base))
295 return PTR_ERR(devbus->base);
297 clk = devm_clk_get(&pdev->dev, NULL);
298 if (IS_ERR(clk))
299 return PTR_ERR(clk);
300 clk_prepare_enable(clk);
303 * Obtain clock period in picoseconds,
304 * we need this in order to convert timing
305 * parameters from cycles to picoseconds.
307 rate = clk_get_rate(clk) / 1000;
308 devbus->tick_ps = 1000000000 / rate;
310 dev_dbg(devbus->dev, "Setting timing parameter, tick is %lu ps\n",
311 devbus->tick_ps);
313 if (!of_property_read_bool(node, "devbus,keep-config")) {
314 /* Read the Device Tree node */
315 err = devbus_get_timing_params(devbus, node, &r, &w);
316 if (err < 0)
317 return err;
319 /* Set the new timing parameters */
320 if (of_device_is_compatible(node, "marvell,orion-devbus"))
321 devbus_orion_set_timing_params(devbus, node, &r, &w);
322 else
323 devbus_armada_set_timing_params(devbus, node, &r, &w);
327 * We need to create a child device explicitly from here to
328 * guarantee that the child will be probed after the timing
329 * parameters for the bus are written.
331 err = of_platform_populate(node, NULL, NULL, dev);
332 if (err < 0)
333 return err;
335 return 0;
338 static const struct of_device_id mvebu_devbus_of_match[] = {
339 { .compatible = "marvell,mvebu-devbus" },
340 { .compatible = "marvell,orion-devbus" },
343 MODULE_DEVICE_TABLE(of, mvebu_devbus_of_match);
345 static struct platform_driver mvebu_devbus_driver = {
346 .probe = mvebu_devbus_probe,
347 .driver = {
348 .name = "mvebu-devbus",
349 .owner = THIS_MODULE,
350 .of_match_table = mvebu_devbus_of_match,
354 static int __init mvebu_devbus_init(void)
356 return platform_driver_register(&mvebu_devbus_driver);
358 module_init(mvebu_devbus_init);
360 MODULE_LICENSE("GPL v2");
361 MODULE_AUTHOR("Ezequiel Garcia <ezequiel.garcia@free-electrons.com>");
362 MODULE_DESCRIPTION("Marvell EBU SoC Device Bus controller");