^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) * This file is provided under a dual BSD/GPLv2 license. When using or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) * redistributing this file, you may do so under either license.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * Copyright(c) 2019 Intel Corporation. All rights reserved.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) #ifndef __IPC_CHANNEL_MAP_H__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) #define __IPC_CHANNEL_MAP_H__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) #include <uapi/sound/sof/header.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) #include <sound/sof/header.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) /**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) * \brief Channel map, specifies transformation of one-to-many or many-to-one.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) * In case of one-to-many specifies how the output channels are computed out of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) * a single source channel,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) * in case of many-to-one specifies how a single target channel is computed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * from a multichannel input stream.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) * Channel index specifies position of the channel in the stream on the 'one'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) * side.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) * Ext ID is the identifier of external part of the transformation. Depending
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) * on the context, it may be pipeline ID, dai ID, ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) * Channel mask describes which channels are taken into account on the "many"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) * side. Bit[i] set to 1 means that i-th channel is used for computation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * (either as source or as a target).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) * Channel mask is followed by array of coefficients in Q2.30 format,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) * one per each channel set in the mask (left to right, LS bit set in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) * mask corresponds to ch_coeffs[0]).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) struct sof_ipc_channel_map {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) uint32_t ch_index;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) uint32_t ext_id;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) uint32_t ch_mask;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) uint32_t reserved;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) int32_t ch_coeffs[0];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) } __packed;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) /**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) * \brief Complete map for each channel of a multichannel stream.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) * num_ch_map Specifies number of items in the ch_map.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) * More than one transformation per a single channel is allowed (in case
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) * multiple external entities are transformed).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) * A channel may be skipped in the transformation list, then it is filled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) * with 0's by the transformation function.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) struct sof_ipc_stream_map {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) struct sof_ipc_cmd_hdr hdr;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) uint32_t num_ch_map;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) uint32_t reserved[3];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) struct sof_ipc_channel_map ch_map[0];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) } __packed;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) #endif /* __IPC_CHANNEL_MAP_H__ */