fabric-precision-timing

Instructions

When invoked, generate code for precision timing experiments on FABRIC. Two main capabilities:

1. PTP (Precision Time Protocol) — IEEE 1588 sub-microsecond time synchronization via Ansible playbooks
2. OWL (One-Way Latency) — Docker-based latency measurement using hardware timestamps

Help the user set up PTP-enabled slices and run OWL measurements between nodes.

API Reference

Finding PTP-Capable Sites

ptp_sites = fablib.get_random_sites(
    count=2,
    filter_function=lambda x: x['ptp_capable'] is True and x['state'] == 'Active'
)

OWL Library

from mflib import owl

# Get node IPs (filters out management network)
owl.nodes_ip_addrs(slice) -> dict

# Check prerequisites (git, phc2sys, docker)
owl.check_owl_prerequisites(slice)

# Start measurement on specific link
owl.start_owl(slice, src_node, dst_node, img_name, probe_freq=1,
              no_ptp=False, duration=120, delete_previous_output=True)

# Start on all links
owl.start_owl_all(slice, img_name, probe_freq=1, duration=600, delete_previous=True)

# Manual sender/capturer control
owl.start_owl_sender(slice, src_node, dst_node, img_name, duration=120)
owl.start_owl_capturer(slice, dst_node, img_name, duration=120)

# Check status
owl.check_owl_all(slice)

# Stop measurements
owl.stop_owl_all(slice)
owl.stop_owl_sender(slice, src_node, dst_node)
owl.stop_owl_capturer(slice, dst_node)

# Download results
owl.download_output(node, local_output_dir)

Patterns

PTP-Enabled Slice Creation

from fabrictestbed_extensions.fablib.fablib import FablibManager

fablib = FablibManager()

# Must use PTP-capable sites
[site1, site2] = fablib.get_random_sites(
    count=2,
    filter_function=lambda x: x['ptp_capable'] is True and x['state'] == 'Active',
)

slice = fablib.new_slice(name="ptp-experiment")

node1 = slice.add_node(name="Node1", site=site1, image="docker_rocky_8")
node1.add_fabnet()

node2 = slice.add_node(name="Node2", site=site2, image="docker_rocky_8")
node2.add_fabnet()

slice.submit()