2005-04-17 06:20:36 +08:00
|
|
|
/*
|
2009-09-22 21:29:36 +08:00
|
|
|
* include/linux/amba/mmci.h
|
2005-04-17 06:20:36 +08:00
|
|
|
*/
|
2009-09-22 21:29:36 +08:00
|
|
|
#ifndef AMBA_MMCI_H
|
|
|
|
|
#define AMBA_MMCI_H
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2007-02-10 05:49:31 +08:00
|
|
|
#include <linux/mmc/host.h>
|
2005-04-17 06:20:36 +08:00
|
|
|
|
ARM: mmci: add dmaengine-based DMA support
Based on a patch from Linus Walleij.
Add dmaengine based support for DMA to the MMCI driver, using the
Primecell DMA engine interface. The changes over Linus' driver are:
- rename txsize_threshold to dmasize_threshold, as this reflects the
purpose more.
- use 'mmci_dma_' as the function prefix rather than 'dma_mmci_'.
- clean up requesting of dma channels.
- don't release a single channel twice when it's shared between tx and rx.
- get rid of 'dma_enable' bool - instead check whether the channel is NULL.
- detect incomplete DMA at the end of a transfer. Some DMA controllers
(eg, PL08x) are unable to be configured for scatter DMA and also listen
to all four DMA request signals [BREQ,SREQ,LBREQ,LSREQ] from the MMCI.
They can do one or other but not both. As MMCI uses LBREQ/LSREQ for the
final burst/words, PL08x does not transfer the last few words.
- map and unmap DMA buffers using the DMA engine struct device, not the
MMCI struct device - the DMA engine is doing the DMA transfer, not us.
- avoid double-unmapping of the DMA buffers on MMCI data errors.
- don't check for negative values from the dmaengine tx submission
function - Dan says this must never fail.
- use new dmaengine helper functions rather than using the ugly function
pointers directly.
- allow DMA code to be fully optimized away using dma_inprogress() which
is defined to constant 0 if DMA engine support is disabled.
- request maximum segment size from the DMA engine struct device and
set this appropriately.
- removed checking of buffer alignment - the DMA engine should deal with
its own restrictions on buffer alignment, not the individual DMA engine
users.
- removed setting DMAREQCTL - this confuses some DMA controllers as it
causes LBREQ to be asserted for the last seven transfers, rather than
six SREQ and one LSREQ.
- removed burst setting - the DMA controller should not burst past the
transfer size required to complete the DMA operation.
Tested-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Russell King <rmk+kernel@arm.linux.org.uk>
2011-01-12 03:35:53 +08:00
|
|
|
/* Just some dummy forwarding */
|
|
|
|
|
struct dma_chan;
|
|
|
|
|
|
2010-04-08 14:39:38 +08:00
|
|
|
/**
|
|
|
|
|
* struct mmci_platform_data - platform configuration for the MMCI
|
|
|
|
|
* (also known as PL180) block.
|
|
|
|
|
* @f_max: the maximum operational frequency for this host in this
|
|
|
|
|
* platform configuration. When this is specified it takes precedence
|
|
|
|
|
* over the module parameter for the same frequency.
|
|
|
|
|
* @ocr_mask: available voltages on the 4 pins from the block, this
|
|
|
|
|
* is ignored if a regulator is used, see the MMC_VDD_* masks in
|
|
|
|
|
* mmc/host.h
|
2010-07-21 19:53:57 +08:00
|
|
|
* @vdd_handler: a callback function to translate a MMC_VDD_*
|
|
|
|
|
* mask into a value to be binary (or set some other custom bits
|
|
|
|
|
* in MMCIPWR) or:ed and written into the MMCIPWR register of the
|
|
|
|
|
* block. May also control external power based on the power_mode.
|
2010-04-08 14:39:38 +08:00
|
|
|
* @status: if no GPIO read function was given to the block in
|
|
|
|
|
* gpio_wp (below) this function will be called to determine
|
|
|
|
|
* whether a card is present in the MMC slot or not
|
|
|
|
|
* @gpio_wp: read this GPIO pin to see if the card is write protected
|
|
|
|
|
* @gpio_cd: read this GPIO pin to detect card insertion
|
2010-08-09 19:54:43 +08:00
|
|
|
* @cd_invert: true if the gpio_cd pin value is active low
|
2010-04-08 14:39:38 +08:00
|
|
|
* @capabilities: the capabilities of the block as implemented in
|
|
|
|
|
* this platform, signify anything MMC_CAP_* from mmc/host.h
|
2011-11-14 19:02:28 +08:00
|
|
|
* @capabilities2: more capabilities, MMC_CAP2_* from mmc/host.h
|
2011-03-31 09:57:33 +08:00
|
|
|
* @dma_filter: function used to select an appropriate RX and TX
|
ARM: mmci: add dmaengine-based DMA support
Based on a patch from Linus Walleij.
Add dmaengine based support for DMA to the MMCI driver, using the
Primecell DMA engine interface. The changes over Linus' driver are:
- rename txsize_threshold to dmasize_threshold, as this reflects the
purpose more.
- use 'mmci_dma_' as the function prefix rather than 'dma_mmci_'.
- clean up requesting of dma channels.
- don't release a single channel twice when it's shared between tx and rx.
- get rid of 'dma_enable' bool - instead check whether the channel is NULL.
- detect incomplete DMA at the end of a transfer. Some DMA controllers
(eg, PL08x) are unable to be configured for scatter DMA and also listen
to all four DMA request signals [BREQ,SREQ,LBREQ,LSREQ] from the MMCI.
They can do one or other but not both. As MMCI uses LBREQ/LSREQ for the
final burst/words, PL08x does not transfer the last few words.
- map and unmap DMA buffers using the DMA engine struct device, not the
MMCI struct device - the DMA engine is doing the DMA transfer, not us.
- avoid double-unmapping of the DMA buffers on MMCI data errors.
- don't check for negative values from the dmaengine tx submission
function - Dan says this must never fail.
- use new dmaengine helper functions rather than using the ugly function
pointers directly.
- allow DMA code to be fully optimized away using dma_inprogress() which
is defined to constant 0 if DMA engine support is disabled.
- request maximum segment size from the DMA engine struct device and
set this appropriately.
- removed checking of buffer alignment - the DMA engine should deal with
its own restrictions on buffer alignment, not the individual DMA engine
users.
- removed setting DMAREQCTL - this confuses some DMA controllers as it
causes LBREQ to be asserted for the last seven transfers, rather than
six SREQ and one LSREQ.
- removed burst setting - the DMA controller should not burst past the
transfer size required to complete the DMA operation.
Tested-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Russell King <rmk+kernel@arm.linux.org.uk>
2011-01-12 03:35:53 +08:00
|
|
|
* DMA channel to be used for DMA, if and only if you're deploying the
|
|
|
|
|
* generic DMA engine
|
|
|
|
|
* @dma_rx_param: parameter passed to the DMA allocation
|
2011-03-31 09:57:33 +08:00
|
|
|
* filter in order to select an appropriate RX channel. If
|
ARM: mmci: add dmaengine-based DMA support
Based on a patch from Linus Walleij.
Add dmaengine based support for DMA to the MMCI driver, using the
Primecell DMA engine interface. The changes over Linus' driver are:
- rename txsize_threshold to dmasize_threshold, as this reflects the
purpose more.
- use 'mmci_dma_' as the function prefix rather than 'dma_mmci_'.
- clean up requesting of dma channels.
- don't release a single channel twice when it's shared between tx and rx.
- get rid of 'dma_enable' bool - instead check whether the channel is NULL.
- detect incomplete DMA at the end of a transfer. Some DMA controllers
(eg, PL08x) are unable to be configured for scatter DMA and also listen
to all four DMA request signals [BREQ,SREQ,LBREQ,LSREQ] from the MMCI.
They can do one or other but not both. As MMCI uses LBREQ/LSREQ for the
final burst/words, PL08x does not transfer the last few words.
- map and unmap DMA buffers using the DMA engine struct device, not the
MMCI struct device - the DMA engine is doing the DMA transfer, not us.
- avoid double-unmapping of the DMA buffers on MMCI data errors.
- don't check for negative values from the dmaengine tx submission
function - Dan says this must never fail.
- use new dmaengine helper functions rather than using the ugly function
pointers directly.
- allow DMA code to be fully optimized away using dma_inprogress() which
is defined to constant 0 if DMA engine support is disabled.
- request maximum segment size from the DMA engine struct device and
set this appropriately.
- removed checking of buffer alignment - the DMA engine should deal with
its own restrictions on buffer alignment, not the individual DMA engine
users.
- removed setting DMAREQCTL - this confuses some DMA controllers as it
causes LBREQ to be asserted for the last seven transfers, rather than
six SREQ and one LSREQ.
- removed burst setting - the DMA controller should not burst past the
transfer size required to complete the DMA operation.
Tested-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Russell King <rmk+kernel@arm.linux.org.uk>
2011-01-12 03:35:53 +08:00
|
|
|
* there is a bidirectional RX+TX channel, then just specify
|
|
|
|
|
* this and leave dma_tx_param set to NULL
|
|
|
|
|
* @dma_tx_param: parameter passed to the DMA allocation
|
2011-03-31 09:57:33 +08:00
|
|
|
* filter in order to select an appropriate TX channel. If this
|
ARM: mmci: add dmaengine-based DMA support
Based on a patch from Linus Walleij.
Add dmaengine based support for DMA to the MMCI driver, using the
Primecell DMA engine interface. The changes over Linus' driver are:
- rename txsize_threshold to dmasize_threshold, as this reflects the
purpose more.
- use 'mmci_dma_' as the function prefix rather than 'dma_mmci_'.
- clean up requesting of dma channels.
- don't release a single channel twice when it's shared between tx and rx.
- get rid of 'dma_enable' bool - instead check whether the channel is NULL.
- detect incomplete DMA at the end of a transfer. Some DMA controllers
(eg, PL08x) are unable to be configured for scatter DMA and also listen
to all four DMA request signals [BREQ,SREQ,LBREQ,LSREQ] from the MMCI.
They can do one or other but not both. As MMCI uses LBREQ/LSREQ for the
final burst/words, PL08x does not transfer the last few words.
- map and unmap DMA buffers using the DMA engine struct device, not the
MMCI struct device - the DMA engine is doing the DMA transfer, not us.
- avoid double-unmapping of the DMA buffers on MMCI data errors.
- don't check for negative values from the dmaengine tx submission
function - Dan says this must never fail.
- use new dmaengine helper functions rather than using the ugly function
pointers directly.
- allow DMA code to be fully optimized away using dma_inprogress() which
is defined to constant 0 if DMA engine support is disabled.
- request maximum segment size from the DMA engine struct device and
set this appropriately.
- removed checking of buffer alignment - the DMA engine should deal with
its own restrictions on buffer alignment, not the individual DMA engine
users.
- removed setting DMAREQCTL - this confuses some DMA controllers as it
causes LBREQ to be asserted for the last seven transfers, rather than
six SREQ and one LSREQ.
- removed burst setting - the DMA controller should not burst past the
transfer size required to complete the DMA operation.
Tested-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Russell King <rmk+kernel@arm.linux.org.uk>
2011-01-12 03:35:53 +08:00
|
|
|
* is NULL the driver will attempt to use the RX channel as a
|
|
|
|
|
* bidirectional channel
|
2010-04-08 14:39:38 +08:00
|
|
|
*/
|
2009-09-22 21:29:36 +08:00
|
|
|
struct mmci_platform_data {
|
2010-04-08 14:39:38 +08:00
|
|
|
unsigned int f_max;
|
|
|
|
|
unsigned int ocr_mask;
|
2010-07-21 19:53:57 +08:00
|
|
|
u32 (*vdd_handler)(struct device *, unsigned int vdd,
|
|
|
|
|
unsigned char power_mode);
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned int (*status)(struct device *);
|
2009-07-09 22:15:12 +08:00
|
|
|
int gpio_wp;
|
|
|
|
|
int gpio_cd;
|
2010-08-09 19:54:43 +08:00
|
|
|
bool cd_invert;
|
2009-09-14 19:57:11 +08:00
|
|
|
unsigned long capabilities;
|
2011-11-14 19:02:28 +08:00
|
|
|
unsigned long capabilities2;
|
ARM: mmci: add dmaengine-based DMA support
Based on a patch from Linus Walleij.
Add dmaengine based support for DMA to the MMCI driver, using the
Primecell DMA engine interface. The changes over Linus' driver are:
- rename txsize_threshold to dmasize_threshold, as this reflects the
purpose more.
- use 'mmci_dma_' as the function prefix rather than 'dma_mmci_'.
- clean up requesting of dma channels.
- don't release a single channel twice when it's shared between tx and rx.
- get rid of 'dma_enable' bool - instead check whether the channel is NULL.
- detect incomplete DMA at the end of a transfer. Some DMA controllers
(eg, PL08x) are unable to be configured for scatter DMA and also listen
to all four DMA request signals [BREQ,SREQ,LBREQ,LSREQ] from the MMCI.
They can do one or other but not both. As MMCI uses LBREQ/LSREQ for the
final burst/words, PL08x does not transfer the last few words.
- map and unmap DMA buffers using the DMA engine struct device, not the
MMCI struct device - the DMA engine is doing the DMA transfer, not us.
- avoid double-unmapping of the DMA buffers on MMCI data errors.
- don't check for negative values from the dmaengine tx submission
function - Dan says this must never fail.
- use new dmaengine helper functions rather than using the ugly function
pointers directly.
- allow DMA code to be fully optimized away using dma_inprogress() which
is defined to constant 0 if DMA engine support is disabled.
- request maximum segment size from the DMA engine struct device and
set this appropriately.
- removed checking of buffer alignment - the DMA engine should deal with
its own restrictions on buffer alignment, not the individual DMA engine
users.
- removed setting DMAREQCTL - this confuses some DMA controllers as it
causes LBREQ to be asserted for the last seven transfers, rather than
six SREQ and one LSREQ.
- removed burst setting - the DMA controller should not burst past the
transfer size required to complete the DMA operation.
Tested-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Russell King <rmk+kernel@arm.linux.org.uk>
2011-01-12 03:35:53 +08:00
|
|
|
bool (*dma_filter)(struct dma_chan *chan, void *filter_param);
|
|
|
|
|
void *dma_rx_param;
|
|
|
|
|
void *dma_tx_param;
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
#endif
|