diff options
Diffstat (limited to 'hifi/xaf/hifi-dpf/audio/xa-class-audio-codec.c')
| -rw-r--r-- | hifi/xaf/hifi-dpf/audio/xa-class-audio-codec.c | 785 |
1 files changed, 0 insertions, 785 deletions
diff --git a/hifi/xaf/hifi-dpf/audio/xa-class-audio-codec.c b/hifi/xaf/hifi-dpf/audio/xa-class-audio-codec.c deleted file mode 100644 index ce233f07..00000000 --- a/hifi/xaf/hifi-dpf/audio/xa-class-audio-codec.c +++ /dev/null @@ -1,785 +0,0 @@ -/******************************************************************************* -* Copyright (C) 2018 Cadence Design Systems, Inc. -* -* Permission is hereby granted, free of charge, to any person obtaining -* a copy of this software and associated documentation files (the -* "Software"), to use this Software with Cadence processor cores only and -* not with any other processors and platforms, subject to -* the following conditions: -* -* The above copyright notice and this permission notice shall be included -* in all copies or substantial portions of the Software. -* -* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY -* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, -* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE -* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -******************************************************************************/ - -/******************************************************************************* - * xa-class-audio-codec.c - * - * Generic audio codec task implementation - * - ******************************************************************************/ - -#define MODULE_TAG CODEC - -/******************************************************************************* - * Includes - ******************************************************************************/ - -#include "xf.h" -#include "xa-class-base.h" -#include "audio/xa-audio-decoder-api.h" - -/******************************************************************************* - * Tracing configuration - ******************************************************************************/ - -TRACE_TAG(INIT, 1); -TRACE_TAG(WARNING, 1); -TRACE_TAG(INFO, 1); -TRACE_TAG(INPUT, 1); -TRACE_TAG(OUTPUT, 1); -TRACE_TAG(DECODE, 1); - -/******************************************************************************* - * Internal functions definitions - ******************************************************************************/ - -typedef struct XAAudioCodec -{ - /*************************************************************************** - * Control data - **************************************************************************/ - - /* ...generic audio codec data */ - XACodecBase base; - - /* ...input port data */ - xf_input_port_t input; - - /* ...output port data */ - xf_output_port_t output; - - /* ...input port index */ - WORD32 in_idx; - - /* ...output port index */ - WORD32 out_idx; - - /*************************************************************************** - * Run-time configuration parameters - **************************************************************************/ - - /* ...sample size in bytes */ - u32 sample_size; - - /* ...audio sample duration */ - u32 factor; - - /* ...total number of produced audio frames since last reset */ - u32 produced; - -} XAAudioCodec; - -/******************************************************************************* - * Auxiliary codec execution flags - ******************************************************************************/ - -/* ...input port setup condition */ -#define XA_CODEC_FLAG_INPUT_SETUP __XA_BASE_FLAG(1 << 0) - -/* ...output port setup condition */ -#define XA_CODEC_FLAG_OUTPUT_SETUP __XA_BASE_FLAG(1 << 1) - -/******************************************************************************* - * Data processing scheduling - ******************************************************************************/ - -/* ...prepare codec for steady operation (tbd - don't absolutely like it) */ -static inline XA_ERRORCODE xa_codec_prepare_runtime(XAAudioCodec *codec) -{ - XACodecBase *base = (XACodecBase *)codec; - xf_message_t *m = xf_msg_queue_head(&codec->output.queue); - xf_start_msg_t *msg = m->buffer; - u32 frame_size; - u32 factor; - - /* ...fill-in buffer parameters */ - XA_API(base, XA_API_CMD_GET_CONFIG_PARAM, XA_CODEC_CONFIG_PARAM_SAMPLE_RATE, &msg->sample_rate); - XA_API(base, XA_API_CMD_GET_CONFIG_PARAM, XA_CODEC_CONFIG_PARAM_CHANNELS, &msg->channels); - XA_API(base, XA_API_CMD_GET_CONFIG_PARAM, XA_CODEC_CONFIG_PARAM_PCM_WIDTH, &msg->pcm_width); - XA_API(base, XA_API_CMD_GET_MEM_INFO_SIZE, codec->in_idx, &msg->input_length); - XA_API(base, XA_API_CMD_GET_MEM_INFO_SIZE, codec->out_idx, &msg->output_length); - - TRACE(INIT, _b("codec[%p]::runtime init: f=%u, c=%u, w=%u, i=%u, o=%u"), codec, msg->sample_rate, msg->channels, msg->pcm_width, msg->input_length, msg->output_length); - - /* ...reallocate input port buffer as needed - tbd */ - BUG(msg->input_length > codec->input.length, _x("Input buffer reallocation required: %u to %u"), codec->input.length, msg->input_length); - - /* ...save sample size in bytes */ - codec->sample_size = msg->channels * (msg->pcm_width == 16 ? 2 : 4); - - /* ...calculate frame duration; get number of samples in the frame (don't like division here - tbd) */ - frame_size = msg->output_length / codec->sample_size; - - /* ...it must be a multiple */ - XF_CHK_ERR(frame_size * codec->sample_size == msg->output_length, XA_API_FATAL_INVALID_CMD_TYPE); - - /* ...retrieve upsampling factor for given sample rate */ - XF_CHK_ERR(factor = xf_timebase_factor(msg->sample_rate), XA_API_FATAL_INVALID_CMD_TYPE); - - /* ...set frame duration factor (converts number of bytes into timebase units) */ - codec->factor = factor / codec->sample_size; - - TRACE(INIT, _b("ts-factor: %u (%u)"), codec->factor, factor); - - BUG(codec->factor * codec->sample_size != factor, _x("Freq mismatch: %u vs %u"), codec->factor * codec->sample_size, factor); - - /* ...pass response to caller (push out of output port) */ - xf_output_port_produce(&codec->output, sizeof(*msg)); - - /* ...codec runtime initialization is completed */ - TRACE(INIT, _b("codec[%p] runtime initialized: i=%u, o=%u"), codec, msg->input_length, msg->output_length); - - return XA_NO_ERROR; -} - -/******************************************************************************* - * Commands processing - ******************************************************************************/ - -/* ...EMPTY-THIS-BUFFER command processing */ -static XA_ERRORCODE xa_codec_empty_this_buffer(XACodecBase *base, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - /* ...make sure the port is valid */ - XF_CHK_ERR(XF_MSG_DST_PORT(m->id) == 0, XA_API_FATAL_INVALID_CMD); - - /* ...command is allowed only in post-init state */ - XF_CHK_ERR(base->state & XA_BASE_FLAG_POSTINIT, XA_API_FATAL_INVALID_CMD); - - /* ...put message into input queue */ - if (xf_input_port_put(&codec->input, m)) - { - /* ...restart stream if it is in completed state */ - if (base->state & XA_BASE_FLAG_COMPLETED) - { - /* ...reset execution stage */ - base->state = XA_BASE_FLAG_POSTINIT | XA_BASE_FLAG_EXECUTION; - - /* ...reset execution runtime */ - XA_API(base, XA_API_CMD_EXECUTE, XA_CMD_TYPE_DO_RUNTIME_INIT, NULL); - - /* ...reset produced samples counter */ - codec->produced = 0; - } - - /* ...codec must be in one of these states */ - XF_CHK_ERR(base->state & (XA_BASE_FLAG_RUNTIME_INIT | XA_BASE_FLAG_EXECUTION), XA_API_FATAL_INVALID_CMD); - - /* ...schedule data processing if output is ready */ - if (xf_output_port_ready(&codec->output)) - { - xa_base_schedule(base, 0); - } - } - - TRACE(INPUT, _b("Received buffer [%p]:%u"), m->buffer, m->length); - - return XA_NO_ERROR; -} - -/* ...FILL-THIS-BUFFER command processing */ -static XA_ERRORCODE xa_codec_fill_this_buffer(XACodecBase *base, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - /* ...make sure the port is valid */ - XF_CHK_ERR(XF_MSG_DST_PORT(m->id) == 1, XA_API_FATAL_INVALID_CMD); - - /* ...command is allowed only in postinit state */ - XF_CHK_ERR(base->state & XA_BASE_FLAG_POSTINIT, XA_API_FATAL_INVALID_CMD); - - /* ...special handling of zero-length buffer */ - if (base->state & XA_BASE_FLAG_RUNTIME_INIT) - { - /* ...message must be zero-length */ - BUG(m->length != 0, _x("Invalid message length: %u"), m->length); - } - else if (m == xf_output_port_control_msg(&codec->output)) - { - /* ...end-of-stream processing indication received; check the state */ - BUG((base->state & XA_BASE_FLAG_COMPLETED) == 0, _x("invalid state: %x"), base->state); - - /* ... mark flushing sequence is done */ - xf_output_port_flush_done(&codec->output); - - /* ...complete pending zero-length input buffer */ - xf_input_port_purge(&codec->input); - - TRACE(INFO, _b("codec[%p] playback completed"), codec); - - /* ...playback is over */ - return XA_NO_ERROR; - } - else if ((base->state & XA_BASE_FLAG_COMPLETED) && !xf_output_port_routed(&codec->output)) - { - /* ...return message arrived from application immediately */ - xf_response_ok(m); - - return XA_NO_ERROR; - } - else - { - TRACE(OUTPUT, _b("Received output buffer [%p]:%u"), m->buffer, m->length); - - /* ...adjust message length (may be shorter than original) */ - m->length = codec->output.length; - } - - /* ...place message into output port */ - if (xf_output_port_put(&codec->output, m) && xf_input_port_ready(&codec->input)) - { - /* ...schedule data processing instantly */ - if (base->state & (XA_BASE_FLAG_RUNTIME_INIT | XA_BASE_FLAG_EXECUTION)) - { - xa_base_schedule(base, 0); - } - } - - return XA_NO_ERROR; -} - -/* ...output port routing */ -static XA_ERRORCODE xa_codec_port_route(XACodecBase *base, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - xf_route_port_msg_t *cmd = m->buffer; - xf_output_port_t *port = &codec->output; - u32 src = XF_MSG_DST(m->id); - u32 dst = cmd->dst; - - /* ...command is allowed only in "postinit" state */ - XF_CHK_ERR(base->state & XA_BASE_FLAG_POSTINIT, XA_API_FATAL_INVALID_CMD); - - /* ...make sure output port is addressed */ - XF_CHK_ERR(XF_MSG_DST_PORT(m->id) == 1, XA_API_FATAL_INVALID_CMD_TYPE); - - /* ...make sure port is not routed yet */ - XF_CHK_ERR(!xf_output_port_routed(port), XA_API_FATAL_INVALID_CMD_TYPE); - - /* ...route output port - allocate queue */ - XF_CHK_ERR(xf_output_port_route(port, __XF_MSG_ID(dst, src), cmd->alloc_number, cmd->alloc_size, cmd->alloc_align) == 0, XA_API_FATAL_MEM_ALLOC); - - /* ...schedule processing instantly */ - xa_base_schedule(base, 0); - - /* ...pass success result to caller */ - xf_response_ok(m); - - return XA_NO_ERROR; -} - -/* ...port unroute command */ -static XA_ERRORCODE xa_codec_port_unroute(XACodecBase *base, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - /* ...command is allowed only in "postinit" state */ - XF_CHK_ERR(base->state & XA_BASE_FLAG_POSTINIT, XA_API_FATAL_INVALID_CMD); - - /* ...make sure output port is addressed */ - XF_CHK_ERR(XF_MSG_DST_PORT(m->id) == 1, XA_API_FATAL_INVALID_CMD_TYPE); - - /* ...cancel any pending processing */ - xa_base_cancel(base); - - /* ...clear output-port-setup condition */ - base->state &= ~XA_CODEC_FLAG_OUTPUT_SETUP; - - /* ...pass flush command down the graph */ - if (xf_output_port_flush(&codec->output, XF_FLUSH)) - { - TRACE(INFO, _b("port is idle; instantly unroute")); - - /* ...flushing sequence is not needed; command may be satisfied instantly */ - xf_output_port_unroute(&codec->output); - - /* ...pass response to the proxy */ - xf_response_ok(m); - } - else - { - TRACE(INFO, _b("port is busy; propagate unroute command")); - - /* ...flushing sequence is started; save flow-control message */ - xf_output_port_unroute_start(&codec->output, m); - } - - return XA_NO_ERROR; -} - -/* ...FLUSH command processing */ -static XA_ERRORCODE xa_codec_flush(XACodecBase *base, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - /* ...command is allowed only in "postinit" state */ - XF_CHK_ERR(base->state & XA_BASE_FLAG_POSTINIT, XA_API_FATAL_INVALID_CMD); - - /* ...ensure input parameter length is zero */ - XF_CHK_ERR(m->length == 0, XA_API_FATAL_INVALID_CMD_TYPE); - - TRACE(1, _b("flush command received")); - - /* ...flush command must be addressed to input port */ - if (XF_MSG_DST_PORT(m->id) == 0) - { - /* ...cancel data processing message if needed */ - xa_base_cancel(base); - - /* ...input port flushing; purge content of input buffer */ - xf_input_port_purge(&codec->input); - - /* ...clear input-ready condition */ - base->state &= ~XA_CODEC_FLAG_INPUT_SETUP; - - /* ...reset execution runtime */ - XA_API(base, XA_API_CMD_EXECUTE, XA_CMD_TYPE_DO_RUNTIME_INIT, NULL); - - /* ...reset produced samples counter */ - codec->produced = 0; - - /* ...propagate flushing command to output port */ - if (xf_output_port_flush(&codec->output, XF_FLUSH)) - { - /* ...flushing sequence is not needed; satisfy command instantly */ - xf_response(m); - } - else - { - /* ...flushing sequence is started; save flow-control message at input port */ - xf_input_port_control_save(&codec->input, m); - } - } - else if (xf_output_port_unrouting(&codec->output)) - { - /* ...flushing during port unrouting; complete unroute sequence */ - xf_output_port_unroute_done(&codec->output); - - TRACE(INFO, _b("port is unrouted")); - } - else - { - /* ...output port flush command/response; check if the port is routed */ - if (!xf_output_port_routed(&codec->output)) - { - /* ...complete all queued messages */ - xf_output_port_flush(&codec->output, XF_FLUSH); - - /* ...and pass response to flushing command */ - xf_response(m); - } - else - { - /* ...response to flushing command received */ - BUG(m != xf_output_port_control_msg(&codec->output), _x("invalid message: %p"), m); - - /* ...mark flushing sequence is completed */ - xf_output_port_flush_done(&codec->output); - - /* ...complete original flow-control command */ - xf_input_port_purge_done(&codec->input); - } - - /* ...clear output-setup condition */ - base->state &= ~XA_CODEC_FLAG_OUTPUT_SETUP; - } - - return XA_NO_ERROR; -} - -/******************************************************************************* - * Generic codec API - ******************************************************************************/ - -/* ...memory buffer handling */ -static XA_ERRORCODE xa_codec_memtab(XACodecBase *base, WORD32 idx, WORD32 type, WORD32 size, WORD32 align, u32 core) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - if (type == XA_MEMTYPE_INPUT) - { - /* ...input port specification; allocate internal buffer */ - XF_CHK_ERR(xf_input_port_init(&codec->input, size, align, core) == 0, XA_API_FATAL_MEM_ALLOC); - - /* ...save input port index */ - codec->in_idx = idx; - - /* ...set input buffer pointer as needed */ - (size ? XA_API(base, XA_API_CMD_SET_MEM_PTR, idx, codec->input.buffer) : 0); - - (size ? TRACE(1, _x("set input ptr: %p"), codec->input.buffer) : 0); - } - else - { - /* ...output buffer specification */ - XF_CHK_ERR(type == XA_MEMTYPE_OUTPUT, XA_API_FATAL_INVALID_CMD_TYPE); - - /* ...initialize output port queue (no allocation here yet) */ - XF_CHK_ERR(xf_output_port_init(&codec->output, size) == 0, XA_API_FATAL_MEM_ALLOC); - - /* ...save output port index */ - codec->out_idx = idx; - } - - return XA_NO_ERROR; -} - -/* ...prepare input/output buffers */ -static XA_ERRORCODE xa_codec_preprocess(XACodecBase *base) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - /* ...prepare output buffer if needed */ - if (!(base->state & XA_CODEC_FLAG_OUTPUT_SETUP)) - { - void *output; - - /* ...get output buffer from port, if possible */ - if (base->state & XA_BASE_FLAG_RUNTIME_INIT) - { - /* ...run-time is not initialized yet; use scratch buffer */ - output = base->scratch; - } - else if ((output = xf_output_port_data(&codec->output)) == NULL) - { - /* ...no output buffer available */ - return XA_CODEC_EXEC_NO_DATA; - } - - /* ...set the output buffer pointer */ - XA_API(base, XA_API_CMD_SET_MEM_PTR, codec->out_idx, output); - - TRACE(1, _x("set output ptr: %p"), output); - - /* ...mark output port is setup */ - base->state ^= XA_CODEC_FLAG_OUTPUT_SETUP; - } - - /* ...prepare input data if needed */ - if (!(base->state & XA_CODEC_FLAG_INPUT_SETUP)) - { - void *input; - u32 filled; - - /* ...fill input buffer */ - if (xf_input_port_bypass(&codec->input)) - { - /* ...use input buffer directly; check if there is data available */ - if ((input = xf_input_port_data(&codec->input)) != NULL) - { - /* ...set input data buffer pointer */ - XA_API(base, XA_API_CMD_SET_MEM_PTR, codec->in_idx, input); - - /* ...retrieve number of input bytes */ - filled = xf_input_port_length(&codec->input); - } - else if (!xf_input_port_done(&codec->input)) - { - /* ...return non-fatal indication to prevent further processing */ - return XA_CODEC_EXEC_NO_DATA; - } - else - { - /* ...mark we have no data in current buffer */ - filled = 0; - } - } - else - { - /* ...port is in non-bypass mode; try to fill internal buffer */ - if (xf_input_port_done(&codec->input) || xf_input_port_fill(&codec->input)) - { - /* ...retrieve number of bytes in input buffer (not really - tbd) */ - filled = xf_input_port_level(&codec->input); - } - else - { - /* ...return non-fatal indication to prevent further processing */ - return XA_CODEC_EXEC_NO_DATA; - } - } - - /* ...check if input stream is over */ - if (xf_input_port_done(&codec->input)) - { - /* ...pass input-over command to the codec to indicate the final buffer */ - XA_API(base, XA_API_CMD_INPUT_OVER, codec->in_idx, NULL); - - TRACE(INFO, _b("codec[%p]: signal input-over (filled: %u)"), codec, filled); - } - - TRACE(INPUT, _b("input-buffer fill-level: %u bytes"), filled); - - /* ...specify number of bytes available in the input buffer */ - XA_API(base, XA_API_CMD_SET_INPUT_BYTES, codec->in_idx, &filled); - - /* ...mark input port is setup */ - base->state ^= XA_CODEC_FLAG_INPUT_SETUP; - } - - return XA_NO_ERROR; -} - -/* ...post-processing operation; input/output ports maintenance */ -static XA_ERRORCODE xa_codec_postprocess(XACodecBase *base, int done) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - WORD32 consumed = 0; - WORD32 produced = 0; - - /* ...get number of consumed / produced bytes */ - XA_API(base, XA_API_CMD_GET_CURIDX_INPUT_BUF, codec->in_idx, &consumed); - - /* ...get number of produced bytes only if runtime is initialized (sample size is known) */ - (codec->sample_size ? XA_API(base, XA_API_CMD_GET_OUTPUT_BYTES, codec->out_idx, &produced) : 0); - - TRACE(DECODE, _b("codec[%p]::postprocess(c=%u, p=%u, d=%u)"), codec, consumed, produced, done); - - /* ...input buffer maintenance; check if we consumed anything */ - if (consumed) - { - /* ...consume specified number of bytes from input port */ - xf_input_port_consume(&codec->input, consumed); - - /* ...clear input-setup flag */ - base->state ^= XA_CODEC_FLAG_INPUT_SETUP; - } - - /* ...output buffer maintenance; check if we have produced anything */ - if (produced) - { - /* ...increment total number of produced samples (really don't like division here - tbd) */ - codec->produced += produced / codec->sample_size; - - /* ...immediately complete output buffer (don't wait until it gets filled) */ - xf_output_port_produce(&codec->output, produced); - - /* ...clear output port setup flag */ - base->state ^= XA_CODEC_FLAG_OUTPUT_SETUP; - } - - /* ...process execution stage transition */ - if (done) - { - if (base->state & XA_BASE_FLAG_RUNTIME_INIT) - { - /* ...stream is completed while codec is in runtime initialization stage */ - BUG(1, _x("breakpoint")); - } - else if (base->state & XA_BASE_FLAG_EXECUTION) - { - /* ...runtime initialization done */ - XA_CHK(xa_codec_prepare_runtime(codec)); - - /* ...clear output port setup flag as we were using scratch buffer; - * technically, no need to repeat setup of input buffer, but some codecs require - * it as well - */ - base->state &= ~(XA_CODEC_FLAG_INPUT_SETUP | XA_CODEC_FLAG_OUTPUT_SETUP); - } - else - { - /* ...output stream is over; propagate condition to sink port */ - if (xf_output_port_flush(&codec->output, XF_FILL_THIS_BUFFER)) - { - /* ...flushing sequence is not needed; complete pending zero-length input */ - xf_input_port_purge(&codec->input); - - /* ...no propagation to output port */ - TRACE(INFO, _b("codec[%p] playback completed"), codec); - } - else - { - /* ...flushing sequence is started; wait until flow-control message returns */ - TRACE(INFO, _b("propagate end-of-stream condition")); - } - } - - /* ...return early to prevent task rescheduling */ - return XA_NO_ERROR; - } - - /* ...reschedule processing if needed */ - if (xf_input_port_ready(&codec->input) && xf_output_port_ready(&codec->output)) - { - /* ...schedule data processing with respect to its urgency */ - xa_base_schedule(base, produced * codec->factor); - } - - return XA_NO_ERROR; -} - -/* ...configuration parameter retrieval */ -static XA_ERRORCODE xa_codec_getparam(XACodecBase *base, WORD32 id, pVOID value) -{ - XAAudioCodec *codec = (XAAudioCodec *) base; - - if (id == XA_CODEC_CONFIG_PARAM_PRODUCED) - { - /* ...retrieve number of produced samples since last reset */ - *(u32 *)value = codec->produced; - - return XA_NO_ERROR; - } - else - { - /* ...pass command to underlying codec plugin */ - return XA_API(base, XA_API_CMD_GET_CONFIG_PARAM, id, value); - } -} - -/******************************************************************************* - * Component entry point - ******************************************************************************/ - -/* ...command hooks */ -static XA_ERRORCODE (* const xa_codec_cmd[])(XACodecBase *, xf_message_t *) = -{ - [XF_OPCODE_TYPE(XF_SET_PARAM)] = xa_base_set_param, - [XF_OPCODE_TYPE(XF_GET_PARAM)] = xa_base_get_param, - [XF_OPCODE_TYPE(XF_ROUTE)] = xa_codec_port_route, - [XF_OPCODE_TYPE(XF_UNROUTE)] = xa_codec_port_unroute, - [XF_OPCODE_TYPE(XF_EMPTY_THIS_BUFFER)] = xa_codec_empty_this_buffer, - [XF_OPCODE_TYPE(XF_FILL_THIS_BUFFER)] = xa_codec_fill_this_buffer, - [XF_OPCODE_TYPE(XF_FLUSH)] = xa_codec_flush, - [XF_OPCODE_TYPE(XF_SET_PARAM_EXT)] = xa_base_set_param_ext, - [XF_OPCODE_TYPE(XF_GET_PARAM_EXT)] = xa_base_get_param_ext, -}; - -/* ...total number of commands supported */ -#define XA_CODEC_CMD_NUM (sizeof(xa_codec_cmd) / sizeof(xa_codec_cmd[0])) - -/* ...command processor for termination state (only for routed port case) */ -static int xa_audio_codec_terminate(xf_component_t *component, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) component; - u32 opcode = m->opcode; - - /* ...check if we received output port control message */ - if (m == xf_output_port_control_msg(&codec->output)) - { - /* ...output port flushing complete; mark port is idle and terminate */ - xf_output_port_flush_done(&codec->output); - return -1; - } - else if (opcode == XF_FILL_THIS_BUFFER) - { - /* ...output buffer returned by the sink component; ignore and keep waiting */ - TRACE(OUTPUT, _b("collect output buffer")); - return 0; - } - else if (opcode == XF_UNREGISTER) - { - /* ...ignore subsequent unregister command/response - tbd */ - return 0; - } - else - { - /* ...everything else is responded with generic failure */ - xf_response_err(m); - return 0; - } -} - -/* ...audio codec destructor */ -static int xa_audio_codec_destroy(xf_component_t *component, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) component; - u32 core = xf_component_core(component); - - /* ...destroy input port */ - xf_input_port_destroy(&codec->input, core); - - /* ...destroy output port */ - xf_output_port_destroy(&codec->output, core); - - /* ...deallocate all resources */ - xa_base_destroy(&codec->base, XF_MM(sizeof(*codec)), core); - - TRACE(INIT, _b("audio-codec[%p@%u] destroyed"), codec, core); - - /* ...indicate the client has been destroyed */ - return 0; -} - -/* ...audio codec destructor - first stage (ports unrouting) */ -static int xa_audio_codec_cleanup(xf_component_t *component, xf_message_t *m) -{ - XAAudioCodec *codec = (XAAudioCodec *) component; - - /* ...complete message with error response */ - xf_response_err(m); - - /* ...cancel internal scheduling message if needed */ - xa_base_cancel(&codec->base); - - /* ...purge input port (returns OK? pretty strange at this point - tbd) */ - xf_input_port_purge(&codec->input); - - /* ...propagate unregister command to connected component */ - if (xf_output_port_flush(&codec->output, XF_FLUSH)) - { - /* ...flushing sequence is not needed; destroy audio codec */ - return xa_audio_codec_destroy(component, NULL); - } - else - { - /* ...wait until output port is cleaned; adjust component hooks */ - component->entry = xa_audio_codec_terminate; - component->exit = xa_audio_codec_destroy; - - TRACE(INIT, _b("codec[%p] cleanup sequence started"), codec); - - /* ...indicate that second stage is required */ - return 1; - } -} - -/******************************************************************************* - * Audio codec component factory - ******************************************************************************/ - -xf_component_t * xa_audio_codec_factory(u32 core, xa_codec_func_t process) -{ - XAAudioCodec *codec; - - /* ...allocate local memory for codec structure */ - XF_CHK_ERR(codec = (XAAudioCodec *) xa_base_factory(core, XF_MM(sizeof(*codec)), process), NULL); - - /* ...set base codec API methods */ - codec->base.memtab = xa_codec_memtab; - codec->base.preprocess = xa_codec_preprocess; - codec->base.postprocess = xa_codec_postprocess; - codec->base.getparam = xa_codec_getparam; - - /* ...set message commands processing table */ - codec->base.command = xa_codec_cmd; - codec->base.command_num = XA_CODEC_CMD_NUM; - - /* ...set component destructor hook */ - codec->base.component.exit = xa_audio_codec_cleanup; - - TRACE(INIT, _b("Codec[%p] initialized"), codec); - - return (xf_component_t *) codec; -} |