- 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 |
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
- 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 |
Bad block management support for OSPI NAND | OSPI |
A53 Drivers: ECAP, EPWM, EQEP, GPMC, Spinlock | Drivers |
GPIO default value can be configured in sysconfig | GPIO |
GPIO direction is set part of sysconfig generated code | GPIO |
FreeRTOS FAT is now supported with FreeRTOS | File System |
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 |
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 |
A53 FreeRTOS support and A53 FreeRTOS examples | DPL, FreeRTOS |
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 |
Bootloader powers off cores if image not present | SBL |
FreeRTOS FAT will now work with FreeRTOS application as well | FAT FS |
FreeRTOS Support on A53
Is | Is Not |
FreeRTOS single core support on A53 | GPU Support |
Drivers listed for A53 in "SOC Device Drivers" section | Low power mode support |
- | CSI RX Driver |
- | WiFi, USB, BLE Drivers |
- | Safety on A53 |
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 | 12.7.0 |
SysConfig | M4F, R5F, A53 | 1.20.0, build 3587 |
TI ARM CLANG | M4F, R5F | 3.2.2.LTS |
GCC AARCH64 | A53 | 9.2-2019.12 |
FreeRTOS Kernel | M4F, R5F, A53 | 10.6.1 |
TIFS | NA | 10.00.08 |
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 |
SOC Device Drivers
Peripheral | Domain | Supported CPUs | SysConfig Support |
DDR | Main | R5F | 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 |
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 | Applicable Releases |
SITSW-3920 | DDR Inline ECC example does not work in debug mode on AM62x | DDR | 09.01.00 onwards |
SITSW-3945 | Issues with the OSPI NAND PHY tuning | OSPI | 09.00.00 onwards |
SITSW-4229 | OSPI NAND performance reduction when phy tuning is skipped | OSPI | 09.02.00 onwards |
SITSW-4271 | Update the FSS_CTRL register to support 128MB flash size by default. | OSPI | 09.01.00 onwards |
SITSW-4282 | Skip tuning is not happenning for sbl stage2 as stage1 closes the drivers. | OSPI | 09.01.00 onwards |
SITSW-4337 | Bootloader_socInitR5FAtcmBtcm function uses global ATCM address resulting in CBASS error | SBL | 08.06.00 onwards |
SITSW-4345 | A53 core freq is limited to 1250MHz in bootloader | SBL | 08.06.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 | 08.04.00 onwards |
SITSW-4611 | Generated tiboot3.bin in SBL examples are copy of GP images instead of HSFS | SBL | 08.06.00 onwards |
SITSW-4612 | UART driver is initialized late in the sysconfig generated code | UART | 08.06.00 onwards |
SITSW-4613 | Generation of Board Configuration Binary fails for HS-SE device type | SBL | 08.06.00 onwards |
SITSW-4630 | Hwip_disable API not working properly on M4F | DPL | 08.06.00 onwards |
SITSW-4647 | AM62X : PADCFG offset value is missing for B16 pin | Pinmux | 08.06.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. |
SITSW-4001 | On SK-AM62-SIP, SBL with ECC enabled does not boot linux, when the SDRAM index is set to 13 | DDR | 09.01.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-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-8404 | ECC is not supported for some instances. These are SDL_CSI_RX_IF0_CSI_RX_IF_ECC_AGGR | SDL | 10.00.00 | None. Support will be added in future release. |
PROC_SDL-8139 | SDL ECC example application exits with failure on UC-2 | SDL | 10.00.00 | Update the MPU config for the example to make the register region as Strongly Ordered. The Example app will be fixed in future release. |
PROC_SDL-8138 | VTM example app fails when built for freertos | SDL | 10.00.00 | Use the nortos example. Example will be fixed in future release. |
PROC_SDL-8137 | PBIST example app fails when built for freertos | SDL | 10.00.00 | Use the nortos example. Freertos example will be fixed in future release. |
PROC_SDL-8134 | POK example app fails when built for freertos | SDL | 10.00.00 | Use the nortos example. Freertos example will be fixed 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 | 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.
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 |