Getting Started with Sensor Hub
Getting Started with Sensor Hub
Sensor Hub lets you connect physical devices (sensors, meters, IoT hardware) to OrbitingFox and monitor their live readings. Each device gets a unique API code — your hardware sends readings to a simple REST endpoint, and the data appears instantly on your dashboard.
Add Your First Device
- Open Sensor Hub from the app menu and click + New Device.
- Select the equipment this sensor is attached to (from Fleet & Assets).
- Give the device a name (e.g. "Engine Temperature Sensor") and choose a mode.
- Click Create Device. Your device code will appear (e.g.
SNS-A1B2C3D4).
Send Your First Reading
From your hardware or a script, send a POST request:
POST /api/v1/sensors/ingest/SNS-A1B2C3D4/
Content-Type: application/json
{"readings": [{"channel": "engine_temp", "value": 87.3}]}The channel is created automatically on first use. Readings appear in the Overview tab immediately.
Set Up an Alert
- Open your device and go to the Alerts tab.
- Click + Add Alert, select a channel, and set a threshold condition.
- When the threshold is crossed, you'll receive a notification automatically.
Modes Explained
- Continuous — device sends readings as fast as it produces them.
- Interval — device sends every N seconds; OrbitingFox alerts you if it goes silent.
- Threshold — device only sends when a value crosses an internal threshold.