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