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 	uint8_t cont_update_posn; /**< 1 means continuous update stream position */
89 	uint8_t reserved0;
90 	int16_t ext_data_length; /**< 0, means no extended data */
91 	uint8_t reserved[2];
92 	uint16_t chmap[SOF_IPC_MAX_CHANNELS];	/**< channel map - SOF_CHMAP_ */
93 	uint8_t ext_data[]; /**< extended data */
94 } __packed;
95 
96 /* PCM params info - SOF_IPC_STREAM_PCM_PARAMS */
97 struct sof_ipc_pcm_params {
98 	struct sof_ipc_cmd_hdr hdr;
99 	uint32_t comp_id;
100 	uint32_t flags;		/**< generic PCM flags - SOF_PCM_FLAG_ */
101 	uint32_t reserved[2];
102 	struct sof_ipc_stream_params params;
103 }  __packed;
104 
105 /* PCM params info reply - SOF_IPC_STREAM_PCM_PARAMS_REPLY */
106 struct sof_ipc_pcm_params_reply {
107 	struct sof_ipc_reply rhdr;
108 	uint32_t comp_id;
109 	uint32_t posn_offset;
110 } __packed;
111 
112 /* free stream - SOF_IPC_STREAM_PCM_PARAMS */
113 struct sof_ipc_stream {
114 	struct sof_ipc_cmd_hdr hdr;
115 	uint32_t comp_id;
116 } __packed;
117 
118 /* flags indicating which time stamps are in sync with each other */
119 #define	SOF_TIME_HOST_SYNC	(1 << 0)
120 #define	SOF_TIME_DAI_SYNC	(1 << 1)
121 #define	SOF_TIME_WALL_SYNC	(1 << 2)
122 #define	SOF_TIME_STAMP_SYNC	(1 << 3)
123 
124 /* flags indicating which time stamps are valid */
125 #define	SOF_TIME_HOST_VALID	(1 << 8)
126 #define	SOF_TIME_DAI_VALID	(1 << 9)
127 #define	SOF_TIME_WALL_VALID	(1 << 10)
128 #define	SOF_TIME_STAMP_VALID	(1 << 11)
129 
130 /* flags indicating time stamps are 64bit else 3use low 32bit */
131 #define	SOF_TIME_HOST_64	(1 << 16)
132 #define	SOF_TIME_DAI_64		(1 << 17)
133 #define	SOF_TIME_WALL_64	(1 << 18)
134 #define	SOF_TIME_STAMP_64	(1 << 19)
135 
136 struct sof_ipc_stream_posn {
137 	struct sof_ipc_reply rhdr;
138 	uint32_t comp_id;	/**< host component ID */
139 	uint32_t flags;		/**< SOF_TIME_ */
140 	uint32_t wallclock_hz;	/**< frequency of wallclock in Hz */
141 	uint32_t timestamp_ns;	/**< resolution of timestamp in ns */
142 	uint64_t host_posn;	/**< host DMA position in bytes */
143 	uint64_t dai_posn;	/**< DAI DMA position in bytes */
144 	uint64_t comp_posn;	/**< comp position in bytes */
145 	uint64_t wallclock;	/**< audio wall clock */
146 	uint64_t timestamp;	/**< system time stamp */
147 	uint32_t xrun_comp_id;	/**< comp ID of XRUN component */
148 	int32_t xrun_size;	/**< XRUN size in bytes */
149 }  __packed;
150 
151 #endif
152