LinkEdge

A local hub that collects sensor data (LoRaWAN or plain HTTP), checks that the values make sense, stores them, and forwards them to your cloud via webhooks.

LoRaWAN sensors → Gateway Bridge → MQTT → ChirpStack ─┐
                                                      ├→ Hub (FastAPI) → TimescaleDB → webhooks
Other sources (HTTP) ─────────────────────────────────┘

You need Docker with Docker Compose.

cp .env.example .env     # then edit .env and set your own passwords and secret key
docker compose up --build -d
curl http://localhost:8000/health

Interactive API docs: http://localhost:8000/docs

curl -X POST http://localhost:8000/api/v1/ingest \
  -H "Content-Type: application/json" \
  -d '{
    "dev_eui": "sensor-01",
    "device_profile_id": "soil_sensor_v1",
    "data": {"ph": 6.5, "temperature_c": 21.3, "moisture_pct": 40}
  }'

The response tells you whether the reading is valid and why not, if it isn't.

A profile defines how a device's data is decoded and which values are allowed. Profiles are JSON files in hub/device_profiles/.

• generic: pass-through with no rules. Used for unknown devices.
• soil_sensor_v1: JSON decoder that checks physical ranges for pH, temperature, moisture, EC, CO2, O2, CH4, N2O, vibroacoustic frequency and amplitude.

To add your own, drop a new JSON file in that folder and restart the hub.

All settings are in .env (see .env.example):

MIT. See LICENSE.