sound/soc/qcom/qdsp6/q6apm-dai.c
Source file repositories/reference/linux-study-clean/sound/soc/qcom/qdsp6/q6apm-dai.c
File Facts
- System
- Linux kernel
- Corpus path
sound/soc/qcom/qdsp6/q6apm-dai.c- Extension
.c- Size
- 29981 bytes
- Lines
- 1062
- Domain
- Driver Families
- Bucket
- sound/soc
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Touches user memory; correctness depends on fault-safe copying and privilege boundary handling.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Touches IRQ or DMA behavior; this matters for the representative real-device path.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/init.hlinux/err.hlinux/module.hlinux/of.hlinux/platform_device.hlinux/slab.hsound/soc.hsound/soc-dapm.hlinux/spinlock.hsound/pcm.hasm/div64.hasm/dma.hlinux/dma-mapping.hsound/pcm_params.hq6apm.h
Detected Declarations
struct q6apm_dai_rtdstruct q6apm_dai_dataenum stream_statefunction event_handlerfunction event_handler_comprfunction q6apm_dai_preparefunction q6apm_dai_ackfunction q6apm_dai_triggerfunction q6apm_dai_openfunction q6apm_dai_closefunction q6apm_dai_pointerfunction q6apm_dai_hw_paramsfunction q6apm_dai_memory_mapfunction q6apm_dai_pcm_newfunction q6apm_dai_memory_unmapfunction q6apm_dai_pcm_freefunction q6apm_dai_compr_openfunction q6apm_dai_compr_freefunction q6apm_dai_compr_get_capsfunction q6apm_dai_compr_get_codec_capsfunction q6apm_dai_compr_pointerfunction q6apm_dai_compr_triggerfunction q6apm_dai_compr_ackfunction q6apm_dai_compr_set_paramsfunction q6apm_dai_compr_set_metadatafunction q6apm_dai_compr_mmapfunction q6apm_compr_copyfunction q6apm_dai_probe
Annotated Snippet
struct q6apm_dai_rtd {
struct snd_pcm_substream *substream;
struct snd_compr_stream *cstream;
struct snd_codec codec;
struct snd_compr_params codec_param;
struct snd_dma_buffer dma_buffer;
struct sh_mem_pull_push_mode_position_buffer *pos_buffer;
uint32_t last_pos_index;
phys_addr_t phys;
phys_addr_t pos_phys;
unsigned int pcm_size;
unsigned int push_pull_size;
unsigned int pcm_count;
unsigned int periods;
uint64_t bytes_sent;
uint64_t bytes_received;
uint64_t copied_total;
uint16_t bits_per_sample;
snd_pcm_uframes_t queue_ptr;
bool next_track;
enum stream_state state;
struct q6apm_graph *graph;
spinlock_t lock;
bool notify_on_drain;
};
struct q6apm_dai_data {
long long sid;
};
static const struct snd_pcm_hardware q6apm_dai_hardware_capture = {
.info = (SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_BLOCK_TRANSFER |
SNDRV_PCM_INFO_MMAP_VALID | SNDRV_PCM_INFO_INTERLEAVED |
SNDRV_PCM_INFO_PAUSE | SNDRV_PCM_INFO_RESUME |
SNDRV_PCM_INFO_NO_REWINDS | SNDRV_PCM_INFO_SYNC_APPLPTR |
SNDRV_PCM_INFO_BATCH),
.formats = (SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S24_LE),
.rates = SNDRV_PCM_RATE_8000_48000,
.rate_min = 8000,
.rate_max = 48000,
.channels_min = 2,
.channels_max = 4,
.buffer_bytes_max = CAPTURE_MAX_NUM_PERIODS * CAPTURE_MAX_PERIOD_SIZE,
.period_bytes_min = CAPTURE_MIN_PERIOD_SIZE,
.period_bytes_max = CAPTURE_MAX_PERIOD_SIZE,
.periods_min = CAPTURE_MIN_NUM_PERIODS,
.periods_max = CAPTURE_MAX_NUM_PERIODS,
.fifo_size = 0,
};
static const struct snd_pcm_hardware q6apm_dai_hardware_playback = {
.info = (SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_BLOCK_TRANSFER |
SNDRV_PCM_INFO_MMAP_VALID | SNDRV_PCM_INFO_INTERLEAVED |
SNDRV_PCM_INFO_PAUSE | SNDRV_PCM_INFO_RESUME |
SNDRV_PCM_INFO_NO_REWINDS | SNDRV_PCM_INFO_SYNC_APPLPTR |
SNDRV_PCM_INFO_BATCH),
.formats = (SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S24_LE),
.rates = SNDRV_PCM_RATE_8000_192000,
.rate_min = 8000,
.rate_max = 192000,
.channels_min = 2,
.channels_max = 8,
.buffer_bytes_max = (PLAYBACK_MAX_NUM_PERIODS * PLAYBACK_MAX_PERIOD_SIZE),
.period_bytes_min = PLAYBACK_MIN_PERIOD_SIZE,
.period_bytes_max = PLAYBACK_MAX_PERIOD_SIZE,
.periods_min = PLAYBACK_MIN_NUM_PERIODS,
.periods_max = PLAYBACK_MAX_NUM_PERIODS,
.fifo_size = 0,
};
static void event_handler(uint32_t opcode, uint32_t token, void *payload, void *priv)
{
struct q6apm_dai_rtd *prtd = priv;
struct snd_pcm_substream *substream = prtd->substream;
switch (opcode) {
case APM_CLIENT_EVENT_WATERMARK_EVENT:
snd_pcm_period_elapsed(substream);
break;
case APM_CLIENT_EVENT_CMD_EOS_DONE:
prtd->state = Q6APM_STREAM_STOPPED;
break;
case APM_CLIENT_EVENT_DATA_WRITE_DONE:
snd_pcm_period_elapsed(substream);
break;
case APM_CLIENT_EVENT_DATA_READ_DONE:
snd_pcm_period_elapsed(substream);
if (prtd->state == Q6APM_STREAM_RUNNING)
q6apm_read(prtd->graph);
Annotation
- Immediate include surface: `linux/init.h`, `linux/err.h`, `linux/module.h`, `linux/of.h`, `linux/platform_device.h`, `linux/slab.h`, `sound/soc.h`, `sound/soc-dapm.h`.
- Detected declarations: `struct q6apm_dai_rtd`, `struct q6apm_dai_data`, `enum stream_state`, `function event_handler`, `function event_handler_compr`, `function q6apm_dai_prepare`, `function q6apm_dai_ack`, `function q6apm_dai_trigger`, `function q6apm_dai_open`, `function q6apm_dai_close`.
- Atlas domain: Driver Families / sound/soc.
- Implementation status: source implementation candidate.
- This snippet crosses the user/kernel memory boundary; validate fault handling and access checks before translating the pattern.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
- IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.