lib_awe

VERSION RELEASED COMMENTS DOCUMENTATION SOFTWARE
1.0.1 2024-08-15 HTML PDF Zip

Summary#

lib_awe is a port of Audio Weaver Embedded (AWE) Core for XMOS’s powerful xcore.ai device. It contains code for software threads which wrap the core library and provide easy interfacing to both audio streaming components such as I2S and USB Audio as well as control interfacing to allow control and loading of pre-built Audio Weaver designs from a host or internally from the device.

Note

You must manually obtain the libAWECore.a file and place in the lib_awe/lib/xs3a directory inable to build applications with this software.

Features#

  • xcore.ai port of AWE core version 8.D.8

  • Remote (via channel) access to AWE Tuning interface

  • Implementation of AWE Control Interface using the above

  • Example implementation of run-time selection of AWE layouts that are compiled into an application

  • Example integration into the XMOS USB Audio Reference Design

  • Supports 48000 Hz sample rate (will be extended in future releases)

Known Issues#

  • The DSP Concepts AWE Flash File System assumes that erase sectors are of a constant size. The FFS uses the data partition which is beyond the boot partition and so this is generally the case, however please check your chosen flash device for this property if enabling the FFS

  • This release is known to be incompatible with versions of AWE core previous to 8.D.8

  • AWE_DSP_THREAD_NUM counts of less than 3 are not currently supported (#44)

  • Lib_awe requires the xcore.ai device to be run with a CPU clock of at least 700 MHz. Please use the appropriate silicon grade to support this (#63)

  • Audio Weaver Designer code-generation produces mis-matched declaration (const) between .h and c files (#39)

  • Currently xscope cannot be using alongside lib_awe (#55)

  • Currently the USB HID tuning interface cannot be used if the Thesycon TUSBAudio driver is installed against the device that doesn’t expose a UAC interface (#69)

Host System Requirements#

For development a installation (and licence) of AudioWeaver is required

Required Tools#

  • XMOS XTC Tools: 15.3.0

Required Libraries (dependencies)#

  • lib_xud (www.github.com/xmos/lib_xud)

Support#

This package is supported by XMOS Ltd. Issues can be raised against the software at: http://www.xmos.com/support

Scroll to Top