5.2. PRU ICSS HSR PRP Release Notes¶
5.2.1. Overview¶
The PRU-ICSS HSR PRP package provides the foundation that facilitate application software development for HSR PRP Adapter on TI Sitara Embedded Processors with PRU-ICSS HW IP.
5.2.2. Licensing¶
Please refer to the software manifest, which outlines the licensing status for all packages included in this release. The manifest can be found on the SDK download page or in the installed directory as indicated below.
5.2.4. Documentation¶
- Software Developer Guide: Provides information on features, functions, delivery package and, compile tools for the release. This also provides detailed information regarding software elements and software infrastructure to allow developers to start creating applications.
- User Guide: Documentation of key API and interface changes from last release.
- HSR PRP Datasheet : Data sheet contains information about the capabilities of the solution, certification information (if applicable), memory and pin mux information. It can be found in the ‘docs’ folder in the installation directory. The directory structure is shown in the user guide here
- Software Manifest : Provides license information on software included in the package. The manifest can be found on the SDK download page or in the installed directory. The directory structure is shown in the user guide here
- EVM Quick Start Guide : Provides information on hardware setup and running the demonstration application that is loaded on flash. This document is provided as part of the EVM kit.
5.2.5. System Requirements¶
This release requires following Processor SDK RTOS as per the device, see Processor SDK Getting Started Guide
| Component | Version |
|---|---|
| Processor SDK RTOS for AM57xx | 9.2.0 |
| Processor SDK RTOS for AM437x | 6.3.0 |
| Processor SDK RTOS for AM335x | 6.3.0 |
Details on Processor SDK RTOS component versions can be found here |
5.2.5.1. Release 01.00.06¶
Released January 2025
PRU-ICSS HSR/PRP package download link : https://www.ti.com/tool/PRU-ICSS-INDUSTRIAL-SW
5.2.5.1.1. What’s New¶
- New interface for communicating packet timestamp from firmware to driver
- Bug Fixes
5.2.5.1.2. Platforms supported¶
- AM335x
- AM437x
- AM57x
- AMIC1x
5.2.5.1.3. Features supported¶
- RTOS support for AMIC1x, AM3x, AM4x, AM5x devices.
- RT-Linux support for AM57xx devices.
- HSR/PRP
- The implementation is as per IEC 62439-3 Ed 2.0
- HSR as per clause 5
- PRP as per clause 4
- LRE implemented completely in firmware
- Operates as a DAN (Dual Attached Node)
- The implementation is as per IEC 62439-3 Ed 2.0
- HSR
- Operates as a DANH
- As per clause 5 of the standard
- Support for modes – H, T, U and N as per standard
- Two ports as per standard, Port A and Port B
- Modes can be changed at run time
- PRP
- Operates as a DANP
- As per clause 6 of the standard
- Two ports as per standard, Port A and Port B
- QoS scheme
- Two priority receive queues on host port, each queue 6 KB in size
- Four priority transmit queues on each physical port, each queue 3 KB in size
- Support for QoS based on 3-bit VLAN PCP i.e. No of levels
supported : 8
- Number of host queues : 2 | 4 QoS levels per host queue
- Number of port queues : 4 | 2 QoS levels per port queue
- Support for Node Table
- Total 128 entries on AMICx, AM335x, AM437x
- Total 256 entries on AM57xx & AM65xx
- Hash Table for faster lookup
- O(1) complexity
- Node forget time of 60 sec
- Node Table statistics
- Support for Multicast Filtering
- Supported on all SoCs
- Hash Table for faster lookup
- O(1) complexity
- Support for VLAN Filtering for host port
- Supported on all SoCs
- Hash Table for faster lookup
- O(1) complexity
- Host Rx interrupt pacing
- Supported on all devices
- Individual interrupt per port
- Pacing timer configurable per port
- Duplicate Discard Table
- Duplicate discard on Port to Host path (HSR and PRP)
- Duplicate discard table on Port to Port path (HSR)
- Data integrity (CRC) check during port to port forwarding, except cut through (HSR)
- PHY Configuration
- Duplex : Full/Auto
- Speed : 100/Auto
- 10mbps and Half duplex modes are not supported
- Statistics
- Supports all MIB statistics as per standard
- Node Table statistics for debugging
- Self configuring
- PTP/1588
- PTP Slave and Master mode
- Supports P2P clock.
- PTP over 802.3 (Annex F)
- Transparent Clock supported
- Ordinary Clock supported
- Single and Two step clock supported
- Peer delay Response is always sent as two-step
- 1 ms buffering per port
- Storm Prevention
- Multicast and Broadcast storm prevention per port
- Interrupt for Link loss detection
- Link loss detection in under 200us
- Callback API’s to perform tasks related to change in network topology
5.2.5.1.4. What is not supported¶
- BMCA for PTP/1588
- See User Guide on how to switch between Slave and Master
- Boundary clock
- Multi domain support for SYNC
5.2.5.1.5. PRU-ICSS Firmware Revision¶
| Platform | Build | Firmware Header Location |
|---|---|---|
| AM335x, AM437x, AMIC11x | [2.20.41] | protocols\hsr_prp\firmware\v1.0 |
| AM571x, AM572x | [2.20.41] | protocols\hsr_prp\firmware\v2.1 |
5.2.5.1.6. Fixed Issues¶
| Record ID | Platform | Details |
|---|---|---|
| PINDSW-8342 | AM335x, AM437x, AMIC11x, AM571x, AM572x | HSR: PDK: Package icss_emac_phy_status_fix.patch for 1.0.6 Release |
| PINDSW-8363 | AM335x, AM437x, AMIC11x, AM571x, AM572x | HSR: AM3/AM4/AM5: timesync: Enable timesync on both ports |
| PINDSW-8364 | AM335x, AM437x, AMIC11x | HSR: AM3/AM4: fw: Disable Follow-Up frame forwarding by firmware |
| PINDSW-8365 | AM335x, AM437x, AMIC11x | HSR: AM3/AM4: timesync: Add minimum ecap-edma period check |
| PINDSW-8366 | AM335x, AM437x, AMIC11x, AM571x, AM572x | HSR: AM3/AM4/AM5: fw: Write pointer corruption Fix |
5.2.5.1.7. Known Issues¶
This section contains the list of known Issues at the time of making the release.
HSR/PRP FUNCTIONALITY
| Record ID | Platform | Details | Workaround |
|---|---|---|---|
| PINDSW-2154 | Sitara | HSR :Duplicate ARP seems to be forwarded to other port | This is an expected behaviour under high traffic scenario, which is allowed by the standard |
| PINDSW-4227 | Sitara | A few packets are truncated during forwarding if continuous burst of packets are send to DUT at line rate | None |
| PINDSW-4230 | AM571x, AM572x | DUT loses it’s IP address if rebooted | IP address needs to be configured every time after board reboot |
HSR/PRP PTP
| Record ID | Platform | Details | Workaround |
|---|---|---|---|
| PINDSW-913 | Sitara | Check for numStepsRemoved field in BMCA for redundant clock not implemented as BMCA not implemented. | None |
| PINDSW-1746 | Sitara | PTP driver is not multi-instance capable | None |
| PINDSW-1968 | Sitara | Sync0 output interval changes on resetting IEP counter and CMP1 register | None |
| PINDSW-8394 | Sitara | HSR-PRP: PTP: DUT goes out of sync in 24hr testing | None |
PRSDK
| Record ID | Platform | Details | Workaround |
|---|---|---|---|
| PRSDK-3086 | Sitara | Interrupt modification due change to host queue remapping scheme. | Patch and rebuild the ICSS EMAC LLD & NIMU ICSS LLD. Rebuild of driver libraries required. |
| PRSDK-8424 | Sitara | Storm prevention is not working for frames during P2 to P1 forwarding | Patch and rebuild the ICSS EMAC LLD & NIMU ICSS LLD. Rebuild of driver libraries required. |
Note
Refer to guide Patching and Rebuilding PDK for details on patching and rebuilding PDK. These patches are provided to resolve known issues.
