25G Ethernet Stratix® 10 Intel® FPGA IP User Guide

ID 683154
Date 6/20/2024
Public
Document Table of Contents

6.7. 1588 PTP Interface Signals

Table 21.  Signals of the 1588 Precision Time Protocol InterfaceSignals are clocked by clk_rxmac or clk_txmac, as specified. All 64-bit output signals are in the Altera 64-bit TOD format, and you are expected to drive all 64-bit input signals in this format.

Signal Name

Direction

Description

latency_sclk Input Latency measurement input sampling clock.

For 25G Ethernet Intel FPGA IP with the IEEE 1588v2 feature, Altera recommends that the frequency of this clock is set to 156.25 MHz. Refer to 25G Ethernet Stratix® 10 FPGA IP Design Example User Guide and L- and H-Tile Transceiver PHY User Guide for more details.

PTP Interface to TOD module
tx_time_of_day_96b_data[95:0] Input Current V2-format (96-bit) TOD in clk_txmac clock domain. Connect this signal to the external TOD module.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

tx_time_of_day_64b_data[63:0] Input Current 64-bit TOD in clk_txmac clock domain. Connect this signal to the external TOD module.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

rx_time_of_day_96b_data[95:0] Input Current V2-format (96-bit) TOD in clk_rxmac clock domain. Connect this signal to the external TOD module.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

rx_time_of_day_64b_data[63:0] Input Current 64-bit TOD in clk_rxmac clock domain. Connect this signal to the external TOD module.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

PTP Interface to Client
TX Signals Related to One Step Processing
tx_etstamp_ins_ctrl_timestamp_insert Input Indicates the current packet on the TX client interface is a 1588 PTP packet, and directs the IP core to process the packet in one-step processing insertion mode. In this mode, the IP core overwrites the timestamp of the packet with the timestamp field when the packet appears on the TX Ethernet link.

The TX client must assert and deassert this signal synchronously with the TX SOP signal for the 1588 PTP packet.

If the TX client asserts this signal simultaneously with tx_etstamp_ins_ctrl_residence_time_update , the results are undefined.

tx_etstamp_ins_ctrl_residence_time_update Input Indicates the current packet on the TX client interface is a 1588 PTP packet, and directs the IP core to process the packet in one-step processing correction mode. In this mode, the IP core adds the latency through the IP core (residence time) to the current contents of the timestamp field.

The TX client must assert and deassert this signal synchronously with the TX SOP signal for the 1588 PTP packet.

If the TX client asserts this signal simultaneously with either of tx_etstamp_ins_ctrl_timestamp_insert or tx_egress_timestamp_request_valid, the results are undefined.

tx_etstamp_ins_ctrl_ingress_timestamp_96b[95:0] Input

Indicates the V2-format TOD when the packet entered the system.

The TX client must ensure this signal is valid in each TX SOP cycle when it asserts tx_etstamp_ins_ctrl_residence_time_update. The TX client must maintain the desired value on this signal while the TX SOP signal is asserted. This signal is useful only in transparent clock mode when the TX client asserts tx_etstamp_ins_ctrl_residence_time_update.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

tx_etstamp_ins_ctrl_ingress_timestamp_64b[63:0] Input

Indicates the TOD (in Altera 64-bit format) when the packet entered the system.

The TX client must ensure this signal is valid in each TX SOP cycle when it asserts tx_etstamp_ins_ctrl_residence_time_update. The TX client must maintain the desired value on this signal while the TX SOP signal is asserted. This signal is useful only in transparent clock mode when the TX client asserts tx_etstamp_ins_ctrl_residence_time_update.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

tx_etstamp_ins_ctrl_timestamp_format Input Specifies the timestamp format (V1 or V2 format) for the current packet if the TX client simultaneously asserts tx_etstamp_ins_ctrl_timestamp_insert. Values are:
  • 1'b0: 96-bit timestamp format (V2)
  • 1'b1: 64-bit timestamp format (V1)

The TX client must maintain the desired value on this signal while the TX SOP signal is asserted.

If the client specifies the V1 format, you read and write the V1 format TOD (32 bits of seconds and 32 bits of nanoseconds) in bits [79:16] of the 96-bit timestamp and TOD signals.

Note: If you set the Time of day format parameter to the value of Enable 64-bit timestamp format, the results of asserting tx_etstamp_ins_ctrl_timestamp_insert are undefined. Therefore, the timestamp in any case maps to the 96-bit signals.
tx_etstamp_ins_ctrl_residence_time_calc_format Input Specifies the TOD format (64-bit TOD format or the V2 96-bit TOD format) for the current packet if the TX client simultaneously asserts tx_etstamp_ins_ctrl_residence_time_update. Values are:
  • 1'b0: 96-bit TOD format (V2)
  • 1'b1: 64-bit TOD format (48-bit ns and 16-bit fns)

The TX client must maintain the desired value on this signal while the TX SOP signal is asserted.

If you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats, and the client specifies the 64-bit TOD format, the IP core uses the 64-bit TOD format for residence time calculation.

If you set the Time of day format parameter to the value of Enable 64-bit timestamp format and the client specifies the 96-bit format (V2), the results are undefined.

tx_etstamp_ins_ctrl_offset_timestamp[15:0]

Input

Specifies the byte offset of the timestamp information in the current packet if the TX client simultaneously asserts tx_etstamp_ins_ctrl_timestamp_insert. The IP core overwrites the value at this offset. The TX client must maintain the desired value on this signal while the TX SOP signal is asserted.

If the packet supports V2 format, the timestamp has 96 bits. In this case, the IP core inserts ten bytes (bits [95:16]) of the timestamp at this offset and the remaining two bytes (bits [15:0]) of the timestamp at the offset specified in tx_etstamp_ins_ctrl_offset_correction_field.

The TX client must ensure that:

  • The offset includes the entire timestamp in a single packet.
  • If the packet is more than 256 bytes, the offset supports inclusion of the entire timestamp in the first 256 bytes of the packet.
  • The timestamp bytes do not overlap with the bytes in any other field, including the UDP checksum field. (If these particular two fields overlap, the result is undefined).
tx_etstamp_ins_ctrl_offset_correction_field[15:0] Input If the TX client simultaneously asserts tx_etstamp_ins_ctrl_residence_time_update, this signal specifies the byte offset of the correction field in the current packet.

If the TX client simultaneously asserts tx_etstamp_ins_ctrl_timestamp_insert and deasserts (sets to the value of 0) the tx_etstamp_ins_ctrl_timestamp_format signal, this signal specifies the byte offset of bits [15:0]] of the timestamp.

The TX client must maintain the desired value on this signal while the TX SOP signal is asserted.

In addition, the TX client must ensure that:

  • The offset includes the entire correction field or timestamp in a single packet.
  • If the packet is more than 256 bytes, the offset supports inclusion of the entire timestamp or correction field in the first 256 bytes of the packet.
  • The correction field or timestamp bytes do not overlap with the bytes in any other field, including the UDP checksum field. (If these particular two fields overlap, the result is undefined).
tx_etstamp_ins_ctrl_checksum_zero Input The TX client asserts this signal during a TX SOP cycle to tell the IP core to zero the UDP checksum in the current packet.

If the TX client asserts the tx_etstamp_ins_ctrl_checksum_correct signal, it cannot assert this signal. This signal is meaningful only in one-step clock mode.

A zeroed UDP checksum indicates the checksum value is not necessarily correct. This information is useful to tell the application to skip checksum checking of UDP IPv4 packets. This function is illegal for UDP IPv6 packets.

tx_etstamp_ins_ctrl_offset_checksum_field[15:0] Input Indicates the byte offset of the UDP checksum in the current packet. The TX client must ensure this signal has a valid value during each TX SOP cycle when it also asserts the tx_etstamp_ins_ctrl_checksum_zero signal. Holds the byte offset of the two bytes in the packet that the IP core should reset. This signal is meaningful only in one-step clock mode.

The TX client must ensure that:

  • The offset includes the entire checksum in a single packet.
  • The checksum bytes do not overlap with the bytes in any other field, including the timestamp bytes. (If these particular two fields overlap, the result is undefined).
tx_etstamp_ins_ctrl_checksum_correct Input The TX client asserts this signal during a TX SOP cycle to tell the IP core to update (correct) the UDP checksum in the current packet.

If the TX client asserts the tx_etstamp_ins_ctrl_checksum_zero signal, it cannot assert this signal. This signal is meaningful only in one-step clock mode.

The application must assert this signal for correct processing of UDP IPv6 packets.

tx_etstamp_ins_ctrl_offset_checksum_correction[15:0] Input Indicates the byte offset of the UDP checksum correction field in the current packet represented by the extended bytes before CRC. The TX client must ensure this signal has a valid value during each TX SOP cycle when it also asserts the tx_etstamp_ins_ctrl_checksum_correct signal. Holds the byte offset of the two bytes in the packet that the IP core should correct. This signal is meaningful only in one-step clock mode.

The TX client must ensure that:

  • The offset and length of the checksum correction field includes the entire two bytes of the checksum correction field in a single packet.
  • The checksum bytes do not overlap with the bytes in any other field, including the timestamp bytes. (If these particular two fields overlap, the result is undefined).
  • The end of the UDP payload of the PTP packet is extended by 2 bytes. The MAC function modifies the extended bytes to ensure that the UDP checksum remains uncompromised.
tx_egress_asymmetry_update Input Indicates the IP core should include the value in the TX_PTP_ASYM_DELAY register in its correction calculations. The TX client must maintain the desired value on this signal while the TX SOP signal is asserted.

This option is useful in one-step correction mode.

TX Signals Related to Two Step Processing
tx_egress_timestamp_request_valid Input Indicates the current packet on the TX client interface is a 1588 PTP packet, and directs the IP core to process the packet in two-step processing mode. In this mode, the IP core outputs the timestamp of the packet when it exits the IP core, and does not modify the packet timestamp information.

The TX client must assert and deassert this signal synchronously with the TX SOP signal for the 1588 PTP packet.

If the TX client asserts this signal simultaneously with tx_etstamp_ins_ctrl_residence_time_update, the results are undefined.

tx_egress_timestamp_96b_data[95:0]

Output

Provides the V2-format timestamp when a 1588 PTP frame begins transmission on the Ethernet link. Value is valid when the tx_egress_timestamp_96b_valid signal is asserted. This signal is meaningful only in two-step clock mode.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

tx_egress_timestamp_96b_valid Output Indicates that the tx_egress_timestamp_96b_data and tx_egress_timestamp_96b_fingerprint signals are valid in the current clk_txmac clock cycle. This signal is meaningful only in two-step clock mode.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

tx_egress_timestamp_64b_data[63:0]

Output

Provides the timestamp when a 1588 PTP frame begins transmission on the Ethernet link. Value is valid when the tx_egress_timestamp_64b_valid signal is asserted. This signal is meaningful only in two-step clock mode.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

tx_egress_timestamp_64b_valid Output Indicates that the tx_egress_timestamp_64b_data and tx_egress_timestamp_64b_fingerprint signals are valid in the current clk_txmac clock cycle. This signal is meaningful only in two-step clock mode.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

tx_egress_timestamp_request_fingerprint[(W–1):0]

where W is the value between 1 and 32, inclusive, that you specify for the Fingerprint width parameter

Input Fingerprint of the current packet.

The TX client must assert and deassert this signal synchronously with the TX SOP signal for the 1588 PTP packet.

tx_egress_timestamp_96b_fingerprint[(W–1):0]

where W is the value between 1 and 32, inclusive, that you specify for the Fingerprint width parameter

Output Provides the fingerprint of the 1588 PTP frame currently beginning transmission on the Ethernet link. Value is valid when the tx_egress_timestamp_96b_valid signal is asserted.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

tx_egress_timestamp_64b_fingerprint[(W–1):0]

where W is the value between 1 and 32, inclusive, that you specify for the Fingerprint width parameter

Output Provides the fingerprint of the 1588 PTP frame currently beginning transmission on the Ethernet link. Value is valid when the tx_egress_timestamp_64b_valid signal is asserted.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

RX Signals
rx_ingress_timestamp_96b_data[95:0]

Output

Whether or not the current packet on the RX client interface is a 1588 PTP packet, indicates the V2-format timestamp when the IP core received the packet on the Ethernet link. The IP core provides a valid value on this signal in the same cycle it asserts the RX SOP signal for 1588 PTP packets.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

rx_ingress_timestamp_96b_valid

Output

Indicates that the rx_ingress_timestamp_96b_data signal is valid in the current cycle. This signal is redundant with the RX SOP signal for 1588 PTP packets.

This signal is available only if you set the Time of day format parameter to the value of Enable 96-bit timestamp format or Enable both formats.

rx_ingress_timestamp_64b_data[63:0]

Output

Whether or not the current packet on the RX client interface is a 1588 PTP packet, indicates the 64-bit TOD (in Altera 64-bit format) when the IP core received the packet on the Ethernet link. The IP core provides a valid value on this signal in the same cycle it asserts the RX SOP signal for 1588 PTP packets.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.

rx_ingress_timestamp_64b_valid

Output

Indicates that the rx_ingress_timestamp_64b_data signal is valid in the current cycle. This signal is redundant with the RX SOP signal for 1588 PTP packets.

This signal is available only if you set the Time of day format parameter to the value of Enable 64-bit timestamp format or Enable both formats.