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_menuconfigPlease 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 eraseThen 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