SPEdyctl Support

Overview

SPEdyctl is a command-line interface for interacting with and configuring SPEdy 100. Use it to update firmware, configure leader/follower mode, and monitor current status, including Ethernet link health, polarity, and the current operating mode.

Install SPEdyctl

MacOS: Homebrew

brew install PhaseLockLabs/tap/spedyctl

Linux: APT

For Ubuntu 22.04+ and Debian bookworm+:

curl -fsSL https://phaselocklabs.github.io/spedy-releases/spedy-archive-key.asc \
  | sudo gpg --dearmor -o /usr/share/keyrings/spedy-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/spedy-archive-keyring.gpg] https://phaselocklabs.github.io/spedy-releases stable main" \
  | sudo tee /etc/apt/sources.list.d/spedy.list
sudo apt update
sudo apt install spedyctl

On Ubuntu Server or minimal installs without a desktop session, add your user to the serial and USB device groups:

sudo usermod -aG dialout,plugdev $USER

Then log out and back in for the changes to take effect.

Windows: Winget 

winget install --id PhaseLockLabs.spedyctl

Then install the USB DFU driver, which is required for firmware upgrades. Use either Command Prompt or PowerShell:

Command Prompt

cd /d "%ProgramFiles%\spedyctl\drivers"
install-driver.cmd

PowerShell

cd "$env:ProgramFiles\spedyctl\drivers"
.\install-driver.cmd

Launch SPEdyctl

Once installed, simply type spedyctl in your terminal and press Enter:

spedyctl

Update SPEdyctl

If spedyctl is already installed, use the commands for your package manager to update it.

macOS: Homebrew

brew upgrade spedyctl

Linux: APT

sudo apt update
sudo apt install --only-upgrade spedyctl

Windows: winget

winget upgrade spedyctl

Connect SPEdy Device

Connect your SPEdy device to your computer using a USB-C cable that supports USB 2.0 data transfer or higher. Charge-only cables will not work. The device will appear in spedyctl as an available device.

Your device will appear in spedyctl even if its firmware needs updating. If the device firmware version doesn’t match your installed version of spedyctl, you’ll be prompted to update it before continuing. Spedyctl handles the update process for you.

Highlight your device, select Sync Firmware, and press Enter. The device will begin updating and will reappear in the device list once the update is complete.

Do not disconnect the device while it is updating.

[Screenshot placeholder: device highlighted with Sync Firmware selected]

FAQ

Why isn’t my device showing up in available devices?

  1. Check that the USB-C cable is securely connected.
  2. Make sure the cable supports USB 2.0 data transfer or higher, not just charging.
  3. Try another cable or USB port.
  4. On Ubuntu Server or minimal Linux installs, check that you have completed the user-group setup and logged out and back in.
  5. Check whether the device is stuck in bootloader mode and try flashing the latest firmware. See What should I do if I disconnected my device during an update?
  6. If bootloader recovery fails, please contact us for assistance.

What should I do if I disconnected my device during an update?

If the device is disconnected during an update, it will remain in bootloader mode until recovered. Reconnect the device to your computer, then run the following command in your terminal to recover it and flash the latest firmware:

spedyctl -r

The device should reappear in the device list once recovery is complete.

If recovery fails with Recovery failed: no DFU device found, please contact us for assistance.

Do not disconnect the device while a firmware update is in progress.