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

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.

Skapa en enhet

1. Gå till Enheter → Virtuella enheter och klicka på Ny enhet.
2. 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.
3. Under Värden klickar du på Lägg till värde för varje sak du vill skicka in, och väljer typ: Temperatur (°C), Luftfuktighet (%), Tal, Effekt (W), Energi (kWh), Ljus (lx), På/av, Dimmer (0–100 %), Knapp eller Öppen/stängd. Ge gärna värdet ett namn, till exempel Laddnivå, och en egen enhet, till exempel % eller km.
4. 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 (Nr på sidan), i den ordning värdena visas. 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, för Knapp click, click-double, click-triple eller click-long, i övrigt ett tal. En Dimmer tar 0–100, och on tar tillbaka den senaste nivån.

Sidan visar de exakta adresserna för varje enhet under Så skriver du värden via API:et, 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.

Ändra ett värde för hand

Klicka på pennan bredvid ett värde på sidan (Ändra värdet här) för att sätta det direkt. Det är praktiskt för att testa en automation innan det riktiga systemet skickar värden. Ett värde av typen Knapp har i stället knappen Tryck, som startar de automationer som lyssnar på den.

Menyn med tre prickar på värdets rad (Fler åtgärder) har Ändra namn och enhet, Ta bort värdet och, för på/av- och dimmervärden, Visa som, som avgör hur värdet visas på dashboarden och i enhetslistan.

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, på/av och läge. 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.