Release Notes 10.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 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

Feature

Module

OSPI flash diag application for custom flashes

OSPI

Support for authentication from DDR when in-place authentication fails from OSPI NOR

Bootloader

Support for SW version check of binaries through RPRC header

Bootloader

SBL now ensures the cores are switched off if no application image is present

Bootloader

SBL NULL: Close flash drivers before jumping to DM application

Bootloader

A53 priv-id is now set to 1 to match other SOCs (instead of previous value 4)

TIFS

WKUP-R5 FreeRTOS examples demonstrating usage of ethernet Networking with LwIP and TSN

Networking

Additional updates on this release

Update

Module

Networking Examples have been moved from examples to source/networking/enet/core/

Networking

PHY drivers used by networking examples have been moved, and added support through sysconfig-GUI

Networking

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

MCU-R5F, WKUP-R5F

12.8.1

SysConfig

MCU-R5F, WKUP-R5F

1.20.0, build 3587

TI ARM CLANG

MCU-R5F, WKUP-R5F

3.2.2.LTS

GCC AARCH64

A53

9.2-2019.12

FreeRTOS Kernel

MCU-R5F, WKUP-R5F

11.1.0

TIFS

NA

v10.01.08

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

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
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 Applicable Releases
EXT_SITMPUSW-34 SBL_UART_UNIFLASH_STAGE2 build fails on removing OSPI and FLASH module in Sysconfig Uniflasher 10.01.00
EXT_SITMPUSW-5 Potential Infinite loop in OSPI_utilLog2 defined in ospi_v0.c OSPI 10.01.00
EXT_SITMPUSW-35 MMCSD_initSD always returns SUCCESS SD 10.01.00
EXT_SITMPUSW-36 MMCSD_initSD does not check the retry variable for failure for OCR command SD 10.01.00
EXT_SITMPUSW-37 Misleading "File read from SD card" bootloader profile point in the SBL_SD bootloader Bootloader 10.01.00
EXT_SITMPUSW-38 Remote core getting hangs when doing IPC with HLOS IPC 10.01.00
EXT_SITMPUSW-39 Error in the CCS build of the SBL examples SBL 10.01.00
EXT_SITMPUSW-47 Update the DDR configuration with DDR syscfg 9.09+ SBL 10.01.00
EXT_SITMPUSW-48 AM62P VTM Temperature output value 0 SBL 10.01.00
EXT_SITMPUSW-41 ClockP_getTicks to use xTaskGetTickCountFromISR() freeRTOS function if it is from ISR DPL 10.01.00
EXT_SITMPUSW-3 EMMC:The tuning algorithm to re-execute up to 10 times if there is no failing or passing itapdly. EMMC 10.01.00
EXT_SITMPUSW-42 Enable floating point task save restore for all tasks by default DPL 10.01.00
EXT_SITMPUSW-43 MMCSD driver doesn't implement the recovery steps for CRC errors EMMC 10.01.00
EXT_SITMPUSW-49 SBL NULL: Close flash drivers before jumping to DM application EMMC 10.01.00
EXT_SITMPUSW-44 DebugP_log API returning wrong value DPL 10.01.00
SITSW-3685 DM Sciclient ignores flags field for TIFS bound messages DM 08.03.00 onwards
SITSW-4773 DM is ignoring the exact flags sent in TISCI message DM 08.03.00 onwards
SYSFW-5992 Unable to set exact pixel clock for OLDI LCD display / HDMI Pixel clock DM 08.05.00 onwards
SYSFW-6432 Set device API doesn't return Error when PD is in transition state DM 08.03.00 onwards
SYSFW-7559 In MCU-Only mode resume path the MCU_M4 LPSC is ON DM (LPM) 10.00.00 onwards
SYSFW-7571 Device IDs higher than 255 does not work with set device constraint API DM (LPM) 10.00.00 onwards
SYSFW-7602 RTC count value not getting updated after DeepSleep exit DM (LPM) 08.03.00 onwards
SYSFW-7614 Unable to configure DSS clock below 15.625MHz DM 10.00.00 onwards
SYSFW-7617 LPM mode selection logic does not check for constraints on all the hosts/devices DM (LPM) 10.00.00 onwards
SYSFW-7740 Only the last latency constraint value passed from a host considered in LPM selection DM (LPM) 10.00.00 onwards
SYSFW-7753 A53 privid is set to 4 and does not match other SOCs value of 1 TIFS 09.02.00 onwards
SYSFW-7760 LPM: MCU subsystem (GPIO) clock should not be changed in MCU Only mode DM (LPM) 10.00.00 onwards
SYSFW-6426 Ownership of a firewall region can be transferred to an invalid host TIFS 08.03.00 onwards
SYSFW-7739 LPM constraint messages received by TIFS not forwarded to DM TIFS 10.00.00

Known Issues

ID Head Line Module Reported in release Workaround
MCUSDK-208 gmake with -j can sometimes lock up Windows command prompt Build 07.03.00 Use bash for windows as part of git for windows or don't use -j option
SITSW-2269 DeepSleep Low power mode (LPM) is not supported if the DM R5 is used for a general purpose application. DM 08.06.00 None.
PMICDRV-194 CRC value received from the PMIC doesn't match with the calculated value PMIC 10.00.00 None.
PMICDRV-195 Getting ADC result code as zero PMIC 10.00.00 None.
SYSFW-7781 Get device API does not return error when the LPSC is in transition state DM 10.01.00 None.
SYSFW-7831 DMA Resources used by ROM are not cleaned up when resuming from IO Only + DDR mode DM (LPM) 10.01.00 None.
SYSFW-7884 There is an additional divide by 4 on all clocks of WKUP/MCU GPIO clock mux DM 10.01.00 None.
SYSFW-7897 Partial I/O mode fails after few hundred iterations DM (LPM) 10.01.00 None.
SYSFW-7899 LPM configuration is not enabled in HS-SE firmware TIFS (LPM) 10.01.00 None.
PROC_SDL-6326 Running MCU LBIST on SBL causes JTAG connection issues to MCU R5F LBIST 09.02.00 None
PROC_SDL-8582 VTM Example is failing in no-bootmode SDL 10.01.00 Use UART Bootmode
PROC_SDL-8860 (MCAN1), PROC_SDL-7044 (CSI) ECC is not supported for some instances. These are SDL_MCAN1_MCANSS_MSGMEM_WRAP_ECC_AGGR SDL_CSI_RX_IF0_CSI_RX_IF_ECC_AGGR SDL 10.01.00 (MCAN1), 09.01.00 (CSI) None
PROC_SDL-8861 ECC is not supported for some instances due to firewall. These are SDL_SA3_SS0_SA3SS_AM62A_DMSS_ECCAGGR SDL_SA3_SS0_SA3SS_AM62A_SA_UL_ECC_AGGR SDL 10.01.00 None
PROC_SDL-8792 System_deinit error in MCRC Semi CPU and Auto CPU examples SDL 10.01.00 None

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