Opis techniczny działania zigbee2mqtt na bramce AIS dom
zigbee2mqtt to program napisany w serwerowym JavaScript → node.js
Czym jest node.js opisujemy tu:
tu jest też opis jak napisać pierwszy własny program w node.js
Lokalizacja zigbee2mqtt na bramce
zigbee2mqtt znajduje się na bramce w katalogu domowym użytkownika AIS (przedstawiany w Linux symbolem ~
i zmienną środowiskową $HOME
)
Przejście do folderu z zigbee2mqtt to komenda w konsoli:
cd ~/zigbee2mqtt
Konfiguracja
konfiguracyja dostępna jest w pliku ~/zigbee2mqtt/data/configuration.yaml
nasza bazowa konfiguracja to:
homeassistant: true
permit_join: false
mqtt:
base_topic: zigbee2mqtt
server: 'mqtt://localhost'
serial:
port: /dev/ttyACM0
advanced:
log_level: info
log_output:
- console
opcje konfiguracji opisane są tu:
Aktualizacja
Na bieżąco automatycznie aktualizujemy zigbee2mqtt do najnowszej stabilnej wersji dostępnej w serwisie GitHub, w którym projekt ten jest rozwijany. Na dzień dzisiejszy (08/08/2020) ta wersja to 1.4.2
Procedura aktualizacji sprowadza się do wykonania następujących kroków:
- przejście do folderu ~/zigbee2mqtt
cd ~/zigbee2mqtt
- pobranie z repozytorium git (projektu zigbee2mqtt) pliku pakietów node.js
git checkout HEAD -- npm-shrinkwrap.json
- instalacja pakietów node.js dla zigbee2mqtt
npm ci
- restart procesu zigbee
pm2 restart zigbee
Przjście na wersje DEV
jesteśmy na gałęzi master (stabilnej na której wydawane są wersje zigbee2mqtt)
można to sprawdzić w konsoli poleceniem
git show-branch --all
można pobrać wersję rozwojową lub zrobić forka projektu i przejść na własną wersję - gdy np. dodajemy nowe urządzenie którego nie obsługuje jeszcze ziegbe2mqtt
numer aktualnej wersji jest zapisany w pliku package.json
cat ~/zigbe2mqtt/package.json
gdy przejdziemy na wersję większą niż aktualnie stabilna to Asystent domowy uzna, że tak jest OK - nie będzie jej przywracał (aktualizacja działa w jedną stronę - do góry)
Oczywiście cały proces własnej aktualizacji można sobie zapisać w skrypcie bash, łącznie z backupem danych itd…
Na czas eksperymentów można wykonać kopię folderu ~/zigbee2mqtt i przywrócić ją jeżeli coś pójdzie nie tak. Jest też zawsze opcja pobrania domyślnych, najnowszych kodów i ustawieć system - reset: