A Linux-native gPTP / IEEE 802.1AS debugging workstation for Automotive Ethernet.
English · 中文
gPTP Studio is deliberately focused on Linux because professional gPTP work depends on Linux capabilities that matter in the measurement path: PHC, hardware timestamping, SO_TIMESTAMPING, linuxptp, sysfs NIC introspection and explicit privilege control. The product does not maintain reduced-function desktop ports that cannot provide the same timing path.
For AUTOSAR EthTSyn / IEEE 802.1AS debugging, one Linux workstation can act as GrandMaster, Slave or passive Listener, show sync convergence live, decode every gPTP frame and correlate timing jumps with the packets and engine state that caused them.
Built with Racket + Glaze, using WebKitGTK for the desktop UI and Linux-native timing/network facilities for the real engine path.
- Four roles, one workstation — GrandMaster, Slave, two-port Boundary Clock (multi-interface
ptp4l+phc2sys -a -r) and passive Listener with generatedptp4l.conf - linuxptp lifecycle management — supervised
ptp4l,phc2sysandpmc - Hardware timing qualification — detects NIC HW timestamp support, mapped PHC and privilege path before starting a real engine
- Real-time sync curves —
offsetFromMaster/meanPathDelay, alarms and engine state - gPTP packet capture & decode — libpcap capture of EtherType
0x88f7, full Sync / Follow_Up / Announce / PDelay_* / Signalling decode, exact sec+nsec timestamp metadata, hex view and pcap/pcapng workflows - Timing-path transparency — NIC capability and actual capture timestamp source are shown separately; timestamp resolution is never presented as calibrated accuracy
- Headless support Doctor —
--doctor/--doctor-jsonreport NIC, PHC, linuxptp and privilege readiness without opening the GUI; MAC/IP are omitted by default - Built-in simulator with fault injection — synthetic 802.1AS sessions flow through the same encode/decode/store pipeline as real traffic; inject Sync/Announce drops, Follow_Up delay, sequence gaps and offset spikes to negative-test your alerts, BMCA reading and reports
- GM runtime tuning — change clockClass, clockAccuracy, timeSource and BMCA priorities on a running engine via
pmc GRANDMASTER_SETTINGS_NP, no restart (Pro) - Wireshark one-click — live capture with a gPTP filter, or replay retained packets; engineering reports export to JSON/Markdown
- Aggregated logs and presets — engine, capture and application events in one place
- Offline licensing — signed offline license files; no cloud dependency required for protected environments
The product contract is Linux only.
| Area | Support |
|---|---|
| Primary validated distributions | Ubuntu 22.04 LTS, Ubuntu 24.04 LTS |
| Desktop UI | GTK 3 + WebKitGTK 4.1 |
| Real GM / Slave engine | linuxptp (ptp4l, phc2sys, pmc) |
| Timing hardware | NIC hardware timestamping + PHC (/dev/ptpN) |
| Capture | libpcap, with runtime timestamp-source reporting |
| Packages | .deb and relocatable .tar.gz |
| Other operating systems | Unsupported by product design |
A NIC reporting hardware timestamping and /dev/ptpN means the host has the required capability for the linuxptp path. It does not by itself prove calibrated end-to-end timing accuracy. Studio keeps capability, runtime timestamp source and any future characterization results separate.
sudo apt install ./gPTP-Studio-linux-x64.deb
gptp-studio --doctor
gptp-studioThe Debian package declares the Linux runtime dependencies and installs the desktop entry, icon and license notices. It intentionally does not grant CAP_NET_ADMIN, CAP_NET_RAW or CAP_SYS_TIME during installation. Doctor / Preflight show the privilege path explicitly so an operator controls security changes.
tar -xzf gPTP-Studio-linux-x64.tar.gz
cd gptp-studio-distributed
./bin/gptp-studio --doctor
./bin/gptp-studiosudo apt install linuxptp libpcap-dev ethtool iproute2 libcap2-bin \
libgtk-3-dev libwebkit2gtk-4.1-dev
raco pkg install --auto --no-docs --link /path/to/glaze
raco make main.rkt
racket main.rkt --doctor
racket main.rkt --simulator
racket main.rktFor real hardware work, start with gptp-studio --doctor, fix structural FAIL items, then use GUI Preflight on the exact interface before starting GM/Slave. See docs/support-doctor.md and docs/hardware-qualification.md.
About 2.5s after startup the app fetches a version manifest once in the background (latest.json, hosted on this repository's main branch). On a newer release an ⬇ version pill appears in the header and links to the releases page. Nothing is installed automatically — what gets installed stays with the operator. Air-gapped hosts can disable the network contact entirely with --no-update-check, or point GPTP_UPDATE_MANIFEST_URL at their own manifest.
| Page | What it does |
|---|---|
| Overview | Live offset/delay curves, port state, current GM, alarm threshold |
| Links & NICs | NIC HW timestamp / PHC capability and actual capture timestamp path |
| Role & Config | Role switch (incl. Boundary Clock port set), gPTP parameters, generated ptp4l.conf, start/stop |
| Reference | Managed phc2sys reference-source lifecycle |
| Packets | Capture, packet table, decoded tree, exact timestamp metadata, hex, import/export |
| Runtime & Logs | Process state, logs, presets and license |
| Official Free | Official Pro | |
|---|---|---|
| Listener capture + packet decode | ✅ | ✅ |
| Offline pcap import | ✅ | ✅ |
| Simulator | ✅ | ✅ |
Config editor + ptp4l.conf preview |
✅ | ✅ |
| GM / Slave / Boundary Clock engine control | — | ✅ |
Reference source (phc2sys) |
— | ✅ |
| pcap export | — | ✅ |
| Packet store | 2,000 frames | 50,000 frames |
The source code is Apache-2.0. Free/Pro describe the product experience, update entitlement and support attached to official distributions; they do not revoke rights already granted by Apache-2.0. Self-built or modified Apache-2.0 versions are not automatically official Pro builds and do not carry official update/support/validation commitments.
Every official install starts with a 14-day Pro trial. See PRICING.md and docs/licensing-model.md.
One Racket process hosts the Glaze/WebKitGTK UI and application services. Real timing is delegated to Linux-native facilities: linuxptp child processes, PHC/hardware timestamps and libpcap. Timing-critical timestamps are produced below the Racket GUI/control layer; Studio focuses on orchestration, observability, analysis and safe qualification. Details: docs/architecture.md.
gPTP Studio source and Apache-covered portions of official distributions remain licensed under Apache-2.0. EULA.md governs official Pro entitlements, license credentials, updates/support and official-brand terms without overriding applicable open-source rights. Third-party attribution is in THIRD_PARTY_NOTICES.md.