Release Notes 10.00.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 |
|---|---|
PMIC driver support |
PMIC |
GPIO default value can be configured in sysconfig |
GPIO |
GPIO direction is set part of sysconfig generated code |
GPIO |
RTOS owned DSS resources are firewalled during display sharing with HLOS |
DSS |
HDMI output panel |
DSS |
YUV420, YUV422 frame format support |
DSS |
QoS support |
QoS |
Early PLL driver in TIFS init updated to follow recommended sequence to avoid PLL instability |
TIFS |
PM PLL and HSDIV programing in PLL init updated to remove steps violating the recommendation |
DM |
Other Updates on This Release
Update |
Module |
|---|---|
ATF Load Address is updated to 0X80000000 from 0x9e780000 |
LinuxAppImageGen, QnxAppImagegen |
Linux FDT is added in qnx app image and loaded at DDR 0x88000000 |
QnxAppImagegen |
make commands are added in boardcfg makefile to open k3-resource-part tool |
BoardCfg |
OSPI tuning optimizations to redue tuning time |
OSPI |
I2C driver updated for inclusinve API names |
I2C |
Option to skip driver open is added in sysconfig |
McASP |
FreeRTOS FAT will now work with FreeRTOS application as well |
FAT FS |
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.7.0 |
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 |
10.6.1 |
TIFS |
NA |
10.00.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 |
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 |
|---|---|---|---|
| SITSW-4271 | Update the FSS_CTRL register to support 128MB flash size by default. | OSPI | 09.02.00 onwards |
| SITSW-4282 | Skip tuning is not happenning for sbl stage2 as stage1 closes the drivers. | OSPI | 09.02.00 onwards |
| SITSW-4337 | Bootloader_socInitR5FAtcmBtcm function uses global ATCM address resulting in CBASS error | SBL | 09.02.00 onwards |
| SITSW-4345 | A53 core freq is limited to 1250MHz in bootloader | SBL | 09.02.00 onwards |
| SITSW-4417 | No checks on number blocks in a single MMCSD R/W transaction | MMCSD | 09.02.00 onwards |
| SITSW-4549 | OSPI Read delay using an older value | OSPI | 09.02.00 onwards |
| SITSW-4599 | SysConfig Updates to UART Clock Frequency fails to reflect in ti_drivers_config.c | UART | 09.02.00 onwards |
| SITSW-4611 | Generated tiboot3.bin in SBL examples are copy of GP images instead of HSFS | SBL | 09.02.00 onwards |
| SITSW-4612 | UART driver is initialized late in the sysconfig generated code | UART | 09.02.00 onwards |
| PROC_SDL-7823 | Setting trim value for non-Ping pong mode POKs accesses invalid offset | SDL | 09.02.00 onwards |
| SYSFW-7536 | Sending JTAG unlock certificate to TIFS using T32 JTAG fails | TIFS | 09.02.01 onwards |
| SYSFW-7474 | Write access from DMA initiators to RA GCFG region results in firewall exception | TIFS | 08.06.00 onwards |
| SYSFW-7485 | Update the PLL driver in TIFS boot flow to follow correct sequence | TIFS | 08.06.00 onwards |
| SYSFW-7463 | TISCI_MSG_GET_CLOCK always return Enabled for input clock | DM | 08.06.00 onwards |
| SYSFW-7486 | PM: Cleanup additional steps in pll init startup routine | DM | 08.06.00 onwards |
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-5992 | Unable to set exact pixel clock for OLDI LCD display / HDMI Pixel clock | DM | 08.05.00 | Avoid gving range for SET_CLOCK, use exact values for min, max and target |
| SYSFW-6369 | DM unable to enter deep sleep mode when booting in SBL flow | DM | 08.03.00 | None. |
| SYSFW-6432 | Set device API doesn't return Error when PD is in transition state | DM | 08.03.00 | None. |
| SYSFW-6426 | Ownership of a firewall region can be transferred to an invalid host | TIFS | 08.03.00 | None. |
| SYSFW-7201 | A53 privid is 4 in am62p and j722s and should be 1 | TIFS | 09.01.00 | None. |
| SYSFW-7559 | LPM: In MCU Only mode resume path the MCU_M4 LPSC is ON | DM | 10.00.00 | None. |
| SYSFW-7571 | LPM: Device IDs higher than 255 will not work with set device constraint | DM | 10.00.00 | None. |
| PROC_SDL-6326 | Running MCU LBIST on SBL causes JTAG connection issues to MCU R5F | LBIST | 09.02.00 | None |
| PROC_SDL-7044 | ECC is not supported for some instances. These are SDL_DSS_DSI0_K3_DSS_DSI_DSI_TOP_ECC_AGGR_SYS SDL_CSI_RX_IF0_CSI_RX_IF_ECC_AGGR | SDL | 09.01.00 | None. Support will be added in future release. |
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 |
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.
Compiler Options
| Module | Affected API | Change | Additional Remarks |
|---|
Examples
| Module | Affected API | Change | Additional Remarks |
|---|
OS Kernel
| Module | Affected API | Change | Additional Remarks |
|---|
SOC Device Drivers
| Module | Affected API | Change | Additional Remarks |
|---|---|---|---|
| Bootloader | Bootloader_parseAndLoadLinuxAppImage | Bootloader_parseAndLoadLinuxAppImage is removed, Bootloader_parseMultiCoreAppImage is updated to parse and load Linux AppImage | NA |
Networking
| Module | Affected API | Change | Additional Remarks |
|---|