2012-02-22 02:49:08 -07:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2012, Analog Devices Inc.
|
|
|
|
* Author: Lars-Peter Clausen <lars@metafoo.de>
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
|
|
* under the terms of the GNU General Public License as published by the
|
|
|
|
* Free Software Foundation; either version 2 of the License, or (at your
|
|
|
|
* option) any later version.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License along
|
|
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
* 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
#ifndef __SOUND_DMAENGINE_PCM_H__
|
|
|
|
#define __SOUND_DMAENGINE_PCM_H__
|
|
|
|
|
|
|
|
#include <sound/pcm.h>
|
2013-04-15 11:19:51 -06:00
|
|
|
#include <sound/soc.h>
|
2012-02-22 02:49:08 -07:00
|
|
|
#include <linux/dmaengine.h>
|
|
|
|
|
|
|
|
/**
|
|
|
|
* snd_pcm_substream_to_dma_direction - Get dma_transfer_direction for a PCM
|
|
|
|
* substream
|
|
|
|
* @substream: PCM substream
|
|
|
|
*/
|
|
|
|
static inline enum dma_transfer_direction
|
|
|
|
snd_pcm_substream_to_dma_direction(const struct snd_pcm_substream *substream)
|
|
|
|
{
|
|
|
|
if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
|
|
|
|
return DMA_MEM_TO_DEV;
|
|
|
|
else
|
|
|
|
return DMA_DEV_TO_MEM;
|
|
|
|
}
|
|
|
|
|
|
|
|
int snd_hwparams_to_dma_slave_config(const struct snd_pcm_substream *substream,
|
|
|
|
const struct snd_pcm_hw_params *params, struct dma_slave_config *slave_config);
|
|
|
|
int snd_dmaengine_pcm_trigger(struct snd_pcm_substream *substream, int cmd);
|
2012-06-11 12:11:42 -06:00
|
|
|
snd_pcm_uframes_t snd_dmaengine_pcm_pointer(struct snd_pcm_substream *substream);
|
2012-06-11 12:11:41 -06:00
|
|
|
snd_pcm_uframes_t snd_dmaengine_pcm_pointer_no_residue(struct snd_pcm_substream *substream);
|
2012-02-22 02:49:08 -07:00
|
|
|
|
|
|
|
int snd_dmaengine_pcm_open(struct snd_pcm_substream *substream,
|
2013-04-15 11:19:48 -06:00
|
|
|
struct dma_chan *chan);
|
2012-02-22 02:49:08 -07:00
|
|
|
int snd_dmaengine_pcm_close(struct snd_pcm_substream *substream);
|
|
|
|
|
2013-04-15 11:19:48 -06:00
|
|
|
int snd_dmaengine_pcm_open_request_chan(struct snd_pcm_substream *substream,
|
|
|
|
dma_filter_fn filter_fn, void *filter_data);
|
|
|
|
int snd_dmaengine_pcm_close_release_chan(struct snd_pcm_substream *substream);
|
|
|
|
|
2013-04-15 11:19:51 -06:00
|
|
|
struct dma_chan *snd_dmaengine_pcm_request_channel(dma_filter_fn filter_fn,
|
|
|
|
void *filter_data);
|
2012-02-22 02:49:08 -07:00
|
|
|
struct dma_chan *snd_dmaengine_pcm_get_chan(struct snd_pcm_substream *substream);
|
|
|
|
|
2016-04-27 07:26:51 -06:00
|
|
|
/*
|
|
|
|
* The DAI supports packed transfers, eg 2 16-bit samples in a 32-bit word.
|
|
|
|
* If this flag is set the dmaengine driver won't put any restriction on
|
|
|
|
* the supported sample formats and set the DMA transfer size to undefined.
|
|
|
|
* The DAI driver is responsible to disable any unsupported formats in it's
|
|
|
|
* configuration and catch corner cases that are not already handled in
|
|
|
|
* the ALSA core.
|
|
|
|
*/
|
|
|
|
#define SND_DMAENGINE_PCM_DAI_FLAG_PACK BIT(0)
|
|
|
|
|
2013-04-03 03:06:02 -06:00
|
|
|
/**
|
|
|
|
* struct snd_dmaengine_dai_dma_data - DAI DMA configuration data
|
|
|
|
* @addr: Address of the DAI data source or destination register.
|
|
|
|
* @addr_width: Width of the DAI data source or destination register.
|
|
|
|
* @maxburst: Maximum number of words(note: words, as in units of the
|
|
|
|
* src_addr_width member, not bytes) that can be send to or received from the
|
|
|
|
* DAI in one burst.
|
|
|
|
* @slave_id: Slave requester id for the DMA channel.
|
|
|
|
* @filter_data: Custom DMA channel filter data, this will usually be used when
|
|
|
|
* requesting the DMA channel.
|
2017-01-17 06:16:41 -07:00
|
|
|
* @chan_name: Custom channel name to use when requesting DMA channel.
|
2013-10-08 07:07:59 -06:00
|
|
|
* @fifo_size: FIFO size of the DAI controller in bytes
|
2016-04-27 07:26:51 -06:00
|
|
|
* @flags: PCM_DAI flags, only SND_DMAENGINE_PCM_DAI_FLAG_PACK for now
|
2013-04-03 03:06:02 -06:00
|
|
|
*/
|
|
|
|
struct snd_dmaengine_dai_dma_data {
|
|
|
|
dma_addr_t addr;
|
|
|
|
enum dma_slave_buswidth addr_width;
|
|
|
|
u32 maxburst;
|
|
|
|
unsigned int slave_id;
|
|
|
|
void *filter_data;
|
2017-01-17 06:16:41 -07:00
|
|
|
const char *chan_name;
|
2013-10-08 07:07:59 -06:00
|
|
|
unsigned int fifo_size;
|
2016-04-27 07:26:51 -06:00
|
|
|
unsigned int flags;
|
2013-04-03 03:06:02 -06:00
|
|
|
};
|
|
|
|
|
|
|
|
void snd_dmaengine_pcm_set_config_from_dai_data(
|
|
|
|
const struct snd_pcm_substream *substream,
|
|
|
|
const struct snd_dmaengine_dai_dma_data *dma_data,
|
|
|
|
struct dma_slave_config *config);
|
|
|
|
|
2013-04-15 11:19:51 -06:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Try to request the DMA channel using compat_request_channel or
|
|
|
|
* compat_filter_fn if it couldn't be requested through devicetree.
|
|
|
|
*/
|
|
|
|
#define SND_DMAENGINE_PCM_FLAG_COMPAT BIT(0)
|
|
|
|
/*
|
|
|
|
* Don't try to request the DMA channels through devicetree. This flag only
|
|
|
|
* makes sense if SND_DMAENGINE_PCM_FLAG_COMPAT is set as well.
|
|
|
|
*/
|
|
|
|
#define SND_DMAENGINE_PCM_FLAG_NO_DT BIT(1)
|
2013-04-20 11:29:00 -06:00
|
|
|
/*
|
|
|
|
* The PCM is half duplex and the DMA channel is shared between capture and
|
|
|
|
* playback.
|
|
|
|
*/
|
|
|
|
#define SND_DMAENGINE_PCM_FLAG_HALF_DUPLEX BIT(3)
|
2017-01-17 06:16:41 -07:00
|
|
|
/*
|
|
|
|
* The PCM streams have custom channel names specified.
|
|
|
|
*/
|
|
|
|
#define SND_DMAENGINE_PCM_FLAG_CUSTOM_CHANNEL_NAME BIT(4)
|
2013-04-15 11:19:51 -06:00
|
|
|
|
2013-04-15 11:19:50 -06:00
|
|
|
/**
|
|
|
|
* struct snd_dmaengine_pcm_config - Configuration data for dmaengine based PCM
|
|
|
|
* @prepare_slave_config: Callback used to fill in the DMA slave_config for a
|
|
|
|
* PCM substream. Will be called from the PCM drivers hwparams callback.
|
2013-04-15 11:19:51 -06:00
|
|
|
* @compat_request_channel: Callback to request a DMA channel for platforms
|
|
|
|
* which do not use devicetree.
|
2018-03-13 10:27:08 -06:00
|
|
|
* @process: Callback used to apply processing on samples transferred from/to
|
|
|
|
* user space.
|
2013-04-15 11:19:51 -06:00
|
|
|
* @compat_filter_fn: Will be used as the filter function when requesting a
|
|
|
|
* channel for platforms which do not use devicetree. The filter parameter
|
|
|
|
* will be the DAI's DMA data.
|
ASoC: dmaengine: add custom DMA config to snd_dmaengine_pcm_config
Add fields to struct snd_dmaengine_pcm_config to allow custom:
- DMA channel names.
This is useful when the default "tx" and "rx" channel names don't
apply, for example if a HW module supports multiple channels, each
having different DMA channel names. This is the case with the FIFOs
in Tegra's AHUB. This new facility can replace
SND_DMAENGINE_PCM_FLAG_CUSTOM_CHANNEL_NAME.
- DMA device
This allows requesting DMA channels for a device other than the device
which is registering the "PCM" driver. This is quite unusual, but is
currently useful on Tegra. In much HW, and in Tegra20, each DAI HW
module contains its own FIFOs which DMA writes to. However, in Tegra30,
the DMA FIFOs were split out AHUB HW module, which then routes the data
through a cross-bar, and into the DAI HW modules. However, the current
ASoC driver structure does not expose this detail, and acts as if the
FIFOs are still part of the DAI HW modules. Consequently, the "PCM"
driver is registered with the DAI HW module, yet the DMA channels must
be looked up in the AHUB HW module's device tree node. This new config
field allows that to happen. Eventually, the Tegra drivers will be
reworked to fully expose the AHUB, and this config field can be
removed.
Signed-off-by: Stephen Warren <swarren@nvidia.com>
Acked-by: Lars-Peter Clausen <lars@metafoo.de>
Signed-off-by: Mark Brown <broonie@linaro.org>
2013-12-03 14:26:34 -07:00
|
|
|
* @dma_dev: If set, request DMA channel on this device rather than the DAI
|
|
|
|
* device.
|
|
|
|
* @chan_names: If set, these custom DMA channel names will be requested at
|
|
|
|
* registration time.
|
2013-04-15 11:19:50 -06:00
|
|
|
* @pcm_hardware: snd_pcm_hardware struct to be used for the PCM.
|
|
|
|
* @prealloc_buffer_size: Size of the preallocated audio buffer.
|
2013-04-15 11:19:51 -06:00
|
|
|
*
|
|
|
|
* Note: If both compat_request_channel and compat_filter_fn are set
|
|
|
|
* compat_request_channel will be used to request the channel and
|
|
|
|
* compat_filter_fn will be ignored. Otherwise the channel will be requested
|
|
|
|
* using dma_request_channel with compat_filter_fn as the filter function.
|
2013-04-15 11:19:50 -06:00
|
|
|
*/
|
|
|
|
struct snd_dmaengine_pcm_config {
|
|
|
|
int (*prepare_slave_config)(struct snd_pcm_substream *substream,
|
|
|
|
struct snd_pcm_hw_params *params,
|
|
|
|
struct dma_slave_config *slave_config);
|
2013-04-15 11:19:51 -06:00
|
|
|
struct dma_chan *(*compat_request_channel)(
|
|
|
|
struct snd_soc_pcm_runtime *rtd,
|
|
|
|
struct snd_pcm_substream *substream);
|
2018-02-19 08:00:36 -07:00
|
|
|
int (*process)(struct snd_pcm_substream *substream,
|
|
|
|
int channel, unsigned long hwoff,
|
|
|
|
void *buf, unsigned long bytes);
|
2013-04-15 11:19:51 -06:00
|
|
|
dma_filter_fn compat_filter_fn;
|
ASoC: dmaengine: add custom DMA config to snd_dmaengine_pcm_config
Add fields to struct snd_dmaengine_pcm_config to allow custom:
- DMA channel names.
This is useful when the default "tx" and "rx" channel names don't
apply, for example if a HW module supports multiple channels, each
having different DMA channel names. This is the case with the FIFOs
in Tegra's AHUB. This new facility can replace
SND_DMAENGINE_PCM_FLAG_CUSTOM_CHANNEL_NAME.
- DMA device
This allows requesting DMA channels for a device other than the device
which is registering the "PCM" driver. This is quite unusual, but is
currently useful on Tegra. In much HW, and in Tegra20, each DAI HW
module contains its own FIFOs which DMA writes to. However, in Tegra30,
the DMA FIFOs were split out AHUB HW module, which then routes the data
through a cross-bar, and into the DAI HW modules. However, the current
ASoC driver structure does not expose this detail, and acts as if the
FIFOs are still part of the DAI HW modules. Consequently, the "PCM"
driver is registered with the DAI HW module, yet the DMA channels must
be looked up in the AHUB HW module's device tree node. This new config
field allows that to happen. Eventually, the Tegra drivers will be
reworked to fully expose the AHUB, and this config field can be
removed.
Signed-off-by: Stephen Warren <swarren@nvidia.com>
Acked-by: Lars-Peter Clausen <lars@metafoo.de>
Signed-off-by: Mark Brown <broonie@linaro.org>
2013-12-03 14:26:34 -07:00
|
|
|
struct device *dma_dev;
|
|
|
|
const char *chan_names[SNDRV_PCM_STREAM_LAST + 1];
|
2013-04-15 11:19:50 -06:00
|
|
|
|
|
|
|
const struct snd_pcm_hardware *pcm_hardware;
|
|
|
|
unsigned int prealloc_buffer_size;
|
|
|
|
};
|
|
|
|
|
|
|
|
int snd_dmaengine_pcm_register(struct device *dev,
|
|
|
|
const struct snd_dmaengine_pcm_config *config,
|
|
|
|
unsigned int flags);
|
|
|
|
void snd_dmaengine_pcm_unregister(struct device *dev);
|
|
|
|
|
2013-11-28 00:50:32 -07:00
|
|
|
int devm_snd_dmaengine_pcm_register(struct device *dev,
|
|
|
|
const struct snd_dmaengine_pcm_config *config,
|
|
|
|
unsigned int flags);
|
|
|
|
|
2013-04-15 11:19:50 -06:00
|
|
|
int snd_dmaengine_pcm_prepare_slave_config(struct snd_pcm_substream *substream,
|
|
|
|
struct snd_pcm_hw_params *params,
|
|
|
|
struct dma_slave_config *slave_config);
|
|
|
|
|
2018-01-28 19:41:09 -07:00
|
|
|
#define SND_DMAENGINE_PCM_DRV_NAME "snd_dmaengine_pcm"
|
|
|
|
|
2012-02-22 02:49:08 -07:00
|
|
|
#endif
|