Guider

Integrationer

Shelly pratar med fler system än sin egen app - lokalt via Home Assistant och MQTT, eller via molnet med Google och Alexa. Vilken väg som fungerar beror på generationen.

Shelly Smart Control är inte den enda vägen in i dina enheter. Beroende på generation kan de också pratas med lokalt - via Home Assistant, MQTT, Matter eller KNX - eller via molnet, som med Google Home och Amazon Alexa.

Vilken integration som är möjlig avgörs, precis som i resten av dokumentationen, av vilken generation enheten är. Är du osäker, börja i Vilken generation har du?.

Snabböversikt

Home Assistant

Home Assistant har en inbyggd Shelly-integration: Inställningar → Enheter och tjänster → Lägg till integration → Shelly. Enheter på samma nätverk hittas ofta automatiskt.

Kommunikationen går direkt mot enheten - inte via Shellys moln. Gen2+ använder samma RPC-gränssnitt som resten av shelly-api-docs.shelly.cloud beskriver, medan Gen1 pratar via CoIoT, Shellys äldre lokala protokoll. För Gen1 måste CoIoT vara påslaget i enhetens avancerade inställningar, och för batteridrivna Gen1-enheter rekommenderas unicast mot Home Assistant-serverns IP och port 5683 i stället för broadcast.

Det här är vägen de flesta som vill ha mer än vad appen erbjuder - egna automationer, statistik, integration med annan utrustning - hamnar i. Priset är att du måste driva en egen Home Assistant-instans.

MQTT

Gen2+ (Plus, Pro, Gen3, Gen4) har ett inbyggt MQTT-komponent, dokumenterat på shelly-api-docs.shelly.cloud. Du pekar enheten mot din egen broker (MQTT.SetConfig, eller motsvarande i appens/webbgränssnittets inställningar), enheten kopplar upp sig och exponerar samma RPC-metoder som HTTP och WebSocket gör - både statusuppdateringar och styrning.

Även Gen1 kan MQTT, men med ett äldre, enklare ämnesschema under /shellies/.... Två saker värda att veta om du ändå hamnar där: att slå på MQTT på en Gen1-enhet stänger av dess anslutning till Shellys moln, och Gen1 stödjer inte krypterade (TLS) MQTT-anslutningar.

MQTT är vägen in om du bygger ett eget system - Node-RED, openHAB, ett eget skript - och varken vill eller behöver Home Assistant eller Shellys app emellan.

Matter

Matter är standarden som kopplar enheten lokalt till Apple Home, Google Home och Alexa, utan att gå via Shellys moln. Vilka enheter som stödjer det är en generationsfråga - se tabellen i Vilken generation har du?: kort sagt alla Gen4, samt en del Gen3-enheter från och med firmware 1.6.0.

Väljer du Matter för en Gen4 väljer du samtidigt bort Zigbee-läget - se avsnittet om det längre ner.

Google Home och Amazon Alexa

Till skillnad från Home Assistant, MQTT, Matter och KNX går den här vägen via molnet. Shellys egen support är entydig på den punkten: en molnanslutning krävs för att integrationerna med Alexa, Google Home och SmartThings ska fungera alls.

• Alexa: aktivera skillet "Shelly Cloud" i Alexa-appen, logga in på home.shelly.cloud när du blir omdirigerad, säg sedan "Alexa, sök efter nya enheter".
• Google Home: Inställningar → Fungerar med Google → sök på "Shelly Smart Home".

Enheten måste alltså finnas i ditt Shelly-konto och ha molnanslutning aktiverad - lokal styrning räcker inte för den här vägen.

Molnets API kontra det lokala API:et

shelly-api-docs.shelly.cloud är uppdelad i flera separata dokumentationer, och det är lätt att blanda ihop dem:

• Gen1 Device API - enhetens eget HTTP-API och CoIoT, dokumenterat separat från Gen2+.
• Gen2+ Device API - RPC-metoder som nås över HTTP, WebSocket, BLE eller MQTT beroende på vad du kopplar upp mot. Samma metoder oavsett transport.
• Cloud Control API - för dig som redan har ett Shelly-konto. Du genererar en auktoriseringsnyckel i kontoinställningarna och styr dina egna enheter via Shellys moln i stället för lokalt. Begränsad till ett anrop per sekund.
• Integrator API - en cloud-to-cloud-integration riktad mot företag/partners som vill koppla sina egna molntjänster mot Shellys, inte något en enskild användare normalt sätter upp själv.

Poängen att ta med sig: allt som pratar direkt med enheten - Home Assistant, MQTT, egna HTTP-anrop mot det lokala RPC-gränssnittet - kräver inget Shelly-moln överhuvudtaget. Molnet behövs först när du vill nå enheten utifrån, eller när integrationen (som Alexa och Google Home ovan) är byggd för att gå via molnet.

KNX

KNX är den integration Shelly själva dokumenterar mest utförligt i sin kunskapsbas - egna KNX-sidor, use cases och en beskrivning av hur en Shelly Pro 1 eller Shelly Pro 1PM kan ersätta en kanal i en befintlig KNX-växelaktor.

KNXnet/IP är inbyggt i:

• Pro-linjen (Gen2) - din DIN-skensenhet i elcentralen.
• Gen3 och senare - flera modeller (bland annat 1, 1L, 2L, 2PM, Mini-varianter, Shutter, Dimmer och Plug S-varianter).

Minimikravet är firmware 1.4.0, men vissa nyare modeller kräver högre (1.5.0, 1.6.0 eller 1.7.0) - kontrollera din specifika modell innan du planerar en installation. Vanliga Shelly Plus-enheter (Gen2) stöds uttryckligen inte.

Över KNXnet/IP kan du styra och läsa status för på/av-utgångar, styra rullgardiner/markiser/persienner (inklusive lamellvinkel på persienner) med positionsåterkoppling, samt rapportera elmätvärden in i KNX-systemet.

Zigbee-fällan igen

Samma sak som i Vilken generation har du? gäller här: ställer du om en Gen4 till Zigbee-läge slutar den fungera i Shelly Smart Control. Det är inte ett fel som ska felsökas - se även Felsökning - utan en konsekvens av valet. Enheten hanteras i stället helt av din Zigbee-hubbs egen app, och vad du kan göra med den där beror på hubben, inte på Shelly.