AM64x INDUSTRIAL COMMUNICATIONS SDK  2025.00.00
HSR-PRP FWHAL

Introduction

This software is designed for the TI SoCs with PRU-ICSSG IP to enable customers to add HSR-PRP (High-availability seamless Redundancy and Parallel Redundancy Protocol) Dual Attached Node support to their system. It implements HSR-PRP functionality and provides HSR-PRP FPGA like functionality integrated into TI SoCs.

HSR-PRP is an Ethernet based communication technology commonly deployed in smart grid substation for low cost, easy to maintain and interoperable common network infrastructure with built-in redundancy. They exist as an LRE (Link Redundancy Entity) between the MAC and Network layer above providing a transparent view of the MAC below to the application.

HSR Software Architecture

HSR-PRP firmware for PRU-ICSSG is a black box product maintained by TI. HSR-PRP FWHAL(Firmware and Hardware Abstraction Layer) enables initialization of an interface in HSR or PRP mode and acts as an interface with the enet driver and PRU-ICSSG. Firmware is based on 333 MHz clock frequency for PRU-ICSSG Core Clock and IEP Clock.

Data Sheet

Features Supported

Feature Description Implementation
High-Availability Seamless (HSR as per clause 5 of IEC 62439) Redundancy Operates as a DANH, Supports mode H as per standard, Two ports as per standard (Port A & Port B) Yes
Parallel Redundancy Protocol (PRP as per clause 4 of IEC 62439) Redundancy Operates as a DANP, Two ports as per standard (Port A & Port B) Yes
Quality of Service (QoS) 8 priority receive queues on host port, 4 priority transmit queues for each physical port. Yes
Node Table HSR-PRP LRE FWHAL based implementation configured with 256 entries by default. Yes
Multicast Filtering Support for Multicast Packet Filtering using FDB Yes
VLAN Filtering Support for VLAN Filtering for host port using FDB Yes
Duplex Full Yes
Half No
Speed Auto Yes
1000Mbps Yes
100Mbps Yes
10Mbps Yes
Statistics Supports MIB statistics Yes
PTP/1588 – Time Synchronization PTP, Supports P2P clock No
HSR-1G average cut-through latency 1.97 microseconds (RFC-2544 Latency test) Yes
HSR-1G forwarding throughput 2Gbps (bidirectional traffic of mixed sizes from 64B to 1518B) Yes

Important Files and Directory Structure

Folder/Files Description
${SDK_INSTALL_PATH}/examples/industrial_comms
hsr_1g_demo HSR Example Files
prp_1g_demo PRP Example Files
${SDK_INSTALL_PATH}/source/industrial_comms/hsr_prp_1g
icss_fwhal/firmware/hsr HSR Firmware for the PRU cores in PRU-ICSSG.
icss_fwhal/firmware/prp PRP Firmware for the PRU cores in PRU-ICSSG.
icss_fwhal/lib/ HSR-PRP LRE library files
icss_fwhal/src HSR-PRP LRE source files
icss_fwhal/*.h HSR-PRP LRE interface files

Terms and Abbreviations

Abbreviation Expansion
PRU-ICSSG Programmable Real-Time Unit Industrial Communication Subsystem - Gigabit
HSR High-availability seamless Redundancy Protocol (A redundancy protocol)
DANH Dual Attached Node (HSR)
PRP Parallel Redundancy Protocol (A redundancy protocol)
DANP Dual Attached Node (PRP)
LRE Link Redundancy Entity
MII Media Independent Interface
DL Datalink Layer
PTP-1588 Precision Time Protocol (IEEE time synchronization protocol)

API Documentation

Please see APIs for HSR-PRP LRE Driver for API documentation.

See also