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 |
|---|---|---|
| EXT_SITMPUSW-177 | Invalid comment in the linker command files | Build |
| EXT_SITMPUSW-243 | Debug unlock certificate generation script does not generate DER certificate blob | 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-208 | PDMA channels are not aligned properly with the different MCSPI instants | 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-115 | SDR/DDR mode are not enabled in the Sysconfig for MMCSD | 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-137 | Random CRC errors observed for eMMC HS400 mode on random reset test | MMCSD |
| EXT_SITMPUSW-139 | Comment and Implementation does not match in the MMCSD_retune | 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-203 | eMMC PHY Tuning Status Result Ignored when switching to HS400 Mode | 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-225 | HSDDR50 mode lead to data CRC errors with correct timing values. | 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-227 | AM62P: fss flash boot size is locking the MMRs | 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-157 | gMemBootloaderConfig in the bootloader driver is not thread safe | SBL |
| EXT_SITMPUSW-159 | SBL SD is broken on AM62P | 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-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-13058 | PBIST example and tests fail in UART Bootmode | SDL |
Known Issues
| ID | Head Line | Module |
|---|---|---|
| EXT_SITMPUSW-245 | MCU+ SDK LPDDR4 Driver starts DDR Training/Leveling Sequence twice | DDR |
| EXT_SITMPUSW-251 | MCU+ SDK Example Projects using incorrect ARMv7 MPU Attributes for Peripheral Register Region | Examples |
| 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-135 | RTC Test application failing intermittently. | RTC |
| EXT_SITMPUSW-220 | SBL_SD bootloaders report incorrect boot image size | SBL |
| EXT_SITMPUSW-153 | MCU+ SDK CCS Project Build Generates Invalid/Redundant Boot Image Files | Build |
| EXT_SITMPUSW-258 | WKUP UART0 is not working in CallBack mode | UART |
| EXT_SITMPUSW-259 | eMMC retuning may be attempted during the initialization sequence | MMCSD |
| 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-12277 | AM62Px: ECC: SDL_MCAN1_MCANSS_MSGMEM_WRAP_ECC_AGGR aggregator is failing | SDL |
| EXT_EP-12279 | CSI RX ECC aggregators are failing on AM62P/AM62X | SDL |
| EXT_EP-12280 | 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 |
<= 10.01.00 |
>= 11.00.00 |
|
NETWORKING |
<= 11.01.00 |
>= 11.02.00 |
|
OSPI |
<= 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 ` |