Neko: Skillnad mellan sidversioner

Från Lysators datorhandbok, den ultimata referensen.
Hoppa till navigering Hoppa till sök
Ingen redigeringssammanfattning
(Lägg till instruktioner om hur Mosquitto är konfigurerat och hur man interagerar med en MQTT-broker)
 
(2 mellanliggande sidversioner av 2 användare visas inte)
Rad 52: Rad 52:
|-
|-
! Ansvarig root
! Ansvarig root
| littlefox
| kempe
|-
|-
! Driftstatus
! Driftstatus
Rad 58: Rad 58:
|}
|}
[[Category:Tjänsteservrar]]
[[Category:Tjänsteservrar]]

[[Category:Maskiner i drift]]
=== Zwave-js-ui ===
[[Kategori:FreeBSD]]
'''Zwave-js-ui går endast att komma åt via localhost på port 8091. För att ansluta måste man tunnla till neko. Zwave-js-ui körs i en docker container.'''
[[Kategori:Rack R2]]

Dörrlåsen i ` och ' är anslutna via Zwave-protokollet. För att ansluta till låsen används en Zwave-antenn ansluten via USB.

Zwave-ui-js är ett webbgränssnitt för att interagera med och konfigurera Zwave-enheter. För att säkert ansluta till låsen genereras ett antal nycklar som identifierar låsen och Zwave-antennen. Dessa finns under services/lyslock i pass.

==== Lägga till eller ta bort ett lås i Zwave-js-ui ====
Kalibrera smart-låset, se manual för låset.

I Zwave-js-ui: Control Panel -> Hamburgermeny i nedre högra hörnet -> Manage Nodes

Här kan du välja att lägga till ett nytt lås "inclusion" eller ta bort ett lås "exclusion".

==== Hantera Zwave scener ====
Zwave kallar tillstånd för scener.
För att lägga till en ny scen:

Scenes -> Skriv in namn i "New Scene" fältet -> klicka på "skicka" knappen. (Du kan även redigera en existerande scen).

Klicka på "New Scene" -> välj låset i listan av noder -> "value" ska vara "target_lock_mode" -> "target_mode" kan vara antingen "unsecured" eller "secured" beroende på vilken scen det är du bygger.

Vilka target modes som finns tillgängliga kan bero på vilken typ av lås som används.

==== Konfigurera Zwave-js-ui att ansluta till MQTT ====
Konfiguration görs under settings -> MQTT. Inställningarna beror på hur MQTT-brokern är konfigurerad. Se dokumentation och konfiguration för MQTT-brokern för att sätta dessa korrekt.

=== Konfiguration av Mosquitto (MQTT-broker) ===
Eclipse Mosquitto är den broker som används i systemet.

Konfigurationen finns i /etc/mosquitto/conf.d/config.conf

Det enda som sätts är lyssnar porten (listener) samt att vi använder en password file.

Lösenordet för lyslock användaren finns i pass under services/lyslock.

==== Interagera med låsen genom MQTT ====
Man ansluter till MQTT-brokern och skickar ett antal "argument" till en topic. I nuvarande konfiguration av systemet skickas numret på den scen som zwave-js-ui ska aktivera (ex. scen 3 för att låsa upp `) som ett argument till topic "zwave/_CLIENTS/ZWAVE_GATEWAY-zwave-js-ui/api/_activateScene/set"

För att se exempel på hur detta görs i kod se git-repot för lysadm-flask där paho-mqtt för python används för att ansluta till Mosquitto.

Nuvarande version från 14 september 2024 kl. 10.49

Funktion Tjänsteserver
Specialfunktion Lokallåsserver
Operativsystem Raspbian
Arkitektur arm64
Minne 1 GB
Moderkort Raspberry Pi 3
Namngiven efter Maneki-neko, lyckobringande katter som vinkar.
Placering Lysators lokal
SSH-fingeravtryck
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

neko.lysator.liu.se har följande SSH-fingeravtryck:
256 SHA256:plihhuH9IzCmRLqWa3rPB0lQCa2IzR9X4eAZ5FwoQxQ root@rpi3-20231109 (ECDSA)
256 SHA256:9ruhYyB4Ly1jV2TToBbkm99l5QblKfypCt8xY+H+Fn4 root@rpi3-20231109 (ED25519)
3072 SHA256:FIUUGYk/mFyyZ/xem0/W1Et1jOw15fgQE7t4xlQRARw root@rpi3-20231109 (RSA)
-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEETci4cPcl+ZcyiACiCkqKrhcKSD0FAmYpak4ACgkQCkqKrhcK
SD1GxA/9EO5/4KsOZxqpLl0KJ/aHvKD+XWxgSM9QRC4FMPuphJqs1yEGxCXqSYbg
/mhSsSu+ggg0kM6qL2jE4wM1nZpitTXneRFci8uI3+Zgf2a8mmsPDo7uhIaCTZX5
BaGomI+loWl+4l4OHoR90ShaHCmJ2J0xqNkU1jKQXg7EHffwevrCO7npTGw63i1+
zOSx9JXpMjKc6xcFaQP2ztkXZzEkE/oP9CId9HXIZLMZFRVZsBCW3Bem4Z2xOoOy
M25TB/yGaCLt8bgvWzuFRW5bAnEDR8+0InrNA8aG8k24kugXhvfLr+yTGswfakFw
zMTfOlzbulczstpwA9yUcV60i81f6xpQi8RyMT+7V83vphPl4zjS9lCYB5xIsZk6
P5CMVR638ZvuBNjA0cwbzxt8JL2C+2SP3gHSnSauUPNYhlAEw8W0fzj8j7+e/49Q
KGRkc7VAxopBnbTXhhJSKB7HnSpe1ZwT6tJZqMp6J9Ol4Ggbx0B7lTx3TRUPN+Ll
A4uj2LTcMIK++5elky+AdRNVVvRLksUCXJnb/R2mM4xlRvbDi0ns4jxH7mCoQO+b
cmfBbKS93LL/6w2ejS7S5WzVAFKt2SDBs3IjnpI97g4u5UySHy8OK4/97HwGj3S/
KuZFUS0ovXsmAYMk/7CpN5pito1Ie2Dj0WYvNcJj8JWLMpF5UMI=
=xOmh
-----END PGP SIGNATURE-----
Ansvarig root littlefox
Driftstatus I drift

Zwave-js-ui

Zwave-js-ui går endast att komma åt via localhost på port 8091. För att ansluta måste man tunnla till neko. Zwave-js-ui körs i en docker container.

Dörrlåsen i ` och ' är anslutna via Zwave-protokollet. För att ansluta till låsen används en Zwave-antenn ansluten via USB.

Zwave-ui-js är ett webbgränssnitt för att interagera med och konfigurera Zwave-enheter. För att säkert ansluta till låsen genereras ett antal nycklar som identifierar låsen och Zwave-antennen. Dessa finns under services/lyslock i pass.

Lägga till eller ta bort ett lås i Zwave-js-ui

Kalibrera smart-låset, se manual för låset.

I Zwave-js-ui: Control Panel -> Hamburgermeny i nedre högra hörnet -> Manage Nodes

Här kan du välja att lägga till ett nytt lås "inclusion" eller ta bort ett lås "exclusion".

Hantera Zwave scener

Zwave kallar tillstånd för scener. För att lägga till en ny scen:

Scenes -> Skriv in namn i "New Scene" fältet -> klicka på "skicka" knappen. (Du kan även redigera en existerande scen).

Klicka på "New Scene" -> välj låset i listan av noder -> "value" ska vara "target_lock_mode" -> "target_mode" kan vara antingen "unsecured" eller "secured" beroende på vilken scen det är du bygger.

Vilka target modes som finns tillgängliga kan bero på vilken typ av lås som används.

Konfigurera Zwave-js-ui att ansluta till MQTT

Konfiguration görs under settings -> MQTT. Inställningarna beror på hur MQTT-brokern är konfigurerad. Se dokumentation och konfiguration för MQTT-brokern för att sätta dessa korrekt.

Konfiguration av Mosquitto (MQTT-broker)

Eclipse Mosquitto är den broker som används i systemet.

Konfigurationen finns i /etc/mosquitto/conf.d/config.conf

Det enda som sätts är lyssnar porten (listener) samt att vi använder en password file.

Lösenordet för lyslock användaren finns i pass under services/lyslock.

Interagera med låsen genom MQTT

Man ansluter till MQTT-brokern och skickar ett antal "argument" till en topic. I nuvarande konfiguration av systemet skickas numret på den scen som zwave-js-ui ska aktivera (ex. scen 3 för att låsa upp `) som ett argument till topic "zwave/_CLIENTS/ZWAVE_GATEWAY-zwave-js-ui/api/_activateScene/set"

För att se exempel på hur detta görs i kod se git-repot för lysadm-flask där paho-mqtt för python används för att ansluta till Mosquitto.