Skip to content

Integrations

SQMeter exposes device data through these integration paths. The legacy raw TCP server that previously ran on port 2020 has been removed.

Supported integration paths

REST API

Pull sensor data, status, and configuration over plain HTTP. See REST API for full endpoint reference.

# Current sensor readings
curl http://sqmeter.local/api/sensors

# System status
curl http://sqmeter.local/api/status

# Configuration
curl http://sqmeter.local/api/config

WebSocket

Real-time streaming over persistent connections. Connect to /ws/sensors for live sensor data (1 second cadence) or /ws/status for system status (2 second cadence). See WebSocket for details.

MQTT

Configure SQMeter to publish to an MQTT broker on a schedule, plus a retained safe/unsafe flag (<topic>/safe) and an alerts on/off switch for Home Assistant. See MQTT Integration for setup.

ASCOM Alpaca

Native SafetyMonitor and ObservingConditions devices for N.I.N.A. and other Alpaca clients, found by Alpaca discovery - no driver or bridge. See ASCOM Alpaca.

Alerts

The device sends its own notifications via Pushover, ntfy, a webhook or MQTT, and can ring a paired phone over Bluetooth. See Alerts and Bluetooth.


Legacy TCP server (removed)

The raw TCP server that previously accepted colon-command strings on port 2020 has been removed. It provided an ASCOM ObservingConditions-compatible interface, but the same data is available through the REST API and MQTT.

If you used the port 2020 TCP interface to drive observatory automation software (N.I.N.A., Voyager, Sequence Generator Pro), use the native ASCOM Alpaca devices instead. For scripts, the REST equivalents are:

Capability Old path Replacement
Sky quality / SQM TCP :003# GET /api/sensors → sky.sqm
Humidity TCP :028# GET /api/sensors → environment.humidity
Pressure TCP :029# GET /api/sensors → environment.pressure
Ambient temp TCP :030# GET /api/sensors → environment.temperature
Dew point TCP :031# GET /api/sensors → environment.dewpoint
Sky temperature TCP :035# GET /api/sensors → infrared.skyTemperature
Cloud cover TCP :038# GET /api/sensors → clouds.coverPercent
Rain rate TCP :051# GET /api/sensors → rain.intensity (mm/h)

Most observatory automation tools that previously supported the SQMeter TCP interface can be configured to query a REST endpoint via HTTP instead, either natively or via a local bridge script.