Skip to content

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Sign in
W
White Rabbit
  • Project
    • Project
    • Details
    • Activity
    • Cycle Analytics
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Charts
  • Issues 5
    • Issues 5
    • List
    • Board
    • Labels
    • Milestones
  • Merge Requests 0
    • Merge Requests 0
  • Wiki
    • Wiki
  • image/svg+xml
    Discourse
    • Discourse
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Charts
  • Create a new issue
  • Commits
  • Issue Boards
  • Projects
  • White Rabbit
  • Wiki
  • Calibration

Calibration

Last edited by Maciej Lipinski Jan 18, 2021
Page history

White Rabbit devices calibration

This page is meant to provide coarse calibration values for the official releases of
WR Switch and WR PTP Core firmware. You can use them as defaults for matching
hardware and gateware version. However, to achieve the best possible synchronization
results you should perform the full calibration procedure for your
WR hardware.

Short introduction about the calibration problem

White Rabbit link established between two devices is characterized with hardware delays
and fiber propagation latencies presented in figure 1.


Figure1: White Rabbit link delay model*

Each WR Master and WR Slave has some constant transmission and reception delays:

  • Δ TXM - transmission delay of WR Master
  • Δ RXM - reception delay of WR Master
  • Δ TXS - transmission delay of WR Slave
  • Δ RXS - reception delay of WR Slave

They are the summed result of SFP transceiver’s, PCB traces’ and electronic components’
delays as well as the delays inside FPGA chip. Additional reception delay is also caused
on both sides by aligning recovered clock signal to the inter-symbol boundaries of data
stream. It is called bitslide value and is marked in figure 1 as:

  • ε M - bitslide of Master's RX path
  • ε S - bitslide of Slave's RX path

Except from hardware delays, packets transmitted in fiber are affected with propagation
latencies in both directions:

  • δ MS - Master-to-Slave fiber latency
  • δ SM - Slave-to-Master fiber latency

Those fiber propagation latencies are not equal since different light wavelengths are used
to communicate simultaneously in both directions using single fiber (Wavelength Division
Multiplexing). For estimating fiber asymmetry White Rabbit uses α parameter, which
is constant for given wavelengths and type of fiber.

WR users should perform the WR Calibration Procedure before deploying WR
hardware to determine correct values of delays and fiber asymmetry factor.

Default calibration values for WR Switch

Below you can find the default calibration values for latest stable releases of the WR Switch.
You should put these values in the dot-config file. Depending on your configuration, you
should either edit the /wr/etc/dot-config file on your switch, or modify it on the central
server, from which the WRS fetches dot-config on boot time. The former requires accessing
the WRS shell either by using the USB-UART management port in the front panel or SSH-ing
through the management Ethernet port. You can edit the configuration by executing the script:

$ wrs_menuconfig

Please use appropriate values depending on your hardware and firmware version. However, bear
in mind that these numbers are valid only for release binaries you can download from the
ohwr.org. If you re-synthesize the gateware, you have to perform the calibration procedure
to find the new values.

WR Switch firmware v6.0

Hardware version: V3.4 V3.4 V3.3 V3.3
Port number Egress Ingress Egress Ingress
1 238903 275901 239490 275282
2 239923 278835 240419 278221
3 238566 277396 239059 276789
4 239491 277469 240035 276869
5 238040 277694 238616 277018
6 237334 277146 237881 276535
7 237543 278371 238119 277673
8 237687 278687 238202 277938
9 238676 278256 239232 277458
10 238848 278678 239326 277940
11 238294 279326 238757 278543
12 239243 278867 239769 278281
13 225920 231130 226279 230371
14 226071 233579 226469 232833
15 226329 233041 226696 232362
16 226467 232311 226868 231578
17 226596 230376 227011 229739
18 226835 230323 227258 229666

Previous WRS releases

If the version you are looking for is not on the least above, please check the default calibration values for old firmware releases.

Default calibration values for White Rabbit PTP Core running on SPEC board

WR PTP Core stores Δ TX, Δ RX and α values in SFP database stored in EEPROM.
To deploy calibration values from table below you have to access WRPC Shell through USB-UART or
VUART (please check the latest WRPC release manual for more information).
First thing to do is clearing existing SFP database:

wrc# sfp erase

Then you can add each SFP with its parameters using sfp add shell command:

wrc# sfp add <SFP part number> <deltaTx> <deltaRx> <alpha>

SFP database for SPEC reference design

The values from the table below can be used with official release binary of WRPC reference design.

WRPC version HW board SFP ** Δ TX ** ** Δ RX ** α wrc# cmd;
v4.2 SPEC AXGE-1254-0531 180750 148326 72169888 sfp add AXGE-1254-0531 180750 148326 72169888
v4.2 SPEC AXGE-3454-0531 180750 148326 -73685416 sfp add AXGE-3454-0531 180750 148326 -73685416
v4.2 SVEC AXGE-1254-0531 178377 152463 72169888 sfp add AXGE-1254-0531 178377 152463 72169888
v4.2 SVEC AXGE-3454-0531 178377 152463 -73685416 sfp add AXGE-3454-0531 178377 152463 -73685416
v4.2 VFC-HD AXGE-1254-0531 188147 -8681 72169888 sfp add AXGE-1254-0531 188147 -8681 72169888
v4.2 VFC-HD AXGE-3454-0531 188147 -8681 -73685416 sfp add AXGE-3454-0531 188147 -8681 -73685416
v4.1 SPEC v4 AXGE-1254-0531 180774 148774 72169888 sfp add AXGE-1254-0531 180774 148774 72169888
v4.1 SPEC v4 AXGE-3454-0531 180774 148774 -73685416 sfp add AXGE-3454-0531 180774 148774 -73685416
v4.1 SVEC AXGE-1254-0531 176073 149565 72169888 sfp add AXGE-1254-0531 176073 149565 72169888
v4.1 SVEC AXGE-3454-0531 176073 149565 -73685416 sfp add AXGE-3454-0531 176073 149565 -73685416
v4.1 VFC-HD AXGE-1254-0531 189555 -7407 72169888 sfp add AXGE-1254-0531 189555 -7407 72169888
v4.1 VFC-HD AXGE-3454-0531 189555 -7407 -73685416 sfp add AXGE-3454-0531 189555 -7407 -73685416
v4.0 SPEC v4 AXGE-1254-0531 180667 148735 72169888 sfp add AXGE-1254-0531 180667 148735 72169888
v4.0 SPEC v4 AXGE-3454-0531 180667 148735 -73685416 sfp add AXGE-3454-0531 180667 148735 -73685416
v4.0 SVEC AXGE-1254-0531 178446 152666 72169888 sfp add AXGE-1254-0531 178446 152666 72169888
v4.0 SVEC AXGE-3454-0531 178446 152666 -73685416 sfp add AXGE-3454-0531 178446 152666 -73685416
v4.0 VFC-HD AXGE-1254-0531 187792 -8140 72169888 sfp add AXGE-1254-0531 187792 -8140 72169888
v4.0 VFC-HD AXGE-3454-0531 187792 -8140 -73685416 sfp add AXGE-3454-0531 187792 -8140 -73685416
v3.0 SPEC v4 AXGE-1254-0531 180625 148451 72169888 sfp add AXGE-1254-0531 180625 148451 72169888
v3.0 SPEC v4 AXGE-3454-0531 180625 148451 -73685416 sfp add AXGE-3454-0531 180625 148451 -73685416
v2.1 SPEC v4 AXGE-1254-0531 180707 148323 72169888 sfp add AXGE-1254-0531 180707 148323 72169888
v2.1 SPEC v4 AXGE-3454-0531 180707 148323 -73685416 sfp add AXGE-3454-0531 180707 148323 -73685416

SFP database for WR Starting Kit

Since v3.0 of the WR Starting Kit, the HDL components/repositories have been restructured and the firmware tagged wr-starting-kit-v3.0 refers to the spec-nic-dio gateware (FPGA bitstream). If you are using older version of starting-kit (<= v2.x) please use the calibration from wr-nic-v2.0 design.

the value in the table below:

FW version HW board SFP Δ TX Δ RX α wrc# cmd;
wr-starting-kit-v3.1 SPECv4+FMC-DIO AXGE-1254-0531 180725 151965 67216940 sfp add AXGE-1254-0531 180725 151965 67216940
wr-starting-kit-v3.1 SPECv4+FMC-DIO AXGE-3454-0531 180795 151861 -68210600 sfp add AXGE-3454-0531 180795 151861 -68210600
wr-starting-kit-v3.0 SPECv4+FMC-DIO AXGE-1254-0531 179410 153544 67216940 sfp add AXGE-1254-0531 179410 153544 67216940
wr-starting-kit-v3.0 SPECv4+FMC-DIO AXGE-3454-0531 179480 153494 -68210600 sfp add AXGE-3454-0531 179480 153494 -68210600

SFP database for SPEC with NIC design

If you are using the wr-nic release (included in the old version of WR Starting Kit) please use the value in the table below:

FW version HW board SFP Δ TX Δ RX α wrc# cmd;
wr-nic-v2.0 SPEC v4 AXGE-1254-0531 177648 150988 68930293 sfp add AXGE-1254-0531 177648 150988 68930293
wr-nic-v2.0 SPEC v4 AXGE-3454-0531 181210 154818 -66901714 sfp add AXGE-3454-0531 181210 154818 -66901714

10 December 2019, Grzegorz Daniluk, Benoit Rat

Files

  • link-model.png
Clone repository
  • Data delivery
  • Documents
  • Documents
    • Articles
    • Faq documents
    • Fpga transceivers propagation delay study
    • Figures
    • Greg's master thesis
    • Posters
    • Presentations
    • Sfp data
    • Temperature tests (aka torture report)
    • Tom's master thesis
    • Wr jobs
    • Wr switch debugging
  • Documents/WR-contribution-for-ITU-T-Q13
    • 15 meeting
More Pages

New Wiki Page

Tip: You can specify the full path for the new file. We will automatically create any missing directories.