SimpleLink Audio Plugin Release Notes
Table of Contents
Introduction
The SimpleLink Audio Plugin is a software package enables audio application development across capable devices within the SimpleLink family.
The SimpleLink Audio Plugin consists of the following common components:
- Hardware Abstraction Layer (HAL)
- Stream manager for packing and unpacking encoded packets
- Software compression codecs
The SimpleLink Audio Plugin also supports protocol stack examples using audio. See the various readmes in the examples/ folder for example features.
This is version 3.30.00.06 of the SimpleLink Audio Plugin.
Documentation
Please refer to the Documentation Overview for in-depth documentation on the SimpleLink Audio Plugin.
SimpleLink Audio Plugin 3.30.00.06 - What’s New
- Initial Release including the following software components:
- Hardware Abstraction Layer (AudioHAL)
- Packet manager (Packetizer)
- TI Optimized Opus codec implementation
- TI Optimized mSBC codec implementation
- Protcol stack examples:
- Wi-Fi
- BLE5-Stack
- Proprietary RF (Sub-1GHz)
Upgrade and Compatibility Information
Upgrading from the previous version of the SDK plugin is as easy as installing the new instance of the plugin.
Operating System Support
- Windows 7 SP1, Windows 8.1, Windows 10
- Ubuntu 14.04 64-bit, Ubuntu 16.04 64-bit
- macOS Mojave
Dependencies
The dependenceies below represent the TI tested configurations of the SimpleLink Audio Plugin. Newer versions of the device SDKs may work without issue, but have not yet been verified.
This release is dependent on the following device SDKs:
- simplelink_cc13x2_26x2_sdk_3_30_00_03
- simplelink_cc32xx_sdk_3_30_01_02
- simplelink_cc2640r2_sdk_3_30_00_20
The plugin was tested against the following tool chains:
- IAR Embedded Workbench: EWARM-8.32.2
- TI Code Composer Studio: CCS-9.2.0
- TI Code Generation Tools for Arm: 18.12.3.LTS
- XDCTools: 3.60.02.34.core
- (Optional) UNIFLASH
Device Support
- CC2642R
- CC2652R
- CC2652RB
- CC2640R2F
- CC2640R2F-Q1
- CC1312R
- CC1352R
- CC1352P
- CC3220S
- CC3220SF
- CC3235S
- CC3235SF
Development Board Support
The following LaunchPads are supported:
- CC26X2R1_LAUNCHXL
- CC2652RB_LAUNCHXL
- CC2640R2_LAUNCHXL
- CC1312R1_LAUNCHXL
- CC1352P_2_LAUNCHXL
- CC1352P_4_LAUNCHXL
- CC1352P1_LAUNCHXL
- CC1352R1_LAUNCHXL
- CC3220S_LAUNCHXL
- CC3220SF_LAUNCHXL
- CC3235S_LAUNCHXL
- CC3235SF_LAUNCHXL
The following BoosterPacks are supported:
New Features
| ID | Summary |
|---|---|
| SL_AUDIO-35 | Use I2C_transferTimeout instead of I2C_transfer to avoid deadlock of the device |
| SL_AUDIO-23 | Create BLE-Stack based Audio example |
| SL_AUDIO-19 | Create AudioHAL for codec implementation |
| SL_AUDIO-17 | Implement MAKE Build system |
| SL_AUDIO-15 | Create a WiFi Audio example |
| SL_AUDIO-14 | Create a Sub-1GHz Audio example |
| SL_AUDIO-7 | Make I2C communication optional with AudioHALCodec |
| SL_AUDIO-3 | Add support for BLE audio examples on CC13xx devices, CC2642RB |
Fixed Issues
| ID | Summary |
|---|---|
| SL_AUDIO-38 | BLE example doesn't optimize connection intervals, data lengths |
| SL_AUDIO-37 | Cleanup/fix KW findings |
| SL_AUDIO-36 | [CC2640R2] The function I2C_transferTimeout is not defined fr CC2640R2 and prevent compilation |
| SL_AUDIO-32 | Remove I2S driver copy from audio plugin |
| SL_AUDIO-31 | Packetizer doesn't produce sound when using MSBC |
| SL_AUDIO-29 | bitStream and encLen are not set correctly when using packetizer with ADPCM |
| SL_AUDIO-26 | AudioHALCodec doesn't allow preloading of buffers before stream start |
| SL_AUDIO-13 | MCLKCC26xx cannot be closed and reopened many times |
| SL_AUDIO-12 | AudioHAL will crash when set to INPUT only |
| SL_AUDIO-6 | Fix errors in audio API doxygen |
| SL_AUDIO-4 | Buffers are not “zeroed”out when they have been transmitted multiple times |
Known Issues and Limitations
SysConfig and FreeRTOS are not supported in this release.
| ID | Summary |
|---|---|
| SL_AUDIO-43 | Packetizer encode, decode are not re-entrant |
| SL_AUDIO-41 | WifiAudio will trigger an exception when using Opus |
Since the AudioHAL component depends on TI-DRIVERS, it is recommended to also look at the coreSDK release notes to see potential issues with related drivers such as I2S, PDM, or I2C.
Warning: The links above will always point to the latest CoreSDK release notes if using an older version, please use the TI Resource Explorer package manager to select the correct version. See TI-REX. Select stack in top right corner –> package manager.
Furthermore, since some of the audio applications in the examples/ folder are based on the protocol stacks (e.g. BLE5-Stack), the protocol stack release notes should also be consulted.
Note: Due to a known issue in the CC32xx I2S driver, a patched version is included here in the plugin. This patched version is included to fix TIDRIVERS-3954. When this issue is resolved in the CC32xx SDK, the patched driver will be removed from the plugin. By default, the examples provided within the plugin already use the patched driver.
Alpha notice: All functionality related to PDM (e.g. examples, scripts, driver) should be considered alpha.
Versioning
This product’s version follows a version format, M.mm.pp.bb, where M is a single digit Major number, mm is 2 digit minor number, pp is a 2 digit patch number, and bb is an unrestricted set of digits used as an incrementing build counter.