]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - drivers/dma/intel_mid_dma.c
intel_mid_dma: Allow IRQ sharing
[mirror_ubuntu-zesty-kernel.git] / drivers / dma / intel_mid_dma.c
CommitLineData
b3c567e4
VK
1/*
2 * intel_mid_dma.c - Intel Langwell DMA Drivers
3 *
4 * Copyright (C) 2008-10 Intel Corp
5 * Author: Vinod Koul <vinod.koul@intel.com>
6 * The driver design is based on dw_dmac driver
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; version 2 of the License.
12 *
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
21 *
22 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
23 *
24 *
25 */
26#include <linux/pci.h>
27#include <linux/interrupt.h>
53a61bad 28#include <linux/pm_runtime.h>
b3c567e4
VK
29#include <linux/intel_mid_dma.h>
30
31#define MAX_CHAN 4 /*max ch across controllers*/
32#include "intel_mid_dma_regs.h"
33
34#define INTEL_MID_DMAC1_ID 0x0814
35#define INTEL_MID_DMAC2_ID 0x0813
36#define INTEL_MID_GP_DMAC2_ID 0x0827
37#define INTEL_MFLD_DMAC1_ID 0x0830
38#define LNW_PERIPHRAL_MASK_BASE 0xFFAE8008
39#define LNW_PERIPHRAL_MASK_SIZE 0x10
40#define LNW_PERIPHRAL_STATUS 0x0
41#define LNW_PERIPHRAL_MASK 0x8
42
43struct intel_mid_dma_probe_info {
44 u8 max_chan;
45 u8 ch_base;
46 u16 block_size;
47 u32 pimr_mask;
48};
49
50#define INFO(_max_chan, _ch_base, _block_size, _pimr_mask) \
51 ((kernel_ulong_t)&(struct intel_mid_dma_probe_info) { \
52 .max_chan = (_max_chan), \
53 .ch_base = (_ch_base), \
54 .block_size = (_block_size), \
55 .pimr_mask = (_pimr_mask), \
56 })
57
58/*****************************************************************************
59Utility Functions*/
60/**
61 * get_ch_index - convert status to channel
62 * @status: status mask
63 * @base: dma ch base value
64 *
65 * Modify the status mask and return the channel index needing
66 * attention (or -1 if neither)
67 */
68static int get_ch_index(int *status, unsigned int base)
69{
70 int i;
71 for (i = 0; i < MAX_CHAN; i++) {
72 if (*status & (1 << (i + base))) {
73 *status = *status & ~(1 << (i + base));
74 pr_debug("MDMA: index %d New status %x\n", i, *status);
75 return i;
76 }
77 }
78 return -1;
79}
80
81/**
82 * get_block_ts - calculates dma transaction length
83 * @len: dma transfer length
84 * @tx_width: dma transfer src width
85 * @block_size: dma controller max block size
86 *
87 * Based on src width calculate the DMA trsaction length in data items
88 * return data items or FFFF if exceeds max length for block
89 */
90static int get_block_ts(int len, int tx_width, int block_size)
91{
92 int byte_width = 0, block_ts = 0;
93
94 switch (tx_width) {
95 case LNW_DMA_WIDTH_8BIT:
96 byte_width = 1;
97 break;
98 case LNW_DMA_WIDTH_16BIT:
99 byte_width = 2;
100 break;
101 case LNW_DMA_WIDTH_32BIT:
102 default:
103 byte_width = 4;
104 break;
105 }
106
107 block_ts = len/byte_width;
108 if (block_ts > block_size)
109 block_ts = 0xFFFF;
110 return block_ts;
111}
112
113/*****************************************************************************
114DMAC1 interrupt Functions*/
115
116/**
117 * dmac1_mask_periphral_intr - mask the periphral interrupt
118 * @midc: dma channel for which masking is required
119 *
120 * Masks the DMA periphral interrupt
121 * this is valid for DMAC1 family controllers only
122 * This controller should have periphral mask registers already mapped
123 */
124static void dmac1_mask_periphral_intr(struct intel_mid_dma_chan *midc)
125{
126 u32 pimr;
127 struct middma_device *mid = to_middma_device(midc->chan.device);
128
129 if (mid->pimr_mask) {
130 pimr = readl(mid->mask_reg + LNW_PERIPHRAL_MASK);
131 pimr |= mid->pimr_mask;
132 writel(pimr, mid->mask_reg + LNW_PERIPHRAL_MASK);
133 }
134 return;
135}
136
137/**
138 * dmac1_unmask_periphral_intr - unmask the periphral interrupt
139 * @midc: dma channel for which masking is required
140 *
141 * UnMasks the DMA periphral interrupt,
142 * this is valid for DMAC1 family controllers only
143 * This controller should have periphral mask registers already mapped
144 */
145static void dmac1_unmask_periphral_intr(struct intel_mid_dma_chan *midc)
146{
147 u32 pimr;
148 struct middma_device *mid = to_middma_device(midc->chan.device);
149
150 if (mid->pimr_mask) {
151 pimr = readl(mid->mask_reg + LNW_PERIPHRAL_MASK);
152 pimr &= ~mid->pimr_mask;
153 writel(pimr, mid->mask_reg + LNW_PERIPHRAL_MASK);
154 }
155 return;
156}
157
158/**
159 * enable_dma_interrupt - enable the periphral interrupt
160 * @midc: dma channel for which enable interrupt is required
161 *
162 * Enable the DMA periphral interrupt,
163 * this is valid for DMAC1 family controllers only
164 * This controller should have periphral mask registers already mapped
165 */
166static void enable_dma_interrupt(struct intel_mid_dma_chan *midc)
167{
168 dmac1_unmask_periphral_intr(midc);
169
170 /*en ch interrupts*/
171 iowrite32(UNMASK_INTR_REG(midc->ch_id), midc->dma_base + MASK_TFR);
172 iowrite32(UNMASK_INTR_REG(midc->ch_id), midc->dma_base + MASK_ERR);
173 return;
174}
175
176/**
177 * disable_dma_interrupt - disable the periphral interrupt
178 * @midc: dma channel for which disable interrupt is required
179 *
180 * Disable the DMA periphral interrupt,
181 * this is valid for DMAC1 family controllers only
182 * This controller should have periphral mask registers already mapped
183 */
184static void disable_dma_interrupt(struct intel_mid_dma_chan *midc)
185{
186 /*Check LPE PISR, make sure fwd is disabled*/
187 dmac1_mask_periphral_intr(midc);
188 iowrite32(MASK_INTR_REG(midc->ch_id), midc->dma_base + MASK_BLOCK);
189 iowrite32(MASK_INTR_REG(midc->ch_id), midc->dma_base + MASK_TFR);
190 iowrite32(MASK_INTR_REG(midc->ch_id), midc->dma_base + MASK_ERR);
191 return;
192}
193
194/*****************************************************************************
195DMA channel helper Functions*/
196/**
197 * mid_desc_get - get a descriptor
198 * @midc: dma channel for which descriptor is required
199 *
200 * Obtain a descriptor for the channel. Returns NULL if none are free.
201 * Once the descriptor is returned it is private until put on another
202 * list or freed
203 */
204static struct intel_mid_dma_desc *midc_desc_get(struct intel_mid_dma_chan *midc)
205{
206 struct intel_mid_dma_desc *desc, *_desc;
207 struct intel_mid_dma_desc *ret = NULL;
208
209 spin_lock_bh(&midc->lock);
210 list_for_each_entry_safe(desc, _desc, &midc->free_list, desc_node) {
211 if (async_tx_test_ack(&desc->txd)) {
212 list_del(&desc->desc_node);
213 ret = desc;
214 break;
215 }
216 }
217 spin_unlock_bh(&midc->lock);
218 return ret;
219}
220
221/**
222 * mid_desc_put - put a descriptor
223 * @midc: dma channel for which descriptor is required
224 * @desc: descriptor to put
225 *
226 * Return a descriptor from lwn_desc_get back to the free pool
227 */
228static void midc_desc_put(struct intel_mid_dma_chan *midc,
229 struct intel_mid_dma_desc *desc)
230{
231 if (desc) {
232 spin_lock_bh(&midc->lock);
233 list_add_tail(&desc->desc_node, &midc->free_list);
234 spin_unlock_bh(&midc->lock);
235 }
236}
237/**
238 * midc_dostart - begin a DMA transaction
239 * @midc: channel for which txn is to be started
240 * @first: first descriptor of series
241 *
242 * Load a transaction into the engine. This must be called with midc->lock
243 * held and bh disabled.
244 */
245static void midc_dostart(struct intel_mid_dma_chan *midc,
246 struct intel_mid_dma_desc *first)
247{
248 struct middma_device *mid = to_middma_device(midc->chan.device);
249
250 /* channel is idle */
53a61bad 251 if (midc->busy && test_ch_en(midc->dma_base, midc->ch_id)) {
b3c567e4
VK
252 /*error*/
253 pr_err("ERR_MDMA: channel is busy in start\n");
254 /* The tasklet will hopefully advance the queue... */
255 return;
256 }
53a61bad 257 midc->busy = true;
b3c567e4
VK
258 /*write registers and en*/
259 iowrite32(first->sar, midc->ch_regs + SAR);
260 iowrite32(first->dar, midc->ch_regs + DAR);
261 iowrite32(first->cfg_hi, midc->ch_regs + CFG_HIGH);
262 iowrite32(first->cfg_lo, midc->ch_regs + CFG_LOW);
263 iowrite32(first->ctl_lo, midc->ch_regs + CTL_LOW);
264 iowrite32(first->ctl_hi, midc->ch_regs + CTL_HIGH);
265 pr_debug("MDMA:TX SAR %x,DAR %x,CFGL %x,CFGH %x,CTLH %x, CTLL %x\n",
266 (int)first->sar, (int)first->dar, first->cfg_hi,
267 first->cfg_lo, first->ctl_hi, first->ctl_lo);
268
269 iowrite32(ENABLE_CHANNEL(midc->ch_id), mid->dma_base + DMA_CHAN_EN);
270 first->status = DMA_IN_PROGRESS;
271}
272
273/**
274 * midc_descriptor_complete - process completed descriptor
275 * @midc: channel owning the descriptor
276 * @desc: the descriptor itself
277 *
278 * Process a completed descriptor and perform any callbacks upon
279 * the completion. The completion handling drops the lock during the
280 * callbacks but must be called with the lock held.
281 */
282static void midc_descriptor_complete(struct intel_mid_dma_chan *midc,
283 struct intel_mid_dma_desc *desc)
284{
285 struct dma_async_tx_descriptor *txd = &desc->txd;
286 dma_async_tx_callback callback_txd = NULL;
287 void *param_txd = NULL;
288
289 midc->completed = txd->cookie;
290 callback_txd = txd->callback;
291 param_txd = txd->callback_param;
292
293 list_move(&desc->desc_node, &midc->free_list);
53a61bad 294 midc->busy = false;
b3c567e4
VK
295 spin_unlock_bh(&midc->lock);
296 if (callback_txd) {
297 pr_debug("MDMA: TXD callback set ... calling\n");
298 callback_txd(param_txd);
299 spin_lock_bh(&midc->lock);
300 return;
301 }
302 spin_lock_bh(&midc->lock);
303
304}
305/**
306 * midc_scan_descriptors - check the descriptors in channel
307 * mark completed when tx is completete
308 * @mid: device
309 * @midc: channel to scan
310 *
311 * Walk the descriptor chain for the device and process any entries
312 * that are complete.
313 */
314static void midc_scan_descriptors(struct middma_device *mid,
315 struct intel_mid_dma_chan *midc)
316{
317 struct intel_mid_dma_desc *desc = NULL, *_desc = NULL;
318
319 /*tx is complete*/
320 list_for_each_entry_safe(desc, _desc, &midc->active_list, desc_node) {
321 if (desc->status == DMA_IN_PROGRESS) {
322 desc->status = DMA_SUCCESS;
323 midc_descriptor_complete(midc, desc);
324 }
325 }
326 return;
327}
328
329/*****************************************************************************
330DMA engine callback Functions*/
331/**
332 * intel_mid_dma_tx_submit - callback to submit DMA transaction
333 * @tx: dma engine descriptor
334 *
335 * Submit the DMA trasaction for this descriptor, start if ch idle
336 */
337static dma_cookie_t intel_mid_dma_tx_submit(struct dma_async_tx_descriptor *tx)
338{
339 struct intel_mid_dma_desc *desc = to_intel_mid_dma_desc(tx);
340 struct intel_mid_dma_chan *midc = to_intel_mid_dma_chan(tx->chan);
341 dma_cookie_t cookie;
342
343 spin_lock_bh(&midc->lock);
344 cookie = midc->chan.cookie;
345
346 if (++cookie < 0)
347 cookie = 1;
348
349 midc->chan.cookie = cookie;
350 desc->txd.cookie = cookie;
351
352
353 if (list_empty(&midc->active_list)) {
354 midc_dostart(midc, desc);
355 list_add_tail(&desc->desc_node, &midc->active_list);
356 } else {
357 list_add_tail(&desc->desc_node, &midc->queue);
358 }
359 spin_unlock_bh(&midc->lock);
360
361 return cookie;
362}
363
364/**
365 * intel_mid_dma_issue_pending - callback to issue pending txn
366 * @chan: chan where pending trascation needs to be checked and submitted
367 *
368 * Call for scan to issue pending descriptors
369 */
370static void intel_mid_dma_issue_pending(struct dma_chan *chan)
371{
372 struct intel_mid_dma_chan *midc = to_intel_mid_dma_chan(chan);
373
374 spin_lock_bh(&midc->lock);
375 if (!list_empty(&midc->queue))
376 midc_scan_descriptors(to_middma_device(chan->device), midc);
377 spin_unlock_bh(&midc->lock);
378}
379
380/**
381 * intel_mid_dma_tx_status - Return status of txn
382 * @chan: chan for where status needs to be checked
383 * @cookie: cookie for txn
384 * @txstate: DMA txn state
385 *
386 * Return status of DMA txn
387 */
388static enum dma_status intel_mid_dma_tx_status(struct dma_chan *chan,
389 dma_cookie_t cookie,
390 struct dma_tx_state *txstate)
391{
392 struct intel_mid_dma_chan *midc = to_intel_mid_dma_chan(chan);
393 dma_cookie_t last_used;
394 dma_cookie_t last_complete;
395 int ret;
396
397 last_complete = midc->completed;
398 last_used = chan->cookie;
399
400 ret = dma_async_is_complete(cookie, last_complete, last_used);
401 if (ret != DMA_SUCCESS) {
402 midc_scan_descriptors(to_middma_device(chan->device), midc);
403
404 last_complete = midc->completed;
405 last_used = chan->cookie;
406
407 ret = dma_async_is_complete(cookie, last_complete, last_used);
408 }
409
410 if (txstate) {
411 txstate->last = last_complete;
412 txstate->used = last_used;
413 txstate->residue = 0;
414 }
415 return ret;
416}
417
418/**
419 * intel_mid_dma_device_control - DMA device control
420 * @chan: chan for DMA control
421 * @cmd: control cmd
422 * @arg: cmd arg value
423 *
424 * Perform DMA control command
425 */
426static int intel_mid_dma_device_control(struct dma_chan *chan,
427 enum dma_ctrl_cmd cmd, unsigned long arg)
428{
429 struct intel_mid_dma_chan *midc = to_intel_mid_dma_chan(chan);
430 struct middma_device *mid = to_middma_device(chan->device);
431 struct intel_mid_dma_desc *desc, *_desc;
432 LIST_HEAD(list);
433
434 if (cmd != DMA_TERMINATE_ALL)
435 return -ENXIO;
436
437 spin_lock_bh(&midc->lock);
53a61bad 438 if (midc->busy == false) {
b3c567e4
VK
439 spin_unlock_bh(&midc->lock);
440 return 0;
441 }
442 list_splice_init(&midc->free_list, &list);
443 midc->descs_allocated = 0;
444 midc->slave = NULL;
445
446 /* Disable interrupts */
447 disable_dma_interrupt(midc);
448
449 spin_unlock_bh(&midc->lock);
450 list_for_each_entry_safe(desc, _desc, &list, desc_node) {
451 pr_debug("MDMA: freeing descriptor %p\n", desc);
452 pci_pool_free(mid->dma_pool, desc, desc->txd.phys);
453 }
454 return 0;
455}
456
457/**
458 * intel_mid_dma_prep_slave_sg - Prep slave sg txn
459 * @chan: chan for DMA transfer
460 * @sgl: scatter gather list
461 * @sg_len: length of sg txn
462 * @direction: DMA transfer dirtn
463 * @flags: DMA flags
464 *
465 * Do DMA sg txn: NOT supported now
466 */
467static struct dma_async_tx_descriptor *intel_mid_dma_prep_slave_sg(
468 struct dma_chan *chan, struct scatterlist *sgl,
469 unsigned int sg_len, enum dma_data_direction direction,
470 unsigned long flags)
471{
472 /*not supported now*/
473 return NULL;
474}
475
476/**
477 * intel_mid_dma_prep_memcpy - Prep memcpy txn
478 * @chan: chan for DMA transfer
479 * @dest: destn address
480 * @src: src address
481 * @len: DMA transfer len
482 * @flags: DMA flags
483 *
484 * Perform a DMA memcpy. Note we support slave periphral DMA transfers only
485 * The periphral txn details should be filled in slave structure properly
486 * Returns the descriptor for this txn
487 */
488static struct dma_async_tx_descriptor *intel_mid_dma_prep_memcpy(
489 struct dma_chan *chan, dma_addr_t dest,
490 dma_addr_t src, size_t len, unsigned long flags)
491{
492 struct intel_mid_dma_chan *midc;
493 struct intel_mid_dma_desc *desc = NULL;
494 struct intel_mid_dma_slave *mids;
495 union intel_mid_dma_ctl_lo ctl_lo;
496 union intel_mid_dma_ctl_hi ctl_hi;
497 union intel_mid_dma_cfg_lo cfg_lo;
498 union intel_mid_dma_cfg_hi cfg_hi;
499 enum intel_mid_dma_width width = 0;
500
501 pr_debug("MDMA: Prep for memcpy\n");
502 WARN_ON(!chan);
503 if (!len)
504 return NULL;
505
506 mids = chan->private;
507 WARN_ON(!mids);
508
509 midc = to_intel_mid_dma_chan(chan);
510 WARN_ON(!midc);
511
512 pr_debug("MDMA:called for DMA %x CH %d Length %zu\n",
513 midc->dma->pci_id, midc->ch_id, len);
514 pr_debug("MDMA:Cfg passed Mode %x, Dirn %x, HS %x, Width %x\n",
515 mids->cfg_mode, mids->dirn, mids->hs_mode, mids->src_width);
516
517 /*calculate CFG_LO*/
518 if (mids->hs_mode == LNW_DMA_SW_HS) {
519 cfg_lo.cfg_lo = 0;
520 cfg_lo.cfgx.hs_sel_dst = 1;
521 cfg_lo.cfgx.hs_sel_src = 1;
522 } else if (mids->hs_mode == LNW_DMA_HW_HS)
523 cfg_lo.cfg_lo = 0x00000;
524
525 /*calculate CFG_HI*/
526 if (mids->cfg_mode == LNW_DMA_MEM_TO_MEM) {
527 /*SW HS only*/
528 cfg_hi.cfg_hi = 0;
529 } else {
530 cfg_hi.cfg_hi = 0;
531 if (midc->dma->pimr_mask) {
532 cfg_hi.cfgx.protctl = 0x0; /*default value*/
533 cfg_hi.cfgx.fifo_mode = 1;
534 if (mids->dirn == DMA_TO_DEVICE) {
535 cfg_hi.cfgx.src_per = 0;
536 if (mids->device_instance == 0)
537 cfg_hi.cfgx.dst_per = 3;
538 if (mids->device_instance == 1)
539 cfg_hi.cfgx.dst_per = 1;
540 } else if (mids->dirn == DMA_FROM_DEVICE) {
541 if (mids->device_instance == 0)
542 cfg_hi.cfgx.src_per = 2;
543 if (mids->device_instance == 1)
544 cfg_hi.cfgx.src_per = 0;
545 cfg_hi.cfgx.dst_per = 0;
546 }
547 } else {
548 cfg_hi.cfgx.protctl = 0x1; /*default value*/
549 cfg_hi.cfgx.src_per = cfg_hi.cfgx.dst_per =
550 midc->ch_id - midc->dma->chan_base;
551 }
552 }
553
554 /*calculate CTL_HI*/
555 ctl_hi.ctlx.reser = 0;
556 width = mids->src_width;
557
558 ctl_hi.ctlx.block_ts = get_block_ts(len, width, midc->dma->block_size);
559 pr_debug("MDMA:calc len %d for block size %d\n",
560 ctl_hi.ctlx.block_ts, midc->dma->block_size);
561 /*calculate CTL_LO*/
562 ctl_lo.ctl_lo = 0;
563 ctl_lo.ctlx.int_en = 1;
564 ctl_lo.ctlx.dst_tr_width = mids->dst_width;
565 ctl_lo.ctlx.src_tr_width = mids->src_width;
566 ctl_lo.ctlx.dst_msize = mids->src_msize;
567 ctl_lo.ctlx.src_msize = mids->dst_msize;
568
569 if (mids->cfg_mode == LNW_DMA_MEM_TO_MEM) {
570 ctl_lo.ctlx.tt_fc = 0;
571 ctl_lo.ctlx.sinc = 0;
572 ctl_lo.ctlx.dinc = 0;
573 } else {
574 if (mids->dirn == DMA_TO_DEVICE) {
575 ctl_lo.ctlx.sinc = 0;
576 ctl_lo.ctlx.dinc = 2;
577 ctl_lo.ctlx.tt_fc = 1;
578 } else if (mids->dirn == DMA_FROM_DEVICE) {
579 ctl_lo.ctlx.sinc = 2;
580 ctl_lo.ctlx.dinc = 0;
581 ctl_lo.ctlx.tt_fc = 2;
582 }
583 }
584
585 pr_debug("MDMA:Calc CTL LO %x, CTL HI %x, CFG LO %x, CFG HI %x\n",
586 ctl_lo.ctl_lo, ctl_hi.ctl_hi, cfg_lo.cfg_lo, cfg_hi.cfg_hi);
587
588 enable_dma_interrupt(midc);
589
590 desc = midc_desc_get(midc);
591 if (desc == NULL)
592 goto err_desc_get;
593 desc->sar = src;
594 desc->dar = dest ;
595 desc->len = len;
596 desc->cfg_hi = cfg_hi.cfg_hi;
597 desc->cfg_lo = cfg_lo.cfg_lo;
598 desc->ctl_lo = ctl_lo.ctl_lo;
599 desc->ctl_hi = ctl_hi.ctl_hi;
600 desc->width = width;
601 desc->dirn = mids->dirn;
602 return &desc->txd;
603
604err_desc_get:
605 pr_err("ERR_MDMA: Failed to get desc\n");
606 midc_desc_put(midc, desc);
607 return NULL;
608}
609
610/**
611 * intel_mid_dma_free_chan_resources - Frees dma resources
612 * @chan: chan requiring attention
613 *
614 * Frees the allocated resources on this DMA chan
615 */
616static void intel_mid_dma_free_chan_resources(struct dma_chan *chan)
617{
618 struct intel_mid_dma_chan *midc = to_intel_mid_dma_chan(chan);
619 struct middma_device *mid = to_middma_device(chan->device);
620 struct intel_mid_dma_desc *desc, *_desc;
621
53a61bad 622 if (true == midc->busy) {
b3c567e4
VK
623 /*trying to free ch in use!!!!!*/
624 pr_err("ERR_MDMA: trying to free ch in use\n");
625 }
53a61bad 626 pm_runtime_put(&mid->pdev->dev);
b3c567e4
VK
627 spin_lock_bh(&midc->lock);
628 midc->descs_allocated = 0;
629 list_for_each_entry_safe(desc, _desc, &midc->active_list, desc_node) {
630 list_del(&desc->desc_node);
631 pci_pool_free(mid->dma_pool, desc, desc->txd.phys);
632 }
633 list_for_each_entry_safe(desc, _desc, &midc->free_list, desc_node) {
634 list_del(&desc->desc_node);
635 pci_pool_free(mid->dma_pool, desc, desc->txd.phys);
636 }
637 list_for_each_entry_safe(desc, _desc, &midc->queue, desc_node) {
638 list_del(&desc->desc_node);
639 pci_pool_free(mid->dma_pool, desc, desc->txd.phys);
640 }
641 spin_unlock_bh(&midc->lock);
642 midc->in_use = false;
53a61bad 643 midc->busy = false;
b3c567e4
VK
644 /* Disable CH interrupts */
645 iowrite32(MASK_INTR_REG(midc->ch_id), mid->dma_base + MASK_BLOCK);
646 iowrite32(MASK_INTR_REG(midc->ch_id), mid->dma_base + MASK_ERR);
647}
648
649/**
650 * intel_mid_dma_alloc_chan_resources - Allocate dma resources
651 * @chan: chan requiring attention
652 *
653 * Allocates DMA resources on this chan
654 * Return the descriptors allocated
655 */
656static int intel_mid_dma_alloc_chan_resources(struct dma_chan *chan)
657{
658 struct intel_mid_dma_chan *midc = to_intel_mid_dma_chan(chan);
659 struct middma_device *mid = to_middma_device(chan->device);
660 struct intel_mid_dma_desc *desc;
661 dma_addr_t phys;
662 int i = 0;
663
53a61bad
KV
664 pm_runtime_get_sync(&mid->pdev->dev);
665
666 if (mid->state == SUSPENDED) {
667 if (dma_resume(mid->pdev)) {
668 pr_err("ERR_MDMA: resume failed");
669 return -EFAULT;
670 }
671 }
b3c567e4
VK
672
673 /* ASSERT: channel is idle */
674 if (test_ch_en(mid->dma_base, midc->ch_id)) {
675 /*ch is not idle*/
676 pr_err("ERR_MDMA: ch not idle\n");
53a61bad 677 pm_runtime_put(&mid->pdev->dev);
b3c567e4
VK
678 return -EIO;
679 }
680 midc->completed = chan->cookie = 1;
681
682 spin_lock_bh(&midc->lock);
683 while (midc->descs_allocated < DESCS_PER_CHANNEL) {
684 spin_unlock_bh(&midc->lock);
685 desc = pci_pool_alloc(mid->dma_pool, GFP_KERNEL, &phys);
686 if (!desc) {
687 pr_err("ERR_MDMA: desc failed\n");
53a61bad 688 pm_runtime_put(&mid->pdev->dev);
b3c567e4
VK
689 return -ENOMEM;
690 /*check*/
691 }
692 dma_async_tx_descriptor_init(&desc->txd, chan);
693 desc->txd.tx_submit = intel_mid_dma_tx_submit;
694 desc->txd.flags = DMA_CTRL_ACK;
695 desc->txd.phys = phys;
696 spin_lock_bh(&midc->lock);
697 i = ++midc->descs_allocated;
698 list_add_tail(&desc->desc_node, &midc->free_list);
699 }
700 spin_unlock_bh(&midc->lock);
53a61bad
KV
701 midc->in_use = true;
702 midc->busy = false;
b3c567e4
VK
703 pr_debug("MID_DMA: Desc alloc done ret: %d desc\n", i);
704 return i;
705}
706
707/**
708 * midc_handle_error - Handle DMA txn error
709 * @mid: controller where error occured
710 * @midc: chan where error occured
711 *
712 * Scan the descriptor for error
713 */
714static void midc_handle_error(struct middma_device *mid,
715 struct intel_mid_dma_chan *midc)
716{
717 midc_scan_descriptors(mid, midc);
718}
719
720/**
721 * dma_tasklet - DMA interrupt tasklet
722 * @data: tasklet arg (the controller structure)
723 *
724 * Scan the controller for interrupts for completion/error
725 * Clear the interrupt and call for handling completion/error
726 */
727static void dma_tasklet(unsigned long data)
728{
729 struct middma_device *mid = NULL;
730 struct intel_mid_dma_chan *midc = NULL;
731 u32 status;
732 int i;
733
734 mid = (struct middma_device *)data;
735 if (mid == NULL) {
736 pr_err("ERR_MDMA: tasklet Null param\n");
737 return;
738 }
739 pr_debug("MDMA: in tasklet for device %x\n", mid->pci_id);
740 status = ioread32(mid->dma_base + RAW_TFR);
741 pr_debug("MDMA:RAW_TFR %x\n", status);
742 status &= mid->intr_mask;
743 while (status) {
744 /*txn interrupt*/
745 i = get_ch_index(&status, mid->chan_base);
746 if (i < 0) {
747 pr_err("ERR_MDMA:Invalid ch index %x\n", i);
748 return;
749 }
750 midc = &mid->ch[i];
751 if (midc == NULL) {
752 pr_err("ERR_MDMA:Null param midc\n");
753 return;
754 }
755 pr_debug("MDMA:Tx complete interrupt %x, Ch No %d Index %d\n",
756 status, midc->ch_id, i);
757 /*clearing this interrupts first*/
758 iowrite32((1 << midc->ch_id), mid->dma_base + CLEAR_TFR);
759 iowrite32((1 << midc->ch_id), mid->dma_base + CLEAR_BLOCK);
760
761 spin_lock_bh(&midc->lock);
762 midc_scan_descriptors(mid, midc);
763 pr_debug("MDMA:Scan of desc... complete, unmasking\n");
764 iowrite32(UNMASK_INTR_REG(midc->ch_id),
765 mid->dma_base + MASK_TFR);
766 spin_unlock_bh(&midc->lock);
767 }
768
769 status = ioread32(mid->dma_base + RAW_ERR);
770 status &= mid->intr_mask;
771 while (status) {
772 /*err interrupt*/
773 i = get_ch_index(&status, mid->chan_base);
774 if (i < 0) {
775 pr_err("ERR_MDMA:Invalid ch index %x\n", i);
776 return;
777 }
778 midc = &mid->ch[i];
779 if (midc == NULL) {
780 pr_err("ERR_MDMA:Null param midc\n");
781 return;
782 }
783 pr_debug("MDMA:Tx complete interrupt %x, Ch No %d Index %d\n",
784 status, midc->ch_id, i);
785
786 iowrite32((1 << midc->ch_id), mid->dma_base + CLEAR_ERR);
787 spin_lock_bh(&midc->lock);
788 midc_handle_error(mid, midc);
789 iowrite32(UNMASK_INTR_REG(midc->ch_id),
790 mid->dma_base + MASK_ERR);
791 spin_unlock_bh(&midc->lock);
792 }
793 pr_debug("MDMA:Exiting takslet...\n");
794 return;
795}
796
797static void dma_tasklet1(unsigned long data)
798{
799 pr_debug("MDMA:in takslet1...\n");
800 return dma_tasklet(data);
801}
802
803static void dma_tasklet2(unsigned long data)
804{
805 pr_debug("MDMA:in takslet2...\n");
806 return dma_tasklet(data);
807}
808
809/**
810 * intel_mid_dma_interrupt - DMA ISR
811 * @irq: IRQ where interrupt occurred
812 * @data: ISR cllback data (the controller structure)
813 *
814 * See if this is our interrupt if so then schedule the tasklet
815 * otherwise ignore
816 */
817static irqreturn_t intel_mid_dma_interrupt(int irq, void *data)
818{
819 struct middma_device *mid = data;
b306df5e 820 u32 tfr_status, err_status;
b3c567e4
VK
821 int call_tasklet = 0;
822
b306df5e
YW
823 tfr_status = ioread32(mid->dma_base + RAW_TFR);
824 err_status = ioread32(mid->dma_base + RAW_ERR);
825 if (!tfr_status && !err_status)
826 return IRQ_NONE;
827
b3c567e4
VK
828 /*DMA Interrupt*/
829 pr_debug("MDMA:Got an interrupt on irq %d\n", irq);
830 if (!mid) {
831 pr_err("ERR_MDMA:null pointer mid\n");
832 return -EINVAL;
833 }
834
b306df5e
YW
835 pr_debug("MDMA: Status %x, Mask %x\n", tfr_status, mid->intr_mask);
836 tfr_status &= mid->intr_mask;
837 if (tfr_status) {
b3c567e4 838 /*need to disable intr*/
b306df5e
YW
839 iowrite32((tfr_status << 8), mid->dma_base + MASK_TFR);
840 pr_debug("MDMA: Calling tasklet %x\n", tfr_status);
b3c567e4
VK
841 call_tasklet = 1;
842 }
b306df5e
YW
843 err_status &= mid->intr_mask;
844 if (err_status) {
845 iowrite32(MASK_INTR_REG(err_status), mid->dma_base + MASK_ERR);
b3c567e4
VK
846 call_tasklet = 1;
847 }
848 if (call_tasklet)
849 tasklet_schedule(&mid->tasklet);
850
851 return IRQ_HANDLED;
852}
853
854static irqreturn_t intel_mid_dma_interrupt1(int irq, void *data)
855{
856 return intel_mid_dma_interrupt(irq, data);
857}
858
859static irqreturn_t intel_mid_dma_interrupt2(int irq, void *data)
860{
861 return intel_mid_dma_interrupt(irq, data);
862}
863
864/**
865 * mid_setup_dma - Setup the DMA controller
866 * @pdev: Controller PCI device structure
867 *
868 * Initilize the DMA controller, channels, registers with DMA engine,
869 * ISR. Initilize DMA controller channels.
870 */
871static int mid_setup_dma(struct pci_dev *pdev)
872{
873 struct middma_device *dma = pci_get_drvdata(pdev);
874 int err, i;
875 unsigned int irq_level;
876
877 /* DMA coherent memory pool for DMA descriptor allocations */
878 dma->dma_pool = pci_pool_create("intel_mid_dma_desc_pool", pdev,
879 sizeof(struct intel_mid_dma_desc),
880 32, 0);
881 if (NULL == dma->dma_pool) {
882 pr_err("ERR_MDMA:pci_pool_create failed\n");
883 err = -ENOMEM;
884 kfree(dma);
885 goto err_dma_pool;
886 }
887
888 INIT_LIST_HEAD(&dma->common.channels);
889 dma->pci_id = pdev->device;
890 if (dma->pimr_mask) {
891 dma->mask_reg = ioremap(LNW_PERIPHRAL_MASK_BASE,
892 LNW_PERIPHRAL_MASK_SIZE);
893 if (dma->mask_reg == NULL) {
894 pr_err("ERR_MDMA:Cant map periphral intr space !!\n");
895 return -ENOMEM;
896 }
897 } else
898 dma->mask_reg = NULL;
899
900 pr_debug("MDMA:Adding %d channel for this controller\n", dma->max_chan);
901 /*init CH structures*/
902 dma->intr_mask = 0;
53a61bad 903 dma->state = RUNNING;
b3c567e4
VK
904 for (i = 0; i < dma->max_chan; i++) {
905 struct intel_mid_dma_chan *midch = &dma->ch[i];
906
907 midch->chan.device = &dma->common;
908 midch->chan.cookie = 1;
909 midch->chan.chan_id = i;
910 midch->ch_id = dma->chan_base + i;
911 pr_debug("MDMA:Init CH %d, ID %d\n", i, midch->ch_id);
912
913 midch->dma_base = dma->dma_base;
914 midch->ch_regs = dma->dma_base + DMA_CH_SIZE * midch->ch_id;
915 midch->dma = dma;
916 dma->intr_mask |= 1 << (dma->chan_base + i);
917 spin_lock_init(&midch->lock);
918
919 INIT_LIST_HEAD(&midch->active_list);
920 INIT_LIST_HEAD(&midch->queue);
921 INIT_LIST_HEAD(&midch->free_list);
922 /*mask interrupts*/
923 iowrite32(MASK_INTR_REG(midch->ch_id),
924 dma->dma_base + MASK_BLOCK);
925 iowrite32(MASK_INTR_REG(midch->ch_id),
926 dma->dma_base + MASK_SRC_TRAN);
927 iowrite32(MASK_INTR_REG(midch->ch_id),
928 dma->dma_base + MASK_DST_TRAN);
929 iowrite32(MASK_INTR_REG(midch->ch_id),
930 dma->dma_base + MASK_ERR);
931 iowrite32(MASK_INTR_REG(midch->ch_id),
932 dma->dma_base + MASK_TFR);
933
934 disable_dma_interrupt(midch);
935 list_add_tail(&midch->chan.device_node, &dma->common.channels);
936 }
937 pr_debug("MDMA: Calc Mask as %x for this controller\n", dma->intr_mask);
938
939 /*init dma structure*/
940 dma_cap_zero(dma->common.cap_mask);
941 dma_cap_set(DMA_MEMCPY, dma->common.cap_mask);
942 dma_cap_set(DMA_SLAVE, dma->common.cap_mask);
943 dma_cap_set(DMA_PRIVATE, dma->common.cap_mask);
944 dma->common.dev = &pdev->dev;
945 dma->common.chancnt = dma->max_chan;
946
947 dma->common.device_alloc_chan_resources =
948 intel_mid_dma_alloc_chan_resources;
949 dma->common.device_free_chan_resources =
950 intel_mid_dma_free_chan_resources;
951
952 dma->common.device_tx_status = intel_mid_dma_tx_status;
953 dma->common.device_prep_dma_memcpy = intel_mid_dma_prep_memcpy;
954 dma->common.device_issue_pending = intel_mid_dma_issue_pending;
955 dma->common.device_prep_slave_sg = intel_mid_dma_prep_slave_sg;
956 dma->common.device_control = intel_mid_dma_device_control;
957
958 /*enable dma cntrl*/
959 iowrite32(REG_BIT0, dma->dma_base + DMA_CFG);
960
961 /*register irq */
962 if (dma->pimr_mask) {
963 irq_level = IRQF_SHARED;
964 pr_debug("MDMA:Requesting irq shared for DMAC1\n");
965 err = request_irq(pdev->irq, intel_mid_dma_interrupt1,
966 IRQF_SHARED, "INTEL_MID_DMAC1", dma);
967 if (0 != err)
968 goto err_irq;
969 } else {
970 dma->intr_mask = 0x03;
971 irq_level = 0;
972 pr_debug("MDMA:Requesting irq for DMAC2\n");
973 err = request_irq(pdev->irq, intel_mid_dma_interrupt2,
974 0, "INTEL_MID_DMAC2", dma);
975 if (0 != err)
976 goto err_irq;
977 }
978 /*register device w/ engine*/
979 err = dma_async_device_register(&dma->common);
980 if (0 != err) {
981 pr_err("ERR_MDMA:device_register failed: %d\n", err);
982 goto err_engine;
983 }
984 if (dma->pimr_mask) {
985 pr_debug("setting up tasklet1 for DMAC1\n");
986 tasklet_init(&dma->tasklet, dma_tasklet1, (unsigned long)dma);
987 } else {
988 pr_debug("setting up tasklet2 for DMAC2\n");
989 tasklet_init(&dma->tasklet, dma_tasklet2, (unsigned long)dma);
990 }
991 return 0;
992
993err_engine:
994 free_irq(pdev->irq, dma);
995err_irq:
996 pci_pool_destroy(dma->dma_pool);
997 kfree(dma);
998err_dma_pool:
999 pr_err("ERR_MDMA:setup_dma failed: %d\n", err);
1000 return err;
1001
1002}
1003
1004/**
1005 * middma_shutdown - Shutdown the DMA controller
1006 * @pdev: Controller PCI device structure
1007 *
1008 * Called by remove
1009 * Unregister DMa controller, clear all structures and free interrupt
1010 */
1011static void middma_shutdown(struct pci_dev *pdev)
1012{
1013 struct middma_device *device = pci_get_drvdata(pdev);
1014
1015 dma_async_device_unregister(&device->common);
1016 pci_pool_destroy(device->dma_pool);
1017 if (device->mask_reg)
1018 iounmap(device->mask_reg);
1019 if (device->dma_base)
1020 iounmap(device->dma_base);
1021 free_irq(pdev->irq, device);
1022 return;
1023}
1024
1025/**
1026 * intel_mid_dma_probe - PCI Probe
1027 * @pdev: Controller PCI device structure
1028 * @id: pci device id structure
1029 *
1030 * Initilize the PCI device, map BARs, query driver data.
1031 * Call setup_dma to complete contoller and chan initilzation
1032 */
1033static int __devinit intel_mid_dma_probe(struct pci_dev *pdev,
1034 const struct pci_device_id *id)
1035{
1036 struct middma_device *device;
1037 u32 base_addr, bar_size;
1038 struct intel_mid_dma_probe_info *info;
1039 int err;
1040
1041 pr_debug("MDMA: probe for %x\n", pdev->device);
1042 info = (void *)id->driver_data;
1043 pr_debug("MDMA: CH %d, base %d, block len %d, Periphral mask %x\n",
1044 info->max_chan, info->ch_base,
1045 info->block_size, info->pimr_mask);
1046
1047 err = pci_enable_device(pdev);
1048 if (err)
1049 goto err_enable_device;
1050
1051 err = pci_request_regions(pdev, "intel_mid_dmac");
1052 if (err)
1053 goto err_request_regions;
1054
1055 err = pci_set_dma_mask(pdev, DMA_BIT_MASK(32));
1056 if (err)
1057 goto err_set_dma_mask;
1058
1059 err = pci_set_consistent_dma_mask(pdev, DMA_BIT_MASK(32));
1060 if (err)
1061 goto err_set_dma_mask;
1062
1063 device = kzalloc(sizeof(*device), GFP_KERNEL);
1064 if (!device) {
1065 pr_err("ERR_MDMA:kzalloc failed probe\n");
1066 err = -ENOMEM;
1067 goto err_kzalloc;
1068 }
1069 device->pdev = pci_dev_get(pdev);
1070
1071 base_addr = pci_resource_start(pdev, 0);
1072 bar_size = pci_resource_len(pdev, 0);
1073 device->dma_base = ioremap_nocache(base_addr, DMA_REG_SIZE);
1074 if (!device->dma_base) {
1075 pr_err("ERR_MDMA:ioremap failed\n");
1076 err = -ENOMEM;
1077 goto err_ioremap;
1078 }
1079 pci_set_drvdata(pdev, device);
1080 pci_set_master(pdev);
1081 device->max_chan = info->max_chan;
1082 device->chan_base = info->ch_base;
1083 device->block_size = info->block_size;
1084 device->pimr_mask = info->pimr_mask;
1085
1086 err = mid_setup_dma(pdev);
1087 if (err)
1088 goto err_dma;
1089
53a61bad
KV
1090 pm_runtime_set_active(&pdev->dev);
1091 pm_runtime_enable(&pdev->dev);
1092 pm_runtime_allow(&pdev->dev);
b3c567e4
VK
1093 return 0;
1094
1095err_dma:
1096 iounmap(device->dma_base);
1097err_ioremap:
1098 pci_dev_put(pdev);
1099 kfree(device);
1100err_kzalloc:
1101err_set_dma_mask:
1102 pci_release_regions(pdev);
1103 pci_disable_device(pdev);
1104err_request_regions:
1105err_enable_device:
1106 pr_err("ERR_MDMA:Probe failed %d\n", err);
1107 return err;
1108}
1109
1110/**
1111 * intel_mid_dma_remove - PCI remove
1112 * @pdev: Controller PCI device structure
1113 *
1114 * Free up all resources and data
1115 * Call shutdown_dma to complete contoller and chan cleanup
1116 */
1117static void __devexit intel_mid_dma_remove(struct pci_dev *pdev)
1118{
1119 struct middma_device *device = pci_get_drvdata(pdev);
1120 middma_shutdown(pdev);
1121 pci_dev_put(pdev);
1122 kfree(device);
1123 pci_release_regions(pdev);
1124 pci_disable_device(pdev);
1125}
1126
53a61bad
KV
1127/* Power Management */
1128/*
1129* dma_suspend - PCI suspend function
1130*
1131* @pci: PCI device structure
1132* @state: PM message
1133*
1134* This function is called by OS when a power event occurs
1135*/
1136int dma_suspend(struct pci_dev *pci, pm_message_t state)
1137{
1138 int i;
1139 struct middma_device *device = pci_get_drvdata(pci);
1140 pr_debug("MDMA: dma_suspend called\n");
1141
1142 for (i = 0; i < device->max_chan; i++) {
1143 if (device->ch[i].in_use)
1144 return -EAGAIN;
1145 }
1146 device->state = SUSPENDED;
1147 pci_set_drvdata(pci, device);
1148 pci_save_state(pci);
1149 pci_disable_device(pci);
1150 pci_set_power_state(pci, PCI_D3hot);
1151 return 0;
1152}
1153
1154/**
1155* dma_resume - PCI resume function
1156*
1157* @pci: PCI device structure
1158*
1159* This function is called by OS when a power event occurs
1160*/
1161int dma_resume(struct pci_dev *pci)
1162{
1163 int ret;
1164 struct middma_device *device = pci_get_drvdata(pci);
1165
1166 pr_debug("MDMA: dma_resume called\n");
1167 pci_set_power_state(pci, PCI_D0);
1168 pci_restore_state(pci);
1169 ret = pci_enable_device(pci);
1170 if (ret) {
1171 pr_err("MDMA: device cant be enabled for %x\n", pci->device);
1172 return ret;
1173 }
1174 device->state = RUNNING;
1175 iowrite32(REG_BIT0, device->dma_base + DMA_CFG);
1176 pci_set_drvdata(pci, device);
1177 return 0;
1178}
1179
1180static int dma_runtime_suspend(struct device *dev)
1181{
1182 struct pci_dev *pci_dev = to_pci_dev(dev);
1183 return dma_suspend(pci_dev, PMSG_SUSPEND);
1184}
1185
1186static int dma_runtime_resume(struct device *dev)
1187{
1188 struct pci_dev *pci_dev = to_pci_dev(dev);
1189 return dma_resume(pci_dev);
1190}
1191
1192static int dma_runtime_idle(struct device *dev)
1193{
1194 struct pci_dev *pdev = to_pci_dev(dev);
1195 struct middma_device *device = pci_get_drvdata(pdev);
1196 int i;
1197
1198 for (i = 0; i < device->max_chan; i++) {
1199 if (device->ch[i].in_use)
1200 return -EAGAIN;
1201 }
1202
1203 return pm_schedule_suspend(dev, 0);
1204}
1205
b3c567e4
VK
1206/******************************************************************************
1207* PCI stuff
1208*/
1209static struct pci_device_id intel_mid_dma_ids[] = {
1210 { PCI_VDEVICE(INTEL, INTEL_MID_DMAC1_ID), INFO(2, 6, 4095, 0x200020)},
1211 { PCI_VDEVICE(INTEL, INTEL_MID_DMAC2_ID), INFO(2, 0, 2047, 0)},
1212 { PCI_VDEVICE(INTEL, INTEL_MID_GP_DMAC2_ID), INFO(2, 0, 2047, 0)},
1213 { PCI_VDEVICE(INTEL, INTEL_MFLD_DMAC1_ID), INFO(4, 0, 4095, 0x400040)},
1214 { 0, }
1215};
1216MODULE_DEVICE_TABLE(pci, intel_mid_dma_ids);
1217
53a61bad
KV
1218static const struct dev_pm_ops intel_mid_dma_pm = {
1219 .runtime_suspend = dma_runtime_suspend,
1220 .runtime_resume = dma_runtime_resume,
1221 .runtime_idle = dma_runtime_idle,
1222};
1223
b3c567e4
VK
1224static struct pci_driver intel_mid_dma_pci = {
1225 .name = "Intel MID DMA",
1226 .id_table = intel_mid_dma_ids,
1227 .probe = intel_mid_dma_probe,
1228 .remove = __devexit_p(intel_mid_dma_remove),
53a61bad
KV
1229#ifdef CONFIG_PM
1230 .suspend = dma_suspend,
1231 .resume = dma_resume,
1232 .driver = {
1233 .pm = &intel_mid_dma_pm,
1234 },
1235#endif
b3c567e4
VK
1236};
1237
1238static int __init intel_mid_dma_init(void)
1239{
1240 pr_debug("INFO_MDMA: LNW DMA Driver Version %s\n",
1241 INTEL_MID_DMA_DRIVER_VERSION);
1242 return pci_register_driver(&intel_mid_dma_pci);
1243}
1244fs_initcall(intel_mid_dma_init);
1245
1246static void __exit intel_mid_dma_exit(void)
1247{
1248 pci_unregister_driver(&intel_mid_dma_pci);
1249}
1250module_exit(intel_mid_dma_exit);
1251
1252MODULE_AUTHOR("Vinod Koul <vinod.koul@intel.com>");
1253MODULE_DESCRIPTION("Intel (R) MID DMAC Driver");
1254MODULE_LICENSE("GPL v2");
1255MODULE_VERSION(INTEL_MID_DMA_DRIVER_VERSION);