1 /* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
2 /*
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.
5  *
6  * Copyright(c) 2018 Intel Corporation. All rights reserved.
7  */
8 
9 #ifndef __INCLUDE_SOUND_SOF_STREAM_H__
10 #define __INCLUDE_SOUND_SOF_STREAM_H__
11 
12 #include <sound/sof/header.h>
13 
14 /*
15  * Stream configuration.
16  */
17 
18 #define SOF_IPC_MAX_CHANNELS			8
19 
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 */
35 
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 */
39 
40 /* generic PCM flags for runtime settings */
41 #define SOF_PCM_FLAG_XRUN_STOP	(1 << 0) /**< Stop on any XRUN */
42 
43 /* stream PCM frame format */
44 enum sof_ipc_frame {
45 	SOF_IPC_FRAME_S16_LE = 0,
46 	SOF_IPC_FRAME_S24_4LE,
47 	SOF_IPC_FRAME_S32_LE,
48 	SOF_IPC_FRAME_FLOAT,
49 	/* other formats here */
50 };
51 
52 /* stream buffer format */
53 enum sof_ipc_buffer_format {
54 	SOF_IPC_BUFFER_INTERLEAVED,
55 	SOF_IPC_BUFFER_NONINTERLEAVED,
56 	/* other formats here */
57 };
58 
59 /* stream direction */
60 enum sof_ipc_stream_direction {
61 	SOF_IPC_STREAM_PLAYBACK = 0,
62 	SOF_IPC_STREAM_CAPTURE,
63 };
64 
65 /* stream ring info */
66 struct sof_ipc_host_buffer {
67 	struct sof_ipc_hdr hdr;
68 	uint32_t phy_addr;
69 	uint32_t pages;
70 	uint32_t size;
71 	uint32_t reserved[3];
72 } __packed;
73 
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 */
80 	uint32_t rate;
81 	uint16_t stream_tag;
82 	uint16_t channels;
83 	uint16_t sample_valid_bytes;
84 	uint16_t sample_container_bytes;
85 
86 	uint32_t host_period_bytes;
87 	uint16_t no_stream_position; /**< 1 means don't send stream position */
88 
89 	uint16_t reserved[3];
90 	uint16_t chmap[SOF_IPC_MAX_CHANNELS];	/**< channel map - SOF_CHMAP_ */
91 } __packed;
92 
93 /* PCM params info - SOF_IPC_STREAM_PCM_PARAMS */
94 struct sof_ipc_pcm_params {
95 	struct sof_ipc_cmd_hdr hdr;
96 	uint32_t comp_id;
97 	uint32_t flags;		/**< generic PCM flags - SOF_PCM_FLAG_ */
98 	uint32_t reserved[2];
99 	struct sof_ipc_stream_params params;
100 }  __packed;
101 
102 /* PCM params info reply - SOF_IPC_STREAM_PCM_PARAMS_REPLY */
103 struct sof_ipc_pcm_params_reply {
104 	struct sof_ipc_reply rhdr;
105 	uint32_t comp_id;
106 	uint32_t posn_offset;
107 } __packed;
108 
109 /* free stream - SOF_IPC_STREAM_PCM_PARAMS */
110 struct sof_ipc_stream {
111 	struct sof_ipc_cmd_hdr hdr;
112 	uint32_t comp_id;
113 } __packed;
114 
115 /* flags indicating which time stamps are in sync with each other */
116 #define	SOF_TIME_HOST_SYNC	(1 << 0)
117 #define	SOF_TIME_DAI_SYNC	(1 << 1)
118 #define	SOF_TIME_WALL_SYNC	(1 << 2)
119 #define	SOF_TIME_STAMP_SYNC	(1 << 3)
120 
121 /* flags indicating which time stamps are valid */
122 #define	SOF_TIME_HOST_VALID	(1 << 8)
123 #define	SOF_TIME_DAI_VALID	(1 << 9)
124 #define	SOF_TIME_WALL_VALID	(1 << 10)
125 #define	SOF_TIME_STAMP_VALID	(1 << 11)
126 
127 /* flags indicating time stamps are 64bit else 3use low 32bit */
128 #define	SOF_TIME_HOST_64	(1 << 16)
129 #define	SOF_TIME_DAI_64		(1 << 17)
130 #define	SOF_TIME_WALL_64	(1 << 18)
131 #define	SOF_TIME_STAMP_64	(1 << 19)
132 
133 struct sof_ipc_stream_posn {
134 	struct sof_ipc_reply rhdr;
135 	uint32_t comp_id;	/**< host component ID */
136 	uint32_t flags;		/**< SOF_TIME_ */
137 	uint32_t wallclock_hz;	/**< frequency of wallclock in Hz */
138 	uint32_t timestamp_ns;	/**< resolution of timestamp in ns */
139 	uint64_t host_posn;	/**< host DMA position in bytes */
140 	uint64_t dai_posn;	/**< DAI DMA position in bytes */
141 	uint64_t comp_posn;	/**< comp position in bytes */
142 	uint64_t wallclock;	/**< audio wall clock */
143 	uint64_t timestamp;	/**< system time stamp */
144 	uint32_t xrun_comp_id;	/**< comp ID of XRUN component */
145 	int32_t xrun_size;	/**< XRUN size in bytes */
146 }  __packed;
147 
148 #endif
149