AM275 FreeRTOS SDK  11.02.00
Release Notes 11.02.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
AM275x R5F, C75 AM275-EVM (referred to as am275x-evm in code) Windows 10 64b or Ubuntu 22.04 64b

Features Added in This Release

Note
Update of OSPI tuning algorithm on this SDK causes increase in tuning time. Refer OSPI NOR Flash Performance
Feature Module
HyperRAM ECC Support HyperRAM
QoS Configuration support QoS
Firewall Examples Security
New OSPI tuning algorithm is added OSPI
Example to demonstrate VTM triggered SoC reset is added SDL
ATCM/BTCM reset base toggle support for multistage bootloader DM
Minimal low power modes support (IO Retention) DM
Support to print DM application logs based on board config is added DM
Example to demonstrate the Jack-Jack latency performance is added(Ethernet AVB Audio Playback Demo) Ethernet AVB
Sample Ethernet AVB Media Clock Recovery example using external clock generator(CDCE6214) is added Ethernet AVB
Sample Ethernet AVB Media Clock Recovery example using Automotive PHY with clock generator(DP83TG721) is added (Ethernet AVB Multistream Media Clock Recovery) Ethernet AVB
Optimized Jack-Jack Latency performance benchmark is added in datasheet (Performance of Ethernet AVB) Ethernet AVB

Dependent Tools and Compiler Information

Tools/ Component Supported CPUs Version
Code Composer Studio R5F, C75 20.3.1
SysConfig R5F, C75 1.24.2, build 4234
TI ARM CLANG R5F 4.0.1.LTS
C7000-CGT C75 5.0.0.LTS
FreeRTOS Kernel R5F, C75 11.1.0

SDK Components

SYSFW / TIFS

Version 11.02.05
Release Notes LINK
User Guide LINK

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
C++ support NA

Eval Features

Attention
Features listed below are early versions and gone through limited testing.
Feature Module
HW ASRC support ASRC
HyperRAM support OSPI
Optiflash support OSPI
AUDIOLIB TISP All modules in AUDIOLIB, TISP

Key Features

OS Kernel

OS Supported CPUs SysConfig Support
FreeRTOS Kernel R5F, C75 NA
FreeRTOS POSIX R5F, C75 NA
No RTOS R5F NA

Driver Porting Layer (DPL)

Module Supported CPUs SysConfig Support OS support
Address Translate R5F Yes FreeRTOS, NORTOS
Cache R5F, C75 Yes FreeRTOS, NORTOS
Clock R5F, C75 Yes FreeRTOS, NORTOS
CycleCounter R5F, C75 NA FreeRTOS, NORTOS
Debug R5F, C75 Yes FreeRTOS, NORTOS
Heap R5F, C75 NA FreeRTOS, NORTOS
Hwi R5F, C75 Yes FreeRTOS, NORTOS
MPU R5F, C75 Yes FreeRTOS, NORTOS
Semaphore R5F, C75 NA FreeRTOS, NORTOS
Task R5F, C75 NA FreeRTOS
Timer 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
SD WKUP-R5F Yes NA NA 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 Supported CPUs SysConfig Support
ADC R5F YES
ASRC C7X YES
ECAP R5F, C7X YES
EPWM R5F, C7X YES
EQEP R5F, C7X YES
GPIO R5F, C7X YES
I2C R5F, C7X YES
IPC R5F, C7X YES
MCAN R5F YES
MCASP R5F, C7X YES
MCSPI R5F YES
MMCSD R5F YES
Pinmux R5F, C7X YES
RTC C7X YES
SOC R5F, C7X YES
SCI Client R5F, C7X YES
UART R5F, C7X YES
UDMA R5F, C7X YES

Board Device Drivers

Peripheral Supported CPUs SysConfig Support
EEPROM R5F Yes
Flash WKUP-R5F Yes
LED R5F Yes

SDL

SDL Module Supported CPUs SysConfig Support
MCRC R5F No
ESM R5F No
VTM R5F No
DCC R5F No
ECC R5F No
RTI R5F No
POK R5F No
PBIST R5F No
LBIST R5F No
ROM_CHECKSUM R5F No
Note
This is BQ release for SDL. FSQ release will be provided in next release.

Fixed Issues

ID Head Line Module
EXT_SITMPUSW-177 Invalid comment in the linker command files BUILD
EXT_SITMPUSW-172 DebugP_assert: change so that it does not lock up the entire core DPL
EXT_SITMPUSW-196 ClockP_getTimeUsec() returns 1000 us less than the actual time when it's multiple of 1000 us on C7x core. DPL
EXT_SITMPUSW-217 ClockP_usleep() getting into infinite loop due to timer wraparound DPL
EXT_SITMPUSW-109 Wrong comments on HwiP_inISR() API Documentation
EXT_SITMPUSW-241 MCU-PLUS-SDK-AM275x: fread error caused by incorrect MMU settings Example
EXT_SITMPUSW-112 SysConfig does not generate correct FLASH section parameters. Flash
EXT_SITMPUSW-179 I2C Target Overrun Test Hangs Waiting for Callback I2C
EXT_SITMPUSW-183 I2c_transfer not returning correct status when transfer mode is set to polling I2C
EXT_SITMPUSW-191 I2C_transfer() return not handled properly while i2cLldHandle is NULL I2C
EXT_SITMPUSW-192 SysConfig does not support configuring both 10-bit own addresses for I2C target mode I2C
EXT_SITMPUSW-194 NACK is not returned to application when performing i2c write in polling mode I2C
EXT_SITMPUSW-232 I2C target mode with multiple own addresses transaction fails I2C
EXT_SITMPUSW-180 Mailbox maximum fifo messages count is incorrect IPC
EXT_SITMPUSW-211 DMA channel teardown sequence is not proper in MCASP_disableDmaTx MCASP
EXT_SITMPUSW-218 MCASP: Mcasp Tx channel disable fails on C7x MCASP
EXT_SITMPUSW-188 [MCSPI]End of Channel Transfer status check is missing for DMA mode MCSPI
EXT_SITMPUSW-200 [MCSPI] Timeout mechanism missing to prevent Infinite loops in MCSPI driver MCSPI
EXT_SITMPUSW-208 PDMA channels are not aligned properly with the different MCSPI instants MCSPI
EXT_SITMPUSW-110 eMMC Init Code Missing DLL Register Settings needed for Initial Legacy SDR Mode Phase MMCSD
EXT_SITMPUSW-113 eMMC PHY I/O Calibration not getting executed during eMMC boot MMCSD
EXT_SITMPUSW-123 MMCSD driver does not follow the SWITCH command sequence correctly MMCSD
EXT_SITMPUSW-124 EXTCSD HS_TIMING register is set incorrectly at certain places in the driver MMCSD
EXT_SITMPUSW-125 MMCSD driver uses infinite loop instead of timeout for checking fields of PRESENTSTATE register MMCSD
EXT_SITMPUSW-126 Timing issues with MMCSD host controller driver MMCSD
EXT_SITMPUSW-127 Incorrect handling of the CAPABILITIES register in the eMMC initialization MMCSD
EXT_SITMPUSW-153 eMMC Driver Error Interrupt Flags accessed in Wrong Register MMCSD
EXT_SITMPUSW-153 eMMC Init Code ignores early failures and continues Execution MMCSD
EXT_SITMPUSW-155 eMMC Driver Error Recovery Recursion can lead to System Crashes MMCSD
EXT_SITMPUSW-171 MMCSD : Read fails when injecting Command time out fault MMCSD
EXT_SITMPUSW-176 MMCSD : Read fails when injecting Command Index fault MMCSD
EXT_SITMPUSW-185 MMCSD : Read times out in HS200 mode after writing in SDR50 mode MMCSD
EXT_SITMPUSW-186 MMCSD : Read fails when injecting Command CRC fault MMCSD
EXT_SITMPUSW-195 MMCSD : Read fails when passing invalid argument. MMCSD
EXT_SITMPUSW-198 MMCSD : EMMC clock validation fails in C7 core MMCSD
EXT_SITMPUSW-204 MMCSD close() is not proper MMCSD
EXT_SITMPUSW-209 Simultaneous FAT transfer fails for the same instance while being accessed from two different tasks. MMCSD
EXT_SITMPUSW-212 MMCSD : Write fails when passing invalid argument. MMCSD
EXT_SITMPUSW-215 MMCSD : Read fails when injecting Command End Bit fault MMCSD
EXT_SITMPUSW-230 MMCSD close fails after opening the same instance twice. MMCSD
EXT_SITMPUSW-78 MMCSD Sysconfig provides options to configure PHY type MMCSD
EXT_SITMPUSW-84 MMCSD error recovery sequence isn't implemented correctly MMCSD
EXT_SITMPUSW-207 Missing -p flag with strip command to reduce the size of *.out Makefiles
EXT_SITMPUSW-118 OSPI tuning algorithm finds points in noisy region on rare scenarios OSPI
EXT_SITMPUSW-158 OSPI_flashExecCmd has a couple of checks where the code may get stuck OSPI
EXT_SITMPUSW-181 Configured dummy cycles in flash driver contradicts flash data sheet OSPI
EXT_SITMPUSW-187 OSPI DAC Mode Configuration hardcoded and not based on flashsize OSPI
EXT_SITMPUSW-190 OSPI_PhyTuneGrapher missing read delay value 4 OSPI
EXT_SITMPUSW-213 OSPI Phy Status Check Missing OSPI
EXT_SITMPUSW-240 NOR Flash Fixup missing in SBL NULL OSPI
EXT_SITMPUSW-85 Flash_eraseSector and Flash_norOspiEraseSector does not erases the mentioned sector. OSPI
EXT_SITMPUSW-157 gMemBootloaderConfig in the bootloader driver is not thread safe SBL
EXT_SITMPUSW-189 Secure board configurations by default allows JTAG unlocking SBL
EXT_SITMPUSW-193 DMA is not enabled for SOC Memory boot media in the SysConfig SBL
EXT_SITMPUSW-228 AM275: SBL: Sciserver deinit happens within System_deinit causing DM services to fail SBL
EXT_SITMPUSW-121 FORCE bit not book keeped properly for MCSPI DMA mode of operation Software
EXT_SITMPUSW-226 Improve Sysconfig tool tips for all drivers SysConfig
EXT_SITMPUSW-174 UDMA: HC/UHC channel allocation fails due to RM config mismatch with CSL defines UDMA
EXT_SITMPUSW-214 UDMA multiple channel open for the same channel and invalid instance not handling properly UDMA
EXT_EP-13056 VTM module sensor reset sequence modification for reliable functionality SDL
EXT_EP-13057 SDL DCC Seed Value Calculation Deviates from TRM Guidelines SDL
EXT_EP-13058 PBIST example and tests fail in UART Bootmode SDL

Known Issues

ID Head Line Module
EXT_SITMPUSW-153 MCU+ SDK CCS Project Build Generates Invalid/Redundant Boot Image Files Build
EXT_SITMPUSW-120 AM62A/AM275x: C7x task size/alignment should be 8KB (not 16KB) C7X
EXT_SITMPUSW-261 AM275x FreeRTOS SDK: The CycleCounterP_getCount32 for R5F_0_0 is not accurate DPL
EXT_SITMPUSW-251 MCU+ SDK Example Projects using incorrect ARMv7 MPU Attributes for Peripheral Register Region Examples
EXT_SITMPUSW-219 AM62D/A/275: C7x portGET_RUN_TIME_COUNTER_VALUE API uses hard coded CPU Freq FreeRTOS
EXT_SITMPUSW-222 MMCSD field Card Type is not ordered logically in the Sysconfig MMCSD
EXT_SITMPUSW-256 Import from json does not work OSPI
EXT_SITMPUSW-249 2 C7x cores ( c7x_0 and c7x_1 ) in AM275 are not able to run 2 different McASP instances MCASP
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
EXT_EP-12282 AM275x: ECC: Some of the aggregators are failing on AM275x - FSS1_OSPI, MCAN0_MSGMEM_WRAP, ADC12FCC0, R5FSS0_PULSAR, WKUP_AGGR0_DM, DMASS0 and WKUP_PSRAM are failing SDL

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.

Module Migration guide Older version Newer version
Bootloader Bootloader Migration Guidelines <= 10.01.00 >= 11.00.00
NETWORKING Version Updates from earlier SDKs to Latest <= 11.01.00 >= 11.02.00
OSPI OSPI Migration Guide <= 11.01.00 >= 11.02.00

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.