- 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 |
| AM62Dx | MCU R5F, WKUP R5F, A53, C75 | AM62D-EVM EVM (referred to as am62dx-evm in code) | Windows 10 64b or Ubuntu 22.04 64b |
Features Added in This Release
| Feature | Module |
| SBL initiates LBSIT and PSBIST for MCU R5F core before booting MCU R5F now | SBL |
| HS-SE boot support | SBL |
| Hello World CPP example added for A53 and C7x | examples |
| DDR inline ECC suppot | DDR |
| Updated DDR configuration from DDR configuration tool v10.30 | DDR |
| ECC Functional Test example for single bit errors is added | SDL |
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 |
| AUDIOLIB | Moudles in AUDIOLIB |
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 | Supported CPUs | Version |
| Code Composer Studio | MCU-R5F, C75 | 20.2.0 |
| SysConfig | MCU-R5F, DM-R5F, C75 | 1.24.0, build 4150 |
| TI ARM CLANG | MCU-R5F, WKUP-R5F | 4.0.1.LTS |
| GCC AARCH64 | A53 | 9.2-2019.12 |
| C7000-CGT | C75 | 5.0.0.LTS |
| FreeRTOS Kernel | MCU-R5F, WKUP-R5F, C75, A53 | 11.1.0 |
SDK Components
SYSFW / TIFS
| Version | 11.01.02 |
| Release Notes | LINK |
| User Guide | LINK |
Key Features
OS Kernel
| OS | Supported CPUs | SysConfig Support |
| FreeRTOS Kernel | MCU-R5F, WKUP-R5F, A53, C75 | NA |
| FreeRTOS POSIX | MCU-R5F, A53 | NA |
| FreeRTOS SMP | A53 | NA |
| No RTOS | MCU-R5F, WKUP-R5F, A53 | 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, A53, C75 | Yes | FreeRTOS, NORTOS |
| Clock | MCU-R5F, WKUP-R5F, A53, C75 | Yes | FreeRTOS, NORTOS |
| CycleCounter | MCU-R5F, WKUP-R5F, A53, C75 | NA | FreeRTOS, NORTOS |
| Debug | MCU-R5F, WKUP-R5F, A53, C75 | Yes | FreeRTOS, NORTOS |
| Heap | MCU-R5F, WKUP-R5F, A53, C75 | NA | FreeRTOS, NORTOS |
| Hwi | MCU-R5F, WKUP-R5F, A53, C75 | Yes | FreeRTOS, NORTOS |
| MPU | MCU-R5F, WKUP-R5F, A53, C75 | Yes | FreeRTOS, NORTOS |
| Semaphore | MCU-R5F, WKUP-R5F, A53, C75 | NA | FreeRTOS, NORTOS |
| Task | MCU-R5F, WKUP-R5F, A53, C75 | NA | FreeRTOS |
| Timer | MCU-R5F, WKUP-R5F, A53 | Yes | FreeRTOS, NORTOS |
Secondary Bootloader (SBL)
| SBL Mode | Supported CPUs | SysConfig Support | PHY Support | DMA Support | OS support |
| OSPI NOR | WKUP-R5F | Yes | No | Yes | NORTOS |
| EMMC | WKUP-R5F | Yes | NA | NA | NORTOS |
| UART | WKUP-R5F | Yes | NA | No | NORTOS |
Networking
| Module | Supported CPUs | SysConfig Support | OS Support | Key features tested | Key features not tested |
| TSN | R5F | NO | FreeRTOS | gPTP IEEE 802.1 AS-2020 compliant gPTP stack, End Nodes and Bridge mode support, YANG data model configuration, IEEE 1722 compliant AVTP Stack | Multi-Clock Domain |
| LwIP | 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) | 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, 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 |
| GPIO | MCU | MCU-R5F | Yes |
| Main | A53, C75 | Yes |
| Wakeup | WKUP-R5F | Yes |
| I2C | MCU | MCU-R5F | Yes |
| Main | A53, C75 | Yes |
| Wakeup | WKUP-R5F | Yes |
| IPC | MCU | MCU-R5F | Yes |
| Main | A53, C75 | Yes |
| Wakeup | WKUP-R5F | Yes |
| MCAN | MCU | MCU-R5F | Yes |
| Maim | A53 | Yes |
| MCASP | Main | A53, C75 | Yes |
| MCSPI | Main | A53, C75 | Yes |
| MCU | MCU-R5F | Yes |
| MMCSD | Main | A53, C75 | Yes |
| Wakeup | WKUP-R5 | Yes |
| OSPI | Main | A53 | Yes |
| Wakeup | WKUP-R5 | Yes |
| Pinmux | Main | A53, C75 | Yes |
| MCU | MCU-R5F | Yes |
| Wakeup | WKUP-R5F | Yes |
| SA3UL | Main | A53 | Yes |
| SOC | NA | MCU-R5F, WKUP-R5F, A53, C75 | Yes |
| SCIClient | NA | MCU-R5F, WKUP-R5F, A53, C75 | Yes |
| UART | Main | A53, C75 | Yes |
| MCU | MCU-R5F | Yes |
| Wakeup | WKUP-R5F | Yes |
| UDMA | Main | A53, C75 | Yes |
| MCU | MCU-R5F | Yes |
| Wakeup | WKUP-R5F | Yes |
| WDT | Main | A53 | Yes |
| MCU | MCU-R5F | 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 |
| EEPROM | MCU-R5F, A53, C75 | Yes |
| Flash | WKUP-R5F, A53 | Yes |
| LED | MCU-R5F, A53, C75 | Yes |
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 |
Fixed Issues
| ID | Head Line | Module | Applicable Releases |
| EXT_EP-12267 | AM62D: MCRC Udma Init failure in semi cpu and auto mode configuration - MCRC semi cpu and auto mode examples fail at udma init step | SDL | 11.01.00 |
| EXT_EP-12721 | ECC TCM example cannot be built for AM62D | SDL | 11.01.00 |
| EXT_SITMPUSW-98 | Audio playback stops on applying breakpoint during CCS debugging | McASP | 11.00.00 |
| EXT_SITMPUSW-101 | Not able to import example projects in CCS v20 | Build | 11.00.00 |
| EXT_SITMPUSW-104 | Missing $Board to build HSMAppImageGen in /mcu_plus_sdk/am62dx/imports.mak | Build | 11.00.00 |
| EXT_SITMPUSW-105 | MMCSD driver uses snprintf function from libc | MMCSD | 11.00.00 |
| EXT_SITMPUSW-77 | Modify Read capture delay logic for Tap Mode | OSPI | 11.00.00 |
| EXT_SITMPUSW-106 | OSPI Phy Tuning Data is not written correctly in Flash_norOspiOpen() | OSPI | 10.01.00 |
Known Issues
| ID | Head Line | Module | Reported in release | Workaround |
| EXT_SITMPUSW-108 | freeRTOS/C7x - Task Size is very big | FreeRTOS | 11.00.00 | No known workaround |
| EXT_SITMPUSW-109 | Wrong comments on HwiP_inISR() API | DPL | 11.00.00 | No known workaround |
| EXT_SITMPUSW-78 | MMCSD Sysconfig provides options to configure PHY type | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-84 | MMCSD error recovery sequence isn't implemented correctly | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-110 | eMMC Init Code Missing DLL Register Settings needed for Initial Legacy SDR Mode Phase | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-113 | eMMC PHY I/O Calibration not getting executed during eMMC boot | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-114 | MMCSD_enableBootPartition implements two mutually exclusive concepts as one function | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-123 | MMCSD driver does not follow the SWITCH command sequence correctly | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-124 | EXTCSD HS_TIMING register is set incorrectly at certain places in the driver | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-125 | MMCSD driver uses infinite loop instead of timeout for checking fields of PRESENTSTATE register | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-126 | Timing issues with MMCSD host controller driver | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-128 | EMMC timiing parameters to be changed based on SOC and MMC instance | MMCSD | 11.00.00 | No known workaround |
| EXT_SITMPUSW-120 | C7x task size/alignment should be 8KB (not 16KB) | FreeRTOS | 11.00.00 | Change the stack alignment |
| EXT_SITMPUSW-121 | FORCE bit not book keeped properly for MCSPI DMA mode of operation | MCSPI | 11.00.00 | No known workaround |
| 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 | 10.01.00 | No known workaround |
| EXT_EP-12283 | ECC aggregators CPSW0, CSI RX are failing on AM62A and CPSW0 on AM62D. | SDL | 09.00.00 | No known workaround |
| EXT_EP-12280 | Running MCU LBIST on SBL causes JTAG connection issues to MCU R5F | SDL | 09.00.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 |
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.
Networking
| Module | Affected API | Change |
| TSN | notify_linkchange | notify_linkchange function is renamed to cb_lld_notify_linkchange, include path <tsn_combase/tilld/cb_lld_ethernet.h> in the file that uses cb_lld_notify_linkchange. |
1.8.20