Koble Airthings-enheter til Evolo med MQTT

Før du starter

For å komme i gang trenger du dette fra Airthings:

• Tilgang til en Airthings for Business-konto med minst én enhet som er online

• Airthings Konto ID: finner du i Airthings Dashboard under Integrasjoner.

• Airthings MQTT Klient ID: finner du når du oppretter en MQTT-klient i Airthings Dashboard.

• Airthings Location ID: finner du i nettadressen når du har åpnet bygget i Airthings Dashboard.
  

  

• Airthings Device ID: finner du i nettadressen når du har åpnet enheten i Airthings Dashboard.
  

  

1. Opprett en MQTT-klient i Airthings Dashboard

For at Evolo Gateway skal kunne koble seg til Airthings, må du først opprette en MQTT-klient i Airthings Dashboard. Dette gir deg påloggingsinformasjonen og sertifikatene du trenger videre i oppsettet.

2. Legg til Airthings MQTT-broker som en enhet

Når MQTT-klienten er opprettet og sertifikatene er lastet ned, legger du til en ny enhet i Evolo.

Legg til en ny enhet i Evolo og bruk mqtt.airthings.com som vertsnavn.

3. Legg til MQTT-grensesnitt

Opprett deretter et nytt grensesnitt med disse innstillingene:

Avanserte innstillinger for grensesnittet

Under avanserte innstillinger legger du inn topicene som Evolo skal abonnere på, og laster opp sertifikatene fra Airthings.

Klikk Opprett når alt er fylt inn.

4. Legg til datapunkter som leser fra MQTT

Når grensesnittet er opprettet, kan du legge til datapunkter for verdiene du vil lese fra Airthings.

I eksemplet med grensesnittet ser vi at Evolo abonnerer på alle topics under:
95c179d9-1edd-471b-b55b-44b3e76802a8/f3b1b49d-8d3d-4497-b0d4-68ca8a5c9f69/#

For å hente ut verdier, legger du til Device ID-en og avslutter med /samples til enheten du vil lese fra.

Eksempel på en komplett topic

95c179d9-1edd-471b-b55b-44b3e76802a8/f3b1b49d-8d3d-4497-b0d4-68ca8a5c9f69/devices/123456789/samples

Eksempel på data fra Airthings

Payloaden fra Airthings kan inneholde verdier som disse:

{
"serialNumber": "2930046980",
"sampleRecorded": "2023-07-04T11:25:31",
"co2": 456, // carbon dioxide (ppm)
"humidity": 43, // relative humidity (%)
"light": 36, // relative light (%)
"lux": 114, // light (lux)
"radonShortTermAvg": 13,
"temp": 24.33, // temperature (°C)
"voc": 71, // volatile organic compounds (ppb)
"pressure": 99166, // pressure (hPa)
"pm1": 10, // particulate matter 1 µm (µg/m³)
"pm25": 10, // particulate matter 2.5 µm (µg/m³)
"soundLevel": 55, // sound level (dBA)
"pressureDifference": null,
"pm10": null,
}

Test datapunktet

Når du har lagt inn uttrykket for verdien du vil lese, kan du teste oppsettet med Les datapunkt. Klikk deretter Opprett for å fullføre.

Feilsøking

Jeg får ikke lest data fra Airthings

Sannsynlig årsak:
MQTT-klienten er ikke opprettet riktig, topicen peker til feil bygg eller enhet, eller sertifikatene er ikke lastet opp riktig.

Løsning:
Kontroller Konto ID, MQTT Klient ID, Location ID og Device ID. Sjekk også at topicen er skrevet riktig, og at TLS og sertifikatvalidering er aktivert.

Datapunktet leser feil verdi

Sannsynlig årsak:
Uttrykket i feltet for Javascript peker til feil parameter i meldingen.

Løsning:
Sjekk payloaden fra Airthings og bekreft at du leser riktig felt, for eksempel temp, co2 eller humidity. Test deretter med Les datapunkt.