AM62Px 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.

Device and Validation Information

SOC Supported CPUs EVM Host PC
AM62P MCU R5F, WKUP R5F SK-AM62P-LP EVM (referred to as am62px-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
Feature Module
SBL EMMC Falcon boot support SBL
MMCSD Driver on MCU R5F MMCSD
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
Spread spectrum clocking (SSC) support for Display PLLs DM
Support to print DM application logs based on board config is added DM

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
Ethernet traffic sharing accross multiple cores, called Ethernet Firmware Networking
C++ SUpport NA

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 recommended and may cause TIFS/ DM functionality to break.
Tools/Components Supported CPUs Version
Code Composer Studio MCU-R5F, WKUP-R5F 20.3.1
SysConfig MCU-R5F, WKUP-R5F 1.24.2, build 4234
TI ARM CLANG MCU-R5F, WKUP-R5F 4.0.1.LTS
GCC AARCH64 A53 9.2-2019.12
FreeRTOS Kernel MCU-R5F, WKUP-R5F 11.1.0

SDK Components

SYSFW / TIFS

Version 11.02.05
Release Notes LINK
User Guide LINK

Keywriter Package

There is NO Keywriter package available specifically based on this version of the MCU+ SDK release.

The most recent Keywriter package available (otp_keywriter_am62px_11_01_00) is based on the MCU+ SDK version 11.01.00 and it is available on the 'Secure resources' portal of ti.com.

Key Features

OS Kernel

OS Supported CPUs SysConfig Support
FreeRTOS Kernel MCU-R5F, WKUP-R5F NA
FreeRTOS POSIX MCU-R5F NA
No RTOS MCU-R5F, WKUP-R5F NA

Driver Porting Layer (DPL)

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

Secondary Bootloader (SBL)

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

SDL

SDL Module Supported CPUs SysConfig Support
MCRC MCU-R5F No
ESM MCU-R5F No
VTM MCU-R5F No
DCC MCU-R5F No
ECC MCU-R5F No
RTI MCU-R5F No
POK MCU-R5F No
STOG MCU-R5F No
MTOG MCU-R5F No
PBIST MCU-R5F No
LBIST MCU-R5F No
ROM_CHECKSUM MCU-R5F No

Networking

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
TSN WKUP-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 WKUP-R5F 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) WKUP-R5F 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 WKUP-R5F Yes
ECAP Main MCU-R5F Yes
EPWM Main MCU-R5F, WKUP-R5F Yes
DSS Main WKUP-R5F Yes
GPIO MCU MCU-R5F, WKUP-R5F Yes
Main MCU-R5F, WKUP-R5F Yes
I2C Main MCU-R5F, WKUP-R5F Yes
MCU MCU-R5F, WKUP-R5F Yes
Wakeup MCU-R5F, WKUP-R5F Yes
IPC Main MCU-R5F, WKUP-R5F Yes
MCAN MCU MCU-R5F Yes
MCASP Main WKUP-R5F Yes
MCSPI Main MCU-R5F, WKUP-R5F Yes
MCU MCU-R5F, WKUP-R5F Yes
MMCSD Main WKUP-R5F, MCU-R5F Yes
Pinmux Main MCU-R5F, WKUP-R5F Yes
MCU MCU-R5F, WKUP-R5F Yes
Wakeup MCU-R5F, WKUP-R5F Yes
SOC NA MCU-R5F, WKUP-R5F Yes
SCIClient NA MCU-R5F, WKUP-R5F Yes
UART Main MCU-R5F, WKUP-R5F Yes
MCU MCU-R5F, WKUP-R5F Yes
Wakeup WKUP-R5F Yes

Fixed Issues

ID Head Line Module
<a href= Invalid comment in the linker command files Build
<a href= Debug unlock certificate generation script does not generate DER certificate blob Build
<a href= LPDDR: DDR PLL reset code issue DDR
<a href= DebugP_assert: change so that it does not lock up the entire core DPL
<a href= ClockP_usleep() getting into infinite loop due to timer wraparound DPL
<a href= OLDI Single Link Common Mode VOCM Voltage Drop with MCU+SDK Display
<a href= Wrong comments on HwiP_inISR() API Documentation
<a href= SysConfig does not generate correct FLASH section parameters. Flash
<a href= I2C Target Overrun Test Hangs Waiting for Callback I2C
<a href= I2c_transfer not returning correct status when transfer mode is set to polling I2C
<a href= I2C_transfer() return not handled properly while i2cLldHandle is NULL I2C
<a href= SysConfig does not support configuring both 10-bit own addresses for I2C target mode I2C
<a href= NACK is not returned to application when performing i2c write in polling mode I2C
<a href= I2C target mode with multiple own addresses transaction fails I2C
<a href= Linux Kernel IPC Examples are broken IPC
<a href= DMA channel teardown sequence is not proper in MCASP_disableDmaTx MCASP
<a href= [MCSPI]End of Channel Transfer status check is missing for DMA mode MCSPI
<a href= [MCSPI] Timeout mechanism missing to prevent Infinite loops in MCSPI driver MCSPI
<a href= PDMA channels are not aligned properly with the different MCSPI instants MCSPI
<a href= eMMC Init Code Missing DLL Register Settings needed for Initial Legacy SDR Mode Phase MMCSD
<a href= eMMC PHY I/O Calibration not getting executed during eMMC boot MMCSD
<a href= SDR/DDR mode are not enabled in the Sysconfig for MMCSD MMCSD
<a href= MMCSD driver does not follow the SWITCH command sequence correctly MMCSD
<a href= EXTCSD HS_TIMING register is set incorrectly at certain places in the driver MMCSD
<a href= MMCSD driver uses infinite loop instead of timeout for checking fields of PRESENTSTATE register MMCSD
<a href= Timing issues with MMCSD host controller driver MMCSD
<a href= Incorrect handling of the CAPABILITIES register in the eMMC initialization MMCSD
<a href= Random CRC errors observed for eMMC HS400 mode on random reset test MMCSD
<a href= Comment and Implementation does not match in the MMCSD_retune MMCSD
<a href= eMMC Driver Error Interrupt Flags accessed in Wrong Register MMCSD
<a href= eMMC Init Code ignores early failures and continues Execution MMCSD
<a href= eMMC Driver Error Recovery Recursion can lead to System Crashes MMCSD
<a href= MMCSD : Read fails when injecting Command time out fault MMCSD
<a href= MMCSD : Read fails when injecting Command Index fault MMCSD
<a href= MMCSD : Read times out in HS200 mode after writing in SDR50 mode MMCSD
<a href= MMCSD : Read fails when injecting Command CRC fault MMCSD
<a href= MMCSD : Read fails when passing invalid argument. MMCSD
<a href= eMMC PHY Tuning Status Result Ignored when switching to HS400 Mode MMCSD
<a href= MMCSD close() is not proper MMCSD
<a href= Simultaneous FAT transfer fails for the same instance while being accessed from two different tasks. MMCSD
<a href= MMCSD : Write fails when passing invalid argument. MMCSD
<a href= MMCSD : Read fails when injecting Command End Bit fault MMCSD
<a href= HSDDR50 mode lead to data CRC errors with correct timing values. MMCSD
<a href= MMCSD close fails after opening the same instance twice. MMCSD
<a href= MMCSD Sysconfig provides options to configure PHY type MMCSD
<a href= MMCSD error recovery sequence isn't implemented correctly MMCSD
<a href= Missing -p flag with strip command to reduce the size of *.out Makefiles
<a href= OSPI tuning algorithm finds points in noisy region on rare scenarios OSPI
<a href= OSPI_flashExecCmd has a couple of checks where the code may get stuck OSPI
<a href= Configured dummy cycles in flash driver contradicts flash data sheet OSPI
<a href= OSPI DAC Mode Configuration hardcoded and not based on flashsize OSPI
<a href= OSPI_PhyTuneGrapher missing read delay value 4 OSPI
<a href= OSPI Phy Status Check Missing OSPI
<a href= AM62P: fss flash boot size is locking the MMRs OSPI
<a href= NOR Flash Fixup missing in SBL NULL OSPI
<a href= Flash_eraseSector and Flash_norOspiEraseSector does not erases the mentioned sector. OSPI
<a href= gMemBootloaderConfig in the bootloader driver is not thread safe SBL
<a href= SBL SD is broken on AM62P SBL
<a href= Secure board configurations by default allows JTAG unlocking SBL
<a href= DMA is not enabled for SOC Memory boot media in the SysConfig SBL
<a href= gAppimage is not allocated to the intended section defined in the linker command files SBL
<a href= """sbl_uart_uniflash_stage2"" is not prebuilt" SBL
<a href= FORCE bit not book keeped properly for MCSPI DMA mode of operation Software
<a href= Improve Sysconfig tool tips for all drivers SysConfig
<a href= UDMA: HC/UHC channel allocation fails due to RM config mismatch with CSL defines UDMA
<a href= UDMA multiple channel open for the same channel and invalid instance not handling properly UDMA
<a href= VTM module sensor reset sequence modification for reliable functionality SDL
<a href= SDL DCC Seed Value Calculation Deviates from TRM Guidelines SDL
<a href= PBIST example and tests fail in UART Bootmode SDL

Known Issues

ID Head Line Module
<a href= MCU+ SDK LPDDR4 Driver starts DDR Training/Leveling Sequence twice DDR
<a href= MCU+ SDK Example Projects using incorrect ARMv7 MPU Attributes for Peripheral Register Region Examples
<a href= Outstanding mailbox messages prevent suspend IPC
<a href= MMCSD_enableBootPartition implements two mutually exclusive concepts as one function MMCSD
<a href= MMCSD_read & MMCSD_write function are not designed simple & readable MMCSD
<a href= MMCSD field Card Type is not ordered logically in the Sysconfig MMCSD
<a href= Incorrect calculation of rowColEnd in the ext_otp_writeMmr OTP
<a href= RTC Test application failing intermittently. RTC
<a href= SBL_SD bootloaders report incorrect boot image size SBL
<a href= MCU+ SDK CCS Project Build Generates Invalid/Redundant Boot Image Files Build
<a href= WKUP UART0 is not working in CallBack mode UART
<a href= eMMC retuning may be attempted during the initialization sequence MMCSD
<a href= 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
<a href= AM62Px: ECC: SDL_MCAN1_MCANSS_MSGMEM_WRAP_ECC_AGGR aggregator is failing SDL
<a href= CSI RX ECC aggregators are failing on AM62P/AM62X SDL
<a href= Running MCU LBIST on SBL causes JTAG connection issues to MCU R5F 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 LPM is not supported with SBL boot flow. It is supported only with SPL boot flow. Bootloader
3 The EVM is limited to only one MAC address in the EEPROM, applications requiring multiple MAC addresses should enable and configure manual MAC address entry in Sysconfig. Networking

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.