Troubleshooting
[ERROR] Failed to detect HAT variant
- Check that the HAT is properly seated on the 40-pin header
- Verify
/proc/device-tree/hat/product exists: cat /proc/device-tree/hat/product
- Some HATs require the EEPROM to be programmed — contact support if the file is missing
[SPI] Failed to open SPI device
- Enable SPI via
raspi-config → Interface Options → SPI
- Check permissions:
ls -la /dev/spidev*
- Run with
sudo or add your user to the spi group
[UART] Failed to open UART device: No such file or directory
- Enable UART via
raspi-config → Interface Options → Serial Port
- Ensure the serial console is disabled and serial hardware is enabled
- Reboot after changing settings
- Ensure the antenna has a clear view of the sky
- Check antenna connection —
AntennaStatus::Open means no antenna detected
- After a cold start, allow 30–60 seconds for acquisition
- Use
Portable dynamic model for initial testing
- Check for RF interference via Jamming Detection
- SPI requires root or
spi group membership
- GPIO operations require root or
gpio group membership
- The bridge daemon runs as root by default
- Check that
timepulsePinConfig.active = true in config
- Call
enableTimepulse() before timepulse()
- Ensure kernel PPS (
/dev/pps0) is not using GPIO 5 simultaneously
- Verify with
gpioinfo | grep 5
