Release Notes 08.02.00

Table of Contents

• New in this Release
• Device and Validation Information
• Tools, Compiler and Other Open Source SW Module Information
• Key Features
  • OS Kernel
  • Driver Porting Layer (DPL)
  • SOC Device Drivers
  • Secondary Bootloader (SBL)
  • Board Device Drivers
  • Networking
• Fixed Issues
• Known Issues
• Limitations
• Upgrade and Compatibility Information
  • Compiler Options

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 noted otherwise, the SW modules would work in both FreeRTOS and NORTOS environment.
Unless noted otherwise, the SW modules would work on any of the CPU present on the SOC.
Unless noted otherwise, the SW modules would work on all supported EVMs

New in this Release

Feature	Module
R5F (No-RTOS, FreeRTOS), C66x (No-RTOS, FreeRTOS),	CPU/OS
LwIP with ethernet driver (ENET) for CPSW	LwIP, ENET
UART, RTI (Timer), EDMA, EPWM, CBUFF	Drivers
IPC, HWA, CSI2-RX, CRC, GPIO, MIBSPI	Drivers
QSPI, Flash writer, MCAN, I2C , ESM, Watchdog, GPADC, ECAP	Drivers
SBL booting R5F and C66x	Bootloader

Device and Validation Information

SOC	Supported CPUs	EVM	Host PC
AM273x	R5F, C66x	AM273x GP EVM (referred to as am273x-evm in code)	Windows 10 64b or Ubuntu 18.04 64b

Tools, Compiler and Other Open Source SW Module Information

Tools / SW module	Supported CPUs	Version
Code Composer Studio	R5F, C66x	11.1.0
SysConfig	R5F, C66x	1.11.0 build, build 2225
TI ARM CLANG	R5F	1.3.0.LTS
TI C6000 Compiler	C66x	8.3.11
FreeRTOS Kernel	R5F, C66x	10.4.3
DSP LIB	C66x	3.4.0.0

DSP LIB package is modified to fix the build in Linux environment from the base version dsplib_c66x_3_4_0_0

Key Features

OS Kernel

OS	Supported CPUs	SysConfig Support	Key features tested	Key features not tested / NOT supported
FreeRTOS Kernel	R5F, C66x	NA	Task, Task notification, interrupts, semaphores, mutexs, timers, event groups. ROV views in CCS IDE, Task load measurement using FreeRTOS run time statistics APIs.	-
FreeRTOS POSIX	R5F, C66x	NA	pthread, mqueue, semaphore, clock	-
NO RTOS	R5F, C66x	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, C66x	YES	FreeRTOS, safeRTOS, NORTOS	Cache write back, invalidate, enable/disable	-
Clock	R5F, C66x	YES	FreeRTOS, safeRTOS, NORTOS	Tick timer at user specified resolution, timeouts and delays	-
CycleCounter	R5F, C66x	NA	FreeRTOS, safeRTOS, NORTOS	Measure CPU cycles using CPU specific internal counters	-
Debug	R5F, C66x	YES	FreeRTOS, safeRTOS, NORTOS	Logging and assert to any combo of: UART, CCS, shared memory	-
Heap	R5F, C66x	NA	FreeRTOS, safeRTOS, NORTOS	Create arbitrary heaps in user defined memory segments	-
Hwi	R5F, C66x	YES	FreeRTOS, safeRTOS, NORTOS	Interrupt register, enable/disable/restore	-
MPU	R5F	YES	FreeRTOS, safeRTOS, NORTOS	Setup MPU and control access to address space	-
Semaphore	R5F, C66x	NA	FreeRTOS, safeRTOS, NORTOS	Binary, Counting Semaphore, recursive mutexs with timeout	-
Task	R5F, C66x	NA	FreeRTOS, safeRTOS	Create, delete tasks	-
Timer	R5F, C66x	YES	FreeRTOS, safeRTOS, NORTOS	Configure arbitrary timers	-
Event	R5F, C66x	YES	FreeRTOS, safeRTOS	Setting, getting, clearing, and waiting of Event bits	-

SOC Device Drivers

Peripheral	Supported CPUs	SysConfig Support	Key features tested	Key features not tested / NOT supported
ADCBUF	R5F, C66x	YES	Source selection, Set chirp thresholds, continuous mode, configure modes	-
CBUFF	R5F, C66x	YES	stream data over LVDS interface	-
CRC	R5F, C66x	YES	Two channels, 8, 16, 32 and 64 bit data size, CPU mode	-
CSI-RX	R5F, C66x	YES	Setup complexio, dphy, common and context settings, event callbacks	-
ECAP	R5F, C66x	YES	Frequency, Duty cycle, interrupt mode	PWM mode not tested
EDMA	R5F, C66x	YES	Basic memory copy, DMA/QDMA channels, Interrupt/Polled, Manual/Event trigger, Chaining	-
EPWM	R5F	YES	Frequency, Duty cycle, interrupt mode	Tripzone, Deadband and Chopper module not tested
ESM	R5F, C66x	YES	Group and Error number selection, Tested ESM notifier with watchdog module	-
GPADC	R5F, C66x	YES	10-bit ADC, Tested single/multiple buffer and on board temperature sensor read	-
GPIO	R5F, C66x	YES	Basic input/output, GPIO as interrupt	-
HWA	R5F, C66x	YES	FFT, CFAR, compression/decompression and local maxima modules, Interrupt/Polled, Manual/DMA trigger	-
I2C	R5F, C66x	YES	Master mode, basic read/write, polling and interrupt mode	Slave mode not supported. Driver not tested from C66x due to EVM limitations
IPC Notify	R5F, C66x	YES	Low latency IPC between RTOS/NORTOS CPUs	-
IPC Rpmsg	R5F, C66x	YES	RPMessage protocol based IPC for all R5F, C66x running NORTOS/FreeRTOS	-
MCAN	R5F	YES	RX, TX, interrupt and polling mode	-
MIBSPI	R5F, C66x	YES	Master/Slave mode, basic read/write, Interrupt/Polled, icount enable/disable, CPU/DMA mode	-
Pinmux	R5F, C66x	YES	Tested with multiple peripheral pinmuxes	-
QSPI	R5F	YES	Read direct, Write indirect, Read/Write commands	Interrupt mode not supported, Dual and Quad writes are not supported
SOC	R5F, C66x	YES	Lock/unlock MMRs, get CPU clock, CPU name, clock enable, set frequency	-
UART	R5F, C66x	YES	Basic read/write, polling, interrupt mode, CPU/DMA mode	-
WATCHDOG	R5F, C66x	YES	Window size and Expiry time selections, Reset mode, Digital windowed	-

Secondary Bootloader (SBL)

Module	Supported CPUs	OS support	Key features tested	Key features not tested / NOT supported
Bootloader	R5FSS0-0	NORTOS	Boot modes: QSPI, UART. R5F (Lockstep/Dual Core) and C66x core boot. RPRC, multi-core image format, Pll configuration.	-

Board Device Drivers

Peripheral	Supported CPUs	SysConfig Support	Key features tested	Key features not tested
EEPROM	R5F	YES	I2C based EEPROM	-
Flash	R5F	YES	QSPI based flash	All vendor flash types not tested
LED	R5F, C66x	YES	GPIO based LED control	-

Networking

Module	Supported CPUs	SysConfig Support	OS Support	Key features tested	Key features not tested
LwIP	R5F	NO	FreeRTOS	TCP/UDP IP networking stack, DHCP, ping, TCP iperf, TCP/UDP IP	Other LwIP features, performance and memory optimizations pending, more robustness tests pending
Ethernet driver (ENET)	R5F	NO	FreeRTOS	Ethernet as port using CPSW; MAC loopback and PHY loopback	Ethernet as switch

Fixed Issues

ID	Head Line	Module	Applicable Releases	Resolution/Comments
MCUSDK-2457	Tools installed twice due to makefile based and ccs based builds	Build	08.01.00	Fixed
MCUSDK-2191	CPSW example doesn't work with SBL	CPSW	08.01.00	Fixed
MCUSDK-2346	docs - Document External JTAG issue workaround	docs	08.01.00	Fixed
MCUSDK-2396	Low SVC stack size with Interrupt nesting enabled	DPL	08.01.00	Fixed
MCUSDK-2301	Correct main task name from frertos_main to freertos_main	Enet	08.01.00	Fixed
MCUSDK-2244	Enet documentation needs to be enabled	Enet	08.01.00	Fixed
MCUSDK-2151	I2C Probe does not display slave devices correctly	I2C	08.01.00, 08.00.02	Fixed
MCUSDK-2541	IPC developer guide block diagram shows invalid cores	IPC_Notify, IPC_RPMSG	08.01.00	Fixed
MCUSDK-2507	[AM273] [QSPI] Missing QSPI driver documentation	QSPI	08.01.00	Fixed
MCUSDK-3266	Remove customer name from the code	SBL	08.01.00	Fixed
MCUSDK-2401	Application size limitation with SBL_UART	SBL	08.01.00	Fixed
MCUSDK-2416	AM64X: Writing images to flash larger than 1024 KByte, uniflash finishes with errors	UART	08.01.00	Fixed

Known Issues

ID	Head Line	Module	Applicable Releases	Workaround
PDK-8405	MIBSPI non-DMA mode transfer doesn't complete when used in mmWaveSDK	MIBSPI	8.00.01	None. Issue is not seen in driver unit test
MCUSDK-2037	MIBSPI: Observing issues with SPI communication on Two-Chip cascade board	MIBSPI	8.00.01	None. Issue is not seen when ccs log is enabled in the application.
MCUSDK-2453	R5 - Init code crashes under certain conditions	FreeRTOS, No-RTOS	8.02.00	None
MCUSDK-2232	"HWA_paramSetDonePolling" function in HWA driver not working properly	HWA_FFT	8.02.00	None
MCUSDK-2183	Streaming of data over Ethernet interface not stable	Enet	8.02.00	None

Limitations

ID	Head Line	Module	Reported in Release	Workaround
PDK-8404	QSPI test failing at 80 Mhz	QSPI	8.00.01	QSPI driver works at 40 Mhz

Upgrade and Compatibility Information

Attention

When migrating from Processor SDK RTOS, see Migration Guides 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.

Compiler Options

Module	Affected API	Change	Additional Remarks
Release Build	-	Updated optimization level in release build to 'Os' as part of bug fix MCUSDK-1980.	The release build with ti-arm-clang compiler has been updated from 'O3' to 'Os' optimization level. It is recommended that user rebuilds the existing libraries and applications with 'Os' option. This can be done by updating CFLAGS_release in library/example makefiles.