> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altnautica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hardware Tab

> Manage your ground station from its detail panel in Mission Control.

# Ground Station Controls in Mission Control

When Mission Control connects to a node running the ground-station profile, that node gets its own detail panel: a browser control surface for status, radio, network, display, physical UI, peripherals, distributed receive, and mesh.

<Frame caption="The ground-station Overview tab showing ground station status, connected clients, and quick actions">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/altnautica/images/placeholder-hardware-tab.png" alt="Mission Control ground-station overview with link health and connected clients" />
</Frame>

## Where to find it

Open the Mission Control Dashboard and select the ground-station node from the fleet. Its detail panel opens with a row of role-aware tabs. The tab set adapts to the node's current role (`direct`, `relay`, or `receiver`), so you only see the surfaces that make sense for the running profile.

## Tabs

### Overview

The landing tab. It shows:

* Ground station profile, board, uptime, and paired-drone state
* Link health, including RSSI, bitrate, channel, and FEC counters when available
* Uplink summary and current role
* Pairing action for the drone link
* PIC widget showing who currently has pilot-in-command authority

### Radio

Drone-facing radio controls. Hidden in the `receiver` role, which does not transmit:

* Channel, bitrate, and FEC counters
* TX power slider
* Video link status

### Network

Full network configuration:

* WiFi AP enable, SSID, passphrase, and band settings
* WiFi client scan, join, and leave
* Ethernet status and configuration
* Cellular modem status and APN settings
* Uplink priority order
* Adapter stability and share-uplink toggle for local clients

### Display

The SPI touch LCD surface, when a panel is attached:

* Live preview of the on-device dashboard
* Remote control, theme toggle, and camera switch
* Recording monitor
* Five-point touch calibration from the desk

See [Display](/ground-agent/display) for the full panel reference.

### Physical UI

OLED, buttons, and controller management:

* OLED brightness and auto-dim behavior
* Live preview of the OLED screen and four front buttons
* Bluetooth scan, pair, and forget for gamepads and accessories
* Factory reset with typed confirmation

Button remapping and screen reorder controls are present as configuration surfaces, but remain limited until the matching agent endpoints are fully supported.

### Peripherals

Connected accessory management:

* Enumerated USB, Bluetooth, and agent-discovered devices
* Per-device health and status
* Device configuration and supported action buttons

### Distributed RX

Shown on mesh-capable nodes in `relay` or `receiver` role. The tab is role-aware:

* **Relay:** shows receiver reachability, relay status, and fragment forwarding stats.
* **Receiver:** shows paired relays, pending join requests, pairing-window state, revoke actions, and combined-stream stats.

This tab polls the role and distributed-receive endpoints while visible. It can change role, open and close the receiver pairing window, approve pending relays, and revoke relays.

### Mesh

Shown on mesh-capable nodes in `relay` or `receiver` role. The tab shows:

* Mesh health, mesh id, peer count, partition indicator, and selected gateway
* Neighbor table with link quality and last-seen age
* Gateway table with advertised gateways and pin action
* Mesh event toasts for partitions, gateway failover, receiver unreachable, relay revoked, and relay disconnected
* Disabled log-aggregation action until the agent log bundle endpoint ships

The tab polls mesh health, neighbors, routes, and gateways while visible. Live mesh deltas arrive through the mesh WebSocket stream.

## Role gating

The visible tab set depends on the node's role:

| Tab            | direct | relay | receiver |
| -------------- | ------ | ----- | -------- |
| Overview       | yes    | yes   | yes      |
| Radio          | yes    | yes   | no       |
| Network        | yes    | yes   | yes      |
| Display        | yes    | yes   | yes      |
| Physical UI    | yes    | yes   | yes      |
| Peripherals    | yes    | yes   | yes      |
| Distributed RX | no     | yes   | yes      |
| Mesh           | no     | yes   | yes      |

Drone pairing and link health live in Overview, while mesh log aggregation is shown as a disabled action in Mesh.

## Data flow

The ground-station detail panel communicates with the Ground Agent through:

| Channel       | Path                                                       |
| ------------- | ---------------------------------------------------------- |
| REST API      | `http://<ground-node>:8080/api/v1/ground-station/*`        |
| Uplink events | `ws://<ground-node>:8080/api/v1/ground-station/ws/uplink`  |
| Mesh events   | `ws://<ground-node>:8080/api/v1/ground-station/ws/mesh`    |
| PIC events    | `ws://<ground-node>:8080/api/v1/ground-station/pic/events` |

For ground stations on the local network, the browser connects directly over WiFi AP, USB tether, or Ethernet. Hosted Mission Control cannot open local `http://` or `ws://` endpoints from an HTTPS page, so local Ground Agent control should use a local Mission Control build or the Ground Agent-hosted build.

## State behavior

* Overview status polls at a short cadence while the page is visible.
* Distributed RX polls every few seconds while visible.
* Mesh polls every few seconds while visible.
* Polling pauses when the browser tab is hidden.
* Last-known state is retained when a node goes offline, then refreshed when it reconnects.

## Using the controls offline

The ground-station detail panel works offline as long as your browser can reach the Ground Agent over the local network. Cloud features are additive. Local video, telemetry, role management, and network setup do not require internet.

## What is next

* [Physical UI](/ground-agent/physical-ui) for OLED and button details
* [Uplink Matrix](/ground-agent/uplink-matrix) for network configuration
* [Power and Runtime](/ground-agent/power-and-runtime) for field power sizing
* [Troubleshooting](/ground-agent/troubleshooting) for common issues
