Skip to main content
GNSS HAT Library Documentation
Shop GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
  1. GNSS HAT Library Documentation
  2. /
  3. Examples
  4. /
  5. Print Satellites

Print Satellites

Display a per-satellite table showing constellation, signal strength, elevation, azimuth, and quality for all tracked satellites.

Source: examples/cpp/print-satellites/, examples/c/print-satellites/, examples/python/print_satellites.py

Note
Want a fancier dashboard? The C++ version also ships an advanced mode (print-satellites-advanced) — a rich terminal UI with ANSI colors, Unicode signal-strength bars, color-coded constellations, a per-constellation used/total summary, and ephemeris/almanac/DGPS correction counters, refreshed at 1 Hz. See the screenshot below. The rest of this page documents the basic example, which is what C, Python, and the print-satellites-basic C++ build all use.
Print Satellites Advanced terminal dashboard

What It Shows

The basic example — shared by C, Python, and the print-satellites-basic C++ build — prints a tabular listing: GNSS system, SV ID, C/N0, elevation, azimuth, quality, used-in-fix, health, plus total/used satellite counts.

ColumnDescription
ConstellationGPS, Galileo, GLONASS, BeiDou, SBAS, QZSS
SV IDSatellite vehicle number
C/N0Carrier-to-noise ratio in dBHz (signal strength)
ElevationDegrees above horizon (-90 to 90)
AzimuthCompass direction (0–360°)
QualitySignal quality level
UsedWhether the satellite contributes to the fix

Key Concepts

  • C/N0 > 30 dBHz = good signal, usable for positioning
  • C/N0 > 40 dBHz = strong signal
  • Used in fix = satellite actively contributes to the navigation solution

Running

sudo examples/bin/print-satellites-basic
sudo examples/bin/print-satellites-advanced

sudo build/examples/c/print-satellites/print-satellites

python3 examples/python/print_satellites.py