AM273x MCU+ SDK  08.02.00
Release Notes 08.01.00

Attention
Also refer to individual module pages for more details on each feature, unsupported features, important usage guidelines.
Note
The examples will show usage of SW modules and APIs on a specific CPU instance and OS combination.
Unless noted otherwise, the SW modules would work in both FreeRTOS and NORTOS environment.
Unless noted otherwise, the SW modules would work on any of the CPU present on the SOC.
Unless noted otherwise, the SW modules would work on all supported EVMs

New in this Release

Feature Module
R5F (No-RTOS, FreeRTOS), C66x (No-RTOS, FreeRTOS), CPU/OS
LwIP with ethernet driver (ENET) for CPSW LwIP, ENET
UART, RTI (Timer), EDMA Drivers
IPC, HWA, CSI2-RX, CRC, GPIO, MIBSPI Drivers
QSPI, Flash writer, MCAN, I2C , ESM, Watchdog, GPADC Drivers
ADCBUF (AWR294x Only) Drivers
SBL booting R5F and C66x Bootloader

Device and Validation Information

SOC Supported CPUs EVM Host PC
AM273x R5F, C66x AM273x GP EVM (referred to as am273x-evm in code) Windows 10 64b or Ubuntu 18.04 64b

Tools, Compiler and Other Open Source SW Module Information

Tools / SW module Supported CPUs Version
Code Composer Studio R5F, C66x 11.1.0
SysConfig R5F, C66x 1.11.0 build, build 2225
TI ARM CLANG R5F 1.3.0.LTS
TI C6000 Compiler C66x 8.3.11
FreeRTOS Kernel R5F, C66x 10.4.3

Key Features

OS Kernel

OS Supported CPUs SysConfig Support Key features tested Key features not tested / NOT supported
FreeRTOS Kernel R5F, C66x NA Task, Task notification, interrupts, semaphores, mutexs, timers, event groups. ROV views in CCS IDE, Task load measurement using FreeRTOS run time statistics APIs. -
FreeRTOS POSIX R5F, C66x NA pthread, mqueue, semaphore, clock -
NO RTOS R5F, C66x NA See Driver Porting Layer (DPL) below -

Driver Porting Layer (DPL)

Module Supported CPUs SysConfig Support OS support Key features tested Key features not tested / NOT supported
Cache R5F, C66x YES FreeRTOS, NORTOS Cache write back, invalidate, enable/disable -
Clock R5F, C66x YES FreeRTOS, NORTOS Tick timer at user specified resolution, timeouts and delays -
CycleCounter R5F, C66x NA FreeRTOS, NORTOS Measure CPU cycles using CPU specific internal counters -
Debug R5F, C66x YES FreeRTOS, NORTOS Logging and assert to any combo of: UART, CCS, shared memory -
Heap R5F, C66x NA FreeRTOS, NORTOS Create arbitrary heaps in user defined memory segments -
Hwi R5F, C66x YES FreeRTOS, NORTOS Interrupt register, enable/disable/restore -
MPU R5F YES FreeRTOS, NORTOS Setup MPU and control access to address space -
Semaphore R5F, C66x NA FreeRTOS, NORTOS Binary, Counting Semaphore, recursive mutexs with timeout -
Task R5F, C66x NA FreeRTOS Create, delete tasks -
Timer R5F, C66x YES FreeRTOS, NORTOS Configure arbitrary timers -
Event R5F, C66x YES FreeRTOS Setting, getting, clearing, and waiting of Event bits -

SOC Device Drivers

Peripheral Supported CPUs SysConfig Support Key features tested Key features not tested / NOT supported
ADCBUF R5F, C66x YES Source selection, Set chirp thresholds, continuous mode, configure modes -
CRC R5F, C66x YES Two channels, 8, 16, 32 and 64 bit data size, CPU mode -
CSI-RX R5F, C66x YES Setup complexio, dphy, common and context settings, event callbacks -
EDMA R5F, C66x YES Basic memory copy, DMA/QDMA channels, Interrupt/Polled, Manual/Event trigger, Chaining -
ESM R5F, C66x YES Group and Error number selection, Tested ESM notifier with watchdog module -
GPADC R5F, C66x YES 10-bit ADC, Tested single/multiple buffer and on board temperature sensor read -
GPIO R5F, C66x YES Basic input/output, GPIO as interrupt -
HWA R5F, C66x YES FFT, CFAR, compression/decompression and local maxima modules, Interrupt/Polled, Manual/DMA trigger -
I2C R5F, C66x YES Master mode, basic read/write, polling and interrupt mode Slave mode not supported. Driver not tested from C66x due to EVM limitations
IPC Notify R5F, C66x YES Low latency IPC between RTOS/NORTOS CPUs -
IPC Rpmsg R5F, C66x YES RPMessage protocol based IPC for all R5F, C66x running NORTOS/FreeRTOS -
MCAN R5F YES RX, TX, interrupt and polling mode -
MIBSPI R5F, C66x YES Master/Slave mode, basic read/write, Interrupt/Polled, icount enable/disable, CPU/DMA mode -
Pinmux R5F, C66x YES Tested with multiple peripheral pinmuxes -
QSPI R5F YES Read direct, Write indirect, Read/Write commands Interrupt mode not supported, Dual and Quad writes are not supported
SOC R5F, C66x YES Lock/unlock MMRs, get CPU clock, CPU name, clock enable, set frequency -
UART R5F, C66x YES Basic read/write, polling, interrupt mode DMA mode not supported
WATCHDOG R5F, C66x YES Window size and Expiry time selections, Reset mode, Digital windowed -

Secondary Bootloader (SBL)

Module Supported CPUs OS support Key features tested Key features not tested / NOT supported
Bootloader R5FSS0-0 NORTOS Boot modes: QSPI, UART. R5F (Lockstep) and C66x core boot. RPRC, multi-core image format, Pll configuration. Dual Core R5 boot.

Board Device Drivers

Peripheral Supported CPUs SysConfig Support Key features tested Key features not tested
EEPROM R5F YES I2C based EEPROM -
Flash R5F YES QSPI based flash All vendor flash types not tested
LED R5F, C66x YES GPIO based LED control -

Networking

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
LwIP R5F NO FreeRTOS TCP/UDP IP networking stack, DHCP, ping, TCP iperf, TCP/UDP IP Other LwIP features, performance and memory optimizations pending, more robustness tests pending
Ethernet driver (ENET) R5F NO FreeRTOS Ethernet as port using CPSW; MAC loopback and PHY loopback Ethernet as switch

Fixed Issues

ID Head Line Module Applicable Releases Applicable Devices Resolution/Comments
MCUSDK-1859 I2C Read Test Fails with SBL I2C 8.00.01 AM273x Fixed
MCUSDK-1980 Change optimization level for ti-arm-clang from O3 to Os Build 8.00.02 AM273x, AWR294x Fixed
MCUSDK-1984 MCAN External Timestamp Interrupt Failing MCAN 8.00.02 AM273x, AWR294x Fixed
MCUSDK-1994 SBL: R5 in lock step mode is able to access only 16KB TCMA memory SBL 8.00.01 AM273x, AWR294x Fixed
MCUSDK-1995 SBL: App image loading is failing if both R5 core 0 and core 1 image are present in appimage SBL 8.00.01 AM273x, AWR294x Fixed
MCUSDK-2015 Converted MSS GPADC data has fluctuations in ext channel and temperature values ADC 8.00.02 AWR294x Fixed
MCUSDK-2020 WDT Interrupt Mode Test Fails for C66x core WDT 8.00.02 AM273x, AWR294x Fixed
MCUSDK-2090 Sigma-Delta divider not set in SBL SBL 8.00.02 AWR294x Fixed
MCUSDK-2097 ESM driver can't process Group#1 interrupts greater than 63 ESM 8.00.02 AWR294x Fixed
MCUSDK-2136 SBL doesn't work for AWR2943 device variant SBL 8.00.02 AWR294x Fixed

Known Issues

ID Head Line Module Applicable Releases Applicable Devices Workaround
MCUSDK-1889 HWA: Context switch tests fails from C66x HWA 8.00.01 AWR294x None
PDK-8405 MIBSPI non-DMA mode transfer doesn't complete when used in mmWaveSDK MIBSPI 8.00.01 AM273x, AWR294x None. Issue is not seen in driver unit test
MCUSDK-1996 SBL: uniflash does not work if uart is configured in interrupt mode SBL 8.00.01 AM273x, AWR294x Use uart in polled mode
MCUSDK-2037 MIBSPI: Observing issues with SPI communication on Two-Chip cascade board MIBSPI 8.00.01 AM273x None. Issue is not seen when ccs log is enabled in the application.
MCUSDK-2083 SafeRTOS ClockP module not supported SafeRTOS DPL 8.00.02 AM273x, AWR294x None
MCUSDK-2151 I2C Probe does not display slave devices correctly I2C 8.00.02 AM273x, AWR294x None
MCUSDK-2184 MCAN External Loopback Interrupt Mode Sample Application fails MCAN 8.00.02 AWR294x None

Limitations

ID Head Line Module Reported in Release Applicable Devices Workaround
PDK-8404 QSPI test failing at 80 Mhz QSPI 8.00.01 AM273x, AWR294x QSPI driver works at 40 Mhz

Upgrade and Compatibility Information

Attention
When migrating from Processor SDK RTOS, see Migration Guides for more details

This section lists changes which could affect user applications developed using older SDK versions. Read this carefully to see if you need to do any changes in your existing application when migrating to this SDK version relative to previous SDK version. Also refer to older SDK version release notes to see changes in earlier SDKs.

Compiler Options

Module Affected API Change Additional Remarks
Release Build - Updated optimization level in release build to 'Os' as part of bug fix MCUSDK-1980. The release build with ti-arm-clang compiler has been updated from 'O3' to 'Os' optimization level. It is recommended that user rebuilds the existing libraries and applications with 'Os' option. This can be done by updating CFLAGS_release in library/example makefiles.