EthFw Release Notes

Version: 11.02.01

Contents

  1. Introduction
  2. Licensing
  3. Getting Started
  4. Documentation
  5. Device Support
  6. Validation Information
  7. Known Issues
  8. Dependencies
  9. Technical Support
  10. Package Versioning

Introduction

This release notes provides important information that will assist you in using the EthFw component. This document provides the product information and known issues with respect to EthFw software component. The EthFw component consists of firmware for Ethernet switch, profiling tools and demos/applications for J722S silicon platforms.

Licensing

Refer to Processor SDK RTOS top-level manifest.

Getting Started

The Ethernet Firmware User's Guide provides the documentation and references necessary to run EthFw demos and begin development on TI's platforms.

Documentation

Refer to following documentation for further details:

Ethernet Firmware User Guide Build instructions, Demos User Guide
Ethernet Firmware API Guide API Guide API Guide

Device Support

Below table shows device support for EthFw.
SoC HOST (OS) Target (OS) Test Platform
J722S Linux FreeRTOS J722S EVM
J721E Linux FreeRTOS, SafeRTOS J721E EVM with GESI and QSGMII Daughter Boards
J7200 Linux FreeRTOS, SafeRTOS J7200 EVM with QSGMII Daughter Board
J784S4 Linux FreeRTOS, SafeRTOS J784S4 EVM with QSGMII Daughter Board

Refer Processor SDK RTOS release notes for SDK device support.

Validation Information

This release was built and validated using the following tools. Refer to the EthFw User's Guide for additional instructions to install and setup the dependencies.

Build Tools (included in Processor SDK)

SoC ISA SafeRTOS package version
J721E R5F 009-005-199-024-219-005
J7200 R5F 009-005-199-024-219-005
J784S4 R5F 009-005-199-024-219-005

Known Issues and Limitations

Issue ID Headline Module Reported in Release Affected Platforms Workaround
ETHFW-2088 EthFW will get stuck waiting for link if link partner is not ready Enet, EthFw 08.04.00.00 J721E, J7200, J784S4 None.
ETHFW-2575 CPSW error flags are not getting updated in UDMA host packet descriptor EthFw 09.02.00.00 J721E, J7200, J784S4 None.
ETHFW-2885 Error Code For Error Packets Not Being Passed to Host CPU in CPSW9G/CPSW5G Enet, EthFw 10.00.00.00 J721E, J7200, J721S2, J784S4 None.
ETHFW-2586 CPSW ALE Table Reads Return Incorrect Values After Prolonged Operation (>20M Runs) Enet, EthFw 09.00.00.00 J721E, J7200, J721S2, J784S4 Trigger CPSW ALE read twice before reading value.
ETHFW-3691 EthFw code has 9 unresolved static analysis violations EthFw 11.02.01 J721E, J7200, J784S4, J722S None

Limitations

For J722S MAC Port 2 supports SGMII mode via MAC-to-MAC connectivity to another Jacinto device (e.g., J721E) through an Ethernet Expander Bridge, as J722S lacks integrated SGMII PHY support.

As J742S2 EVM E1 version does not provide any Enet board/connector, hence no functionality test has been done on J742S2-EVM. EthFw (built for J742S2) for CPSW_9G is validated on J784S4-EVM post applying a patch. Please refer to ETHFW J742S2 Testing section in ETHFW User's Guide for more details.

Dependencies

All Ethernet Firmware dependencies are also part of the SDK, please refer to the User's Guide for details.

Technical Support

For technical support and additional assistance, contact local TI Field Application Engineer

Package Versioning

Each package version is composed of 4 period-delimited numbers - represented here by the letters M, m, p and b [M.m.p.b]. The table below provides a descriptive reference regarding package version numbering.

Digit Meaning Description
1 (M=Major) Major revision Incremented when the new version is substantially different from the previous For example, a new module added or an existing module's algorithm significantly altered.
2 (m=minor) Minor revision Incremented when the new version has changed but not in a major way. For example, some minor changes in the API or feature set.
3 (p=patch) Patch number Incremented for all other source code changes. This include any packaging support code.
4 (b=build) Build number Incremented for each release delivery to CM. Reset for any change to M, m or p.
Copyright 2026, Texas Instruments Incorporated