stream.h (4579B)
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 */ 44enum 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 */ 53enum sof_ipc_buffer_format { 54 SOF_IPC_BUFFER_INTERLEAVED, 55 SOF_IPC_BUFFER_NONINTERLEAVED, 56 /* other formats here */ 57}; 58 59/* stream direction */ 60enum sof_ipc_stream_direction { 61 SOF_IPC_STREAM_PLAYBACK = 0, 62 SOF_IPC_STREAM_CAPTURE, 63}; 64 65/* stream ring info */ 66struct 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 74struct 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 90 uint8_t reserved[5]; 91 uint16_t chmap[SOF_IPC_MAX_CHANNELS]; /**< channel map - SOF_CHMAP_ */ 92} __packed; 93 94/* PCM params info - SOF_IPC_STREAM_PCM_PARAMS */ 95struct sof_ipc_pcm_params { 96 struct sof_ipc_cmd_hdr hdr; 97 uint32_t comp_id; 98 uint32_t flags; /**< generic PCM flags - SOF_PCM_FLAG_ */ 99 uint32_t reserved[2]; 100 struct sof_ipc_stream_params params; 101} __packed; 102 103/* PCM params info reply - SOF_IPC_STREAM_PCM_PARAMS_REPLY */ 104struct sof_ipc_pcm_params_reply { 105 struct sof_ipc_reply rhdr; 106 uint32_t comp_id; 107 uint32_t posn_offset; 108} __packed; 109 110/* free stream - SOF_IPC_STREAM_PCM_PARAMS */ 111struct sof_ipc_stream { 112 struct sof_ipc_cmd_hdr hdr; 113 uint32_t comp_id; 114} __packed; 115 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) 121 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) 127 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) 133 134struct 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 */ 147} __packed; 148 149#endif