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.3. Standard Compliance

Compliant to IEC 62439-3 spec Ed 2.0


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.
  • Getting Started Guide: provides information on getting the software and running basic examples/demonstrations bundled in the package.
  • 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 Processor SDK RTOS 06_03_00, see Processor SDK Getting Started Guide


Component Version
Processor SDK RTOS for AM57xx 6.3.0
Processor SDK RTOS for AM437x 6.3.0
Processor SDK RTOS for AM335x 6.3.0
Processor SDK RTOS for AM65X 6.3.0

Details on Processor SDK RTOS component versions can be found here |

5.2.5.1. Release 01.00.05

Released April 2020

PRU-ICSS HSR/PRP package download link : https://www.ti.com/tool/PRU-ICSS-INDUSTRIAL-SW

5.2.5.1.1. What’s New

  • AM65xx support in MII and RGMII mode
  • Improved Storm Prevention support with individual control for UC/MC/BC
  • Bug Fixes

5.2.5.1.2. Platforms supported

  • AM335x
  • AM437x
  • AM57x
  • AM65xx
  • AMIC1x

5.2.5.1.3. Features supported

  • RTOS support for AMIC1x, AM3x, AM4x, AM5x & AM65xx 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)
  • 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.16.17] protocols\hsr_prp\firmware\v1.0
AM571x, AM572x [2.16.17] protocols\hsr_prp\firmware\v2.1
AM65xx [2.16.17] protocols\hsr_prp\firmware\g_v1.0

5.2.5.1.6. Fixed Issues

Record ID Platform Details
PINDSW-2718 AM335x, AM437x, AMIC11x, AM571x, AM572x PRU HSR firmware: small degradation in performance seen for MTU sized frames
PINDSW-3426 AM335x, AM437x, AMIC11x, AM571x, AM572x HSR-PRP VLAN tag issue - Goose pkt
PINDSW-3934 AM335x, AM437x, AMIC11x, AM571x, AM572x HSR: forwarding of untagged frames in default mode H not according to IEC 62439-3:2016, “5.3.3 DANH receiving from an HSR port”.

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

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

The common patch for the above mentioned PRSDK-3086 and PRSDK-8424, known issues is present in <INSTALLER_PATH>/protocols/pdk_patches/06.03.00/PRSDK-3086-HSRPRP_2_interrupts_PDK.patch

Note

For AM65xx RGMII application icss-emac should be patched with an additional patch present in <INSTALLER_PATH>/protocols/pdk_patches/06.03.00/rgmii_icss_emac.patch, amd should be rebuilt after patching.