]>
Commit | Line | Data |
---|---|---|
ccdc7bf9 SO |
1 | /* |
2 | * OMAP2 McSPI controller driver | |
3 | * | |
4 | * Copyright (C) 2005, 2006 Nokia Corporation | |
5 | * Author: Samuel Ortiz <samuel.ortiz@nokia.com> and | |
1a5d8190 | 6 | * Juha Yrj�l� <juha.yrjola@nokia.com> |
ccdc7bf9 SO |
7 | * |
8 | * This program is free software; you can redistribute it and/or modify | |
9 | * it under the terms of the GNU General Public License as published by | |
10 | * the Free Software Foundation; either version 2 of the License, or | |
11 | * (at your option) any later version. | |
12 | * | |
13 | * This program is distributed in the hope that it will be useful, | |
14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | * GNU General Public License for more details. | |
17 | * | |
18 | * You should have received a copy of the GNU General Public License | |
19 | * along with this program; if not, write to the Free Software | |
20 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
21 | * | |
22 | */ | |
23 | ||
24 | #include <linux/kernel.h> | |
25 | #include <linux/init.h> | |
26 | #include <linux/interrupt.h> | |
27 | #include <linux/module.h> | |
28 | #include <linux/device.h> | |
29 | #include <linux/delay.h> | |
30 | #include <linux/dma-mapping.h> | |
53741ed8 RK |
31 | #include <linux/dmaengine.h> |
32 | #include <linux/omap-dma.h> | |
ccdc7bf9 SO |
33 | #include <linux/platform_device.h> |
34 | #include <linux/err.h> | |
35 | #include <linux/clk.h> | |
36 | #include <linux/io.h> | |
5a0e3ad6 | 37 | #include <linux/slab.h> |
1f1a4384 | 38 | #include <linux/pm_runtime.h> |
d5a80031 BC |
39 | #include <linux/of.h> |
40 | #include <linux/of_device.h> | |
ec155afa | 41 | #include <linux/pinctrl/consumer.h> |
ccdc7bf9 SO |
42 | |
43 | #include <linux/spi/spi.h> | |
44 | ||
2203747c | 45 | #include <linux/platform_data/spi-omap2-mcspi.h> |
ccdc7bf9 SO |
46 | |
47 | #define OMAP2_MCSPI_MAX_FREQ 48000000 | |
27b5284c | 48 | #define SPI_AUTOSUSPEND_TIMEOUT 2000 |
ccdc7bf9 SO |
49 | |
50 | #define OMAP2_MCSPI_REVISION 0x00 | |
ccdc7bf9 SO |
51 | #define OMAP2_MCSPI_SYSSTATUS 0x14 |
52 | #define OMAP2_MCSPI_IRQSTATUS 0x18 | |
53 | #define OMAP2_MCSPI_IRQENABLE 0x1c | |
54 | #define OMAP2_MCSPI_WAKEUPENABLE 0x20 | |
55 | #define OMAP2_MCSPI_SYST 0x24 | |
56 | #define OMAP2_MCSPI_MODULCTRL 0x28 | |
57 | ||
58 | /* per-channel banks, 0x14 bytes each, first is: */ | |
59 | #define OMAP2_MCSPI_CHCONF0 0x2c | |
60 | #define OMAP2_MCSPI_CHSTAT0 0x30 | |
61 | #define OMAP2_MCSPI_CHCTRL0 0x34 | |
62 | #define OMAP2_MCSPI_TX0 0x38 | |
63 | #define OMAP2_MCSPI_RX0 0x3c | |
64 | ||
65 | /* per-register bitmasks: */ | |
66 | ||
7a8fa725 JH |
67 | #define OMAP2_MCSPI_MODULCTRL_SINGLE BIT(0) |
68 | #define OMAP2_MCSPI_MODULCTRL_MS BIT(2) | |
69 | #define OMAP2_MCSPI_MODULCTRL_STEST BIT(3) | |
ccdc7bf9 | 70 | |
7a8fa725 JH |
71 | #define OMAP2_MCSPI_CHCONF_PHA BIT(0) |
72 | #define OMAP2_MCSPI_CHCONF_POL BIT(1) | |
ccdc7bf9 | 73 | #define OMAP2_MCSPI_CHCONF_CLKD_MASK (0x0f << 2) |
7a8fa725 | 74 | #define OMAP2_MCSPI_CHCONF_EPOL BIT(6) |
ccdc7bf9 | 75 | #define OMAP2_MCSPI_CHCONF_WL_MASK (0x1f << 7) |
7a8fa725 JH |
76 | #define OMAP2_MCSPI_CHCONF_TRM_RX_ONLY BIT(12) |
77 | #define OMAP2_MCSPI_CHCONF_TRM_TX_ONLY BIT(13) | |
ccdc7bf9 | 78 | #define OMAP2_MCSPI_CHCONF_TRM_MASK (0x03 << 12) |
7a8fa725 JH |
79 | #define OMAP2_MCSPI_CHCONF_DMAW BIT(14) |
80 | #define OMAP2_MCSPI_CHCONF_DMAR BIT(15) | |
81 | #define OMAP2_MCSPI_CHCONF_DPE0 BIT(16) | |
82 | #define OMAP2_MCSPI_CHCONF_DPE1 BIT(17) | |
83 | #define OMAP2_MCSPI_CHCONF_IS BIT(18) | |
84 | #define OMAP2_MCSPI_CHCONF_TURBO BIT(19) | |
85 | #define OMAP2_MCSPI_CHCONF_FORCE BIT(20) | |
ccdc7bf9 | 86 | |
7a8fa725 JH |
87 | #define OMAP2_MCSPI_CHSTAT_RXS BIT(0) |
88 | #define OMAP2_MCSPI_CHSTAT_TXS BIT(1) | |
89 | #define OMAP2_MCSPI_CHSTAT_EOT BIT(2) | |
ccdc7bf9 | 90 | |
7a8fa725 | 91 | #define OMAP2_MCSPI_CHCTRL_EN BIT(0) |
ccdc7bf9 | 92 | |
7a8fa725 | 93 | #define OMAP2_MCSPI_WAKEUPENABLE_WKEN BIT(0) |
ccdc7bf9 SO |
94 | |
95 | /* We have 2 DMA channels per CS, one for RX and one for TX */ | |
96 | struct omap2_mcspi_dma { | |
53741ed8 RK |
97 | struct dma_chan *dma_tx; |
98 | struct dma_chan *dma_rx; | |
ccdc7bf9 SO |
99 | |
100 | int dma_tx_sync_dev; | |
101 | int dma_rx_sync_dev; | |
102 | ||
103 | struct completion dma_tx_completion; | |
104 | struct completion dma_rx_completion; | |
105 | }; | |
106 | ||
107 | /* use PIO for small transfers, avoiding DMA setup/teardown overhead and | |
108 | * cache operations; better heuristics consider wordsize and bitrate. | |
109 | */ | |
8b66c134 | 110 | #define DMA_MIN_BYTES 160 |
ccdc7bf9 SO |
111 | |
112 | ||
1bd897f8 BC |
113 | /* |
114 | * Used for context save and restore, structure members to be updated whenever | |
115 | * corresponding registers are modified. | |
116 | */ | |
117 | struct omap2_mcspi_regs { | |
118 | u32 modulctrl; | |
119 | u32 wakeupenable; | |
120 | struct list_head cs; | |
121 | }; | |
122 | ||
ccdc7bf9 | 123 | struct omap2_mcspi { |
ccdc7bf9 | 124 | struct spi_master *master; |
ccdc7bf9 SO |
125 | /* Virtual base address of the controller */ |
126 | void __iomem *base; | |
e5480b73 | 127 | unsigned long phys; |
ccdc7bf9 SO |
128 | /* SPI1 has 4 channels, while SPI2 has 2 */ |
129 | struct omap2_mcspi_dma *dma_channels; | |
1bd897f8 | 130 | struct device *dev; |
1bd897f8 | 131 | struct omap2_mcspi_regs ctx; |
0384e90b | 132 | unsigned int pin_dir:1; |
ccdc7bf9 SO |
133 | }; |
134 | ||
135 | struct omap2_mcspi_cs { | |
136 | void __iomem *base; | |
e5480b73 | 137 | unsigned long phys; |
ccdc7bf9 | 138 | int word_len; |
89c05372 | 139 | struct list_head node; |
a41ae1ad H |
140 | /* Context save and restore shadow register */ |
141 | u32 chconf0; | |
142 | }; | |
143 | ||
ccdc7bf9 SO |
144 | static inline void mcspi_write_reg(struct spi_master *master, |
145 | int idx, u32 val) | |
146 | { | |
147 | struct omap2_mcspi *mcspi = spi_master_get_devdata(master); | |
148 | ||
149 | __raw_writel(val, mcspi->base + idx); | |
150 | } | |
151 | ||
152 | static inline u32 mcspi_read_reg(struct spi_master *master, int idx) | |
153 | { | |
154 | struct omap2_mcspi *mcspi = spi_master_get_devdata(master); | |
155 | ||
156 | return __raw_readl(mcspi->base + idx); | |
157 | } | |
158 | ||
159 | static inline void mcspi_write_cs_reg(const struct spi_device *spi, | |
160 | int idx, u32 val) | |
161 | { | |
162 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
163 | ||
164 | __raw_writel(val, cs->base + idx); | |
165 | } | |
166 | ||
167 | static inline u32 mcspi_read_cs_reg(const struct spi_device *spi, int idx) | |
168 | { | |
169 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
170 | ||
171 | return __raw_readl(cs->base + idx); | |
172 | } | |
173 | ||
a41ae1ad H |
174 | static inline u32 mcspi_cached_chconf0(const struct spi_device *spi) |
175 | { | |
176 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
177 | ||
178 | return cs->chconf0; | |
179 | } | |
180 | ||
181 | static inline void mcspi_write_chconf0(const struct spi_device *spi, u32 val) | |
182 | { | |
183 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
184 | ||
185 | cs->chconf0 = val; | |
186 | mcspi_write_cs_reg(spi, OMAP2_MCSPI_CHCONF0, val); | |
a330ce20 | 187 | mcspi_read_cs_reg(spi, OMAP2_MCSPI_CHCONF0); |
a41ae1ad H |
188 | } |
189 | ||
ccdc7bf9 SO |
190 | static void omap2_mcspi_set_dma_req(const struct spi_device *spi, |
191 | int is_read, int enable) | |
192 | { | |
193 | u32 l, rw; | |
194 | ||
a41ae1ad | 195 | l = mcspi_cached_chconf0(spi); |
ccdc7bf9 SO |
196 | |
197 | if (is_read) /* 1 is read, 0 write */ | |
198 | rw = OMAP2_MCSPI_CHCONF_DMAR; | |
199 | else | |
200 | rw = OMAP2_MCSPI_CHCONF_DMAW; | |
201 | ||
af4e944d S |
202 | if (enable) |
203 | l |= rw; | |
204 | else | |
205 | l &= ~rw; | |
206 | ||
a41ae1ad | 207 | mcspi_write_chconf0(spi, l); |
ccdc7bf9 SO |
208 | } |
209 | ||
210 | static void omap2_mcspi_set_enable(const struct spi_device *spi, int enable) | |
211 | { | |
212 | u32 l; | |
213 | ||
214 | l = enable ? OMAP2_MCSPI_CHCTRL_EN : 0; | |
215 | mcspi_write_cs_reg(spi, OMAP2_MCSPI_CHCTRL0, l); | |
4743a0f8 RT |
216 | /* Flash post-writes */ |
217 | mcspi_read_cs_reg(spi, OMAP2_MCSPI_CHCTRL0); | |
ccdc7bf9 SO |
218 | } |
219 | ||
220 | static void omap2_mcspi_force_cs(struct spi_device *spi, int cs_active) | |
221 | { | |
222 | u32 l; | |
223 | ||
a41ae1ad | 224 | l = mcspi_cached_chconf0(spi); |
af4e944d S |
225 | if (cs_active) |
226 | l |= OMAP2_MCSPI_CHCONF_FORCE; | |
227 | else | |
228 | l &= ~OMAP2_MCSPI_CHCONF_FORCE; | |
229 | ||
a41ae1ad | 230 | mcspi_write_chconf0(spi, l); |
ccdc7bf9 SO |
231 | } |
232 | ||
233 | static void omap2_mcspi_set_master_mode(struct spi_master *master) | |
234 | { | |
1bd897f8 BC |
235 | struct omap2_mcspi *mcspi = spi_master_get_devdata(master); |
236 | struct omap2_mcspi_regs *ctx = &mcspi->ctx; | |
ccdc7bf9 SO |
237 | u32 l; |
238 | ||
1bd897f8 BC |
239 | /* |
240 | * Setup when switching from (reset default) slave mode | |
ccdc7bf9 SO |
241 | * to single-channel master mode |
242 | */ | |
243 | l = mcspi_read_reg(master, OMAP2_MCSPI_MODULCTRL); | |
af4e944d S |
244 | l &= ~(OMAP2_MCSPI_MODULCTRL_STEST | OMAP2_MCSPI_MODULCTRL_MS); |
245 | l |= OMAP2_MCSPI_MODULCTRL_SINGLE; | |
ccdc7bf9 | 246 | mcspi_write_reg(master, OMAP2_MCSPI_MODULCTRL, l); |
a41ae1ad | 247 | |
1bd897f8 | 248 | ctx->modulctrl = l; |
a41ae1ad H |
249 | } |
250 | ||
251 | static void omap2_mcspi_restore_ctx(struct omap2_mcspi *mcspi) | |
252 | { | |
1bd897f8 BC |
253 | struct spi_master *spi_cntrl = mcspi->master; |
254 | struct omap2_mcspi_regs *ctx = &mcspi->ctx; | |
255 | struct omap2_mcspi_cs *cs; | |
a41ae1ad H |
256 | |
257 | /* McSPI: context restore */ | |
1bd897f8 BC |
258 | mcspi_write_reg(spi_cntrl, OMAP2_MCSPI_MODULCTRL, ctx->modulctrl); |
259 | mcspi_write_reg(spi_cntrl, OMAP2_MCSPI_WAKEUPENABLE, ctx->wakeupenable); | |
a41ae1ad | 260 | |
1bd897f8 | 261 | list_for_each_entry(cs, &ctx->cs, node) |
89c05372 | 262 | __raw_writel(cs->chconf0, cs->base + OMAP2_MCSPI_CHCONF0); |
a41ae1ad | 263 | } |
ccdc7bf9 | 264 | |
5fda88f5 S |
265 | static int omap2_prepare_transfer(struct spi_master *master) |
266 | { | |
267 | struct omap2_mcspi *mcspi = spi_master_get_devdata(master); | |
268 | ||
269 | pm_runtime_get_sync(mcspi->dev); | |
270 | return 0; | |
271 | } | |
272 | ||
273 | static int omap2_unprepare_transfer(struct spi_master *master) | |
274 | { | |
275 | struct omap2_mcspi *mcspi = spi_master_get_devdata(master); | |
276 | ||
277 | pm_runtime_mark_last_busy(mcspi->dev); | |
278 | pm_runtime_put_autosuspend(mcspi->dev); | |
279 | return 0; | |
280 | } | |
281 | ||
2764c500 IK |
282 | static int mcspi_wait_for_reg_bit(void __iomem *reg, unsigned long bit) |
283 | { | |
284 | unsigned long timeout; | |
285 | ||
286 | timeout = jiffies + msecs_to_jiffies(1000); | |
287 | while (!(__raw_readl(reg) & bit)) { | |
ff23fa3b SAS |
288 | if (time_after(jiffies, timeout)) { |
289 | if (!(__raw_readl(reg) & bit)) | |
290 | return -ETIMEDOUT; | |
291 | else | |
292 | return 0; | |
293 | } | |
2764c500 IK |
294 | cpu_relax(); |
295 | } | |
296 | return 0; | |
297 | } | |
298 | ||
53741ed8 RK |
299 | static void omap2_mcspi_rx_callback(void *data) |
300 | { | |
301 | struct spi_device *spi = data; | |
302 | struct omap2_mcspi *mcspi = spi_master_get_devdata(spi->master); | |
303 | struct omap2_mcspi_dma *mcspi_dma = &mcspi->dma_channels[spi->chip_select]; | |
304 | ||
53741ed8 RK |
305 | /* We must disable the DMA RX request */ |
306 | omap2_mcspi_set_dma_req(spi, 1, 0); | |
830379e0 FB |
307 | |
308 | complete(&mcspi_dma->dma_rx_completion); | |
53741ed8 RK |
309 | } |
310 | ||
311 | static void omap2_mcspi_tx_callback(void *data) | |
312 | { | |
313 | struct spi_device *spi = data; | |
314 | struct omap2_mcspi *mcspi = spi_master_get_devdata(spi->master); | |
315 | struct omap2_mcspi_dma *mcspi_dma = &mcspi->dma_channels[spi->chip_select]; | |
316 | ||
53741ed8 RK |
317 | /* We must disable the DMA TX request */ |
318 | omap2_mcspi_set_dma_req(spi, 0, 0); | |
830379e0 FB |
319 | |
320 | complete(&mcspi_dma->dma_tx_completion); | |
53741ed8 RK |
321 | } |
322 | ||
d7b4394e S |
323 | static void omap2_mcspi_tx_dma(struct spi_device *spi, |
324 | struct spi_transfer *xfer, | |
325 | struct dma_slave_config cfg) | |
ccdc7bf9 SO |
326 | { |
327 | struct omap2_mcspi *mcspi; | |
ccdc7bf9 | 328 | struct omap2_mcspi_dma *mcspi_dma; |
8c7494a5 | 329 | unsigned int count; |
ccdc7bf9 SO |
330 | |
331 | mcspi = spi_master_get_devdata(spi->master); | |
332 | mcspi_dma = &mcspi->dma_channels[spi->chip_select]; | |
d7b4394e | 333 | count = xfer->len; |
ccdc7bf9 | 334 | |
d7b4394e | 335 | if (mcspi_dma->dma_tx) { |
53741ed8 RK |
336 | struct dma_async_tx_descriptor *tx; |
337 | struct scatterlist sg; | |
338 | ||
339 | dmaengine_slave_config(mcspi_dma->dma_tx, &cfg); | |
340 | ||
341 | sg_init_table(&sg, 1); | |
342 | sg_dma_address(&sg) = xfer->tx_dma; | |
343 | sg_dma_len(&sg) = xfer->len; | |
344 | ||
345 | tx = dmaengine_prep_slave_sg(mcspi_dma->dma_tx, &sg, 1, | |
d7b4394e | 346 | DMA_MEM_TO_DEV, DMA_PREP_INTERRUPT | DMA_CTRL_ACK); |
53741ed8 RK |
347 | if (tx) { |
348 | tx->callback = omap2_mcspi_tx_callback; | |
349 | tx->callback_param = spi; | |
350 | dmaengine_submit(tx); | |
351 | } else { | |
352 | /* FIXME: fall back to PIO? */ | |
353 | } | |
354 | } | |
d7b4394e S |
355 | dma_async_issue_pending(mcspi_dma->dma_tx); |
356 | omap2_mcspi_set_dma_req(spi, 0, 1); | |
357 | ||
d7b4394e | 358 | } |
53741ed8 | 359 | |
d7b4394e S |
360 | static unsigned |
361 | omap2_mcspi_rx_dma(struct spi_device *spi, struct spi_transfer *xfer, | |
362 | struct dma_slave_config cfg, | |
363 | unsigned es) | |
364 | { | |
365 | struct omap2_mcspi *mcspi; | |
366 | struct omap2_mcspi_dma *mcspi_dma; | |
367 | unsigned int count; | |
368 | u32 l; | |
369 | int elements = 0; | |
370 | int word_len, element_count; | |
371 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
372 | mcspi = spi_master_get_devdata(spi->master); | |
373 | mcspi_dma = &mcspi->dma_channels[spi->chip_select]; | |
374 | count = xfer->len; | |
375 | word_len = cs->word_len; | |
376 | l = mcspi_cached_chconf0(spi); | |
53741ed8 | 377 | |
d7b4394e S |
378 | if (word_len <= 8) |
379 | element_count = count; | |
380 | else if (word_len <= 16) | |
381 | element_count = count >> 1; | |
382 | else /* word_len <= 32 */ | |
383 | element_count = count >> 2; | |
384 | ||
385 | if (mcspi_dma->dma_rx) { | |
53741ed8 RK |
386 | struct dma_async_tx_descriptor *tx; |
387 | struct scatterlist sg; | |
388 | size_t len = xfer->len - es; | |
389 | ||
390 | dmaengine_slave_config(mcspi_dma->dma_rx, &cfg); | |
391 | ||
392 | if (l & OMAP2_MCSPI_CHCONF_TURBO) | |
393 | len -= es; | |
394 | ||
395 | sg_init_table(&sg, 1); | |
396 | sg_dma_address(&sg) = xfer->rx_dma; | |
397 | sg_dma_len(&sg) = len; | |
398 | ||
399 | tx = dmaengine_prep_slave_sg(mcspi_dma->dma_rx, &sg, 1, | |
d7b4394e S |
400 | DMA_DEV_TO_MEM, DMA_PREP_INTERRUPT | |
401 | DMA_CTRL_ACK); | |
53741ed8 RK |
402 | if (tx) { |
403 | tx->callback = omap2_mcspi_rx_callback; | |
404 | tx->callback_param = spi; | |
405 | dmaengine_submit(tx); | |
406 | } else { | |
d7b4394e | 407 | /* FIXME: fall back to PIO? */ |
2764c500 | 408 | } |
ccdc7bf9 SO |
409 | } |
410 | ||
d7b4394e S |
411 | dma_async_issue_pending(mcspi_dma->dma_rx); |
412 | omap2_mcspi_set_dma_req(spi, 1, 1); | |
4743a0f8 | 413 | |
d7b4394e S |
414 | wait_for_completion(&mcspi_dma->dma_rx_completion); |
415 | dma_unmap_single(mcspi->dev, xfer->rx_dma, count, | |
416 | DMA_FROM_DEVICE); | |
417 | omap2_mcspi_set_enable(spi, 0); | |
53741ed8 | 418 | |
d7b4394e | 419 | elements = element_count - 1; |
4743a0f8 | 420 | |
d7b4394e S |
421 | if (l & OMAP2_MCSPI_CHCONF_TURBO) { |
422 | elements--; | |
4743a0f8 | 423 | |
57c5c28d | 424 | if (likely(mcspi_read_cs_reg(spi, OMAP2_MCSPI_CHSTAT0) |
d7b4394e | 425 | & OMAP2_MCSPI_CHSTAT_RXS)) { |
57c5c28d EN |
426 | u32 w; |
427 | ||
428 | w = mcspi_read_cs_reg(spi, OMAP2_MCSPI_RX0); | |
429 | if (word_len <= 8) | |
d7b4394e | 430 | ((u8 *)xfer->rx_buf)[elements++] = w; |
57c5c28d | 431 | else if (word_len <= 16) |
d7b4394e | 432 | ((u16 *)xfer->rx_buf)[elements++] = w; |
57c5c28d | 433 | else /* word_len <= 32 */ |
d7b4394e | 434 | ((u32 *)xfer->rx_buf)[elements++] = w; |
57c5c28d | 435 | } else { |
d7b4394e S |
436 | dev_err(&spi->dev, "DMA RX penultimate word empty"); |
437 | count -= (word_len <= 8) ? 2 : | |
438 | (word_len <= 16) ? 4 : | |
439 | /* word_len <= 32 */ 8; | |
440 | omap2_mcspi_set_enable(spi, 1); | |
441 | return count; | |
57c5c28d | 442 | } |
ccdc7bf9 | 443 | } |
d7b4394e S |
444 | if (likely(mcspi_read_cs_reg(spi, OMAP2_MCSPI_CHSTAT0) |
445 | & OMAP2_MCSPI_CHSTAT_RXS)) { | |
446 | u32 w; | |
447 | ||
448 | w = mcspi_read_cs_reg(spi, OMAP2_MCSPI_RX0); | |
449 | if (word_len <= 8) | |
450 | ((u8 *)xfer->rx_buf)[elements] = w; | |
451 | else if (word_len <= 16) | |
452 | ((u16 *)xfer->rx_buf)[elements] = w; | |
453 | else /* word_len <= 32 */ | |
454 | ((u32 *)xfer->rx_buf)[elements] = w; | |
455 | } else { | |
456 | dev_err(&spi->dev, "DMA RX last word empty"); | |
457 | count -= (word_len <= 8) ? 1 : | |
458 | (word_len <= 16) ? 2 : | |
459 | /* word_len <= 32 */ 4; | |
460 | } | |
461 | omap2_mcspi_set_enable(spi, 1); | |
462 | return count; | |
463 | } | |
464 | ||
465 | static unsigned | |
466 | omap2_mcspi_txrx_dma(struct spi_device *spi, struct spi_transfer *xfer) | |
467 | { | |
468 | struct omap2_mcspi *mcspi; | |
469 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
470 | struct omap2_mcspi_dma *mcspi_dma; | |
471 | unsigned int count; | |
472 | u32 l; | |
473 | u8 *rx; | |
474 | const u8 *tx; | |
475 | struct dma_slave_config cfg; | |
476 | enum dma_slave_buswidth width; | |
477 | unsigned es; | |
e47a682a | 478 | void __iomem *chstat_reg; |
d7b4394e S |
479 | |
480 | mcspi = spi_master_get_devdata(spi->master); | |
481 | mcspi_dma = &mcspi->dma_channels[spi->chip_select]; | |
482 | l = mcspi_cached_chconf0(spi); | |
483 | ||
484 | ||
485 | if (cs->word_len <= 8) { | |
486 | width = DMA_SLAVE_BUSWIDTH_1_BYTE; | |
487 | es = 1; | |
488 | } else if (cs->word_len <= 16) { | |
489 | width = DMA_SLAVE_BUSWIDTH_2_BYTES; | |
490 | es = 2; | |
491 | } else { | |
492 | width = DMA_SLAVE_BUSWIDTH_4_BYTES; | |
493 | es = 4; | |
494 | } | |
495 | ||
496 | memset(&cfg, 0, sizeof(cfg)); | |
497 | cfg.src_addr = cs->phys + OMAP2_MCSPI_RX0; | |
498 | cfg.dst_addr = cs->phys + OMAP2_MCSPI_TX0; | |
499 | cfg.src_addr_width = width; | |
500 | cfg.dst_addr_width = width; | |
501 | cfg.src_maxburst = 1; | |
502 | cfg.dst_maxburst = 1; | |
503 | ||
504 | rx = xfer->rx_buf; | |
505 | tx = xfer->tx_buf; | |
506 | ||
507 | count = xfer->len; | |
508 | ||
509 | if (tx != NULL) | |
510 | omap2_mcspi_tx_dma(spi, xfer, cfg); | |
511 | ||
512 | if (rx != NULL) | |
e47a682a S |
513 | count = omap2_mcspi_rx_dma(spi, xfer, cfg, es); |
514 | ||
515 | if (tx != NULL) { | |
516 | chstat_reg = cs->base + OMAP2_MCSPI_CHSTAT0; | |
517 | wait_for_completion(&mcspi_dma->dma_tx_completion); | |
518 | dma_unmap_single(mcspi->dev, xfer->tx_dma, xfer->len, | |
519 | DMA_TO_DEVICE); | |
520 | ||
521 | /* for TX_ONLY mode, be sure all words have shifted out */ | |
522 | if (rx == NULL) { | |
523 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
524 | OMAP2_MCSPI_CHSTAT_TXS) < 0) | |
525 | dev_err(&spi->dev, "TXS timed out\n"); | |
526 | else if (mcspi_wait_for_reg_bit(chstat_reg, | |
527 | OMAP2_MCSPI_CHSTAT_EOT) < 0) | |
528 | dev_err(&spi->dev, "EOT timed out\n"); | |
529 | } | |
530 | } | |
ccdc7bf9 SO |
531 | return count; |
532 | } | |
533 | ||
ccdc7bf9 SO |
534 | static unsigned |
535 | omap2_mcspi_txrx_pio(struct spi_device *spi, struct spi_transfer *xfer) | |
536 | { | |
537 | struct omap2_mcspi *mcspi; | |
538 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
539 | unsigned int count, c; | |
540 | u32 l; | |
541 | void __iomem *base = cs->base; | |
542 | void __iomem *tx_reg; | |
543 | void __iomem *rx_reg; | |
544 | void __iomem *chstat_reg; | |
545 | int word_len; | |
546 | ||
547 | mcspi = spi_master_get_devdata(spi->master); | |
548 | count = xfer->len; | |
549 | c = count; | |
550 | word_len = cs->word_len; | |
551 | ||
a41ae1ad | 552 | l = mcspi_cached_chconf0(spi); |
ccdc7bf9 SO |
553 | |
554 | /* We store the pre-calculated register addresses on stack to speed | |
555 | * up the transfer loop. */ | |
556 | tx_reg = base + OMAP2_MCSPI_TX0; | |
557 | rx_reg = base + OMAP2_MCSPI_RX0; | |
558 | chstat_reg = base + OMAP2_MCSPI_CHSTAT0; | |
559 | ||
adef658d MJ |
560 | if (c < (word_len>>3)) |
561 | return 0; | |
562 | ||
ccdc7bf9 SO |
563 | if (word_len <= 8) { |
564 | u8 *rx; | |
565 | const u8 *tx; | |
566 | ||
567 | rx = xfer->rx_buf; | |
568 | tx = xfer->tx_buf; | |
569 | ||
570 | do { | |
feed9bab | 571 | c -= 1; |
ccdc7bf9 SO |
572 | if (tx != NULL) { |
573 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
574 | OMAP2_MCSPI_CHSTAT_TXS) < 0) { | |
575 | dev_err(&spi->dev, "TXS timed out\n"); | |
576 | goto out; | |
577 | } | |
079a176d | 578 | dev_vdbg(&spi->dev, "write-%d %02x\n", |
ccdc7bf9 | 579 | word_len, *tx); |
ccdc7bf9 SO |
580 | __raw_writel(*tx++, tx_reg); |
581 | } | |
582 | if (rx != NULL) { | |
583 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
584 | OMAP2_MCSPI_CHSTAT_RXS) < 0) { | |
585 | dev_err(&spi->dev, "RXS timed out\n"); | |
586 | goto out; | |
587 | } | |
4743a0f8 RT |
588 | |
589 | if (c == 1 && tx == NULL && | |
590 | (l & OMAP2_MCSPI_CHCONF_TURBO)) { | |
591 | omap2_mcspi_set_enable(spi, 0); | |
592 | *rx++ = __raw_readl(rx_reg); | |
079a176d | 593 | dev_vdbg(&spi->dev, "read-%d %02x\n", |
4743a0f8 | 594 | word_len, *(rx - 1)); |
4743a0f8 RT |
595 | if (mcspi_wait_for_reg_bit(chstat_reg, |
596 | OMAP2_MCSPI_CHSTAT_RXS) < 0) { | |
597 | dev_err(&spi->dev, | |
598 | "RXS timed out\n"); | |
599 | goto out; | |
600 | } | |
601 | c = 0; | |
602 | } else if (c == 0 && tx == NULL) { | |
603 | omap2_mcspi_set_enable(spi, 0); | |
604 | } | |
605 | ||
ccdc7bf9 | 606 | *rx++ = __raw_readl(rx_reg); |
079a176d | 607 | dev_vdbg(&spi->dev, "read-%d %02x\n", |
ccdc7bf9 | 608 | word_len, *(rx - 1)); |
ccdc7bf9 | 609 | } |
95c5c3ab | 610 | } while (c); |
ccdc7bf9 SO |
611 | } else if (word_len <= 16) { |
612 | u16 *rx; | |
613 | const u16 *tx; | |
614 | ||
615 | rx = xfer->rx_buf; | |
616 | tx = xfer->tx_buf; | |
617 | do { | |
feed9bab | 618 | c -= 2; |
ccdc7bf9 SO |
619 | if (tx != NULL) { |
620 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
621 | OMAP2_MCSPI_CHSTAT_TXS) < 0) { | |
622 | dev_err(&spi->dev, "TXS timed out\n"); | |
623 | goto out; | |
624 | } | |
079a176d | 625 | dev_vdbg(&spi->dev, "write-%d %04x\n", |
ccdc7bf9 | 626 | word_len, *tx); |
ccdc7bf9 SO |
627 | __raw_writel(*tx++, tx_reg); |
628 | } | |
629 | if (rx != NULL) { | |
630 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
631 | OMAP2_MCSPI_CHSTAT_RXS) < 0) { | |
632 | dev_err(&spi->dev, "RXS timed out\n"); | |
633 | goto out; | |
634 | } | |
4743a0f8 RT |
635 | |
636 | if (c == 2 && tx == NULL && | |
637 | (l & OMAP2_MCSPI_CHCONF_TURBO)) { | |
638 | omap2_mcspi_set_enable(spi, 0); | |
639 | *rx++ = __raw_readl(rx_reg); | |
079a176d | 640 | dev_vdbg(&spi->dev, "read-%d %04x\n", |
4743a0f8 | 641 | word_len, *(rx - 1)); |
4743a0f8 RT |
642 | if (mcspi_wait_for_reg_bit(chstat_reg, |
643 | OMAP2_MCSPI_CHSTAT_RXS) < 0) { | |
644 | dev_err(&spi->dev, | |
645 | "RXS timed out\n"); | |
646 | goto out; | |
647 | } | |
648 | c = 0; | |
649 | } else if (c == 0 && tx == NULL) { | |
650 | omap2_mcspi_set_enable(spi, 0); | |
651 | } | |
652 | ||
ccdc7bf9 | 653 | *rx++ = __raw_readl(rx_reg); |
079a176d | 654 | dev_vdbg(&spi->dev, "read-%d %04x\n", |
ccdc7bf9 | 655 | word_len, *(rx - 1)); |
ccdc7bf9 | 656 | } |
95c5c3ab | 657 | } while (c >= 2); |
ccdc7bf9 SO |
658 | } else if (word_len <= 32) { |
659 | u32 *rx; | |
660 | const u32 *tx; | |
661 | ||
662 | rx = xfer->rx_buf; | |
663 | tx = xfer->tx_buf; | |
664 | do { | |
feed9bab | 665 | c -= 4; |
ccdc7bf9 SO |
666 | if (tx != NULL) { |
667 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
668 | OMAP2_MCSPI_CHSTAT_TXS) < 0) { | |
669 | dev_err(&spi->dev, "TXS timed out\n"); | |
670 | goto out; | |
671 | } | |
079a176d | 672 | dev_vdbg(&spi->dev, "write-%d %08x\n", |
ccdc7bf9 | 673 | word_len, *tx); |
ccdc7bf9 SO |
674 | __raw_writel(*tx++, tx_reg); |
675 | } | |
676 | if (rx != NULL) { | |
677 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
678 | OMAP2_MCSPI_CHSTAT_RXS) < 0) { | |
679 | dev_err(&spi->dev, "RXS timed out\n"); | |
680 | goto out; | |
681 | } | |
4743a0f8 RT |
682 | |
683 | if (c == 4 && tx == NULL && | |
684 | (l & OMAP2_MCSPI_CHCONF_TURBO)) { | |
685 | omap2_mcspi_set_enable(spi, 0); | |
686 | *rx++ = __raw_readl(rx_reg); | |
079a176d | 687 | dev_vdbg(&spi->dev, "read-%d %08x\n", |
4743a0f8 | 688 | word_len, *(rx - 1)); |
4743a0f8 RT |
689 | if (mcspi_wait_for_reg_bit(chstat_reg, |
690 | OMAP2_MCSPI_CHSTAT_RXS) < 0) { | |
691 | dev_err(&spi->dev, | |
692 | "RXS timed out\n"); | |
693 | goto out; | |
694 | } | |
695 | c = 0; | |
696 | } else if (c == 0 && tx == NULL) { | |
697 | omap2_mcspi_set_enable(spi, 0); | |
698 | } | |
699 | ||
ccdc7bf9 | 700 | *rx++ = __raw_readl(rx_reg); |
079a176d | 701 | dev_vdbg(&spi->dev, "read-%d %08x\n", |
ccdc7bf9 | 702 | word_len, *(rx - 1)); |
ccdc7bf9 | 703 | } |
95c5c3ab | 704 | } while (c >= 4); |
ccdc7bf9 SO |
705 | } |
706 | ||
707 | /* for TX_ONLY mode, be sure all words have shifted out */ | |
708 | if (xfer->rx_buf == NULL) { | |
709 | if (mcspi_wait_for_reg_bit(chstat_reg, | |
710 | OMAP2_MCSPI_CHSTAT_TXS) < 0) { | |
711 | dev_err(&spi->dev, "TXS timed out\n"); | |
712 | } else if (mcspi_wait_for_reg_bit(chstat_reg, | |
713 | OMAP2_MCSPI_CHSTAT_EOT) < 0) | |
714 | dev_err(&spi->dev, "EOT timed out\n"); | |
e1993ed6 JW |
715 | |
716 | /* disable chan to purge rx datas received in TX_ONLY transfer, | |
717 | * otherwise these rx datas will affect the direct following | |
718 | * RX_ONLY transfer. | |
719 | */ | |
720 | omap2_mcspi_set_enable(spi, 0); | |
ccdc7bf9 SO |
721 | } |
722 | out: | |
4743a0f8 | 723 | omap2_mcspi_set_enable(spi, 1); |
ccdc7bf9 SO |
724 | return count - c; |
725 | } | |
726 | ||
57d9c10d HH |
727 | static u32 omap2_mcspi_calc_divisor(u32 speed_hz) |
728 | { | |
729 | u32 div; | |
730 | ||
731 | for (div = 0; div < 15; div++) | |
732 | if (speed_hz >= (OMAP2_MCSPI_MAX_FREQ >> div)) | |
733 | return div; | |
734 | ||
735 | return 15; | |
736 | } | |
737 | ||
ccdc7bf9 SO |
738 | /* called only when no transfer is active to this device */ |
739 | static int omap2_mcspi_setup_transfer(struct spi_device *spi, | |
740 | struct spi_transfer *t) | |
741 | { | |
742 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
743 | struct omap2_mcspi *mcspi; | |
a41ae1ad | 744 | struct spi_master *spi_cntrl; |
ccdc7bf9 SO |
745 | u32 l = 0, div = 0; |
746 | u8 word_len = spi->bits_per_word; | |
9bd4517d | 747 | u32 speed_hz = spi->max_speed_hz; |
ccdc7bf9 SO |
748 | |
749 | mcspi = spi_master_get_devdata(spi->master); | |
a41ae1ad | 750 | spi_cntrl = mcspi->master; |
ccdc7bf9 SO |
751 | |
752 | if (t != NULL && t->bits_per_word) | |
753 | word_len = t->bits_per_word; | |
754 | ||
755 | cs->word_len = word_len; | |
756 | ||
9bd4517d SE |
757 | if (t && t->speed_hz) |
758 | speed_hz = t->speed_hz; | |
759 | ||
57d9c10d HH |
760 | speed_hz = min_t(u32, speed_hz, OMAP2_MCSPI_MAX_FREQ); |
761 | div = omap2_mcspi_calc_divisor(speed_hz); | |
ccdc7bf9 | 762 | |
a41ae1ad | 763 | l = mcspi_cached_chconf0(spi); |
ccdc7bf9 SO |
764 | |
765 | /* standard 4-wire master mode: SCK, MOSI/out, MISO/in, nCS | |
766 | * REVISIT: this controller could support SPI_3WIRE mode. | |
767 | */ | |
2cd45179 | 768 | if (mcspi->pin_dir == MCSPI_PINDIR_D0_IN_D1_OUT) { |
0384e90b DM |
769 | l &= ~OMAP2_MCSPI_CHCONF_IS; |
770 | l &= ~OMAP2_MCSPI_CHCONF_DPE1; | |
771 | l |= OMAP2_MCSPI_CHCONF_DPE0; | |
772 | } else { | |
773 | l |= OMAP2_MCSPI_CHCONF_IS; | |
774 | l |= OMAP2_MCSPI_CHCONF_DPE1; | |
775 | l &= ~OMAP2_MCSPI_CHCONF_DPE0; | |
776 | } | |
ccdc7bf9 SO |
777 | |
778 | /* wordlength */ | |
779 | l &= ~OMAP2_MCSPI_CHCONF_WL_MASK; | |
780 | l |= (word_len - 1) << 7; | |
781 | ||
782 | /* set chipselect polarity; manage with FORCE */ | |
783 | if (!(spi->mode & SPI_CS_HIGH)) | |
784 | l |= OMAP2_MCSPI_CHCONF_EPOL; /* active-low; normal */ | |
785 | else | |
786 | l &= ~OMAP2_MCSPI_CHCONF_EPOL; | |
787 | ||
788 | /* set clock divisor */ | |
789 | l &= ~OMAP2_MCSPI_CHCONF_CLKD_MASK; | |
790 | l |= div << 2; | |
791 | ||
792 | /* set SPI mode 0..3 */ | |
793 | if (spi->mode & SPI_CPOL) | |
794 | l |= OMAP2_MCSPI_CHCONF_POL; | |
795 | else | |
796 | l &= ~OMAP2_MCSPI_CHCONF_POL; | |
797 | if (spi->mode & SPI_CPHA) | |
798 | l |= OMAP2_MCSPI_CHCONF_PHA; | |
799 | else | |
800 | l &= ~OMAP2_MCSPI_CHCONF_PHA; | |
801 | ||
a41ae1ad | 802 | mcspi_write_chconf0(spi, l); |
ccdc7bf9 SO |
803 | |
804 | dev_dbg(&spi->dev, "setup: speed %d, sample %s edge, clk %s\n", | |
57d9c10d | 805 | OMAP2_MCSPI_MAX_FREQ >> div, |
ccdc7bf9 SO |
806 | (spi->mode & SPI_CPHA) ? "trailing" : "leading", |
807 | (spi->mode & SPI_CPOL) ? "inverted" : "normal"); | |
808 | ||
809 | return 0; | |
810 | } | |
811 | ||
ccdc7bf9 SO |
812 | static int omap2_mcspi_request_dma(struct spi_device *spi) |
813 | { | |
814 | struct spi_master *master = spi->master; | |
815 | struct omap2_mcspi *mcspi; | |
816 | struct omap2_mcspi_dma *mcspi_dma; | |
53741ed8 RK |
817 | dma_cap_mask_t mask; |
818 | unsigned sig; | |
ccdc7bf9 SO |
819 | |
820 | mcspi = spi_master_get_devdata(master); | |
821 | mcspi_dma = mcspi->dma_channels + spi->chip_select; | |
822 | ||
53741ed8 RK |
823 | init_completion(&mcspi_dma->dma_rx_completion); |
824 | init_completion(&mcspi_dma->dma_tx_completion); | |
825 | ||
826 | dma_cap_zero(mask); | |
827 | dma_cap_set(DMA_SLAVE, mask); | |
53741ed8 RK |
828 | sig = mcspi_dma->dma_rx_sync_dev; |
829 | mcspi_dma->dma_rx = dma_request_channel(mask, omap_dma_filter_fn, &sig); | |
830 | if (!mcspi_dma->dma_rx) { | |
831 | dev_err(&spi->dev, "no RX DMA engine channel for McSPI\n"); | |
ccdc7bf9 SO |
832 | return -EAGAIN; |
833 | } | |
834 | ||
53741ed8 RK |
835 | sig = mcspi_dma->dma_tx_sync_dev; |
836 | mcspi_dma->dma_tx = dma_request_channel(mask, omap_dma_filter_fn, &sig); | |
837 | if (!mcspi_dma->dma_tx) { | |
838 | dev_err(&spi->dev, "no TX DMA engine channel for McSPI\n"); | |
839 | dma_release_channel(mcspi_dma->dma_rx); | |
840 | mcspi_dma->dma_rx = NULL; | |
ccdc7bf9 SO |
841 | return -EAGAIN; |
842 | } | |
843 | ||
ccdc7bf9 SO |
844 | return 0; |
845 | } | |
846 | ||
ccdc7bf9 SO |
847 | static int omap2_mcspi_setup(struct spi_device *spi) |
848 | { | |
849 | int ret; | |
1bd897f8 BC |
850 | struct omap2_mcspi *mcspi = spi_master_get_devdata(spi->master); |
851 | struct omap2_mcspi_regs *ctx = &mcspi->ctx; | |
ccdc7bf9 SO |
852 | struct omap2_mcspi_dma *mcspi_dma; |
853 | struct omap2_mcspi_cs *cs = spi->controller_state; | |
854 | ||
7d077197 | 855 | if (spi->bits_per_word < 4 || spi->bits_per_word > 32) { |
ccdc7bf9 SO |
856 | dev_dbg(&spi->dev, "setup: unsupported %d bit words\n", |
857 | spi->bits_per_word); | |
858 | return -EINVAL; | |
859 | } | |
860 | ||
ccdc7bf9 SO |
861 | mcspi_dma = &mcspi->dma_channels[spi->chip_select]; |
862 | ||
863 | if (!cs) { | |
10aa5a35 | 864 | cs = kzalloc(sizeof *cs, GFP_KERNEL); |
ccdc7bf9 SO |
865 | if (!cs) |
866 | return -ENOMEM; | |
867 | cs->base = mcspi->base + spi->chip_select * 0x14; | |
e5480b73 | 868 | cs->phys = mcspi->phys + spi->chip_select * 0x14; |
a41ae1ad | 869 | cs->chconf0 = 0; |
ccdc7bf9 | 870 | spi->controller_state = cs; |
89c05372 | 871 | /* Link this to context save list */ |
1bd897f8 | 872 | list_add_tail(&cs->node, &ctx->cs); |
ccdc7bf9 SO |
873 | } |
874 | ||
8c7494a5 | 875 | if (!mcspi_dma->dma_rx || !mcspi_dma->dma_tx) { |
ccdc7bf9 SO |
876 | ret = omap2_mcspi_request_dma(spi); |
877 | if (ret < 0) | |
878 | return ret; | |
879 | } | |
880 | ||
034d3dc9 | 881 | ret = pm_runtime_get_sync(mcspi->dev); |
1f1a4384 G |
882 | if (ret < 0) |
883 | return ret; | |
a41ae1ad | 884 | |
86eeb6fe | 885 | ret = omap2_mcspi_setup_transfer(spi, NULL); |
034d3dc9 S |
886 | pm_runtime_mark_last_busy(mcspi->dev); |
887 | pm_runtime_put_autosuspend(mcspi->dev); | |
ccdc7bf9 SO |
888 | |
889 | return ret; | |
890 | } | |
891 | ||
892 | static void omap2_mcspi_cleanup(struct spi_device *spi) | |
893 | { | |
894 | struct omap2_mcspi *mcspi; | |
895 | struct omap2_mcspi_dma *mcspi_dma; | |
89c05372 | 896 | struct omap2_mcspi_cs *cs; |
ccdc7bf9 SO |
897 | |
898 | mcspi = spi_master_get_devdata(spi->master); | |
ccdc7bf9 | 899 | |
5e774943 SE |
900 | if (spi->controller_state) { |
901 | /* Unlink controller state from context save list */ | |
902 | cs = spi->controller_state; | |
903 | list_del(&cs->node); | |
89c05372 | 904 | |
10aa5a35 | 905 | kfree(cs); |
5e774943 | 906 | } |
ccdc7bf9 | 907 | |
99f1a43f SE |
908 | if (spi->chip_select < spi->master->num_chipselect) { |
909 | mcspi_dma = &mcspi->dma_channels[spi->chip_select]; | |
910 | ||
53741ed8 RK |
911 | if (mcspi_dma->dma_rx) { |
912 | dma_release_channel(mcspi_dma->dma_rx); | |
913 | mcspi_dma->dma_rx = NULL; | |
99f1a43f | 914 | } |
53741ed8 RK |
915 | if (mcspi_dma->dma_tx) { |
916 | dma_release_channel(mcspi_dma->dma_tx); | |
917 | mcspi_dma->dma_tx = NULL; | |
99f1a43f | 918 | } |
ccdc7bf9 SO |
919 | } |
920 | } | |
921 | ||
5fda88f5 | 922 | static void omap2_mcspi_work(struct omap2_mcspi *mcspi, struct spi_message *m) |
ccdc7bf9 | 923 | { |
ccdc7bf9 SO |
924 | |
925 | /* We only enable one channel at a time -- the one whose message is | |
5fda88f5 | 926 | * -- although this controller would gladly |
ccdc7bf9 SO |
927 | * arbitrate among multiple channels. This corresponds to "single |
928 | * channel" master mode. As a side effect, we need to manage the | |
929 | * chipselect with the FORCE bit ... CS != channel enable. | |
930 | */ | |
ccdc7bf9 | 931 | |
5fda88f5 S |
932 | struct spi_device *spi; |
933 | struct spi_transfer *t = NULL; | |
5cbc7ca9 | 934 | struct spi_master *master; |
5fda88f5 S |
935 | int cs_active = 0; |
936 | struct omap2_mcspi_cs *cs; | |
937 | struct omap2_mcspi_device_config *cd; | |
938 | int par_override = 0; | |
939 | int status = 0; | |
940 | u32 chconf; | |
ccdc7bf9 | 941 | |
5fda88f5 | 942 | spi = m->spi; |
5cbc7ca9 | 943 | master = spi->master; |
5fda88f5 S |
944 | cs = spi->controller_state; |
945 | cd = spi->controller_data; | |
ccdc7bf9 | 946 | |
5fda88f5 S |
947 | omap2_mcspi_set_enable(spi, 1); |
948 | list_for_each_entry(t, &m->transfers, transfer_list) { | |
949 | if (t->tx_buf == NULL && t->rx_buf == NULL && t->len) { | |
950 | status = -EINVAL; | |
951 | break; | |
952 | } | |
953 | if (par_override || t->speed_hz || t->bits_per_word) { | |
954 | par_override = 1; | |
955 | status = omap2_mcspi_setup_transfer(spi, t); | |
956 | if (status < 0) | |
957 | break; | |
958 | if (!t->speed_hz && !t->bits_per_word) | |
959 | par_override = 0; | |
960 | } | |
5cbc7ca9 MB |
961 | if (cd && cd->cs_per_word) { |
962 | chconf = mcspi->ctx.modulctrl; | |
963 | chconf &= ~OMAP2_MCSPI_MODULCTRL_SINGLE; | |
964 | mcspi_write_reg(master, OMAP2_MCSPI_MODULCTRL, chconf); | |
965 | mcspi->ctx.modulctrl = | |
966 | mcspi_read_cs_reg(spi, OMAP2_MCSPI_MODULCTRL); | |
967 | } | |
968 | ||
4743a0f8 | 969 | |
5fda88f5 S |
970 | if (!cs_active) { |
971 | omap2_mcspi_force_cs(spi, 1); | |
972 | cs_active = 1; | |
973 | } | |
4743a0f8 | 974 | |
5fda88f5 S |
975 | chconf = mcspi_cached_chconf0(spi); |
976 | chconf &= ~OMAP2_MCSPI_CHCONF_TRM_MASK; | |
977 | chconf &= ~OMAP2_MCSPI_CHCONF_TURBO; | |
ccdc7bf9 | 978 | |
5fda88f5 S |
979 | if (t->tx_buf == NULL) |
980 | chconf |= OMAP2_MCSPI_CHCONF_TRM_RX_ONLY; | |
981 | else if (t->rx_buf == NULL) | |
982 | chconf |= OMAP2_MCSPI_CHCONF_TRM_TX_ONLY; | |
ccdc7bf9 | 983 | |
5fda88f5 S |
984 | if (cd && cd->turbo_mode && t->tx_buf == NULL) { |
985 | /* Turbo mode is for more than one word */ | |
986 | if (t->len > ((cs->word_len + 7) >> 3)) | |
987 | chconf |= OMAP2_MCSPI_CHCONF_TURBO; | |
988 | } | |
ccdc7bf9 | 989 | |
5fda88f5 | 990 | mcspi_write_chconf0(spi, chconf); |
ccdc7bf9 | 991 | |
5fda88f5 S |
992 | if (t->len) { |
993 | unsigned count; | |
994 | ||
995 | /* RX_ONLY mode needs dummy data in TX reg */ | |
996 | if (t->tx_buf == NULL) | |
997 | __raw_writel(0, cs->base | |
998 | + OMAP2_MCSPI_TX0); | |
ccdc7bf9 | 999 | |
5fda88f5 S |
1000 | if (m->is_dma_mapped || t->len >= DMA_MIN_BYTES) |
1001 | count = omap2_mcspi_txrx_dma(spi, t); | |
1002 | else | |
1003 | count = omap2_mcspi_txrx_pio(spi, t); | |
1004 | m->actual_length += count; | |
ccdc7bf9 | 1005 | |
5fda88f5 S |
1006 | if (count != t->len) { |
1007 | status = -EIO; | |
1008 | break; | |
ccdc7bf9 SO |
1009 | } |
1010 | } | |
1011 | ||
5fda88f5 S |
1012 | if (t->delay_usecs) |
1013 | udelay(t->delay_usecs); | |
ccdc7bf9 | 1014 | |
5fda88f5 S |
1015 | /* ignore the "leave it on after last xfer" hint */ |
1016 | if (t->cs_change) { | |
ccdc7bf9 | 1017 | omap2_mcspi_force_cs(spi, 0); |
5fda88f5 S |
1018 | cs_active = 0; |
1019 | } | |
1020 | } | |
1021 | /* Restore defaults if they were overriden */ | |
1022 | if (par_override) { | |
1023 | par_override = 0; | |
1024 | status = omap2_mcspi_setup_transfer(spi, NULL); | |
1025 | } | |
ccdc7bf9 | 1026 | |
5fda88f5 S |
1027 | if (cs_active) |
1028 | omap2_mcspi_force_cs(spi, 0); | |
ccdc7bf9 | 1029 | |
5cbc7ca9 MB |
1030 | if (cd && cd->cs_per_word) { |
1031 | chconf = mcspi->ctx.modulctrl; | |
1032 | chconf |= OMAP2_MCSPI_MODULCTRL_SINGLE; | |
1033 | mcspi_write_reg(master, OMAP2_MCSPI_MODULCTRL, chconf); | |
1034 | mcspi->ctx.modulctrl = | |
1035 | mcspi_read_cs_reg(spi, OMAP2_MCSPI_MODULCTRL); | |
1036 | } | |
1037 | ||
5fda88f5 | 1038 | omap2_mcspi_set_enable(spi, 0); |
ccdc7bf9 | 1039 | |
5fda88f5 | 1040 | m->status = status; |
1f1a4384 | 1041 | |
ccdc7bf9 SO |
1042 | } |
1043 | ||
5fda88f5 | 1044 | static int omap2_mcspi_transfer_one_message(struct spi_master *master, |
18dd6199 | 1045 | struct spi_message *m) |
ccdc7bf9 SO |
1046 | { |
1047 | struct omap2_mcspi *mcspi; | |
ccdc7bf9 SO |
1048 | struct spi_transfer *t; |
1049 | ||
5fda88f5 | 1050 | mcspi = spi_master_get_devdata(master); |
ccdc7bf9 SO |
1051 | m->actual_length = 0; |
1052 | m->status = 0; | |
1053 | ||
1054 | /* reject invalid messages and transfers */ | |
5fda88f5 | 1055 | if (list_empty(&m->transfers)) |
ccdc7bf9 SO |
1056 | return -EINVAL; |
1057 | list_for_each_entry(t, &m->transfers, transfer_list) { | |
1058 | const void *tx_buf = t->tx_buf; | |
1059 | void *rx_buf = t->rx_buf; | |
1060 | unsigned len = t->len; | |
1061 | ||
1062 | if (t->speed_hz > OMAP2_MCSPI_MAX_FREQ | |
1063 | || (len && !(rx_buf || tx_buf)) | |
1064 | || (t->bits_per_word && | |
1065 | ( t->bits_per_word < 4 | |
18dd6199 | 1066 | || t->bits_per_word > 32))) { |
5fda88f5 | 1067 | dev_dbg(mcspi->dev, "transfer: %d Hz, %d %s%s, %d bpw\n", |
ccdc7bf9 SO |
1068 | t->speed_hz, |
1069 | len, | |
1070 | tx_buf ? "tx" : "", | |
1071 | rx_buf ? "rx" : "", | |
1072 | t->bits_per_word); | |
1073 | return -EINVAL; | |
1074 | } | |
57d9c10d | 1075 | if (t->speed_hz && t->speed_hz < (OMAP2_MCSPI_MAX_FREQ >> 15)) { |
5fda88f5 | 1076 | dev_dbg(mcspi->dev, "speed_hz %d below minimum %d Hz\n", |
18dd6199 MB |
1077 | t->speed_hz, |
1078 | OMAP2_MCSPI_MAX_FREQ >> 15); | |
ccdc7bf9 SO |
1079 | return -EINVAL; |
1080 | } | |
1081 | ||
1082 | if (m->is_dma_mapped || len < DMA_MIN_BYTES) | |
1083 | continue; | |
1084 | ||
ccdc7bf9 | 1085 | if (tx_buf != NULL) { |
5fda88f5 | 1086 | t->tx_dma = dma_map_single(mcspi->dev, (void *) tx_buf, |
ccdc7bf9 | 1087 | len, DMA_TO_DEVICE); |
5fda88f5 S |
1088 | if (dma_mapping_error(mcspi->dev, t->tx_dma)) { |
1089 | dev_dbg(mcspi->dev, "dma %cX %d bytes error\n", | |
ccdc7bf9 SO |
1090 | 'T', len); |
1091 | return -EINVAL; | |
1092 | } | |
1093 | } | |
1094 | if (rx_buf != NULL) { | |
5fda88f5 | 1095 | t->rx_dma = dma_map_single(mcspi->dev, rx_buf, t->len, |
ccdc7bf9 | 1096 | DMA_FROM_DEVICE); |
5fda88f5 S |
1097 | if (dma_mapping_error(mcspi->dev, t->rx_dma)) { |
1098 | dev_dbg(mcspi->dev, "dma %cX %d bytes error\n", | |
ccdc7bf9 SO |
1099 | 'R', len); |
1100 | if (tx_buf != NULL) | |
5fda88f5 | 1101 | dma_unmap_single(mcspi->dev, t->tx_dma, |
ccdc7bf9 SO |
1102 | len, DMA_TO_DEVICE); |
1103 | return -EINVAL; | |
1104 | } | |
1105 | } | |
1106 | } | |
1107 | ||
5fda88f5 S |
1108 | omap2_mcspi_work(mcspi, m); |
1109 | spi_finalize_current_message(master); | |
ccdc7bf9 SO |
1110 | return 0; |
1111 | } | |
1112 | ||
fd4a319b | 1113 | static int omap2_mcspi_master_setup(struct omap2_mcspi *mcspi) |
ccdc7bf9 SO |
1114 | { |
1115 | struct spi_master *master = mcspi->master; | |
1bd897f8 | 1116 | struct omap2_mcspi_regs *ctx = &mcspi->ctx; |
1bd897f8 | 1117 | int ret = 0; |
ccdc7bf9 | 1118 | |
034d3dc9 | 1119 | ret = pm_runtime_get_sync(mcspi->dev); |
1f1a4384 G |
1120 | if (ret < 0) |
1121 | return ret; | |
ddb22195 | 1122 | |
39f8052d | 1123 | mcspi_write_reg(master, OMAP2_MCSPI_WAKEUPENABLE, |
18dd6199 | 1124 | OMAP2_MCSPI_WAKEUPENABLE_WKEN); |
39f8052d | 1125 | ctx->wakeupenable = OMAP2_MCSPI_WAKEUPENABLE_WKEN; |
ccdc7bf9 SO |
1126 | |
1127 | omap2_mcspi_set_master_mode(master); | |
034d3dc9 S |
1128 | pm_runtime_mark_last_busy(mcspi->dev); |
1129 | pm_runtime_put_autosuspend(mcspi->dev); | |
ccdc7bf9 SO |
1130 | return 0; |
1131 | } | |
1132 | ||
1f1a4384 G |
1133 | static int omap_mcspi_runtime_resume(struct device *dev) |
1134 | { | |
1135 | struct omap2_mcspi *mcspi; | |
1136 | struct spi_master *master; | |
1137 | ||
1138 | master = dev_get_drvdata(dev); | |
1139 | mcspi = spi_master_get_devdata(master); | |
1140 | omap2_mcspi_restore_ctx(mcspi); | |
1141 | ||
1142 | return 0; | |
1143 | } | |
1144 | ||
d5a80031 BC |
1145 | static struct omap2_mcspi_platform_config omap2_pdata = { |
1146 | .regs_offset = 0, | |
1147 | }; | |
1148 | ||
1149 | static struct omap2_mcspi_platform_config omap4_pdata = { | |
1150 | .regs_offset = OMAP4_MCSPI_REG_OFFSET, | |
1151 | }; | |
1152 | ||
1153 | static const struct of_device_id omap_mcspi_of_match[] = { | |
1154 | { | |
1155 | .compatible = "ti,omap2-mcspi", | |
1156 | .data = &omap2_pdata, | |
1157 | }, | |
1158 | { | |
1159 | .compatible = "ti,omap4-mcspi", | |
1160 | .data = &omap4_pdata, | |
1161 | }, | |
1162 | { }, | |
1163 | }; | |
1164 | MODULE_DEVICE_TABLE(of, omap_mcspi_of_match); | |
ccc7baed | 1165 | |
fd4a319b | 1166 | static int omap2_mcspi_probe(struct platform_device *pdev) |
ccdc7bf9 SO |
1167 | { |
1168 | struct spi_master *master; | |
83a01e72 | 1169 | const struct omap2_mcspi_platform_config *pdata; |
ccdc7bf9 SO |
1170 | struct omap2_mcspi *mcspi; |
1171 | struct resource *r; | |
1172 | int status = 0, i; | |
d5a80031 BC |
1173 | u32 regs_offset = 0; |
1174 | static int bus_num = 1; | |
1175 | struct device_node *node = pdev->dev.of_node; | |
1176 | const struct of_device_id *match; | |
ec155afa | 1177 | struct pinctrl *pinctrl; |
ccdc7bf9 SO |
1178 | |
1179 | master = spi_alloc_master(&pdev->dev, sizeof *mcspi); | |
1180 | if (master == NULL) { | |
1181 | dev_dbg(&pdev->dev, "master allocation failed\n"); | |
1182 | return -ENOMEM; | |
1183 | } | |
1184 | ||
e7db06b5 DB |
1185 | /* the spi->mode bits understood by this driver: */ |
1186 | master->mode_bits = SPI_CPOL | SPI_CPHA | SPI_CS_HIGH; | |
1187 | ||
ccdc7bf9 | 1188 | master->setup = omap2_mcspi_setup; |
5fda88f5 S |
1189 | master->prepare_transfer_hardware = omap2_prepare_transfer; |
1190 | master->unprepare_transfer_hardware = omap2_unprepare_transfer; | |
1191 | master->transfer_one_message = omap2_mcspi_transfer_one_message; | |
ccdc7bf9 | 1192 | master->cleanup = omap2_mcspi_cleanup; |
d5a80031 BC |
1193 | master->dev.of_node = node; |
1194 | ||
0384e90b DM |
1195 | dev_set_drvdata(&pdev->dev, master); |
1196 | ||
1197 | mcspi = spi_master_get_devdata(master); | |
1198 | mcspi->master = master; | |
1199 | ||
d5a80031 BC |
1200 | match = of_match_device(omap_mcspi_of_match, &pdev->dev); |
1201 | if (match) { | |
1202 | u32 num_cs = 1; /* default number of chipselect */ | |
1203 | pdata = match->data; | |
1204 | ||
1205 | of_property_read_u32(node, "ti,spi-num-cs", &num_cs); | |
1206 | master->num_chipselect = num_cs; | |
1207 | master->bus_num = bus_num++; | |
2cd45179 DM |
1208 | if (of_get_property(node, "ti,pindir-d0-out-d1-in", NULL)) |
1209 | mcspi->pin_dir = MCSPI_PINDIR_D0_OUT_D1_IN; | |
d5a80031 BC |
1210 | } else { |
1211 | pdata = pdev->dev.platform_data; | |
1212 | master->num_chipselect = pdata->num_cs; | |
1213 | if (pdev->id != -1) | |
1214 | master->bus_num = pdev->id; | |
0384e90b | 1215 | mcspi->pin_dir = pdata->pin_dir; |
d5a80031 BC |
1216 | } |
1217 | regs_offset = pdata->regs_offset; | |
ccdc7bf9 | 1218 | |
ccdc7bf9 SO |
1219 | r = platform_get_resource(pdev, IORESOURCE_MEM, 0); |
1220 | if (r == NULL) { | |
1221 | status = -ENODEV; | |
39f1b565 | 1222 | goto free_master; |
ccdc7bf9 | 1223 | } |
1458d160 | 1224 | |
d5a80031 BC |
1225 | r->start += regs_offset; |
1226 | r->end += regs_offset; | |
1458d160 | 1227 | mcspi->phys = r->start; |
ccdc7bf9 | 1228 | |
b0ee5605 TR |
1229 | mcspi->base = devm_ioremap_resource(&pdev->dev, r); |
1230 | if (IS_ERR(mcspi->base)) { | |
1231 | status = PTR_ERR(mcspi->base); | |
1a77b127 | 1232 | goto free_master; |
55c381e4 | 1233 | } |
ccdc7bf9 | 1234 | |
1f1a4384 | 1235 | mcspi->dev = &pdev->dev; |
ccdc7bf9 | 1236 | |
1bd897f8 | 1237 | INIT_LIST_HEAD(&mcspi->ctx.cs); |
ccdc7bf9 | 1238 | |
ccdc7bf9 SO |
1239 | mcspi->dma_channels = kcalloc(master->num_chipselect, |
1240 | sizeof(struct omap2_mcspi_dma), | |
1241 | GFP_KERNEL); | |
1242 | ||
1243 | if (mcspi->dma_channels == NULL) | |
1a77b127 | 1244 | goto free_master; |
ccdc7bf9 | 1245 | |
1a5d8190 C |
1246 | for (i = 0; i < master->num_chipselect; i++) { |
1247 | char dma_ch_name[14]; | |
1248 | struct resource *dma_res; | |
1249 | ||
1250 | sprintf(dma_ch_name, "rx%d", i); | |
1251 | dma_res = platform_get_resource_byname(pdev, IORESOURCE_DMA, | |
18dd6199 | 1252 | dma_ch_name); |
1a5d8190 C |
1253 | if (!dma_res) { |
1254 | dev_dbg(&pdev->dev, "cannot get DMA RX channel\n"); | |
1255 | status = -ENODEV; | |
1256 | break; | |
1257 | } | |
1258 | ||
1a5d8190 C |
1259 | mcspi->dma_channels[i].dma_rx_sync_dev = dma_res->start; |
1260 | sprintf(dma_ch_name, "tx%d", i); | |
1261 | dma_res = platform_get_resource_byname(pdev, IORESOURCE_DMA, | |
18dd6199 | 1262 | dma_ch_name); |
1a5d8190 C |
1263 | if (!dma_res) { |
1264 | dev_dbg(&pdev->dev, "cannot get DMA TX channel\n"); | |
1265 | status = -ENODEV; | |
1266 | break; | |
1267 | } | |
1268 | ||
1a5d8190 | 1269 | mcspi->dma_channels[i].dma_tx_sync_dev = dma_res->start; |
ccdc7bf9 SO |
1270 | } |
1271 | ||
39f1b565 S |
1272 | if (status < 0) |
1273 | goto dma_chnl_free; | |
1274 | ||
ec155afa MP |
1275 | pinctrl = devm_pinctrl_get_select_default(&pdev->dev); |
1276 | if (IS_ERR(pinctrl)) | |
1277 | dev_warn(&pdev->dev, | |
18dd6199 | 1278 | "pins are not configured from the driver\n"); |
ec155afa | 1279 | |
27b5284c S |
1280 | pm_runtime_use_autosuspend(&pdev->dev); |
1281 | pm_runtime_set_autosuspend_delay(&pdev->dev, SPI_AUTOSUSPEND_TIMEOUT); | |
1f1a4384 G |
1282 | pm_runtime_enable(&pdev->dev); |
1283 | ||
1284 | if (status || omap2_mcspi_master_setup(mcspi) < 0) | |
39f1b565 | 1285 | goto disable_pm; |
ccdc7bf9 SO |
1286 | |
1287 | status = spi_register_master(master); | |
1288 | if (status < 0) | |
37a2d84a | 1289 | goto disable_pm; |
ccdc7bf9 SO |
1290 | |
1291 | return status; | |
1292 | ||
39f1b565 | 1293 | disable_pm: |
751c925c | 1294 | pm_runtime_disable(&pdev->dev); |
39f1b565 | 1295 | dma_chnl_free: |
1f1a4384 | 1296 | kfree(mcspi->dma_channels); |
39f1b565 | 1297 | free_master: |
37a2d84a | 1298 | spi_master_put(master); |
ccdc7bf9 SO |
1299 | return status; |
1300 | } | |
1301 | ||
fd4a319b | 1302 | static int omap2_mcspi_remove(struct platform_device *pdev) |
ccdc7bf9 SO |
1303 | { |
1304 | struct spi_master *master; | |
1305 | struct omap2_mcspi *mcspi; | |
1306 | struct omap2_mcspi_dma *dma_channels; | |
ccdc7bf9 SO |
1307 | |
1308 | master = dev_get_drvdata(&pdev->dev); | |
1309 | mcspi = spi_master_get_devdata(master); | |
1310 | dma_channels = mcspi->dma_channels; | |
1311 | ||
a93a2029 | 1312 | pm_runtime_put_sync(mcspi->dev); |
751c925c | 1313 | pm_runtime_disable(&pdev->dev); |
ccdc7bf9 SO |
1314 | |
1315 | spi_unregister_master(master); | |
1316 | kfree(dma_channels); | |
1317 | ||
1318 | return 0; | |
1319 | } | |
1320 | ||
7e38c3c4 KS |
1321 | /* work with hotplug and coldplug */ |
1322 | MODULE_ALIAS("platform:omap2_mcspi"); | |
1323 | ||
42ce7fd6 GC |
1324 | #ifdef CONFIG_SUSPEND |
1325 | /* | |
1326 | * When SPI wake up from off-mode, CS is in activate state. If it was in | |
1327 | * unactive state when driver was suspend, then force it to unactive state at | |
1328 | * wake up. | |
1329 | */ | |
1330 | static int omap2_mcspi_resume(struct device *dev) | |
1331 | { | |
1332 | struct spi_master *master = dev_get_drvdata(dev); | |
1333 | struct omap2_mcspi *mcspi = spi_master_get_devdata(master); | |
1bd897f8 BC |
1334 | struct omap2_mcspi_regs *ctx = &mcspi->ctx; |
1335 | struct omap2_mcspi_cs *cs; | |
42ce7fd6 | 1336 | |
034d3dc9 | 1337 | pm_runtime_get_sync(mcspi->dev); |
1bd897f8 | 1338 | list_for_each_entry(cs, &ctx->cs, node) { |
42ce7fd6 | 1339 | if ((cs->chconf0 & OMAP2_MCSPI_CHCONF_FORCE) == 0) { |
42ce7fd6 GC |
1340 | /* |
1341 | * We need to toggle CS state for OMAP take this | |
1342 | * change in account. | |
1343 | */ | |
af4e944d | 1344 | cs->chconf0 |= OMAP2_MCSPI_CHCONF_FORCE; |
42ce7fd6 | 1345 | __raw_writel(cs->chconf0, cs->base + OMAP2_MCSPI_CHCONF0); |
af4e944d | 1346 | cs->chconf0 &= ~OMAP2_MCSPI_CHCONF_FORCE; |
42ce7fd6 GC |
1347 | __raw_writel(cs->chconf0, cs->base + OMAP2_MCSPI_CHCONF0); |
1348 | } | |
1349 | } | |
034d3dc9 S |
1350 | pm_runtime_mark_last_busy(mcspi->dev); |
1351 | pm_runtime_put_autosuspend(mcspi->dev); | |
42ce7fd6 GC |
1352 | return 0; |
1353 | } | |
1354 | #else | |
1355 | #define omap2_mcspi_resume NULL | |
1356 | #endif | |
1357 | ||
1358 | static const struct dev_pm_ops omap2_mcspi_pm_ops = { | |
1359 | .resume = omap2_mcspi_resume, | |
1f1a4384 | 1360 | .runtime_resume = omap_mcspi_runtime_resume, |
42ce7fd6 GC |
1361 | }; |
1362 | ||
ccdc7bf9 SO |
1363 | static struct platform_driver omap2_mcspi_driver = { |
1364 | .driver = { | |
1365 | .name = "omap2_mcspi", | |
1366 | .owner = THIS_MODULE, | |
d5a80031 BC |
1367 | .pm = &omap2_mcspi_pm_ops, |
1368 | .of_match_table = omap_mcspi_of_match, | |
ccdc7bf9 | 1369 | }, |
7d6b6d83 | 1370 | .probe = omap2_mcspi_probe, |
fd4a319b | 1371 | .remove = omap2_mcspi_remove, |
ccdc7bf9 SO |
1372 | }; |
1373 | ||
9fdca9df | 1374 | module_platform_driver(omap2_mcspi_driver); |
ccdc7bf9 | 1375 | MODULE_LICENSE("GPL"); |