HSR-PRP (High-availability seamless Redundancy/Parallel Redundancy Protocol) 1G Driver

Table of Contents

• Introduction
• Data Sheet
  • Features Supported
• Important Files and Directory Structure
• Terms and Abbreviations
• API Documentation
• See also

Note

This page explains the driver used by 1G capable HSR implementation. There is also an existing/older 100M capable HSR-PRP example which is explained here: HSR_PRP(High-availability seamless Redundancy/Parallel Redundancy Protocol) FWHAL

Introduction

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

HSR 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 firmware for PRU-ICSSG is a black box product maintained by TI. HSR-PRP LRE Driver enables initialization of an interface in HSR mode (PRP mode is not currently supported) 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.

Note

PRP mode is not supported!

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
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 driver 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

Important Files and Directory Structure

Folder/Files	Description
${SDK_INSTALL_PATH}/examples/industrial_comms
hsr_1g_demo	HSR Example Files
${SDK_INSTALL_PATH}/source/industrial_comms/hsr_prp_1g
icss_fwhal/firmware	Firmware for the PRU cores in PRU-ICSSG. Firmware Tag: REL.HSR_1G_01.02.03.04
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

• HSR 1G Demo