- 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 |
| ECC example for R5F cache | SDL |
| IPC between A53 cores | IPC |
| Example for Key Revision update | OTP |
| LPM example for MCU only with Timer and MCAN as wakeup sources | LPM |
| Coremark-pro, Dhrystone, interrupt latency benchmarks for A53 | Benchmark |
| Optimized boottime for eMMC, SD boot by enabling DMA for DDR to DDR copy | Bootloader |
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 |
| FreeRTOS AMP support on A53. | DPL, FreeRTOS |
| A53 FreeRTOS AMP examples demonstrating usage of ethernet | Networking |
FreeRTOS Support on A53
| Is | Is Not |
| FreeRTOS AMP support on A53 | GPU Support |
| Drivers listed for A53 in "SOC Device Drivers" section | Low power mode support |
| Ethernet Networking | 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 | 20.1.0 |
| SysConfig | M4F, R5F, A53 | 1.23.0, build 4000 |
| TI ARM CLANG | M4F, R5F | 4.0.1.LTS |
| GCC AARCH64 | A53 | 9.2-2019.12 |
| FreeRTOS Kernel | M4F, R5F, A53 | 11.1.0 |
SDK Components
SYSFW / TIFS
| Version | 11.00.07 |
| Release Notes | LINK |
| User Guide | LINK |
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 |
Networking
| Module | Supported CPUs | SysConfig Support | OS Support | Key features tested | Key features not tested |
| TSN | A53 | 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 | A53 | 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) | A53 | 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 | R5F | Yes |
| DSS | Main | A53 | 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 |
| RTC | Main | R5F, A53 | 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 |
| EXT_SITMPUSW-52 | UART baud rate and operational mode condition misalignment | UART | 08.03.00 |
| EXT_SITMPUSW-57 | Data Abort at MCSPI_udmaIsrTx when using MCSPI DMA | MCSPI | 08.03.00 |
| EXT_SITMPUSW-58 | MCU PLUS SDK: ipc_rpmsg_echo [DM Firmware] Timeout not working as expected, crashes FW | DM, IPC | 08.03.00 |
| EXT_SITMPUSW-59 | VTM giving same value for every call | VTM | 10.01.00 |
| EXT_SITMPUSW-89 | I2C Error Handler transition from status to i2cTransaction.status | I2C | 08.03.00 |
| EXT_SITMPUSW-90 | MMCSD_write & MMCSD_read function fails for the numBlocks greater than 0xFFFF | MCSPI | 08.04.00 |
| EXT_EP-12318 | SDL_ECC_aggrTransBaseAddressTable declared without extern keyword | SDL | 11.00.00 |
| EXT_EP-12320 | AM62x: VTM: vtm_example is failing on R5F core | SDL | 11.00.00 |
| EXT_EP-12324 | gSDL_pvt_poly_golden has to be used in SDL_vtmPrepLookupTable API instead of gSDL_pvt_poly | SDL | 11.00.00 |
| PROC_SDL-8865 | AM62x: ECC: SDL_ICSSM0_ICSS_M_CORE_BORG_ECC_AGGR aggregator is failing | SDL | 11.00.00 |
| EXT_SITMPUSW-55 | AM62x: ENET : A53 : TCP Throughput drop in iperf application running on FreeRTOS A53 core | Ethernet | 11.00.00 |
Known Issues
| ID | Head Line | Module | Reported in release | Workaround |
| EXT_SITMPUSW-28 | Outstanding mailbox messages prevent suspend | IPC | 08.03.00 | No known workaround |
| EXT_SITMPUSW-73 | OSPI_readDirect and OSPI_isPhyEnable do not correctly check if the PHY is enabled | OSPI | 08.03.00 | No known workaround |
| EXT_SITMPUSW-77 | Modify Read capture delay logic for Tap Mode | OSPI | 08.03.00 | No known workaround |
| EXT_SITMPUSW-78 | MMCSD Sysconfig provides options to configure PHY type | MMCSD | 08.03.00 | No known workaround |
| EXT_SITMPUSW-85 | Flash_eraseSector and Flash_norOspiEraseSector does not erases the mentioned sector. | Flash | 08.03.00 | No known workaround |
| EXT_SITMPUSW-87 | Sysconfig crashing when adding large number of GPIO pins | GPIO | 08.03.00 | No known workaround |
| EXT_EP-12275 | AM62x: ECC: SDL_WKUP_R5FSS0_PULSAR_UL_CPU0_ECC_AGGR aggregator is failing on M4F core | SDL | 10.01.00 | No known workaround |
| EXT_EP-12276 | ECC: Firewall related aggregator failures - ECC Aggregators SDL_SA3_SS0_SA3SS_AM62A_DMSS_ECCAGGR and SDL_SMS0_SMS_TIFS_ECC fail because of firewall access issues faced by SDL | SDL | 10.01.00 | No known workaround |
| EXT_EP-12278 | ECC Aggregator SMS0_SMS_HSM_ECC Aggr fails on AM62x. | SDL | 10.00.00 | No known workaround |
| EXT_EP-12279 | CSI RX ECC aggregators are failing on AM62P/AM62X | SDL | 09.01.00 | No known workaround |
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
- Attention
- When migrating from oldder version to 11.00.00, see Bootloader Migration Guidelines for more details
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.
1.8.20