Skip to content

Settings Page

Jump to bottom
W9KSB edited this page Jun 14, 2026 · 2 revisions

Settings Page

The settings page is the main configuration surface for station, hardware, automation, and advanced behavior setup.

Related pages:

What This Page Controls

The settings page covers:

  • station information and location
  • TLE source URLs
  • stale-after timing
  • RX settings
  • TX settings
  • rotator settings
  • automation scripts
  • advanced settings

Station Settings

The station section defines the ground-station location used for pass prediction, live geometry, and time-zone-aware display behavior.

The current GUI workflow is centered around a grid-based station entry rather than forcing the operator to work from raw coordinates alone.

TLE Settings

This section controls where Pi-Sat gets orbital data and how stale it is allowed to become before a refresh is considered necessary.

The force-update button exists so you can refresh TLE data immediately without waiting for the scheduler.

Pi-Sat supports multiple TLE URLs and merges them into one working cache.

RX and TX Device Settings

These sections define how Pi-Sat talks to the radio paths.

Important choices include:

  • local connectivity
  • network connectivity
  • model ID
  • serial port
  • baud rate
  • host and port
  • target VFO

If local connectivity is used, directly attached USB serial devices are detected and offered in the serial-port dropdown when available.

Each section also provides a test button so you can validate the configured RX or TX path without waiting for a live pass.

Rotator Settings

The rotator section defines:

  • whether the rotator path is enabled
  • the control path for the rotator
  • whether return-home-after-pass is active
  • the rotator minimum elevation threshold

The rotator section also provides a test button so you can validate the configured rotator path directly from the settings page.

Automation Settings

The automation section allows you to select optional scripts that can run on real pass events.

The page supports:

  • an AOS script selection
  • an LOS script selection
  • None as the default choice for each
  • test buttons to manually trigger those scripts without waiting for a live pass

Pi-Sat looks for supported scripts in the root scripts/ directory.

Supported script types are:

  • .py
  • .sh

Script execution results from the test buttons are shown on the page, and normal runtime script activity is also visible through the monitor page logs.

Advanced Settings

The advanced settings section is a collapsible area for lower-level control and safety tuning.

Examples include:

  • TX inhibit rules
  • frequency deadband
  • CAT rate limit
  • tracking update interval
  • number of failures before a device is marked offline

These settings exist because hardware control needs guardrails and predictable retry behavior.

Why the Settings Page Exists

The settings page is intended to keep normal operating changes inside the GUI so the user does not need to live in the config file for routine adjustments.

The config file still exists as the source of truth underneath. Some values remain intentionally config-only because they are backend or deployment controls rather than normal operator-facing settings.

Clone this wiki locally