Styr dina Z-Wave-enheter med Home Assistant och Aeon Z-stick

I den här guiden visar vi hur du kommer igång med styrning av Z-wave-enheter i Home Assistant.
Publicerad: juni 15, 2017
Senast uppdaterad: november 16, 2017
touch_app Styrenhet
Home Assistant All-In-One install
multiline_chart Svårighetsgrad
Inte så farligt
format_list_bulleted Antal steg
8
trending_up Visningar
7740
chat_bubble_outline Kommentarer
16
star_outline Betyg
5 / 1

Steg 1. Vad handlar den här guiden om link

Det här behöver du köpa

favorite_border Om du gillar Snillevilla och vill stötta bloggen och se fler och bättre guides, använd gärna länkarna ovan för att göra köp på m.nu. Då får vi en liten ersättning för varje köp du gör. Det medför ingen extra kostnad för dig. Pengarna går oavkortat till vidareutveckling av Snillevilla. Tack!
done Du behöver inga verktyg eller andra tillbehör för att genomföra denna guide.

Steg 2. Koppla in Z-Stick i din Raspberry Pi link

  • Koppla in Z-Stick i din Raspberry Pi.
    Den C-formade lampan på den kommer blinka i olika färger.
  • Använd PuTTY för att öppna en terminalsession till din Raspberry Pi där du har Home Assistant installerad och skriv in följande kommando: sudo usermod -a -G dialout homeassistant
  • Detta kommando gör att Home Assistant kan nu kommunicera med enheter anslutna till Raspberry Pi.

Steg 3. Gör det lätt för Raspberry Pi att hitta din Z-Stick link

  • Varje enhet som är inkopplad i Raspberry Pi har en ‘adress’. För att kunna skicka och ta emot information från Z-Stick, behöver Home Assistant veta var den ‘bor’. För prylar anslutna med USB ändras tyvärr denna adress nästan varje gång man kopplar dem ut / in igen.
  • Därför ska vi skapa en ‘permanent’ adress för din Z-Stick så Home Assistant kan alltid hitta den, oavsett hur den är inkopplad i din Raspberry Pi.
  • Skriv kommando ls /dev/ttyACM*. Det kommer skrivas ut en textrad i terminalen. Detta är adressen Pi använder för att hitta till din Z-Stick. Skriv ner den då du ska använda den senare. Adressen jag fick var /dev/ttyACM0.
  • Efteråt, skriv följande kommando i terminalen: udevadm info -a -n /dev/ttyACM0 | grep '{idProduct}' | head -n1. Ersätt /dev/ttyACM0 med adressen du fick reda på nyss.
  • Du kommer se en rad text som ser ut såhär: ATTRS{idProduct}=="0200". Siffrorna i citationstecken är produkt-id för din Z-Stick. Skriv ner dem.
  • Till sist, skriv kommando udevadm info -a -n /dev/ttyACM0 | grep '{idVendor}' | head -n1 i terminalen. Ersätt /dev/ttyACM0 med din adress.
  • Du kommer se en rad text som ser ut såhär: ATTRS{idVendor}=="0658".  Siffrorna i citationstecken är producentid för din Z-Stick. Skriv ned dem också.
  • Skriv kommando cd /etc/udev/rules.d i terminalen. Detta gör att du byter arbetsmapp från din hemmamapp till mappen ‘rules.d’.
  • Skriv sudo nano 99-usb-serial.rules i terminalen. Det gör att du skapar en ny fil i din arbetsmapp som heter ’99-usb-serial.rules’ och öppnar den för redigering.
  • Du kommer se ett tomt fönster. Det är en textredigerare.
  • Skriv där följande text: SUBSYSTEM=="tty", ATTRS{idVendor}=="0658", ATTRS{idProduct}=="0200", SYMLINK+="zwave". Ersätt texter i citationstecken med idVendor och idProduct som du antecknade förut.
  • Tryck på Ctrl + X på tangentbordet. Terminalen kommer fråga om du vill spara ändringarna i filen.
  • Skriv ‘Y’ och tryck Enter. Pi kommer spara filen du nyss skapade.
  • Nu är du tillbaka till terminalen där du var förut.
  • Starta om din Raspberry Pi genom att skriva sudo reboot i terminalen. Vänta någon minut och sen logga in på Pi igen.
  • Nu kommer Raspberry Pi veta att den alltid kan hitta din Z-Stick på adress /dev/zwave.
  • Du kan verifiera att du har gjort rätt genom att skriva ls -l /dev/zwave i terminalen. Du bör då se en rad text som ser ut såhär: lrwxrwxrwx 1 root root 7 Jun 12 21:54 /dev/zwave -> ttyACM0.
  • Det här steget har ändrats sedan guiden publicerades då flera bloggens läsare fick inte USB addreseringen att funka när de följde stegets förra version. Hoppas det funkar nu. Lämna gärna en kommentar om något fortfarande strular. 🙂

Steg 4. Stäng av blinkande lampan på Z-Stick link

  • När du har kopplat in Z-Sticken i din Raspberry Pi blinkar den C-formade lampan i olika färger.
  • Om du, som jag, tycker att det är irriterande, kan du stänga av den.
  • I PuTTY terminalen, skriv följande kommando: sudo apt-get install cu och tryck ‘Enter’. Det kommer installeras en liten mjukvara på din Pi som heter ‘cu’.
  • När den är färdig, skriv följande kommando: echo -e 'x01x08x00xF2x51x01x00x05x01x51'|cu -l /dev/zwave -s 115200.
  • Nu är lampan på Z-Stick avstängd.
  • Om du någon gång vill slå på lampan igen, skriv följande kommando: echo -e 'x01x08x00xF2x51x01x01x05x01x50'|cu -l /dev/zwave -s 115200.
  • Observera att /dev/zwave delen i kommandona ovan är samma adress till Z-Stick som vi skapade i förra steget. Har du en annan adress till din Z-Stick, använd den istället

Steg 5. Öppna Home Assistants konfigurationsfil link

  • Sådär, det var allt vi behövde göra i terminalen för tillfället. Nu ska vi redigera konfigurationsfilen som kommer att berätta för Home Assistant att vi vill använda den för att styra Z-Wave prylar vi har hemma med hjälp av Z-Stick.
  • Logga in på din Raspberry Pi med WinSCP och gå till mapp ‘/home/homeassistant/.homeassistant’.  
  • Filen som vi ska redigera, heter ‘configuration.yaml’. Dubbelklicka på den för att öppna den. Om din dator frågar vilket program ska den använda för att redigera den, välj en textredigerare, t.ex. Notepad. Jag använder en textredigerare som heter Atom.
  • Filen ‘configuration.yaml’ innehåller all information för Home Assistant om vilka enheter du vill ansluta till den och styra med hjälp av den. Den måste vara formaterad på ett visst sätt för att funka, så håll noga koll på alla mellanrum och liknande i anvisningarna som följer.

Steg 6. Konfigurera Home Assistant för att styra Z-Wave prylar med Z-Stick link

  • I konfigurationsfilen som du har öppnat, scrolla ner lite och på valfritt ställe skriv in följande text:
    # Z-Wave support
    zwave:
      usb_path: /dev/zwave
  • Om du inte använder en textredigerare som är anpassad för programmering, observera att det inte får vara mellanslag framför de första raderna och exakt två mellanslag framför raden usb_path: /dev/zwave. Annars kommer konfigurationen inte att funka.
  • Spara och stäng filen.
  • Öppna Home Assistant i din webbläsare. I mitt fall är adressen http://192.168.0.17:8123.
  • Om du har glömt IP adress till din Home Assistant, skriv följande kommando i PuTTY terminalen: ip addr show
  • Du kommer få en massa text som svar. Hitta rad som börjar med ‘inet’ i texten, precis efter ‘inet’ står det IP adress för din Pi.
  • I webbgränssnittet, välj ‘Configuration’ i menyn.
  • I fönstret till höger, scrolla ner något tills du ser ett kort med rubrik ‘Server management’. Tryck på knappen ‘Restart’ där.
  • Din Home Assistant-server kommer att startas om och installera Z-Wave-komponenten. Det tar ungefär 20 minuter. Du får inget meddelande om detta och du kommer inte att kunna ansluta till webbgränssnittet under tiden. Tålamod! 🙂
  • När du får kontakt med webbgränssnittet igen, kommer du se ett nytt kort med din Z-Stick och ett nytt val i menyn: Z-Wave.
  • När du klickar på namnet på din Z-Stick på kortet, ser du en dialogruta med all möjlig information om den.
  • Grattis! Nu kan du börja ansluta dina Z-Wave-prylar till Home Assistant. 🙂

Steg 7. Anslut din första Z-Wave-pryl till Z-Stick link

  • Första Z-Wave prylen jag kommer ansluta till min Home Assistant är det här fina Z-Wave On/Off-eluttaget från Telldus.
  • Gör så här för att ansluta en Z-Wave-pryl till din Z-Stick i Home Assistant.
  • Tryck på Z-Wave i menyn och sen på knappen ‘Add Node’ som du ser i fönstret till höger.
  • Nu kan du ansluta Z-Wave-prylar till Home Assistant. Exakt hur du gör är lite olika för varje pryl och bäst är att du kollar upp det i manualen som följde med den.
  • I mitt fall behöver jag trycka på en knapp på uttaget. En diod som lyser lila på den indikerar att uttaget har anslutit sig till ett Z-Wave nätverk.
  • Nu kan du se och styra prylen som du precis lagt till i Home Assistants webbgränssnitt.
  • Alla prylar som ingår i ett Z-Wave-nätverk kallas för ‘nodes’ på engelska. På svenska brukar man använda ordet ‘noder’.

  • Om du trycker på prylens namn i kortet ‘ZWave’ kan du se all information om den.
  • Just nu har min pryl inget namn. För att ange ett namn till den, tryck på Z-Wave i menyn och sen på rullgardinsmenyn ‘Nodes’ i kortet ‘Z-Wave Node Management’. Du kommer att se en lista av alla anslutna Z-Wave-prylar eller s.k. noder.
  • Välj noden du vill ändra namn på och ange ett namn för den i fältet ‘Rename Node’. Eftersom jag i fortsättningen tänker styra min plattång (glömmer stänga av den på morgonen alldeles för ofta) med det här uttaget, nämner jag min nod ‘Remington’. Tryck på knappen ‘Rename Node’ för att spara namnet.
  • Tryck på ‘Configuration’ i menyn och sen på knappen ‘Restart’ i kortet ‘Server management’.
  • Home Assistant kommer att startas om. Nu, när du öppnar webbgränssnittet igen, kommer du se din pryl i listan med namnet du har valt.
  • Anslut alla dina andra Z-Wave-prylar till Home Assistant på samma sätt. 🙂

Anpassa Home Assistants webbgränssnitt till dina behov link

zoom_in
  • Om du har en stor mängd prylar du vill ansluta till din Home Assistant, kommer det att bli stökigt fort i webbgränssnittet.
  • Som tur är kan du skräddarsy Home Assistants webbgränssnitt helt så som du vill. Du kan gruppera prylar, visa fina grafer och mycket, mycket mer.
  • Vi kommer att publicera en separat guide som handlar just om detta om två veckor. Prenumenera på vårt nyhetsbrev eller följ oss på Facebook för att inte missa när den är ute! 🙂
  • Lycka till med dina äventyr och experiment med Home Assistant framöver!

Tack till m.nu för lån av prylarna som behövdes för att genomföra denna guide. Tack även till Isabella Gross Alström (@teachingbirds), Martin Jonsson (@Jonsson9), Johan Linge (@johanlinge) och Mattias Martikkainen för korrläsning och återkoppling.

Diskussion

  • Varför fungerar inte detta för mig? Jag har en Z-stick och får fram exakt samma värden som visas i guiden i steg 3 och har sparat i rules-filen MEN det som ska komma ut som svar i den sista punkten kommer inte utan det står bara att zwave inte hittas.

    Kör Hassbian och har laddat in supporten för Zwave via hassbian-config. Var det ett misstag kanske?

  • Hej!
    Jättebra guide! Jag har en fråga bara: Går det att få bort den sista ”_switch” i entity ID? t.ex switch.framsida_switch Jag försökte ändra namn men fick istället bara duplicerade

    • Tack! 🙂 Tyvärr går det inte, inte på något enkelt sätt i alla fall, så vitt jag vet. Ska undersöka frågan närmare, kanske går det att trixa till det via t.ex. REST API. Återkommer!

  • Så nära, men inte funkade inte riktigt ända fram för mig.

    Jag har slutfört hela Steg 3, får exakt samma resultat som i guiden. Lyckas ”verifiera att jag gjort rätt”.

    Hoppade först över Steg 4, och får bara ”Invalid Config” i Home Assistant. Efter många försök så försöker jag med Steg 4 för att säkerställa att jag kan kommunicera med Z-stick, upptäcker då att inte det heller fungerar. Får dock exakt samma resultat i terminalen som det blir i skärmdumparna i guiden.

    Förslag på hur jag går tillväga med fortsatt felsökning?

    • Hej! Ska gå igenom guiden själv om några dagar och återkommer om jag hittar något som har blivit fel under tiden.

    • Har tyvärr inte en Mac, så kan inte göra några guider på den. Men i och med att Mac är i grund och botten Unix-baserad, borde det inte vara någon jättestor skillnad, eller?

    • Hass.io och Home Assistant är tyvärr två helt olika saker. Har du Home Assistant (Hassbian eller AIO) så bör den funka. Har du hass.io (se den här guiden) så kan den funka annorlunda eller inte alls, har inte haft möjlighet att testa själv än.

  • Svara mig själv ; )

     

    Jag lyckades få in Z stick i Hass.io.

     

    Stoppade i usb stickan, öppnade config.yaml filen, la till

    zwave:
      usb_path: /dev/zwave
    
    sparade filen, startade om homeassistant och sen följde jag din guide i att lägga till enheter.
    Funkade kanon!
    
    Tack igen för grym blogg!!!!
    • Hittade mitt eget fel. I bilden ser jag att det ska vara snedstreck, det stod inte med i texten så jag missade det:)

    • Bra upptäckt. Fick inte heller det steget att fungera så jag fick flytta stickan till min windowsburk och köra med Aeons eget verktyg för att släcka den irriterande lampan. Nu vet jag iaf vad som var fel om jag skulle vilja slå på den igen. 

  • Hei

    I stedet for å bruke ”udevadm” kommando, er det bare å skrive ”lsusb”.

    Da vises ID for Aeon z-stick. Se etter ”Sigma Designs, Inc.” Dette er navnet på z-wave chip produsent.

    Info som vises er etc. Bus 001 Device 012: ID 0658:0200 Sigma Designs, Inc.

    Enkelt 🙂

  • Vad tyckte du om guiden? Funkade allt så som du förväntade dig? Stötte du på några problem? Lämna en kommentar!

    keyboard_arrow_up