docs: Update README and setup.sh for PTP integration and configuration

Co-authored-by: aider (openrouter/anthropic/claude-sonnet-4) <aider@aider.chat>
This commit is contained in:
Chaos Rogers 2025-07-10 19:03:45 +01:00
parent b673b0f507
commit 3e94625a9d
2 changed files with 19 additions and 6 deletions

View file

@ -1,5 +1,5 @@
{
"hardware_offset_ms": 20,
"hardware_offset_ms": 0,
"ptp_enabled": true,
"ptp_interface": "eth0"
}

View file

@ -7,7 +7,7 @@ echo " Welcome to the NTP TimeTurner Installer"
echo "─────────────────────────────────────────────"
echo ""
echo "\"It's a very complicated piece of magic...\" Hermione Granger"
echo "Preparing the Ministry-grade temporal interface..."
echo "Preparing the Ministry-grade temporal interface with PTP precision..."
echo ""
# ---------------------------------------------------------
@ -17,11 +17,11 @@ echo "Step 1: Updating package lists and upgrading..."
sudo apt update && sudo apt upgrade -y
# ---------------------------------------------------------
# Step 2: Install core tools and Python dependencies
# Step 2: Install core tools and dependencies
# ---------------------------------------------------------
echo "Step 2: Installing required tools..."
echo "Step 2: Installing required tools and PTP dependencies..."
sudo apt install -y git curl python3 python3-pip build-essential cmake \
python3-serial libusb-dev
python3-serial libusb-dev linuxptp ethtool
# ---------------------------------------------------------
# Step 2.5: Install teensy-loader-cli from source
@ -49,6 +49,13 @@ sudo udevadm control --reload-rules
sudo udevadm trigger
echo "✅ Teensy udev rules installed. Reboot required to take full effect."
# ---------------------------------------------------------
# Step 2.7: Configure PTP hardware timestamping support
# ---------------------------------------------------------
echo "Configuring PTP hardware timestamping support..."
# Enable hardware timestamping on network interfaces if supported
sudo ethtool -T eth0 2>/dev/null | grep -q "hardware-transmit" && echo "✅ Hardware timestamping supported on eth0" || echo "⚠️ Hardware timestamping not available on eth0"
# ---------------------------------------------------------
# Step 3: Install Arduino CLI manually (latest version)
# ---------------------------------------------------------
@ -121,5 +128,11 @@ echo "────────────────────────
echo "NOTE: Teensy firmware ready in $HOME, but not auto-flashed."
echo "Boot splash will remain until desktop loads."
echo ""
echo "PTP Integration Features:"
echo "• IEEE 1588 PTP v2 client for sub-microsecond precision"
echo "• Hardware timestamping support (if available)"
echo "• Real-time offset monitoring and jitter measurement"
echo "• Configurable via config.json (ptp_enabled, ptp_interface)"
echo ""
sleep 15
sudo reboot