Koble til Evolo MQTT-broker

Med Evolo MQTT-broker kan du lese og skrive data via MQTT mot gatewayene dine i Evolo.

Skrevet av Evolo Support

Sist oppdatert Omtrent en måned siden

Før du starter

For å komme i gang trenger du dette:

  • Gateway er opprettet.

  • Du har opprettet en MQTT-nøkkel under Bruker → Integrasjoner.

1. Aktiver MQTT på gatewayen

  1. Gå til Konfigurasjon → Gateways.

  2. Åpne gatewayen du vil eksponere.

  3. Aktiver avhukingen Aktiver MQTT.

    Aktiver MQTT

  4. Klikk Lagre.

Evolo Gateway vil nå speile alle datapunkter til vår MQTT-broker på Internett.

2. Opprett en MQTT-klient i Integrasjoner

  1. Gå til Bruker → Integrasjoner.

  2. Velg fanen MQTT.

  3. Klikk Opprett ny MQTT Klient.

  4. Fyll inn:

    • Navn og beskrivelse

    • Tilganger: Les MQTT og/eller Skriv MQTT

    • Bygg: velg hvilke bygg nøkkelen skal gjelde for

  5. Klikk Opprett.

  6. Kopier disse verdiene:

    • Token
      Dette vises bare én gang.

    • Client ID
      Dette er UUID-en som vises i tabellen.

3. Koble til i MQTT Explorer

Bruk disse verdiene i MQTT Explorer:

Host
mqtt.evolo.no

Port
8883

Username
Din e-postadresse i Evolo

Password
MQTT-tokenet

Client ID
client:<uuid>

Eksempel:

UUID
123e4567-e89b-12d3-a456-426614174000

Client ID i MQTT Explorer
client:123e4567-e89b-12d3-a456-426614174000

4. Abonner på topics

Når tilkoblingen er opprettet, kan du abonnere på topics.

Eksempler:

evolo/<gateway_key>/#
evolo/<gateway_key>/tags/#
evolo/<gateway_key>/status/#

Bytt ut <gateway_key> med nøkkelen til gatewayen du vil lese fra.

Eksempel for å lese verdi fra et datapunkt:

evolo/<gateway_key>/tags/<tag_id>/value

5. Skriv til datapunkt

For å skrive en verdi til et datapunkt publiserer du en melding til write-topic for datapunktet.

Topic-format:

evolo/<gateway_key>/tags/<tag_id>/write

Payload må være gyldig JSON, og verdien må være enten et tall eller en boolean.

Eksempel: skriv tallverdi

Topic: evolo/<gateway_key>/tags/123/write Payload: 42

Eksempel: skriv boolean-verdi

Topic: evolo/<gateway_key>/tags/456/write Payload: true

Gatewayen plukker opp meldingen og forsøker å skrive verdien til det valgte datapunktet.

  • MQTT-klienten må ha tilgangen Skriv MQTT.

  • Datapunktet må være skrivbart og tilgjengelig for gatewayen.

  • <tag_id> er ID-en til datapunktet.

  • Payload skal ikke pakkes inn i et objekt. Send selve verdien direkte, for eksempel 42, 21.5, true eller false.

Andre merknader

Gi bare den tilgangen integrasjonen faktisk trenger. Du trenger ikke både Les MQTT og Skriv MQTT hvis klienten bare skal abonnere eller bare skal publisere.

Det er ofte lurt å opprette én MQTT-nøkkel per integrasjon eller klient. Da blir det enklere å administrere tilgang og tilbakekalle nøkler ved behov.