1 /* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
3 * This file is provided under a dual BSD/GPLv2 license. When using or
4 * redistributing this file, you may do so under either license.
6 * Copyright(c) 2018 Intel Corporation. All rights reserved.
9 #ifndef __INCLUDE_SOUND_SOF_STREAM_H__
10 #define __INCLUDE_SOUND_SOF_STREAM_H__
12 #include <sound/sof/header.h>
15 * Stream configuration.
18 #define SOF_IPC_MAX_CHANNELS 8
20 /* common sample rates for use in masks */
21 #define SOF_RATE_8000 (1 << 0) /**< 8000Hz */
22 #define SOF_RATE_11025 (1 << 1) /**< 11025Hz */
23 #define SOF_RATE_12000 (1 << 2) /**< 12000Hz */
24 #define SOF_RATE_16000 (1 << 3) /**< 16000Hz */
25 #define SOF_RATE_22050 (1 << 4) /**< 22050Hz */
26 #define SOF_RATE_24000 (1 << 5) /**< 24000Hz */
27 #define SOF_RATE_32000 (1 << 6) /**< 32000Hz */
28 #define SOF_RATE_44100 (1 << 7) /**< 44100Hz */
29 #define SOF_RATE_48000 (1 << 8) /**< 48000Hz */
30 #define SOF_RATE_64000 (1 << 9) /**< 64000Hz */
31 #define SOF_RATE_88200 (1 << 10) /**< 88200Hz */
32 #define SOF_RATE_96000 (1 << 11) /**< 96000Hz */
33 #define SOF_RATE_176400 (1 << 12) /**< 176400Hz */
34 #define SOF_RATE_192000 (1 << 13) /**< 192000Hz */
36 /* continuous and non-standard rates for flexibility */
37 #define SOF_RATE_CONTINUOUS (1 << 30) /**< range */
38 #define SOF_RATE_KNOT (1 << 31) /**< non-continuous */
40 /* generic PCM flags for runtime settings */
41 #define SOF_PCM_FLAG_XRUN_STOP (1 << 0) /**< Stop on any XRUN */
43 /* stream PCM frame format */
45 SOF_IPC_FRAME_S16_LE = 0,
46 SOF_IPC_FRAME_S24_4LE,
49 /* other formats here */
52 /* stream buffer format */
53 enum sof_ipc_buffer_format {
54 SOF_IPC_BUFFER_INTERLEAVED,
55 SOF_IPC_BUFFER_NONINTERLEAVED,
56 /* other formats here */
59 /* stream direction */
60 enum sof_ipc_stream_direction {
61 SOF_IPC_STREAM_PLAYBACK = 0,
62 SOF_IPC_STREAM_CAPTURE,
65 /* stream ring info */
66 struct sof_ipc_host_buffer {
67 struct sof_ipc_hdr hdr;
74 struct sof_ipc_stream_params {
75 struct sof_ipc_hdr hdr;
76 struct sof_ipc_host_buffer buffer;
77 uint32_t direction; /**< enum sof_ipc_stream_direction */
78 uint32_t frame_fmt; /**< enum sof_ipc_frame */
79 uint32_t buffer_fmt; /**< enum sof_ipc_buffer_format */
83 uint16_t sample_valid_bytes;
84 uint16_t sample_container_bytes;
86 uint32_t host_period_bytes;
87 uint16_t no_stream_position; /**< 1 means don't send stream position */
88 uint8_t cont_update_posn; /**< 1 means continuous update stream position */
91 uint16_t chmap[SOF_IPC_MAX_CHANNELS]; /**< channel map - SOF_CHMAP_ */
94 /* PCM params info - SOF_IPC_STREAM_PCM_PARAMS */
95 struct sof_ipc_pcm_params {
96 struct sof_ipc_cmd_hdr hdr;
98 uint32_t flags; /**< generic PCM flags - SOF_PCM_FLAG_ */
100 struct sof_ipc_stream_params params;
103 /* PCM params info reply - SOF_IPC_STREAM_PCM_PARAMS_REPLY */
104 struct sof_ipc_pcm_params_reply {
105 struct sof_ipc_reply rhdr;
107 uint32_t posn_offset;
110 /* free stream - SOF_IPC_STREAM_PCM_PARAMS */
111 struct sof_ipc_stream {
112 struct sof_ipc_cmd_hdr hdr;
116 /* flags indicating which time stamps are in sync with each other */
117 #define SOF_TIME_HOST_SYNC (1 << 0)
118 #define SOF_TIME_DAI_SYNC (1 << 1)
119 #define SOF_TIME_WALL_SYNC (1 << 2)
120 #define SOF_TIME_STAMP_SYNC (1 << 3)
122 /* flags indicating which time stamps are valid */
123 #define SOF_TIME_HOST_VALID (1 << 8)
124 #define SOF_TIME_DAI_VALID (1 << 9)
125 #define SOF_TIME_WALL_VALID (1 << 10)
126 #define SOF_TIME_STAMP_VALID (1 << 11)
128 /* flags indicating time stamps are 64bit else 3use low 32bit */
129 #define SOF_TIME_HOST_64 (1 << 16)
130 #define SOF_TIME_DAI_64 (1 << 17)
131 #define SOF_TIME_WALL_64 (1 << 18)
132 #define SOF_TIME_STAMP_64 (1 << 19)
134 struct sof_ipc_stream_posn {
135 struct sof_ipc_reply rhdr;
136 uint32_t comp_id; /**< host component ID */
137 uint32_t flags; /**< SOF_TIME_ */
138 uint32_t wallclock_hz; /**< frequency of wallclock in Hz */
139 uint32_t timestamp_ns; /**< resolution of timestamp in ns */
140 uint64_t host_posn; /**< host DMA position in bytes */
141 uint64_t dai_posn; /**< DAI DMA position in bytes */
142 uint64_t comp_posn; /**< comp position in bytes */
143 uint64_t wallclock; /**< audio wall clock */
144 uint64_t timestamp; /**< system time stamp */
145 uint32_t xrun_comp_id; /**< comp ID of XRUN component */
146 int32_t xrun_size; /**< XRUN size in bytes */