Low Latency 40- and 100-Gbps Ethernet MAC and PHY MegaCore Function User Guide

ID 683628
Date 12/28/2017
Public
Document Table of Contents

3.2.14.6. 1588 PTP Interface Signals

Table 26.  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

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 turn on the Enable 96b Time of Day Format parameter.

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 turn on the Enable 64b Time of Day Format parameter.

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 turn on the Enable 96b Time of Day Format parameter.

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 turn on the Enable 64b Time of Day Format parameter.

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 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 either of tx_etstamp_ins_ctrl_residence_time_update or tx_egress_timestamp_request_valid, 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

Iindicates 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 turn on the Enable 96b Time of Day Format parameter.

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 turn on the Enable 64b Time of Day Format parameter.

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 do not turn on the Enable 96b Time of Day Format parameter, the results of asserting tx_etstamp_ins_ctrl_timestamp_insert are undefined. Therefore, the timestamp in either case maps to the 96-bit signals.
tx_etstamp_ins_ctrl_residence_time_calc_format Input Specifies the TOD format (Altera 64-bit TOD format or the V2 96-bit 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

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

If you turned on Enable 96b Time of Day Format and the client specifies the 64-bit format, the IP core maps the 64-bit TOD format time-of-day (32 bits of seconds and 32 bits of nanoseconds) as is in bits [79:16] of the 96-bit timestamp and TOD signals.

If you turned off Enable 96b Time of Day 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 offset must support inclusion of the entire timestamp in the first 256 bytes of the packet.

The TX client must ensure that the timestamp bytes and the UDP checksum bytes in the packet do not overlap. The IP core does not check for overlap. If these two fields overlap, the results are 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 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. The offset must support inclusion of the entire timestamp in the first 256 bytes of the packet.

The TX client must ensure that the correction field bytes and the UDP checksum bytes in the packet do not overlap. The IP core does not check for overlap. If these two fields overlap, the results are 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 two-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 two-step clock mode.

The TX client must ensure that the UDP checksum bytes and the timestamp bytes in the packet do not overlap. The IP core does not check for overlap. If these two fields overlap, the results are 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 two-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 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_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 two-step clock mode.

The TX client must ensure that the UDP checksum bytes and the timestamp bytes in the packet do not overlap. The IP core does not check for overlap. If these two fields overlap, the results are undefined.

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 two-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 either of tx_etstamp_ins_ctrl_timestamp_insert or 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 turn on the Enable 96b Time of Day Format parameter.

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 turn on the Enable 96b Time of Day Format parameter.

tx_egress_timestamp_64b_data[63:0]

Output

Provides the timestamp when a V1-format 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 turn on the Enable 64b Time of Day Format parameter.

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 turn on the Enable 64b Time of Day Format parameter.

tx_egress_timestamp_request_fingerprint[(W–1):0]

where W is the value between 1 and 16, inclusive, that you specify for the Timestamp 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 16, inclusive, that you specify for the Timestamp fingerprint width parameter

Output Provides the fingerprint of the V2-format 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 turn on the Enable 96b Time of Day Format parameter.

tx_egress_timestamp_64b_fingerprint[(W–1):0]

where W is the value between 1 and 16, inclusive, that you specify for the Timestamp fingerprint width parameter

Output Provides the fingerprint of the V1-format 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 turn on the Enable 64b Time of Day Format parameter.

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 turn on the Enable 96b Time of Day Format parameter.

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 turn on the Enable 96b Time of Day Format parameter.

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 turn on the Enable 64b Time of Day Format parameter.

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 turn on the Enable 64b Time of Day Format parameter.