Radio Control Layer (RCL) 8.20.01.14 Release Notes
Table of Contents
Introduction
The Radio Control Layer (RCL) component for the LPF3 SDK consists of:
- High-level Radio Control Layer driver providing scheduling and power management
- Low-level RF protocol implementation
- Radio core firmware images
- RF configuration arrays and settings
- API documentation
Disclaimer
See Upgrade and Compatibility Information for details.
Documentation
The following documentation is included in RCL.
- API documentation
- Release Notes (this document)
Build Size
The following is the output of the TI ARM Clang size tool:
Component | Flash Size (Bytes) | RAM Size (Bytes) |
---|---|---|
Other | 1032 | 101 |
LRF | 4336 | 33 |
RCL | 5512 | 1 |
BLE5 Command Handler | 18124 | 0 |
IEEE 802.15.4 Command Handler | 4572 | 0 |
Generic PHY Command Handler | 6162 | 0 |
ADC Noise Command Handler | 960 | 0 |
Totals | 40698 (7.76%) | 135 (0.37%) |
Note this is the total size of the archive, not necessarily the size of the final linked program.
Dependencies
- coresdk_lpf3: 8.10.01.04
- TI ARM LLVM: 3.2.2.LTS-0
- GCC: 9.2019.q4.major-0
- IAR: 9.50.2-1
- Radioconfig: 8.20.00.47
Hardware Setup
This release is tested with the following hardware:
- LP_EM_CC2340R5
- LP_EM_CC2745R10_Q1
No hardware modifications are required.
What’s New
This list contains all new features in: v8.20
ID | Summary |
---|---|
RCL-689 | Support for different connection parameters based on the received AuxPHY |
RCL-376 | Support Periodic Advertising Setup |
RCL-98 | Support Periodic Advertising |
RCL-810 | AUX_SCAN_REQ packet to be built by the BLE stack |
RCL-807 | CC23XX: Enable DCOLDO temperature compensation |
RCL-672 | Provide lastCmdDone callbacks for descheduled commands |
RCL-425 | Support for AE Privacy changes |
RCL-635 | IEEE: Support for source matching on incoming packets |
RCL-557 | Extern ADC noise definition from RCL to radioconfig |
RCL-118 | IEEE: Support CCA before TX operation |
Fixed Issues
This list contains all bugfixes in: v8.20
ID | Summary |
---|---|
RCL-764 | BLE AE: Backoff is not updated as expected when failing to receive AUX_CONNECT_RSP |
RCL-761 | BLE AE: Erroneous AuxPtr handling for periodic advertising |
RCL-804 | BLE AE: LastCmdDone is not received after the RCL_command_stop API is called |
RCL-806 | BLE AE: LastCmdDone is not received after RCL_command_stop is called for advertiser command |
RCL-795 | LastCmdDone is not received after RCL_command_stop is called |
RCL-792 | BLE AE: RCL_BLE5_getAuxAdvStartTimeDelta returns a wrong value when primary PHY is 1M and secondary PHY is 2M |
RCL-803 | BLE AE: lastCmdDone callback is not invoked when using the initiator with privacy |
RCL-776 | [Initiator] when using privacy, lastCmdDone callback is not invoked |
RCL-808 | BLE AE: Missing handler state member for periodic scanner |
RCL-811 | BLE AE: AUX_CONNECT_RSP PDUs with unknown RPAs in AdvA are ignored by the LRF |
RCL-739 | Handling of extended header lengths equal to zero leads to erroneous behavior |
RCL-693 | Scan Response is sent in response to a connection indication |
RCL-801 | NESB: PRX command hangs after device is subjected to intermittent noise |
RCL-694 | When initiator receives aux_conn_rsp with unknown address the device ignores it and keep scanning |
RCL-691 | Filtering based on presence of syncInfo field not working as expected |
RCL-796 | Initiator successfully establishes a connection with a public BD device address not on the accepted list |
Known Issues
ID | Summary |
---|---|
RCL-343 | PBE NESB - Address mismatch counter not implemented |
Upgrade and Compatibility Information
ADC Noise PHY Settings
The pre-generated ADC Noise PHY settings, previously found in rcl_settings_adc_noise.c/h
, are no longer provided as part of the rcl_*.a
libraries. Any application using the RCL_AdcNoise_*
API need to generate these settings with SysConfig, to make sure e.g. symbol LRF_configAdcNoise
is available at link time. Please see the below code snippet for an example on how to do this, matching what was provided in rcl_settings_adc_noise.c/h
.
In the application *.syscfg
configuration file:
# Add the radioconfig module for custom PHY configuration.
const custom = scripting.addModule("/ti/devices/radioconfig/custom");
# Select the ADC Noise PHY, and ensure expected symbol name generation.
custom.ble = ["adc_noise"];
custom.radioConfigadc_noise.codeExportConfig.phyAbbr = true;
Known Limitations
The following scenarios have limited test coverage in the RCL module tests:
- Stress testing or throughput testing of connection
- Testing of adding buffers to the radio while it is running
- The testing of fields in the
stats
structures
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 b is an unrestricted set of digits used as an incrementing build counter.