Commit d8095f94 authored by Marek Szyprowski's avatar Marek Szyprowski Committed by Vinod Koul
Browse files

dmaengine: add support for reporting pause and resume separately 



'cmd_pause' DMA channel capability means that respective DMA engine
supports both pausing and resuming given DMA channel. However, in some
cases it is important to know if DMA channel can be paused without the
need to resume it. This is a typical requirement for proper residue
reading on transfer timeout in UART drivers. There are also some DMA
engines with limited hardware, which doesn't really support resuming.

Reporting pause and resume capabilities separately allows UART drivers to
properly check for the really required capabilities and operate in DMA
mode also in systems with limited DMA hardware. On the other hand drivers,
which rely on full channel suspend/resume support, should now check for
both 'pause' and 'resume' features.

Existing clients of dma_get_slave_caps() have been checked and the only
driver which rely on proper channel resuming is soc-generic-dmaengine-pcm
driver, which has been updated to check the newly added capability.
Existing 'cmd_pause' now only indicates that DMA engine support pausing
given DMA channel.

Signed-off-by: default avatarMarek Szyprowski <m.szyprowski@samsung.com>
Acked-by: default avatarMark Brown <broonie@kernel.org>
Signed-off-by: default avatarVinod Koul <vkoul@kernel.org>
parent ce397d21

drivers/dma/dmaengine.c

+2 −6
Original line number Diff line number Diff line
@@ -500,12 +500,8 @@ int dma_get_slave_caps(struct dma_chan *chan, struct dma_slave_caps *caps) 
	caps->max_burst = device->max_burst;

	caps->residue_granularity = device->residue_granularity;

	caps->descriptor_reuse = device->descriptor_reuse;



	/*

	 * Some devices implement only pause (e.g. to get residuum) but no

	 * resume. However cmd_pause is advertised as pause AND resume.

	 */

	caps->cmd_pause = !!(device->device_pause && device->device_resume);

	caps->cmd_pause = !!device->device_pause;

	caps->cmd_resume = !!device->device_resume;

	caps->cmd_terminate = !!device->device_terminate_all;



	return 0;

include/linux/dmaengine.h

+4 −1
Original line number Diff line number Diff line
@@ -415,7 +415,9 @@ enum dma_residue_granularity { 
 *	each type, the dma controller should set BIT(<TYPE>) and same

 *	should be checked by controller as well

 * @max_burst: max burst capability per-transfer

 * @cmd_pause: true, if pause and thereby resume is supported

 * @cmd_pause: true, if pause is supported (i.e. for reading residue or

 *	       for resume later)

 * @cmd_resume: true, if resume is supported

 * @cmd_terminate: true, if terminate cmd is supported

 * @residue_granularity: granularity of the reported transfer residue

 * @descriptor_reuse: if a descriptor can be reused by client and
@@ -427,6 +429,7 @@ struct dma_slave_caps { 
	u32 directions;

	u32 max_burst;

	bool cmd_pause;

	bool cmd_resume;

	bool cmd_terminate;

	enum dma_residue_granularity residue_granularity;

	bool descriptor_reuse;

sound/soc/soc-generic-dmaengine-pcm.c

+1 −1
Original line number Diff line number Diff line
@@ -156,7 +156,7 @@ static int dmaengine_pcm_set_runtime_hwparams(struct snd_pcm_substream *substrea 


	ret = dma_get_slave_caps(chan, &dma_caps);

	if (ret == 0) {

		if (dma_caps.cmd_pause)

		if (dma_caps.cmd_pause && dma_caps.cmd_resume)

			hw.info |= SNDRV_PCM_INFO_PAUSE | SNDRV_PCM_INFO_RESUME;

		if (dma_caps.residue_granularity <= DMA_RESIDUE_GRANULARITY_SEGMENT)

			hw.info |= SNDRV_PCM_INFO_BATCH;

CRA Git | Maintained and supported by SUSTech CRA and CCSE