AM263x MCU+ SDK  08.05.00
Release Notes 08.05.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.
Unless explicitly noted otherwise, the SW modules would work on any of the R5F's present on the SOC.
Attention
Klockwork Static Analysis report is not updated for this release

New in this Release

Feature Module
Crypto driver support AES, SHA, HMAC, RSA, EDSA Security
HSM support for HS-FS device Security
Added get version example for HSM Client Security
ADC examples - Burst mode, differencial mode, synchronous SW trigger, interleaved averaging ADC
ADC examples - continous self trigger, EPWM triggered conversion, Oversampling ADC
MMCSD driver with raw IO support MMCSD
Ethernet (CPSW) dual mac/multiple netif support Ethernet
Ethernet Bare metal support Ethernet
Enet (CPSW) SysConfig support for MDIO, MAC PORT, ALE, Phy configurations etc Ethernet
PTP Timesync demo support in Enet CPSW TimeSync PTP Demo example Ethernet
Software Diagnostics Library SDL

Device and Validation Information

SOC Supported CPUs EVM Host PC
AM263x R5F AM263x ControlCard Revision E1 (referred to as am263x-cc in code).
Windows 10 64b or Ubuntu 18.04 64b
AM263x R5F AM263x LaunchPad Revision E1 (referred to as am263x-lp in code) Windows 10 64b or Ubuntu 18.04 64b

Dependent Tools and Compiler Information

Tools Supported CPUs Version
Code Composer Studio R5F 12.1.0
SysConfig R5F 1.14.0, build 2667
TI ARM CLANG R5F 2.1.2.LTS
FreeRTOS Kernel R5F 10.4.3
LwIP R5F STABLE-2_1_2_RELEASE
Attention
TI ARM CLANG 2.1.2.LTS is not part of CCS by default, Follow steps at TI CLANG Compiler Toolchain to install the compiler

Key Features

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
GUI for UART Uniflash Tool Bootloader

OS Kernel

OS Supported CPUs SysConfig Support Key features tested Key features not tested / NOT supported
FreeRTOS Kernel R5F NA Task, Task notification, interrupts, semaphores, mutexs, timers Task load measurement using FreeRTOS run time statistics APIs. Limited support for ROV features.
FreeRTOS POSIX R5F NA pthread, mqueue, semaphore, clock -
NO RTOS R5F NA See Driver Porting Layer (DPL) below -

Driver Porting Layer (DPL)

Module Supported CPUs SysConfig Support OS support Key features tested Key features not tested / NOT supported
Cache R5F YES FreeRTOS, NORTOS Cache write back, invalidate, enable/disable -
Clock R5F YES FreeRTOS, NORTOS Tick timer at user specified resolution, timeouts and delays -
CpuId R5F NA FreeRTOS, NORTOS Verify Core ID and Cluster ID that application is currently running on -
CycleCounter R5F NA FreeRTOS, NORTOS Measure CPU cycles using CPU specific internal counters -
Debug R5F YES FreeRTOS, NORTOS Logging and assert to any combo of: UART, CCS, shared memory -
Heap R5F NA FreeRTOS, NORTOS Create arbitrary heaps in user defined memory segments -
Hwi R5F YES FreeRTOS, NORTOS Interrupt register, enable/disable/restore, Interrupt prioritization -
MPU R5F YES FreeRTOS, NORTOS Setup MPU and control access to address space -
Semaphore R5F NA FreeRTOS, NORTOS Binary, Counting Semaphore, recursive mutexs with timeout -
Task R5F NA FreeRTOS Create, delete tasks -
Timer R5F YES FreeRTOS, NORTOS Configure arbitrary timers -

Secondary Bootloader (SBL)

Module Supported CPUs SysConfig Support OS support Key features tested Key features not tested / NOT supported
Bootloader R5FSS0-0 YES NORTOS Boot modes: QSPI, UART. All R5F's. RPRC, multi-core image format Force Dual Core Mode, Disable Dual Core Switch and R5SS1 only not tested

SOC Device Drivers

Peripheral Supported CPUs SysConfig Support DMA Supported Key features tested Key features not tested / NOT supported
ADC R5F YES Yes. Example: adc_soc_continuous_dma Single software triggered conversion, Multiple ADC trigger using PWM, Result read using DMA, EPWM trip through PPB limit, PPB limits, PPB offsets, burst mode oversampling, differential mode, Offset, EPWM triggered conversion -
Bootloader R5F YES Yes. DMA enabled for SBL QSPI Boot modes: QSPI, UART. All R5F's -
CMPSS R5F YES NA Asynchronous PWM trip -
CPSW R5F YES No MAC loopback, PHY loopback, LWIP: Getting IP, Ping, Iperf, Layer 2 MAC, Layer 2 PTP Timestamping and CPSW Switch support -
DAC R5F YES Yes. Example: dac_sine_dma Constant voltage, Square wave generation, Sine wave generation with and without DMA, Ramp wave generation, Random Voltage generation -
ECAP R5F YES No ECAP APWM mode, PWM capture -
EDMA R5F YES NA DMA transfer using interrupt and polling mode, QDMA Transfer, Channel Chaining, PaRAM Linking -
EPWM R5F YES Yes. Example: epwm_dma PWM outputs A and B in up-down count mode, Trip zone, Update PWM using EDMA, Valley switching, High resolution time period adjustment, type5 feature -
EQEP R5F YES NA Speed and Position measurement. Frequency Measurement not tested
FSI R5F YES Yes. Example: fsi_loopback_dma RX, TX, polling, interrupt mode, Dma, single lane loopback. - FSI Spi Mode
GPIO R5F YES NA Output, Input and Interrupt functionality -
I2C R5F YES No Controller mode, basic read/write -
IPC Notify R5F YES NA Mailbox functionality, IPC between RTOS/NORTOS CPUs M4F core
IPC Rpmsg R5F YES NA RPMessage protocol based IPC M4F core
MCAN R5F YES No RX, TX, interrupt and polling mode, Corrupt Message Transmission Prevention, Error Passive state, Bus Off State, Bus Monitoring Mode -
MCSPI R5F YES Yes. Example: mcspi_loopback_dma Controller/Peripheral mode, basic read/write, polling, interrupt and DMA mode -
MDIO R5F YES NA Register read/write, link status and link interrupt enable API -
MPU Firewall R5F YES NA Only compiled (Works only on HS-SE device) -
MMCSD R5F YES NA MMCSD 4bit, Raw read/write - file IO, eMMC
PINMUX R5F YES NA Tested with multiple peripheral pinmuxes -
PRUICSS R5F YES NA Tested with Ethercat FW HAL -
QSPI R5F YES Yes. Example: qspi_flash_dma_transfer Read direct, Write indirect, Read/Write commands, DMA for read -
RTI R5F YES No Counter read, timebase selction, comparator setup for Interrupt, DMA requests Capture feature, fast enabling/disabling of events not tested
SDFM R5F YES No Filter data read from CPU, Filter data read with PWM sync -
SOC R5F YES NA Lock/unlock MMRs, clock enable, set Hz, Xbar configuration, SW Warm Reset, Address Translation -
SPINLOCK R5F NA NA Lock, unlock HW spinlocks -
UART R5F YES Yes. Example: uart_echo_dma Basic read/write at baud rate 115200, polling, interrupt mode HW flow control not tested, DMA mode not supported
WATCHDOG R5F YES NA Reset mode Interrupt mode

Board Device Drivers

Peripheral Supported CPUs SysConfig Support Key features tested Key features not tested
EEPROM R5F YES Only compiled -
ETHPHY R5F YES Tested with ethercat_slave_beckhoff_ssc_demo example -
FLASH R5F YES QSPI Flash -
LED R5F YES GPIO -

CMSIS

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
- - - - - -

Industrial Communications Toolkit

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
EtherCAT SubDevice FWHAL R5F NO FreeRTOS Tested with ethercat_slave_beckhoff_ssc_demo example Reset isolation

Motor Control

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
- - - - - -

Networking

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
LwIP R5F YES FreeRTOS TCP/UDP IP networking stack with and without checksum offload enabled,, TCP/UDP IP networking stack, DHCP, ping, TCP iperf, TCP/UDP IP, scatter-gather Other LwIP features, checksum offload with VLAN_Tag, more robustness tests pending
Ethernet driver (ENET) R5F YES FreeRTOS Ethernet as port using CPSW and ICSS,Layer 2 MAC, Layer 2 PTP Timestamping, CPSW Switch, CPSW EST, interrupt pacing, Policer, MDIO Manual Mode -
ICSS-EMAC R5F YES FreeRTOS Only compiled Not tested

Demos

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
- - - - - -

Safety Diagnostic Library

Module Supported CPUs SysConfig Support OS support Key features tested Key features not tested / NOT supported
MCRC R5F NA NORTOS Full CPU, Auto CPU Mode Semi CPU Auto Mode.
DCC R5F NA NORTOS Single Shot and Continuous modes -
PBIST R5F NA NORTOS Memories supported by MSS PBIST controller. -
ESM R5F NA NORTOS Tested in combination with RTI, DCC -
RTI R5F NA NORTOS WINDOWSIZE_100_PERCENT, WINDOWSIZE_50_PERCENT ,Latency/Propagation timing error(early)(50% window),Latency/Propagation timing error(late)(50% window) -
ECC R5F NA NORTOS ECC of MSS_L2, R5F TCM, MCAN R5F Cache, VIM, HSM, ICSSM, CPSW
Bus Safety R5F NA NORTOS AHB, AXI, TPTC -
CCM R5F NA NORTOS CCM Self Test Mode. Error Forcing Mode and Self Test Error Forcing Mode.
R5F STC(LBIST) R5F NA NORTOS STC of R5F. -

Fixed Issues

ID Head Line Module Applicable Releases Applicable Devices Resolution/Comments
MCUSDK-1016 Semaphore does not function as expected when "post" call is present in multiple ISRs at different priorities DPL, FreeRTOS 07.03.02 onwards AM263x Fixed
MCUSDK-3797 Fix for enabling –rom_model linker optiom DPL 08.01.00 onwards AM263x Fixed
MCUSDK-4059 FSI first frame transmitted is incorrect in DMA mode FSI 08.02.00 onwards AM263x Fixed
MCUSDK-6908 ECAP triggers missing from ADC drivers ADC 08.03.00 onwards AM263x Fixed
MCUSDK-8079 EDMA: Aggregated interrupt used instead of Region interrupt EDMA 08.04.00 onwards AM263x Fixed
MCUSDK-8235 CMPSS: Example fails - PWM not tripped on LP CMPSS 08.04.00 onwards AM263x Fixed
MCUSDK-8348 [Enet] EnetDma_initPktInfo does not initialized chkSumInfo member Enet 08.04.00 onwards AM263x Fixed
MCUSDK-8394 Trip zone retains previous code when Advanced option is chosen EPWM 08.03.00 onwards AM263x Fixed
MCUSDK-8395 Action Qualifier T1 trigger source and T2 trigger source configuration is being overwritten by syscfg EPWM 08.03.00 onwards AM263x Fixed
MCUSDK-8396 [EPWM]EALLOW comments needs to be changed for EPWM_lockRegisters API (C2K feature) EPWM 08.03.00 onwards AM263x Fixed
MCUSDK-8423 [enet] MDIO manual mode delay implementation is incorrect Enet 08.04.00 onwards AM263x Fixed
MCUSDK-8430 Digital Compare Event CBC Event and Latch is not present in Syscfg EPWM 08.03.00 onwards AM263x Fixed
MCUSDK-8432 Digital Compare DCxH(L) Trip syscfg configurable changes EPWM 08.03.00 onwards AM263x Fixed
MCUSDK-8460 hardcoded sysconfig for HSM Server not allowing to change the Secure Controller for HSM Security 08.03.00 onwards AM263x Fixed
MCUSDK-8467 EQEP strobe not OR'd with EPWM ADCSOCA/B EQEP 08.04.00 onwards AM263x Fixed
MCUSDK-8554 [Eqep]Compiler error when EQEP is configured for 2 instances EQEP 08.04.00 onwards AM263x Fixed
MCUSDK-8616 Changing RGMII mode in CPSW lwip example leads to assert Enet 08.04.00 onwards AM243x, AM64x Fixed
MCUSDK-8731 "[ERROR] XMODEM recv failed" during SBL UART boot across multiple examples Enet, IPC, SBL 08.04.00 onwards AM243x, AM64x Fixed

Known Issues

ID Head Line Module Reported in release Workaround
MCUSDK-2294 GPIO Pin Direction GPIO. GPIO Pin Direction not getting automatically configured. 8.0.0 Use GPIO_setDirMode to set pin direction for GPIO pin.
MCUSDK-2557 eqep_frequency_measurement example is failing SBL 8.2.0 -
MCUSDK-4234 FSI RX Generic Trigger Test is not working FSI 8.3.0 -
SITARAAPPS-2040 Dual Core configuration issue with CSP 1.1.3 (Sitara MCU Device Support) on AM263x CSP Gel Scripts 8.2.1 Edit gel file as mentioned in Prerequisites while running multi core applications.
MCUSDK-6909 EPWM: Emulation mode doesn't work EPWM 8.4.0 -
MCUSDK-7030 Interrupt nesting is not functional as expected when you have 2 or more interrupts with different priorities MCAN 8.4.0 Keep the interrupt priority same in system
MCUSDK-7319 CONTROLSS-SDFM: Two Back-to-Back Writes to SDCPARMx Register Bit Fields CEVT1SEL, CEVT2SEL, and HZEN Within Three SD-Modulator Clock Cycles can Corrupt SDFM State Machine, Resulting in Spurious Comparator Events SDFM 8.4.0 Avoid back-to-back writes within three SD-modulator clock cycles or have the SDCPARMx register bit fields configured in one register write.
MCUSDK-7811 CPSW: Ethernet Packet corruption occurs if CPDMA fetches a packet which spans across memory banks CPSW 8.3.0 onwards Ensure from application side single ethernet packet does not span across memory banks.
MCUSDK-7915 SDFM: EPWM filter sync example does not configure and check the PWM synchronization SDFM 8.3.0 onwards None
MCUSDK-8072 EnetBoard_setupPorts does not provide config option to enable internal delay for RGMII Enet 8.4.0 onwards None
MCUSDK-8073 UART1 not working as expected while configuring two uarts i.e UART0 and UART1 for two different cores UART 8.4.0 onwards UART1 configuration from other core should be done after UART0 is configured and initialized
MCUSDK-8348 EnetDma_initPktInfo does not initialized chkSumInfo member Enet 8.4.0 onwards All L2 based applications need to explicitly set EnetDma_initPktInfo.chkSumInfo = 0
MCUSDK-8391 PRU Pin Mux configuration missing in syscfg am263x PRU 8.4.0 -
MCUSDK-8403 1000000(1MHz) baud rate not working on UART UART 8.4.0 -
MCUSDK-8825 MCAN bit timing parameters not correct in Sysconfig generated code MCAN 8.4.0 -
MCUSDK-8974 LIN External Example is only sending the LIN ID and no packet data LIN 8.4.0 -
MCUSDK-8989 WDT Reset example takes more than expiration time to reset. WDT 8.5.0 None PROC_SDL-4558 Binary generated from MSS ECC CCS based example(sdl_ecc_r5_atcm0) does not work. SDL 8.5.0 onwards Add the resetvecs.S manually in to CCS project / Use the binary generated from gmake.
PROC_SDL-4749 AXI DED Bus Safety fail. SDL 8.5.0 onwards None.
PROC_SDL-4751 In CCM mode, only self test mode tested.Error Forcing Mode and Self Test Error Forcing Mode are not yet supported. SDL 8.5.0 onwards None.
PROC_SDL-4755 MCRC Semi CPU mode is not supported. SDL 8.5.0 onwards Use Full CPU mode ot Auto mode.

Limitations

ID Head Line Module Reported in release Workaround
- - - - -

Upgrade and Compatibility Information

Compiler Options

Module Affected API Change Additional Remarks

SOC Device Drivers

Module Affected API Change Additional Remarks
EPWM sysconfig Following configurables -
Under 'EPWMXA OutputOutput Configuration'
EPWMXA T1 Trigger Source (epwmActionQualifier_EPWM_AQ_OUTPUT_A_t1Source)
EPWMXA T2 Trigger Source (epwmActionQualifier_EPWM_AQ_OUTPUT_A_t2Source)
Under 'EPWMXB OutputOutput Configuration'
EPWMXB T1 Trigger Source (epwmActionQualifier_EPWM_AQ_OUTPUT_B_t1Source)
EPWMXB T2 Trigger Source (epwmActionQualifier_EPWM_AQ_OUTPUT_B_t2Source)
Renamed from epwmActionQualifier_EPWM_AQ_OUTPUT_A_t1Source to epwmActionQualifier_t1Source and epwmActionQualifier_EPWM_AQ_OUTPUT_A_t2Source to epwmActionQualifier_t2Source.
Removed epwmActionQualifier_EPWM_AQ_OUTPUT_B_t1Source and epwmActionQualifier_EPWM_AQ_OUTPUT_B_t2Source
Action Qualifier has T1 and T2 trigger source. This is independent of EPWMA and EPWMB. Up to 8.4, EPWM sysconfig module supported EPWM_A/EPWM_B dependent configurables (which is redundant) for T1 and T2 trigger source.
Modify the SysCfg file as follows:
Search and replace
epwmActionQualifier_EPWM_AQ_OUTPUT_A_t1Source with epwmActionQualifier_t1Source
epwmActionQualifier_EPWM_AQ_OUTPUT_A_t2Source with epwmActionQualifier_t2Source
Remove
epwmActionQualifier_EPWM_AQ_OUTPUT_B_t1Source and epwmActionQualifier_EPWM_AQ_OUTPUT_B_t2Source

Networking

Module Affected API Change Additional Remarks
ENET SysConfig For all LWIP based examples, packet buffer memory management is moved out of driver and expected to handle at application side. This requires user to regenerate the code via SysConfig This is applicable only for RX, TX remains same. Custom pBuff enabled LwIP application to manage the buffer memory efficiently
ENET, LWIP Library Names Library 'enet-lwip-cpsw' is split into 'enet-cpsw' and 'lwipif-cpsw-freertos'. 'lwip-contrib' is renamed to 'lwip-contrib-freertos' Additionally while using NoRTOS (baremetal) based examples nortos version of 'lwipif-cpsw' and 'lwip-contrib' needs to be used