Virtuella enheter: ta in värden från andra system

Så skapar du en virtuell enhet i qtrl.me och skickar värden till den från Home Assistant, Homey, ett skript eller en webhook, för att använda dem i automationer och på dashboarden.

En virtuell enhet är en enhet som qtrl.me inte mäter själv. Den får sina värden från dig: bilens laddnivå från Home Assistant, en temperatur från Homey, antalet olästa mejl från ett skript. Så fort ett värde finns fungerar enheten som vilken givare som helst i flöden, termostater och på dashboarden.

Molntjänster som Shelly ansluter du i stället under Kopplingar, se guiden Shelly.

Formuläret för att skapa en virtuell enhet

Skapa en enhet

Gå till Enheter → Virtuella enheter.
Ange ett namn, till exempel Bilen, och en nyckel. Nyckeln används i adressen du skickar till och får bara innehålla små bokstäver a–z, siffror, bindestreck och understreck.
Under Värden lägger du till ett värde per sak du vill skicka in, och väljer typ: Temperatur, Luftfuktighet, Tal, Effekt, Energi, Ljus, På/av eller Öppen/stängd. Ge gärna värdet ett namn, till exempel Laddnivå, och en egen enhet, till exempel % eller km.
Klicka på Skapa enhet.

En enhet kan ha upp till åtta värden. Du kan lägga till, byta namn på och ta bort värden i efterhand.

Skicka in värden

Värdena skrivs med din API-nyckel, som du skapar under Nycklar. Det finns två sätt.

PUT med JSON, för system som kan skicka vanliga API-anrop:

curl -X PUT https://qtrl.me/api/virtual/bilen/0 \
  -H "Authorization: Bearer <nyckel>" \
  -H "Content-Type: application/json" \
  -d '{"value": 63}'

Webhook med GET, för system som bara kan anropa en adress:

https://qtrl.me/api/virtual/bilen/0/63?token=<nyckel>

Siffran efter nyckeln är värdets nummer, i den ordning värdena visas på sidan. Utelämnar du numret skrivs det första värdet, nummer 0. För På/av skickar du on eller off, för Öppen/stängd open eller closed, i övrigt ett tal.

Sidan visar de exakta adresserna för varje enhet, så du kan kopiera dem därifrån.

Home Assistant

Lägg till ett rest_command i configuration.yaml och anropa det från en automation:

rest_command:
  qtrlme_bilen_laddniva:
    url: "https://qtrl.me/api/virtual/bilen/0"
    method: PUT
    headers:
      Authorization: "Bearer <nyckel>"
      Content-Type: "application/json"
    payload: '{"value": {{ states("sensor.bilen_laddniva") }}}'

Homey

Använd kortet Gör en webbförfrågan (Logic) i ett flöde med metoden PUT, adressen ovan och JSON som innehåll, eller den enkla webhook-adressen med GET.

En virtuell enhet med tre värden

Ändra ett värde för hand

Klicka på pennan bredvid ett värde på sidan för att sätta det direkt. Det är praktiskt för att testa en automation innan det riktiga systemet skickar värden.

Beräknade värden

Ett värde behöver inte skickas in utifrån: det kan i stället få en formel som räknar fram det ur andra kanaler, till exempel medeltemperaturen av två givare eller effekten i kW. Klicka på kalkylatorknappen på värdets rad. Hur formler skrivs beskrivs i guiden Beräknade värden.

Termostatens enhet

En termostat skapar en egen virtuell enhet med börvärde, temperatur och på/av. Den är märkt termostat, följer termostaten och kan inte ändras eller tas bort här.

Bra att veta

Virtuella enheter räknas in i kontots antal anslutna enheter, tillsammans med enheter från kopplingar som Shelly. Antalet beror på din nivå.
Nyckeln i adressen går inte att byta efter att enheten skapats. Skapa i så fall en ny enhet.
Om API-nyckeln hamnar på villovägar tar du bort den under Nycklar och skapar en ny.