AM273x MCU+ SDK  09.01.00
Release Notes 09.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 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
Memory Configurator (SysConfig based Linker generation) (Memory Configurator) Common
Coremark and Dhrystone benchmark (Coremark Benchmark, Dhrystone Benchmark) Common
SafeIPC support (IPC SafeIPC Echo) IPC
LwIP stack is upgraded to 2.2.0 version Ethernet and Networking
YANG data model based configuration support for IET/Frame Preemption(IEEE 802.1Qbu), Credit Based Shaper(IEEE 802.1Qav), Enhancements for Scheduled Traffic(IEEE 802.1Qbv) and other TSN features Ethernet and Networking
Ethernet Switch management through standard Link Layer Discovery Protocol(IEEE 802.1AB) for CPSW peripheral Ethernet and Networking
Multi-time domain gPTP(IEEE 802.1AS) support enabled in TSN stack Ethernet and Networking
Example to showcase the simultaneous execution of Time-Sensitive Networking and LwIP stack Ethernet and Networking
Syscfg and doc update for static IP configuration, custom MAC address and other ethernet related configurations Ethernet and Networking

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.5.0
SysConfig R5F, C66x 1.18.0 build, build 3266
TI ARM CLANG R5F 3.2.0.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

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 -

Ethernet and Networking

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
TSN R5F NO FreeRTOS gPTP IEEE 802.1 AS-2020 compliant gPTP stack, End Nodes and Bridge mode support, YANG data model configuration Multi-Clock Domain
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, DSP L1/L2/L3, HWA R5F Cache
ECC 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. -

Fixed Issues

ID Head Line Module Applicable Releases Resolution/Comments
MCUSDK-9309 IPC: Issue when Combination of Notify and RPMsg is enabled in SysCfg. IPC 8.01.00 onwards -
MCUSDK-11232 Add a check condition in mcu_rom_image_gen.py based on ROM acceptance criterion SBL 8.6.0 onwards Added size checking condition in script
MCUSDK-11561 PLL config for DSP 550Mhz and 300Mhz is not working in supported AM273x NZN device SBL 8.6.0 onwards Added eFUSE checks for the variant and correspondingly do the config.
MCUSDK-11673 TimerP driver has bug in TimerP_clearOverflowInt function DPL 9.0.0 onwards -
MCUSDK-11426 Rx timestamping is not stable Networking 8.6.0 onwards -

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
mbedTLS-advisory
MCUSDK-9082
MbedTLS - RSA exploit by kernel-privileged cache side-channel attackers Mbed-TLS 8.6.0 onwards -
MCUSDK-11730 A wrong counter is used for Event 2 in PMU configuration PMU 09.00.00 onwards -
MCUSDK-12514 Package migration script is not working Common 09.01.00 onwards

-

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-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-11506 ENET: CPDMA Goes To Lockup State. CPSW 8.5.0 onwards Disable THOST checksum Offload.
MCUSDK-11507 ENET: CPSW MAC port is stuck forever and dropping all the Rx/Tx packets with reception of corrupts preamble. CPSW 8.2.0 onwards

Disable hostRxTimestampEn flag in CPSW CPST configuration. This does not impact the CPTS Rx or Tx Timestamp Events for PTP packets and is orthogonal feature.

Errata

ID Head Line Module SDK Status
i2288 EDMA transfer that spans M1+M2 memories of HWA could result in data corruption HWA Open
i2289 Unaligned access from DSS CM4 could cause data integrity failure and hang HWA Open
i2294 Subsequent memory initialisation configuration of L3 Bank D will not trigger a memory initialisation Common Open
i2297 CSI Careabouts CSI Open
i2336 MibSPI in Peipheral Mode in 3- or 4-Pin Communication Transmits Data Incorrectly for Slow SPICLK Frequencies and for Clock Phase = 1 MibSPI Open
i2337 A Data Length Error is Generated Repeatedly in Peripheral Mode When IO Loopback is Enabled MibSPI Open
i2338 Spurious RX DMA REQ From a Peripheral Mode MibSPI MibSPI Open
i2339 MibSPI RX RAM RXEMPTY Bit Does Not Get Cleared After Reading MibSPI Open
i2341 Unallocated space access to DSP L2 - DSP IP is not blocking access to reserved space causing aliasing and L2 parity error DSP-L2 Open
i2342 2D Stats sample value RAM processor write back issue during FFT execution on HWA HWA Open
i2344 For Aurora, valid udp size range is AURORA_TX_UDP_SIZE > 4 Aurora Not supported in SDK
i2345 CPSW: Ethernet Packet corruption occurs if CPDMA fetches a packet which spans across memory banks CPSW Implemented
i2387 PLL: Boot fails sometimes because of possible glitch in R5F GCM SBL Implemented
i2389 Recommended PLL Configuration if locked below 1GHz SBL Implemented
i2390 Recommended HWA memInit Sequence HWA Open
i2392 Race condition in capture registers resulting in events miss Interrupt Open
i2394 Race condition in interrupt and error aggregator capture registers resulting in events miss Interrupt Open
i2401 CPSW: Host Timestamps Cause CPSW Port to Lock up CPSW Open
i2402 CPSW: Ethernet to Host Checksum Offload does not work CPSW Open
i2404 Race condition in mailbox registers resulting in events miss IPC Implemented

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
Linker Default linker in SDK SDK is moved to support sysconfig based linker generation Older is removed from core project ti-arm-clang folder and syconfig will generate the new linker under generated folder during sysconfig file generation step of compilation refer Memory Configurator. Customer project created earlier can continue to use the existing linker if they don't want to move to syscofnig based linker.

Ethernet and Networking

Module Affected API Change Additional Remarks
LwIP TCP/IP stack None Upgraded to 2.2.0 version Please refer to Lightweight IP (LwIP) 'Upgrade' section