#
# Copyright (c) 2015-2022 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 deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, 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.
#
======================================================================
Xtensa Audio Framework (XAF) - Hostless solution
======================================================================
======================================================================
Revision History
======================================================================
Version 2.10 API 2.1 : November 24, 2021
+ GA Release
+ Built with RI.6 tools
+ Compiled with xt-clang compiler
+ [J3058] In AEC23 plugin, added changes to return non-fatal error if
both input ports have 0 length input data. Also non-fatal error is
returned during execution if the output buffer is NULL.
+ [J3066] Added checks to prevent the input buffer fill level from
going negative in xf_input_port_consume function if input-port
bypass is enabled and a corresponding CRITICAL trace print.
This could happen if the component plugin incorrectly reports
consumed bytes to be greater than the input bytes.
+ [J3070] Corrected components' default priority calculation logic to
ensure that the default priority remains the highest priority among
the DSP worker threads.
+ [J3077] Modified TIMEBASE_FREQ value to support 1 to 16 channels;
1,2,3 or 4 bytes per PCM-sample and commonly used sample rates
between 4000 to 192000 Hz. Also made changes in prepare_runtime
function of all the classes to support 8 bits per PCM-sample.
+ Compiler warning fixes:
Fixed two "comparison of integers of different signs" warnings
observed with -Wextra build option in xf-proxy.c.
+ Testbench changes:
Corrected the argument type of comp_cycles passed to
compute_comp_mcps function from 'int' to 'long long'.
----------------------------------------------------------------------
Version 2.9_Beta API 2.1 : September 24, 2021
+ Built with RI.6 tools
+ Compiled with xt-clang compiler
+ Programmers Guide not updated
+ [J2564] Reverted workaround code change to address XOS thread
abort issue, since the the fix is available in newer tools version
(RI.6 and above).
+ [J2928] Extended set/get config APIs are also enabled for MIMO, Mixer
and Renderer classes.
+ [J2970] Added changes for graceful handling of fatal errors from
message processing function xf_core_process_message().
+ [J2982] Corrected a condition check in "xf_worker_queue_purge"
function.
+ [J3023] Fix to avoid scheduling of components after a fatal error
has occured.
+ [J3025] Fixed validation of frame_size to be multiple of
codec->sample_size by using the input-buffer length (PCM) instead
of the output buffer length for encoder components.
+ [J3028] Added checks to avoid NULL pointer access after component
deletion in the local message submit logic(same thread components).
+ Optimization changes:
Optimized memory usage by removing base_cancel_pool related code
when preemption is active and decentralized scheduling is used.
+ Robustness fixes:
1. Replaced XF_CHK_ERR with condition check and to print appropriate
trace message with WARNING tag instead of ERROR tag in the function
xa_base_event_handler().
2. Corrected return value if the component's scheduled processing
occurs when it is in terminate state (all classes).
3. Corrected a trace print in xf_mm_alloc().
4. Fixed component state check in xaf_comp_get_status() API to
return the correct status to the application if the component delete
was already initiated.
+ Plugin changes:
1. Renamed opus encoder plugin directory from "opus" to "opus_enc".
2. Corrected mimo plugins' input and output buffer NULL check
error values.
+ Testbench changes:
1. The following new testbench is added:
- xaf-full-duplex-opus-test.c (Opus Full Duplex Pipeline).
2. The following testbeches are no longer packed:
- xaf-full-duplex-test.c
- xaf-aac-dec-test.c
- xaf-src-test.c
- xaf-vorbis-dec-test.c
- xaf-opus-enc-test.c
- xaf-opus-dec-test.c
3. Added 2 more MCPS prints after testbench execution
XAF MCPS and Total MCPS (DSP Component MCPS + Framework MCPS).
4. Fixed memory corruption in xa_app_receive_events_cb() due to
write event array index exceeding maximum value.
+ Packaging changes:
Added support for the following multiple testbench project in xws
package which can be built and run out-of-the-box(15 test projects)
- testxa_af_hostless
- testxa_af_mimo_mix
- testxa_af_gain_renderer
- testxa_af_capturer_gain
- testxa_af_renderer_ref_port
- testxa_af_dec*
- testxa_af_dec_mix*
- testxa_af_amr_wb_dec*
- testxa_af_mp3_dec_rend*
- testxa_af_capturer_mp3_enc*
- testxa_af_playback_usecase*
- testxa_af_full_duplex_opus*
- testxa_af_tflm_microspeech*
- testxa_af_tflm_pd*
- testxa_af_tflm_microspeech_pd*
The test projects with(*) require dependent libraries, header files
and Additional Liker path to be provided.
+ Notes:
1. xaf_comp_set_config_ext and xaf_comp_get_config_ext API usage is
now demonstrated in the functions opus_dec_setup() and
get_opus_dec_config() of the newly added Opus Full Duplex testbench
(xaf-full-duplex-opus-test.c).
2. testxa_af_hostless project has common test_inp and test_out
directory hosting input and output files of all the test projects in
the package. Hence user must import this project into the workspace.
3. For testxa_af_full_duplex_opus, xa_opus_codec.a of only one of
the opus_enc or opus_dec plugin needs to be provided for linking.
----------------------------------------------------------------------
Version 2.8_Alpha API 2.1 : August 11, 2021
+ Built with RI.6 tools
+ Programmers Guide not updated
+ [J2893] xaf_format_t type used by the application is moved from
xaf-api.h to xaf-utils-test.h.
+ [J2908] Fixed critical Coverity scan errors in xaf library, PCM-Gain
plugin and FreeRTOS.
+ [J2914] Enabled support for decoder initialization without input.
+ [J2928] Added support for extended get-config and set-config to
support more than 4 bytes of data per config parameter.
+ [J2942] Added support for input port bypass to avoid data copy at
input ports from connect buffers to input buffer of components.
+ [J2943] Added per-worker-thread de-centralized scheduler and
message queue for MCPS reduction.
+ [J2952] Corrected component ID of SRC component from
"audio-fx/src-pp" to "post-proc/src-pp".
+ [J2957] Corrected output buffer length adjustment in mimo-class and
mixer class fill-this-buffer functions.
+ [J2973] Reverted flexi-lock optimizations around sync-msg-queues
to ensure sync-msg-queues always have locked access.
+ [J2977] Enabled propagation of non-fatal error codes for synchronous
APIs through response message.
+ [J2979] Enabled CRITICAL trace prints with minimal increase in code
size (~2%).
+ [J2982] Fixed a memory corruption issue by responding to pending
worker queue messages during component deletion.
+ [J2985] Fixed potential buffer corruption due to concurrent
auxiliary buffer access.
+ [J2999] Added changes to avoid relax-schedule check for output port
readiness of MIMO components during initialization.
+ Added following new APIs:
1. xaf_comp_set_config_ext(pVOID comp_ptr, WORD32 num_param,
WORD32 *p_param);
Note: This API is not a replacement for existing API used for
component setup(xaf_comp_set_config) and it should not be used
until component setup is done.
2. xaf_comp_get_config_ext(pVOID comp_ptr, WORD32 num_param,
WORD32 *p_param);
+ Plugin changes:
1. Consumed bytes variable to consider any partial bytes less than
sample_size. This change is done in PCM-Gain, Mimo-mix, PCM-Split
and Mixer component plugins.
2. Updated Mixer plugin to avoid memset on the input buffer if
filled partially.
+ Robustness fixes:
1. Added component state check after xf_response_get() in
xaf_comp_get_status() API call. This prevents any buffer access
after the component gets deleted.
2. Corrected a condition check for xf_client_lookup() in
dsp_worker_entry().
+ Notes:
1. Input-port-bypass is activated if the plugin reports its input
buffer size as zero when queried with XA_API_CMD_GET_MEM_INFO_SIZE.
A usage is demonstarted in the plugin PCM-Gain(xa-pcm-gain.c) under
the disabled compile time option XA_INPORT_BYPASS_TEST.
2. xaf_comp_set_config_ext and xaf_comp_get_config_ext API usage is
demonstrated in the functions get_opus_dec_config() and
opus_dec_setup() of Opus decoder testbench(xaf-opus-dec-test.c)
and support a maximum of 8 configuation parameters per API call.
3. Usage of decoder component intialization without input data is
shown in the AMR decoder testbench(xaf-amr-wb-dec-test.c).
----------------------------------------------------------------------
Version 2.7_Alpha API 2.0 : May 28, 2021
+ Alpha Release
+ Built with RI.6 tools, xt-clang compiler
+ Programmers Guide not updated
+ Added support for TensorFlow Lite For Micro (TFLM) inference
networks to be added as components in XAF.
+ Added following two XAF components to demonstrate TFLM support
- Microspeech Yes-No Recognizer
- Person Detect
+ Added following three XAF applications to demonstrate TFLM support
- Microspeech Yes-No Recognizer Application
- Person Detect Application
- Simultaneous Microspeech and Person Detect Application
+ Note: TFLM code or libraries are not included in the package.
Please refer to $libxa_af_hostless/build/readme_tflm.txt for details
on how to download and build TFLM code, and TFLM XAF applications.
+ Note: The XAF TFLM support is built and tested with:
https://github.com/tensorflow/tensorflow/commit/a1acddcf3f990332b5f0bd19faba1d6e256787f0
----------------------------------------------------------------------
Version 2.6 API 2.0 : March 31, 2021
+ GA Release
+ Built with RI.2 tools
+ [J2877] Fixed potential memory overwrite bug by returning UWORD32
instead of UWORD64 during get-config for capturer and renderer
component plugins.
+ [J2806] Fixed the rollback logic to avoid memory corruption when
event channel creation fails.
+ [J2804] Fixed the rollback logic during port routing to prevent
propagation of already freed buffers.
+ [J2799] Reduced maximum number of event buffers per channel from
1024 to 16.
+ [J2746] Renderer plugin state changed to IDLE when execution is
complete.
----------------------------------------------------------------------
Version 2.5_Beta API 2.0 : January 08, 2021
+ Beta release
+ Built with RI.2 tools
+ Programmers Guide not updated
+ [J2714] Schedule-tree bug fixes for deleting a node which is not
present on the schedule-tree and for adding a node which is already
present on the schedule-tree
+ [J2662] Compulsory flush message propagation when triggered due to
natural EOS in execution, even if the port is IDLE.
+ [J2624] In Opus encoder plugin, corrected bytes consumed calculation
for multi-channel inputs.
+ [J2617] Corrected the calling order of functions in all the classes,
xf_output_port_flush_done and xf_output_port_unroute_done to enable
correct state update (uses XOR operation to toggle states).
+ [J2611] Corrected duplicate bit-masks for two of the component
states in mimo-proc class (XA_OUT_TRACK_FLAG_FLUSHING_DONE and
XA_MIMO_FLAG_PROBE_SETUP)
+ [J2601] Added -mcoproc compiler option to all source file
compilation of library that are not associated with ISR.
+ [J2600] -Wextra warnings: Removed warnings other than
'unused variable' for library
+ [J2592] Added check for maximum alignment value in xf_mem_alloc()
+ Robustness Fixes:
- Core:
1. Introduced component lookup after dequeue of message from worker
queue, and reply with appropriate response if the lookup fails.
When component lookup fails, prevent internally generated UNREGISTER
message by responding with an internal response_failure message.
2. Components are assigned the highest-worker-thread priority when
created until the set-config-parameter stage where the priority is
reverted to that of either the background-thread or the configured
priority(XAF_COMP_CONFIG_PARAM_PRIORITY)
3. Disabled code related to unused queue "cd->response".
- IO:
1. Added state check XF_INPUT_FLAG_PURGING for xf_input_port_ready
and XF_OUTPUT_FLAG_FLUSHING for xf_output_port_ready.
2. Disabled premature input-port state change from XF_INPUT_FLAG_EOS
to XF_INPUT_FLAG_DONE in xf_input_port_put.
- Base-class:
1. Updated base-cancel mechanism based on the schedule-tree fixes.
When preemption is enabled, base_cancel attempts to remove the node
from schedule-tree, failing which the node is enqueued
into base_cancel queue, which is dropped from processing when a
matching node is dequeued from the worker->queue.
2. Corrected the variable in scratch size assertion/check to that
of the worker_thread_scratch_size in base_postinit.
- Audio-codec class:
1. Flush: if there is a flush on input port, and the flush completes
immediately, then update the base->state to COMPLETED if the output
port is unrouted.
2. Probe_pause: probe_stop should complete flushing the probe port
without checking if base->state is COMPLETED.
3. Fill_this_buffer: check xf_output_port_ready before scheduling
as the port may be in unrouting or flushing state.
- Mimo-proc class:
1. Terminate: Remove the assert of output port number check
2. Unroute: on unroute, update output port state to unrouted and
indicate disconnect to plugin early.
3. Fill_this_buffer: check if the port is unrouting before changing
the output port state to routed and indicate connect to plugin.
4. Cleanup: avoid setting the state unroute_done which is redundant
at this point.
5. Route: check if the ports are ready before scheduling
6. unroute_done() to be called after the flag
XA_OUT_TRACK_FLAG_FLUSHING_DONE is set, to make sure all flags are
cleared after unroute completes.
7. Fix for handling EMPTY_THIS_BUFFER when in terminate: avoid
calculating output index of a port for any buffer arriving on
input port.
8. Output port flag XA_OUT_TRACK_FLAG_FLUSHING_DONE is cleared when
output is produced.
- All classes:
1. Removed assert check for COMPLETED state in fill_this_buffer().
2. Delayed response to UNREGISTER command from application until
the component completes flushing and freeing of memory.
3. Handling of lookup-failure messages to prevent self-destruction
of the component.
- API:
1. Fixed a range check error in xaf_adev_set_priorities().
- Plugins:
1. Capturer: Avoid assert on NULL output buffer(output buffer is
optional and plugin needs to take appropriate action if NULL).
+ Event communication features:
1. Event communication to application using event channels
2. Fatal and non-fatal error reporting to application (as event)
using event channel per component
3. Event communication from one component to another
4. Self-scheduling support for components from plugins
+ API changes:
1. xaf_adev_open(pVOID *pp_adev, WORD32 audio_frmwk_buf_size,
WORD32 audio_comp_buf_size, xaf_mem_malloc_fxn_t mem_malloc,
xaf_mem_free_fxn_t mem_free)
-> xaf_adev_open(pVOID *pp_adev, xaf_adev_config_t *pconfig)
The old API is retained as xaf_adev_open_deprecated()
New xaf_adev_open() supports configurable scratch memory size (per
worker thread), dsp-thread-priority and proxy-thread-priority,
callback function pointer for events
Older xaf_adev_open API is available as xaf_adev_open_deprecated
2. xaf_comp_create(pVOID adev_ptr, pVOID *pp_comp, xf_id_t comp_id,
UWORD32 ninbuf, UWORD32 noutbuf, pVOID pp_inbuf[],
xaf_comp_type comp_type)
-> xaf_comp_create(pVOID p_adev, pVOID *pp_comp,
xaf_comp_config_t *pconfig)
The old API is retained as xaf_comp_create_deprecated()
New xaf_comp_create() supports configurable enabling of fatal-error
reporting(as an event)
Older xaf_comp_create API is available as xaf_comp_create_deprecated
3. Added new APIs for event communication:
xaf_create_event_channel
xaf_delete_event_channel
4. Added new APIs to initialize default configuration parameters
xaf_adev_config_default_init
xaf_comp_config_default_init
+ App Interface Layer changes:
1. Added a thread-safe mechanism for component chain access
2. Optimized comp_state to only necessary states RESET and CREATE
3. Delayed the component state update in comp_create until component
is created
+ DSP Interface Layer changes:
1. Added BUG asserts for possible hang-case detection in
xf_mm_alloc/xf_mm_free, enabled with DEBUG=1 build option.
+ Plugin Changes:
1. Added XA_<component>_CONFIG_PARAM_FRAME_SIZE_IN_SAMPLES
configuration parameter for consistency of frame_size setting
in samples-per-channel.
Components updated: PCM_GAIN, MIXER, OPUS_ENC, CAPTURER, RENDERER
The older counterparts XA_<component>_CONFIG_PARAM_FRAME_SIZE,
will be removed in future.
2. Updated plugins xa-pcm-gain.c, xa-mimo-mix.c to demonstrate
event communication between components.
+ Testbench Changes
1. Testbench changes to demonstrate event communication between
components: xaf-mimo-mix-test.c
2. Testbench changes to demonstrate error reporting to application:
xaf-playback-usecase-test.c
3. Corrected help text in gain-renderer testbench.
+ MCPS reduction changes:
1. A buffer can be submitted by a component to the destination
worker-queue by directly calling dispatch, thus avoiding enqueue
and dequeue of DSP-thread queue.
2. base_cancel to check the presence of schedule-node in worker
queue to avoid spurious scheduling.
3. Sync msgq access with disable/restore of interrupts instead of
RTOS' mutex locks.
4. Added port readiness check for input port in mimo class
fill_this_buffer() to avoid excess scheduling.
5. Added a generic lock wrapper as xf-flx-lock-if.h (flexi-lock)
The locks are initialized as dummy by default. With pre-emption
enabled, when worker threads are created, the scheduler, shmem and
component-memory locks are reinitialized to RTOS-mutex-locks and
xf_sync_enqueue/dequeue locks are reinitialized to interrupt
disable/restore type of access.
+ Code size reduction changes:
Following optional (not used by default) compile time switches are
provided:
1. XA_DISABLE_EVENT: To disable event-communication related code
2. XA_DISABLE_DEPRECATED_API: To disable deprecated API code
----------------------------------------------------------------------
Version 2.3 API 1.3 : July 24, 2020
+ GA release
+ Built with RI.2 tools
+ [J2593] Added support for following two config params in Opus
encoder plugin:
- XA_OPUS_ENC_CONFIG_PARAM_SIGNAL_TYPE
- XA_OPUS_ENC_CONFIG_PARAM_RESET_STATE
+ [J2592] Fixed XAF internal memory allocator to use alignment
parameter appropriately
+ [J2586, J2587] Fixed argument to xos_start_system_timer() API
to select a timer with highest interrupt-priority <= EXCMLEVEL
+ [J2576, J2577] Fixed memory leaks by deleting the timer object in
capturer and renderer plugins
+ [J2567] Updated audio-codec-class to reset base state when an
output buffer is received after execution completion
+ Renamed pcm_mix component plugin to mimo_mix
----------------------------------------------------------------------
Version 2.2_Beta API 1.3 : May 21, 2020
+ Beta release
+ Built with RI.2 tools
+ Programmers Guide not updated
+ [J2220] Hostless XAF is tested and supported on Fusion cores
+ [J2226, J2464] Unified Hostless XAF release packages across cores
+ [J2543] Fixed a bug by clearing output_setup flag on relaxed output
ports during postprocess in MIMO class
+ [J2544] Added reset EOS stream flags in Opus Encoder, PCM Gain,
SRC plugin files to enable re-run upon receiving new input
+ [J2545] PCM Gain plugin updated to support 8, 24, 32 bit PCM width
and multichannel input data
+ [J2546] Fixed a bug in scratch allocation with pre-emptive
scheduling - allocated independent scratch for each worker thread
+ [J2553] Fixed a bug in MIMO class postprocess to avoid re-schedule
if execution is complete
+ [J2561] Updated XF_TIMEBASE_FREQ to support 48kHz, 16ch, 32bit PCM
configuration
+ [J2563] Fixed a memory leak bug by freeing all mutex locks in
xaf_adev_close API
+ [J2456] Updated runtime commands logic in testbench to allow other
runtime commands to execute while disconnect API is in progress
----------------------------------------------------------------------
Version 2.1_Alpha API 1.3 : April 23, 2020
+ Alpha release - HiFi4 only
+ Built with RI.2 tools
+ Changed some non-standard return codes from XAF Developer APIs to
standards XAF Error codes
+ Updated xaf_comp_get_status API to return EXEC_DONE status for
components returning output or probe data to application
+ [2453] Enhanced mem_malloc and mem_free wrappers to avoid maximum
number of allocations allowed constraint
+ [2472] Minimum connect buffers between components requirement is
reduced from 2 to 1. Note with this change, MIMO class preprocess
allows execution if any of input port has non-zero data (earlier,
it would check for non-zero data on all input ports)
+ [2473] Moved TRACE control tags to xf-debug.h for better
configurability
+ [2475] Fixed bug in renderer disconnect API implementation
+ [2486] Increased auxiliary buffer size from 128 to 256 to allow
32 configuration parameters in xaf_comp_set_config and
xaf_comp_get_config API (shared memory usage increases by 4kB)
+ [2491] Updated xaf_get_mem_stats API implementation to report
peak and current memory usage. Note with this change, the API
expects pointer to array of five integers as second argument
(earlier it expected pointer to array of three integers)
+ [2498] Fixed bug of redundant stack allocation during thread
creation with FreeRTOS
+ [2513] Reduced input buffer size requirement of Opus encoder
plugin to hold only one frame
+ [2528] Removed fatal error from capturer class in case of output
buffer non-availability, this should be handled by plugin
+ [2530] Updated copyright headers to MIT style for all files
+ Programmers Guide not updated
----------------------------------------------------------------------
Version 2.0 API 1.3 : January 31, 2020
+ GA Release - HiFi3, HiFi4 and HiFi5 only
+ Built with RI.2 tools
----------------------------------------------------------------------
Version 1.8_3_Alpha API 1.3 : December 23, 2019
+ Patch release - HiFi4 only
+ Built with RI.2 tools
+ Added MIMO (Multi-Input, Multi-Output) data processing class.
+ Added following new XAF Developer APIs:
XAF_ERR_CODE xaf_pause(pVOID p_comp, WORD32 port);
XAF_ERR_CODE xaf_resume(pVOID p_comp, WORD32 port);
XAF_ERR_CODE xaf_probe_start(pVOID p_comp);
XAF_ERR_CODE xaf_probe_stop(pVOID p_comp);
XAF_ERR_CODE xaf_disconnect(pVOID p_src, WORD32 src_out_port,
pVOID p_dest, WORD32 dest_in_port);
+ Updated prototype for xaf_connect API:
XAF_ERR_CODE xaf_connect(pVOID p_src, WORD32 src_out_port,
pVOID p_dest, WORD32 dest_in_port, WORD32 num_buf);
+ Added support for FreeRTOS.
+ Added support for preemptive scheduling for both XOS and FreeRTOS.
+ Following updates are done for Renderer Class:
- Changed logic to schedule execution of renderer on each interrupt
irrespective of input port readiness
- Added XAF_START_FLAG command support for explicit initialization of
renderer
- Added support for additional, optional output port to generate
reference or feedback output
+ Following updates are done for Audio Codec Class:
- Updated Audio Codec Class to initialize all components except
decoders (comp_type XAF_DECODER) without input data
+ Following updates are done for Renderer Plugin:
- Added actual FIFO in the plugin to mimic hardware operation
- Added state configuration parameter (XA_RENDERER_STATE_START) to
start renderer hardware operation (e.g. enable interrupt)
Note, even if this configuration parameter is not used from
application, renderer hardware operation starts once FIFO is full
- Added logic to zero-fill output if real data is not available
At start, this logic would insert zero frames or prepend zeros to
real data, if required
At runtime, this logic would insert zero frames or append zeros to
real data, if required
- Added support for additional, optional output port to generate
reference or feedback data
- Moved renderer execution from set_input_bytes() to do_execute()
function
- Added logic to set exec-done from plugin when input is over
+ Following updates are done for Capturer Plugin:
- Added state configuration parameter (XA_CAPTURER_STATE_START) to
start capturer hardware operation (e.g. enable interrupt)
Note, this configuration parameter must be issued from application
for capturer hardware operation to start
- Moved capturer execution from set_mem_ptr() to do_execute() function
+ Updated initialization API call sequence requirement as -
initialization status must be queried by xaf_comp_get_status() API
after xaf_comp_process(...XAF_START_FLAG) API call.
+ Corrected Capturer output port number to 0 from 1.
+ Added few robustness fixes as per internal QA testing.
+ Added new example testbenches and plugins to demonstrate usage of
new features.
+ Programmers Guide not updated.
+ Notes
- New feature implementation mentioned above has undergone limited
testing and may get updated.
- By default, this release uses XOS as RTOS.
- To use FreeRTOS instead of XOS, please refer to instructions in
'libxa_af_hostless/build/readme-freertos-bld.txt'.
- XOS is configured with 100 MHz clock frequency with 0.1 ms timer
tick resolution whereas FreeRTOS is configured with 50 MHz clock
frequency with 1 ms timer tick resolution.
- Known constraint: MCPS computation and prints are not supported
with FreeRTOS in this release.
----------------------------------------------------------------------
Version 1.4 API 1.1 : March 11, 2019
+ GA release.
----------------------------------------------------------------------
Version 1.3p4_Alpha API 1.1 : August 30, 2018
+ Patch release - HiFi3 and HiFi4 only
+ Built with RG.5 tools
+ [J2117] Fixed an issue in xaf_adev_close function (ensured internal
proxy thread is closed properly).
+ [J2118] Sample Rate Convertor plugin wrapper is updated to work
with Sample Rate Convertor v1.9 Library.
+ Updated Programmers Guide to indicate
- XAF must not be used with fast functional 'TurboSim' mode of
Instruction Set Simulator.
- Sample Rate Convertor plugin wrapper is updated to work with
Sample Rate Convertor v1.9 Library.
----------------------------------------------------------------------
Version 1.3p3_Alpha API 1.1 : March 12, 2018
+ Patch release
+ Built with RG.5 tools
+ [J2004] Fixed an issue in compilation of ISR code (removed -mcoproc
compile flag for ISR code).
----------------------------------------------------------------------
Version 1.3p2_Alpha API 1.1 : February 2, 2018
+ Patch release - HiFi4 only
+ Built with RG.5 tools
+ Fixed issues in packaging of release packages.
----------------------------------------------------------------------
Version 1.3p1_Alpha API 1.1 : February 1, 2018
+ Patch release - HiFi3, HiFi4 only
+ Built with RG.5 tools
+ [J1965] Avoided use of cache line size (core specific) while
calculating size of cache line aligned DSP Thread Handle struct.
----------------------------------------------------------------------
Version 1.3_Alpha API 1.1 : December 14, 2017
+ Initial (Alpha) customer release.
----------------------------------------------------------------------
Version 1.2 API 1.1 : November 21, 2016
+ Known issues in Release 1.1 fixed.
+ Added support for renderer and capturer components.
+ Added AAC-Dec, Renderer, Capturer, SRC components along with
corresponding test benches.
+ Testbenches updated for Realtek ALC5677 EVM.
----------------------------------------------------------------------
Version 1.1 API 1.1 : June 2, 2016
+ Known issues in Release 1.0 fixed.
+ Added testbenches for mixer, audio encoder and speech decoder.
+ Improved robustness and minor changes in API.
----------------------------------------------------------------------
Version 1.0 API 1.0 : March 04, 2016
+ Initial release.
----------------------------------------------------------------------
Version 0.7 API 1.0 : December 17, 2015
+ Beta release.
----------------------------------------------------------------------
2022-04-08:13:14:RI-2021.6:712830:726678:716953::