AM62x MCU+ SDK  11.02.00
Release Notes 11.02.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 explicitly noted otherwise, the SW modules would work in both FreeRTOS and no-RTOS environment.
Attention
MCU+SDK on A53 is provided as is for customers as a reference to implement/validate on their own SW Stack & OS. TI will not support these features on the E2E forum as these are not part of the MCU+SDK product. If these features need to be productized, TI can recommend third parties who can help.

Device and Validation Information

SOC Supported CPUs EVM Host PC
AM62x M4F, R5F, A53 SK-AM62 (referred as am62x-sk in code), SK-AM62-LP (referred as am62x-sk-lp in code), SK-AM62-SIP (referred as am62x-sip-sk in code) Windows 10 64b or Ubuntu 22.04 64b

Features Added in This Release

Note
Update of OSPI tuning algorithm on this SDK causes increase in tuning time. Refer OSPI NOR Flash Performance
Attention
DeepSleep low power mode (LPM) is not supported if the DM R5 is used for a general purpose application. This is because when the SoC goes to any LPM, the context of peripherals used by DM R5 will be lost. To use DM R5 for a general purpose application, disable LPM support. Refer Disabling Low Power Mode to know how to disable LPM.
Feature Module
FreeRTOS SMP support on A53 Kernel
SBL EMMC Falcon boot support SBL
New OSPI tuning algorithm is added OSPI
Example to demonstrate VTM triggered SoC reset is added SDL
ATCM/BTCM reset base toggle support for multistage bootloader DM
Support to print DM application logs based on board config is added DM

Dependent Tools and Compiler Information

Attention
It is recommended to use the TIFS version provided with the release for ensuring compatibility between TIFS and device manager. Using the TIFS from different MCU+SDK release is not recomended and may cause TIFS/ DM functionality to break.
Tools/Components Supported CPUs Version
Code Composer Studio M4F, R5F, A53 20.3.1
SysConfig M4F, R5F, A53 1.24.2, build 4234
TI ARM CLANG M4F, R5F 4.0.1.LTS
GCC AARCH64 A53 9.2-2019.12
FreeRTOS Kernel M4F, R5F, A53 11.1.0

SDK Components

SYSFW / TIFS

Version 11.02.05
Release Notes LINK
User Guide LINK

Key Features

OS Kernel

OS Supported CPUs SysConfig Support
FreeRTOS Kernel M4F, R5F, A53 NA
FreeRTOS POSIX M4F, A53 NA
No RTOS M4F, R5F, A53 NA

Driver Porting Layer (DPL)

Module Supported CPUs SysConfig Support OS support
Address Translate M4F, R5F Yes FreeRTOS, NORTOS
Cache R5F, A53 Yes FreeRTOS, NORTOS
Clock M4F, R5F, A53 Yes FreeRTOS, NORTOS
CycleCounter M4F, R5F, A53 NA FreeRTOS, NORTOS
Debug M4F, R5F, A53 Yes FreeRTOS, NORTOS
Heap M4F, R5F, A53 NA FreeRTOS, NORTOS
Hwi M4F, R5F, A53 Yes FreeRTOS, NORTOS
MPU M4F, R5F, A53 Yes FreeRTOS, NORTOS
Semaphore M4F, R5F, A53 NA FreeRTOS, NORTOS
Task M4F, R5F, A53 NA FreeRTOS
Timer M4F, R5F, A53 Yes FreeRTOS, NORTOS

Secondary Bootloader (SBL)

SBL Mode Supported CPUs SysConfig Support PHY Support DMA Support OS support
OSPI NOR R5F Yes Yes Yes NORTOS
OSPI NAND R5F Yes Yes Yes NORTOS
EMMC R5F Yes NA NA NORTOS
UART R5F Yes NA No NORTOS

Networking

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
TSN A53 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 A53 YES FreeRTOS TCP/UDP IP networking stack with and without checksum offload enabled, TCP/UDP IP networking stack with server and client functionality, basic Socket APIs, netconn APIs and raw APIs, DHCP, ping, TCP iperf, scatter-gather, DSCP priority mapping, LwIP bridge, shared memory driver Other LwIP features
Ethernet driver (ENET) A53 YES FreeRTOS Ethernet as port using CPSW, MAC loopback and PHY loopback, Layer 2 MAC, Packet Timestamping, CPSW Switch, Policer and Classifier, MDIO Manual Mode, CBS (IEEE 802.1Qav) on CPSW, IET (IEEE 802.1Qbu) on CPSW, Strapped PHY (Early Ethernet), cut through switch on CPSW RMII mode

SOC Device Drivers

Note
See the updated MCASP usage guidelines in MCASP for changes in MCASP driver
Peripheral Domain Supported CPUs SysConfig Support
DDR Main R5F Yes
DSS Main A53 Yes
ECAP Main A53 Yes
EPWM Main M4F, A53 Yes
EQEP Main A53 Yes
GPIO MCU M4F, R5F Yes
Main M4F, R5F, A53 Yes
GPMC Main R5F, A53 Yes
I2C Main M4F, R5F, A53 Yes
MCU M4F, R5F Yes
Wakeup M4F, R5F Yes
IPC Main M4F, R5F, A53 Yes
MCAN Main R5F, A53 Yes
MCU M4F Yes
MCSPI Main M4F, R5F, A53 Yes
MCU M4F, R5F Yes
MMCSD Main R5F, A53 Yes
OSPI Main R5F, A53 Yes
Pinmux Main M4F, R5F, A53 Yes
MCU M4F, R5F Yes
Wakeup M4F, R5F Yes
RTC Main R5F, A53 Yes
SOC NA M4F, R5F, A53 Yes
SCIClient NA M4F, R5F, A53 Yes
UART Main M4F, R5F, A53 Yes
MCU M4F, R5F Yes
Wakeup R5F Yes
UDMA Main R5F, A53 Yes
WDT Main A53 Yes
Note
Refer Accessing main and wakeup domain peripherals from MCU domain for accessing main/wakeup peripherals from MCU Domain.

Board Device Drivers

Peripheral Supported CPUs SysConfig Support
Flash R5F Yes

Software Diagnostic Library (SDL)

SDL Module Supported CPUs SysConfig Support
ESM M4F, R5F No
MCRC M4F, R5F No
RTI M4F, R5F No
DCC M4F, R5F No
VTM M4F, R5F No
STOG M4F, R5F No
PBIST M4F, R5F No
MTOG M4F No
POK M4F, R5F No
ECC M4F, R5F No
LBIST M4F No
ROM Checksum R5F No

Fixed Issues

ID Head Line Module
EXT_SITMPUSW-134 GPIO input interrupt example not working on A53 AMP AMP
EXT_SITMPUSW-177 Invalid comment in the linker command files BUILD
EXT_SITMPUSW-269 LPDDR: DDR PLL reset code issue DDR
EXT_SITMPUSW-172 DebugP_assert: change so that it does not lock up the entire core DPL
EXT_SITMPUSW-217 ClockP_usleep() getting into infinite loop due to timer wraparound DPL
EXT_SITMPUSW-234 OLDI Single Link Common Mode VOCM Voltage Drop with MCU+SDK Display
EXT_SITMPUSW-109 Wrong comments on HwiP_inISR() API Documentation
EXT_SITMPUSW-112 SysConfig does not generate correct FLASH section parameters. Flash
EXT_SITMPUSW-179 I2C Target Overrun Test Hangs Waiting for Callback I2C
EXT_SITMPUSW-183 I2c_transfer not returning correct status when transfer mode is set to polling I2C
EXT_SITMPUSW-191 I2C_transfer() return not handled properly while i2cLldHandle is NULL I2C
EXT_SITMPUSW-192 SysConfig does not support configuring both 10-bit own addresses for I2C target mode I2C
EXT_SITMPUSW-194 NACK is not returned to application when performing i2c write in polling mode I2C
EXT_SITMPUSW-232 I2C target mode with multiple own addresses transaction fails I2C
EXT_SITMPUSW-117 Linux Kernel IPC Examples are broken IPC
EXT_SITMPUSW-211 DMA channel teardown sequence is not proper in MCASP_disableDmaTx MCASP
EXT_SITMPUSW-188 [MCSPI]End of Channel Transfer status check is missing for DMA mode MCSPI
EXT_SITMPUSW-200 [MCSPI] Timeout mechanism missing to prevent Infinite loops in MCSPI driver MCSPI
EXT_SITMPUSW-110 eMMC Init Code Missing DLL Register Settings needed for Initial Legacy SDR Mode Phase MMCSD
EXT_SITMPUSW-113 eMMC PHY I/O Calibration not getting executed during eMMC boot MMCSD
EXT_SITMPUSW-123 MMCSD driver does not follow the SWITCH command sequence correctly MMCSD
EXT_SITMPUSW-124 EXTCSD HS_TIMING register is set incorrectly at certain places in the driver MMCSD
EXT_SITMPUSW-125 MMCSD driver uses infinite loop instead of timeout for checking fields of PRESENTSTATE register MMCSD
EXT_SITMPUSW-126 Timing issues with MMCSD host controller driver MMCSD
EXT_SITMPUSW-127 Incorrect handling of the CAPABILITIES register in the eMMC initialization MMCSD
EXT_SITMPUSW-153 eMMC Driver Error Interrupt Flags accessed in Wrong Register MMCSD
EXT_SITMPUSW-153 eMMC Init Code ignores early failures and continues Execution MMCSD
EXT_SITMPUSW-155 eMMC Driver Error Recovery Recursion can lead to System Crashes MMCSD
EXT_SITMPUSW-171 MMCSD : Read fails when injecting Command time out fault MMCSD
EXT_SITMPUSW-176 MMCSD : Read fails when injecting Command Index fault MMCSD
EXT_SITMPUSW-185 MMCSD : Read times out in HS200 mode after writing in SDR50 mode MMCSD
EXT_SITMPUSW-186 MMCSD : Read fails when injecting Command CRC fault MMCSD
EXT_SITMPUSW-195 MMCSD : Read fails when passing invalid argument. MMCSD
EXT_SITMPUSW-204 MMCSD close() is not proper MMCSD
EXT_SITMPUSW-209 Simultaneous FAT transfer fails for the same instance while being accessed from two different tasks. MMCSD
EXT_SITMPUSW-212 MMCSD : Write fails when passing invalid argument. MMCSD
EXT_SITMPUSW-215 MMCSD : Read fails when injecting Command End Bit fault MMCSD
EXT_SITMPUSW-230 MMCSD close fails after opening the same instance twice. MMCSD
EXT_SITMPUSW-78 MMCSD Sysconfig provides options to configure PHY type MMCSD
EXT_SITMPUSW-84 MMCSD error recovery sequence isn't implemented correctly MMCSD
EXT_SITMPUSW-207 Missing -p flag with strip command to reduce the size of *.out Makefiles
EXT_SITMPUSW-118 OSPI tuning algorithm finds points in noisy region on rare scenarios OSPI
EXT_SITMPUSW-158 OSPI_flashExecCmd has a couple of checks where the code may get stuck OSPI
EXT_SITMPUSW-181 Configured dummy cycles in flash driver contradicts flash data sheet OSPI
EXT_SITMPUSW-187 OSPI DAC Mode Configuration hardcoded and not based on flashsize OSPI
EXT_SITMPUSW-190 OSPI_PhyTuneGrapher missing read delay value 4 OSPI
EXT_SITMPUSW-213 OSPI Phy Status Check Missing OSPI
EXT_SITMPUSW-231 OSPI NAND Writes DAC enable OSPI
EXT_SITMPUSW-240 NOR Flash Fixup missing in SBL NULL OSPI
EXT_SITMPUSW-85 Flash_eraseSector and Flash_norOspiEraseSector does not erases the mentioned sector. OSPI
EXT_SITMPUSW-133 Falcon Boot through SBL is not supported SBL
EXT_SITMPUSW-189 Secure board configurations by default allows JTAG unlocking SBL
EXT_SITMPUSW-193 DMA is not enabled for SOC Memory boot media in the SysConfig SBL
EXT_SITMPUSW-202 gAppimage is not allocated to the intended section defined in the linker command files SBL
EXT_SITMPUSW-205 sbl_uart_uniflash_stage2 is not prebuilt SBL
EXT_SITMPUSW-122 HSM core does not boot SBL
EXT_SITMPUSW-121 FORCE bit not book keeped properly for MCSPI DMA mode of operation Software
EXT_SITMPUSW-226 Improve Sysconfig tool tips for all drivers SysConfig
EXT_SITMPUSW-174 UDMA: HC/UHC channel allocation fails due to RM config mismatch with CSL defines UDMA
EXT_SITMPUSW-214 UDMA multiple channel open for the same channel and invalid instance not handling properly UDMA
EXT_EP-13056 VTM module sensor reset sequence modification for reliable functionality SDL
EXT_EP-13057 SDL DCC Seed Value Calculation Deviates from TRM Guidelines SDL
EXT_EP-13069 AM62x: POK Example and FT are failing in r5f-freertos SDL
EXT_EP-13070 AM62x: VTM Example and FT are failing in r5f-freertos SDL

Known Issues

ID Head Line Module
EXT_SITMPUSW-153 MCU+ SDK CCS Project Build Generates Invalid/Redundant Boot Image Files Build
EXT_SITMPUSW-251 MCU+ SDK Example Projects using incorrect ARMv7 MPU Attributes for Peripheral Register Region Examples
EXT_SITMPUSW-87 Sysconfig crashing when adding large number of GPIO pins GPIO
EXT_SITMPUSW-28 Outstanding mailbox messages prevent suspend IPC
EXT_SITMPUSW-114 MMCSD_enableBootPartition implements two mutually exclusive concepts as one function MMCSD
EXT_SITMPUSW-138 MMCSD_read & MMCSD_write function are not designed simple & readable MMCSD
EXT_SITMPUSW-222 MMCSD field Card Type is not ordered logically in the Sysconfig MMCSD
EXT_SITMPUSW-256 Incorrect calculation of rowColEnd in the ext_otp_writeMmr OTP
EXT_SITMPUSW-220 SBL_SD bootloaders report incorrect boot image size SBL
EXT_SITMPUSW-252 AM62X : Loading an A53 example is not working after the CPU Reset from the CCS CCS
EXT_EP-12275 AM62x: ECC: SDL_WKUP_R5FSS0_PULSAR_UL_CPU0_ECC_AGGR and SDL_DMASS0_DMSS_AM62_ECCAGGR aggregators are failing. SDL
EXT_EP-12276 ECC: Firewall related aggregators failures - ECC Aggregators SDL_SMS0_SMS_TIFS_ECC, SDL_SMS0_SMS_HSM_ECC, SDL_SA3_SS0_SA3SS_AM62A_DMSS_ECCAGGR and SDL_SA3_SS0_SA3SS_AM62A_SA_UL_ECC_AGGR fail because of firewall access issues faced by SDL SDL
EXT_EP-12278 ECC Aggregator SMS0_SMS_HSM_ECC Aggr fails on AM62x. SDL
EXT_EP-12279 CSI RX ECC aggregators are failing on AM62P/AM62X SDL

Limitations

S.No Head Line Module
1 The ROM startup model for runtime initializations in TI ARM CLANG is not supported/tested in the SDK NA
2 PHY mode not supported for OSPI NAND SBL on DDR mode. It is supported for SDR mode only Bootloader
3 LPM is not supported with SBL boot flow. It is supported only with SPL boot flow. Bootloader

Upgrade and Compatibility Information

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.

The below table captures the list of migration document sections when migrating from one version to another. The migration for a partcluar module will be applicable, if you are migrating from older version listed to newer version listed on the table below.

Module Migration guide Older version Newer version
Bootloader Bootloader Migration Guidelines<= 10.01.00 >= 11.00.00
NETWORKING Version Updates from earlier SDKs to Latest<= 11.01.00 >= 11.02.00
OSPI OSPI Migration Guide<= 11.01.00 >= 11.02.00

Networking

Module Affected API Change
TSN notify_linkchange notify_linkchange function is renamed to cb_lld_notify_linkchange, include path <tsn_combase/tilld/cb_lld_ethernet.h> in the file that uses cb_lld_notify_linkchange.