AM273x MCU+ SDK  08.06.00
Release Notes 08.06.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 NO-RTOS 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
Attention
Klockwork Static Analysis report is not updated for this release

New in this Release

Feature Module
Receive packet Scatter-Gather feature support Ethernet
Support for custom modification receive packet buffer size Ethernet
Mbed-TLS library support (software cryptography) Networking
ENET driver (enet-lld) APIs added to support IEEE 802.1Qav (TSN Credit Based Shapper) in CPSW Ethernet
R5 PMU driver and example added PMU

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 12.1.0
SysConfig R5F, C66x 1.14.0 build, build 2667
TI ARM CLANG R5F 2.1.2.LTS
TI C6000 Compiler C66x 8.3.12
FreeRTOS Kernel R5F, C66x 10.4.3
DSP LIB C66x 3.4.0.0
Mbed-TLS R5F mbedtls-2.13.1

DSP LIB package is modified to fix the build in Linux environment from the base version dsplib_c66x_3_4_0_0

Attention
TI ARM CLANG 2.1.2.LTS is not part of CCS by default, Follow steps at TI CLANG Compiler Toolchain to install the compiler

Key Features

Experimental Features

Attention
Features listed below are early versions and should be considered as "experimental".
Users can evaluate the feature, however the feature is not fully tested at TI side.
TI would not support these feature on public e2e.
Experimental features will be enabled with limited examples and SW modules.
Feature Module
GUI for UART Uniflash Tool Bootloader

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, mutexes, timers, event groups. ROV views in CCS IDE, Task load measurement using FreeRTOS run time statistics APIs. -
FreeRTOS POSIX R5F, C66x NA pthread, queue, 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, safeRTOS, NORTOS Cache write back, invalidate, enable/disable -
Clock R5F, C66x YES FreeRTOS, safeRTOS, NORTOS Tick timer at user specified resolution, timeouts and delays -
CpuId R5F NA FreeRTOS, NORTOS Verify Core ID and Cluster ID that application is running -
CycleCounter R5F, C66x NA FreeRTOS, safeRTOS, NORTOS Measure CPU cycles using CPU specific internal counters -
Debug R5F, C66x YES FreeRTOS, safeRTOS, NORTOS Logging and assert to any combo of: UART, CCS, shared memory -
Heap R5F, C66x NA FreeRTOS, safeRTOS, NORTOS Create arbitrary heaps in user defined memory segments -
Hwi R5F, C66x YES FreeRTOS, safeRTOS, NORTOS Interrupt register, enable/disable/restore -
MPU R5F YES FreeRTOS, safeRTOS, NORTOS Setup MPU and control access to address space -
Semaphore R5F, C66x NA FreeRTOS, safeRTOS, NORTOS Binary, Counting Semaphore, recursive mutexes with timeout -
Task R5F, C66x NA FreeRTOS, safeRTOS Create, delete tasks -
Timer R5F, C66x YES FreeRTOS, safeRTOS, NORTOS Configure arbitrary timers -
Event R5F, C66x YES FreeRTOS, safeRTOS Setting, getting, clearing, and waiting of Event bits -
Queue R5F, C66x NA FreeRTOS, safeRTOS, NORTOS Enqueue, dequeue, status -

SOC Device Drivers

Peripheral Supported CPUs SysConfig Support DMA Supported Key features tested Key features not tested / NOT supported
ADCBUF R5F, C66x YES No Source selection, Set chirp thresholds, continuous mode, configure modes -
CBUFF R5F, C66x YES YES stream data over LVDS interface -
CRC R5F, C66x YES NA Two channels, 8, 16, 32 and 64 bit data size, CPU mode -
CSI-RX R5F, C66x YES NA Setup complexio, dphy, common and context settings, event callbacks -
ECAP R5F, C66x YES NA Frequency, Duty cycle, interrupt mode PWM mode not tested
EDMA R5F, C66x YES NA Basic memory copy, DMA/QDMA channels, Interrupt/Polled, Manual/Event trigger, Chaining -
EPWM R5F YES NA Frequency, Duty cycle, interrupt mode Tripzone, Deadband and Chopper module not tested
ESM R5F, C66x YES NA Group and Error number selection, Tested ESM notifier with watchdog module -
GPADC R5F, C66x YES NA 10-bit ADC, Tested single/multiple buffer and on board temperature sensor read -
GPIO R5F, C66x YES NA Basic input/output, GPIO as interrupt -
HWA R5F, C66x YES YES FFT, CFAR, compression/decompression and local maxima modules, Interrupt/Polled, Manual/DMA trigger -
I2C R5F, C66x YES No Controller mode, basic read/write, polling and interrupt mode Peripheral mode not supported. Driver not tested from C66x due to EVM limitations
IPC Notify R5F, C66x YES NA Low latency IPC between RTOS/NORTOS CPUs -
IPC Rpmsg R5F, C66x YES NA RPMessage protocol based IPC for all R5F, C66x running NORTOS/FreeRTOS -
MCAN R5F YES NA RX, TX, interrupt and polling mode -
MIBSPI R5F, C66x YES YES Controller/Peripheral mode, basic read/write, Interrupt/Polled, icount enable/disable, CPU/DMA mode -
MCASP R5F, C66x YES YES Controller mode, transmit/receive, Interrupt/DMA, serializer config -
Pinmux R5F, C66x YES NA Tested with multiple peripheral pinmuxes -
PMU R5F NO NA Tested various PMU events Counter overflow detection is not enabled
QSPI R5F YES YES Read direct, Write indirect, Read/Write commands Interrupt mode not supported, Dual and Quad writes are not supported
SOC R5F, C66x YES NA Lock/unlock MMRs, get CPU clock, CPU name, clock enable, set frequency, SW Warm Reset, Address Translation -
UART R5F, C66x YES YES Basic read/write, polling, interrupt mode, CPU/DMA mode -
WATCHDOG R5F, C66x YES NA 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/Dual Core) and C66x core boot. RPRC, multi-core image format, Pll configuration. -

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, TCP/UDP IP networking stack with server and client functionality, basic Socket APIs, netconn APIs and raw APIs, DHCP, ping, TCP iperf, scatter-gather, Other LwIP features
Ethernet driver (ENET) R5F NO FreeRTOS Ethernet as port using CPSW, MAC loopback and PHY loopback, Layer 2 MAC, Packet Timestamping, interrupt pacing, Policer and Classifier, MDIO Manual Mode, CBS (IEEE 802.1Qav) Ethernet as switch, MII and RMII modes
Mbed-TLS R5F NO FreeRTOS Tested software cryptography after porting, used mbedTLS with LwIP to implement HTTPS server Hardware offloaded cryptography

Safety Diagnostic Library

Module Supported CPUs SysConfig Support OS support Key features tested Key features not tested / NOT supported
MCRC R5F, C66 NA NORTOS Full CPU Mode, Auto CPU Mode and Semi CPU Mode. -
DCC R5F, C66 NA NORTOS Single Shot Mode, Continuous Mode -
PBIST R5F NA NORTOS Memories supported by MSS and DSS PBIST controller. -
ESM R5F, C66 NA NORTOS Tested in combination with RTI, DCC, ECC -
RTI R5F, C66 NA NORTOS WINDOWSIZE_100_PERCENT, WINDOWSIZE_50_PERCENT ,Latency/Propagation timing error(early)(50% window),Latency/Propagation timing error(late)(50% window) -
ECC R5F, C66 NA NORTOS ECC of MSS_L2, Mailbox, TPTC, R5SS TCM, MCAN, VIM, ICSSM R5F Cache, HSM
Bus Safety R5F, C66 NA NORTOS Bus Safety of Mailbox, DSS L3, HWA, ADCBUF, DSS_PCR, MSS_TPTC, CORE A and B AHB, MCRC, MSS_CR5 ,MSS_QSPI, MSS_PCR, MSS_SWBUF, MSS_GPADC, DSS_DSP_SDMA,MSS_TO_MDO MSS_CPSW, MSS_L2, DAP_R232, DSS_DSP_MDMA
HWA C66 NA NORTOS Parity on Data Memories, Window Memory and FSM Lockstep -
CCM R5F NA NORTOS CCM Self Test Mode, Error Forcing Mode and Self Test Error Forcing Mode -
R5F STC(LBIST) R5F NA NORTOS STC of R5F and DSP. -
PARITY R5F, C66 NA NORTOS TCM and DMA memories -

Fixed Issues

ID Head Line Module Applicable Releases Resolution/Comments
MCUSDK-9044 Strapping mode in phy is not giving correct link speed Ethernet 8.5.0 onwards Phy configuration for strapped and forced mode was not correctly handled
MCUSDK-8383 Load from JSON feature fails in SysConfig in Windows PC Flash 8.4.0 onwards Updated the sysconfig to use OS agnostic copy function
MCUSDK-9304 LWIP Ethernet CPSW Socket: Putting Udp application buffer in cached region of memory causes stale data to be sent out in Udp packets ENET 8.4.0 onwards Fixed the udp examples and added udp client socket example
PROC_SDL-5739 MCRC Auto mode was not implemented correctly. SDL 8.5.0 onwards

Fixed the source and example.

MCUSDK-8854 Enet_cpsw_tcpclient failing to send large sized data, no warning/assert Ethernet CPSW 8.04.00 onwards

Fixed

Known Issues

ID Head Line Module Applicable Releases

Workaround

MCUSDK-3897 MCASP Audio playback demo does not work in interrupt mode MCASP 8.03.00 onwards Use the McASP in DMA mode
MCUSDK-5873 FIQ handler data missing in HwIP_armv7r_handlers_nortos_asm.S file DPL 8.03.00 onwards None
MCUSDK-7811 Ethernet CPSW: Ethernet Packet corruption occurs if CPDMA fetches a packet which spans across memory banks Ethernet CPSW 8.03.00 onwards

Ensure from application side single ethernet packet does not span across memory banks

MCUSDK-3899 MIBSPI non-DMA mode transfer doesn't complete when used in mmWaveSDK MIBSPI 8.00.01 None. Issue is not seen in driver unit test
PROC_SDL-4749 AXI DED Bus Safety fail. SDL 8.5.0 onwards None.
PROC_SDL-5159 SEC ECC Bus Safety for MSS_AXI_RD not supported. SDL 8.5.0 onwards None.
PROC_SDL-5615 DAP R232 SEC, DED does not work. SDL 8.6.0 onwards None.
PROC_SDL-5616 For ECC Bus Safety, SEC and DED are not supported for CPSW. SDL 8.6.0 onwards None.
PROC_SDL-5617 ECC Bus safety for SEC and DED not supported for MSS_L2. SDL 8.6.0 onwards None.
PROC_SDL-5650 ECC Bus safety for SEC and DED not supported for DSS_DSP_MDMA. SDL 8.6.0 onwards

None.

MCUSDK-9082 MbedTLS - RSA exploit by kernel-privileged cache side-channel attackers Mbed-TLS 8.6.0 onwards -
MCUSDK-9800 ENET: Connection reset while running HTTPS server due to insufficient packet buffers ENET 8.6.0 onwards

-

Limitations

ID Head Line Module Reported in Release Workaround
PDK-8404 QSPI test failing at 80 Mhz QSPI 8.00.01 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

SOC Device Drivers

Module Affected API Change Additional Remarks
FSI Macro FSI_RX_MASTER_CORE_RESET, FSI_TX_MASTER_CORE_RESET API/MACRO/STRUCTURE name are updated while keeping the case sensitivity from MASTER to MAIN Updated to use the inclusive naming
I2C Structure I2C_Transaction member slaveAddress, masterMode API/MACRO/STRUCTURE name are updated while keeping the case sensitivity from master to controller and slave to target, for example..
slaveAddress->targetAddress
Updated to use the inclusive naming
McSPI MACRO MCSPI_MS_MODE_MASTER, MCSPI_MS_MODE_SLAVE API/MACRO/STRUCTURE name are updated while keeping the case sensitivity from master to controller and slave to peripheral, for example..
MCSPI_MS_MODE_MASTER->MCSPI_MS_MODE_CONTROLLER
Updated to use the inclusive naming
UDMA Structure Udma_EventPrms member masterEventHandle API/MACRO/STRUCTURE name are updated while keeping the case sensitivity from masterEventHandle to controllerEventHandle

Updated to use the inclusive naming

Networking

Module Affected API Change Additional Remarks
Ethernet CPSW Structure EnetCpdma_Cfg in Cpsw_Cfg
Function Enet_open
Removed the parameter 'isCacheable'. Support to place descriptor in cached memory is removed. CPDMA descriptiors has be placed un-cached memory section always.