nuki_hub
Nuki Hub 9.02
Der Zweck des Nuki Hub besteht darin, eine effiziente Möglichkeit zur Integration von Nuki-Geräten in eine lokale Home-Automation-Plattform zu bieten.
Die Nuki Hub-Software läuft auf einem ESP32-Modul und fungiert als Brücke zwischen Nuki-Geräten und einer Home-Automation-Plattform.
Es kommuniziert mit einem Nuki Lock und/oder Öffner über Bluetooth (BLE) und nutzt MQTT zur Integration mit anderen Systemen.
Es legt den Sperrzustand (und vieles mehr) über MQTT offen und ermöglicht das Ausführen von Befehlen wie Sperren und Entsperren sowie das Ändern der Nuki Lock/Opener-Konfiguration über MQTT.
Nuki Hub lässt sich nicht in die Nuki Mobile App integrieren, er kann sich nicht als Bridge in der offiziellen Nuki Mobile App registrieren.
Treten Sie uns gerne auf Discord bei: https://discord.gg/9nPq85bP4p
Unterstützte ESP32-Geräte:
Nicht unterstützte ESP32-Geräte:
Unterstützte Nuki-Geräte:
Ungetestet, aber wahrscheinlich unterstützt:
Unterstützte Ethernet-Geräte:
Als Alternative zu Wi-Fi (das auf jedem unterstützten ESP32 verfügbar ist) werden die folgenden ESP32-Module mit integriertem kabelgebundenem Ethernet unterstützt:
Grundsätzlich werden alle ESP32-Geräte (und Varianten) mit integriertem Ethernet-Port unterstützt, erfordern jedoch möglicherweise eine zusätzliche Einrichtung mithilfe der Option „Benutzerdefiniertes LAN-Setup“. Weitere Informationen finden Sie im Abschnitt „Verbindung über Ethernet herstellen“.
Wenn WIFI6 unbedingt erforderlich ist: ESP32-C6
Wenn PoE erforderlich ist: Jedes der oben genannten Geräte mit PoE oder ein anderes ESP-Gerät in Kombination mit einem SPI-Ethernet-Modul (W5500) und einem PoE-zu-Ethernet- und USB-Typ-B/C-Splitter
Wenn Sie maximale Leistung wünschen und eine oder mehrere der folgenden Aktionen ausführen möchten:
Ein ESP32-S3 mit 2 MB PSRAM oder mehr (suchen Sie nach einem ESP32-S3 mit der Bezeichnung N>=4 und R>=2, z. B. einem ESP32-S3 N16R8)
Im Allgemeinen beim Kauf eines neuen Geräts, wenn Größe und ein paar Dollar mehr oder weniger keine Rolle spielen: Ein ESP32-S3 mit 2 MB PSRAM oder mehr.
Der ESP32-S3 ist eine Dual-Core-CPU mit vielen GPIOs, der Möglichkeit, den Arbeitsspeicher mithilfe von PSRAM zu vergrößern, der Möglichkeit, Ethernet-Module über SPI anzuschließen und das Gerät optional mit einem PoE-Splitter mit Strom zu versorgen. Die einzigen Funktionen, die dem ESP32-S3 im Vergleich zu anderen ESP-Geräten fehlen, sind die Möglichkeit, einige Ethernet-Module zu verwenden, die nur vom ursprünglichen ESP32 unterstützt werden, und die Möglichkeit, eine Verbindung über WIFI6 (C6) herzustellen.
| Besonderheit | Nuki Hub | Nuki-Brücke |
|---|---|---|
| Bridge-API | X | |
| Smart Lock-Fernbedienung | X | X |
| Smart Home-Integration über Matter | X | |
| Apple HomeKit-Integration über Matter | X | |
| MQTT-API | X | x (nur für die Modelle SL 3, 4 und 4 Pro) |
| Unterstützung für kabelgebundenes LAN | X | |
| Power over Ethernet (PoE) | x (sofern vom LAN/ESP-Modul unterstützt) | |
| WLAN-Unterstützung | X | x (nur für SL 3 und 4 Pro-Modelle) |
| Integration der Home-Automation-Plattform | X | X |
| Cloud-Unterstützung | x (optional über Smarthome-Lösung) | X |
| Cloudloser Betrieb | X | x (seit FW 3.8.2) |
| Offizielle Nuki-App-Integration | X | |
| Nuki Smartlocks alle Modelle | X | X |
| Nuki-Opener | X | X |
| Nuki Keypad (1.0 und 2.0) | X | X |
| MQTT-Verschlüsselung | X | |
| Fein abgestimmte Zugriffskontrolle der MQTT-API | X | |
| Export von Sperraktionen über die MQTT-API | X | |
| Steuerung über GPIO | X | |
| Hybridmodus für WiFI- und Thread-verbundene Schlösser | X |
Wenn du dein Nuki-Produkt noch nicht bestellt hast, kannst du mich unterstützen, indem du bei deiner Bestellung meinen Empfehlungscode verwendest:
REF2BJHFVHZKK
Dadurch erhalten Sie außerdem 10 % Rabatt auf Ihre Bestellung.
Die Nutzung dieses Projekts ist für jedermann kostenlos. Wenn Sie jedoch Lust haben zu spenden, können Sie mir auf ko-fi.com einen Kaffee spendieren:
Flashen Sie die Firmware auf einen ESP32. Der einfachste Weg zur Installation ist die Verwendung des Web-Installers mit einem kompatiblen Browser wie Chrome/Opera/Edge:
https://technyon.github.io/nuki_hub/
HINWEIS: Webflash ist für den ESP32-Solo1 nicht verfügbar
Alternativ können Sie die neueste Version für Ihr ESP32-Modell von https://github.com/technyon/nuki_hub/releases herunterladen
Entpacken Sie das Zip-Archiv und lesen Sie die beigefügte how-to-flash.txt, um Installationsanweisungen für „Espressif Flash Download Tools“ oder „esptool“ zu erhalten.
Schalten Sie den ESP32 ein und ein neuer WLAN-Zugangspunkt namens „NukiHub“ sollte erscheinen.
Das Passwort des Zugangspunkts lautet „NukiHubESP32“.
Verbinden Sie ein Client-Gerät mit diesem Zugangspunkt und navigieren Sie in einem Browser zu „http://192.168.4.1“.
Verwenden Sie die Webschnittstelle, um das ESP mit Ihrem bevorzugten WLAN-Netzwerk zu verbinden.
Nach der WLAN-Konfiguration sollte sich der ESP automatisch mit Ihrem Netzwerk verbinden.
Um die Verbindung zum MQTT-Broker zu konfigurieren, verbinden Sie zunächst Ihr Client-Gerät mit demselben Wi-Fi-Netzwerk, mit dem der ESP32 verbunden ist.
Navigieren Sie in einem Browser zu der IP-Adresse, die dem ESP32 über DHCP zugewiesen wurde (häufig in der Weboberfläche Ihres Internet-Routers zu finden).
Klicken Sie anschließend unter „MQTT-Konfiguration“ auf „Bearbeiten“ und geben Sie die Adresse und den Port (normalerweise 1883) Ihres MQTT-Brokers sowie einen Benutzernamen und ein Passwort ein, falls Ihr MQTT-Broker dies verlangt.
Die Firmware unterstützt SSL-Verschlüsselung für MQTT, die meisten Menschen und insbesondere Privatanwender verwenden diese jedoch nicht.
Lassen Sie in diesem Fall alle Felder, die mit „MQTT SSL“ beginnen, leer. Ansonsten lesen Sie den Abschnitt „MQTT-Verschlüsselung“ dieser README-Datei.
Stellen Sie sicher, dass „Bluetooth-Pairing“ für das Nuki-Gerät aktiviert ist, indem Sie diese Einstellung in der offiziellen Nuki-App unter „Einstellungen“ > „Funktionen & Konfiguration“ > „Taste und LED“ aktivieren. Nachdem Sie die Einstellung aktiviert haben, drücken Sie einige Sekunden lang die Taste am Nuki-Gerät.
Das Pairing sollte automatisch erfolgen, wenn der ESP32 eingeschaltet wird.
Wenn das Pairing erfolgreich war, sollte auf der Weboberfläche „Paired: Yes“ angezeigt werden.
MQTT-Knoten wie Sperrstatus und Batteriestand sollten nun die gemeldeten Werte der Sperre widerspiegeln.
Hinweis: Es ist möglich, Nuki Hub neben einer Nuki Bridge zu betreiben. Dies wird nicht empfohlen (außer bei Verwendung des Hybridmodus) und führt zu einer übermäßigen Batterieentladung und kann dazu führen, dass bei beiden Geräten Updates fehlen. Aktivieren Sie vor dem Koppeln „Als App registrieren“, um dies zu ermöglichen. Andernfalls wird die Bridge beim Koppeln mit dem Nuki Hub abgemeldet.
Der Hybrid-Modus ermöglicht die Nutzung der offiziellen Nuki MQTT-Implementierung auf einem Nuki Lock 3.0 Pro, Nuki Lock 4.0 oder Nuki Lock 4.0 Pro in Verbindung mit dem Nuki Hub.
Weitere Informationen finden Sie im Hybridmodus.
ESP32-Geräten steht nur eine begrenzte Menge an freiem RAM zur Verfügung.
Bei Version 9.01 des Nuki Hub mit nur angeschlossenem Nuki Lock liegt die erwartete freie Menge an verfügbarem RAM/Heap bei etwa:
Diese freie Menge an RAM kann (vorübergehend) durch bestimmte Aktionen (z. B. Änderung der Nuki-Gerätekonfiguration) oder kontinuierlich reduziert werden, wenn Folgendes aktiviert wird:
Den aktuell verfügbaren RAM/Heap finden Sie auf der Infoseite des Web-Konfigurators von Nuki Hub.
Wenn dem ESP32 der verfügbare RAM ausgeht, kann dieses Gerät abstürzen oder ein anderes unerwartetes Verhalten auftreten.
Nuki Hub ermöglicht die Verwendung von eingebettetem PSRAM auf den regulären Binärdateien, wann immer es verfügbar ist.
PSRAM ist in der Regel 2, 4 oder 8 MB groß und vergrößert damit die verfügbaren 320 KB internen RAM erheblich.
Es ist grundsätzlich unmöglich, dass der Arbeitsspeicher knapp wird, wenn PSRAM verfügbar ist. Ob PSRAM verfügbar ist, können Sie auf der Infoseite des Web-Konfigurators prüfen.
Beachten Sie, dass es zwei Builds des Nuki Hub für den ESP32-S3 gibt.
Eines für Geräte ohne oder Quad-SPI-PSRAM und eines für Geräte mit Octal-SPI-PSRAM.
Wenn Ihr ESP32-S3-Gerät über PSRAM verfügt, es aber nicht erkannt wird, flashen Sie bitte die andere S3-Binärdatei.
Navigieren Sie in einem Browser zu der IP-Adresse, die dem ESP32 zugewiesen ist.
Der Menüpunkt „Konfiguration importieren/exportieren“ ermöglicht den Import und Export der NukiHub-Einstellungen im JSON-Format.
Erstellen Sie eine (Teil-)Sicherung der aktuellen NukiHub-Einstellungen, indem Sie eine der folgenden Optionen auswählen:
Bei beiden oben genannten Optionen werden keine Kopplungsdaten gesichert, daher müssen Sie Nuki-Geräte manuell koppeln, wenn Sie diesen Export auf ein auf die Werkseinstellungen zurückgesetztes oder neues Gerät importieren.
So ändern Sie die Einstellungen für die Nuki -Sperr-/Opener das configuration/action in einem von den folgenden Einstellungen angegebenen Wert von JSON -Formatierungen. Mehrere Einstellungen können gleichzeitig geändert werden. Weitere Informationen zu den verfügbaren Einstellungen finden Sie in Nuki Smart Lock API Basic Config, Nuki Smart Lock API Advanced Config, Nuki Opener API Basic Config und Nuki Opener API Advanced Config.
Das Ändern der Einstellungen muss zunächst im Konfigurationsportal aktiviert werden. Überprüfen Sie die Einstellungen, die Sie unter "Nuki Lock/Opener Config Control" in der "Zugriffsebenekonfiguration" ändern möchten, und speichern Sie die Konfiguration.
| Einstellung | Verwendung | Mögliche Werte | Beispiel |
|---|---|---|---|
| Name | Der Name des Smart Lock. | Alphanumerische Schnur, maximale Länge 32 Zeichen | { "name": "Frontdoor" } |
| Breite | Der Breitengrad der Smart Locks Geoposition. | Schweben | { "latitude": "48.858093" } |
| Länge | Die Länge der Smart Locks Geoposition | Schweben | { "longitude": "2.294694" } |
| Autounlatch | Ob die Tür durch manuelles Betrieb eines Türgriffs von außen ausgeschlossen wird oder nicht. | 1 = aktiviert, 0 = deaktiviert | { "autoUnlatch": "1" } |
| pairingEnabled | Ob die Aktivierung des Paarungsmodus über Taste aktiviert wird oder nicht, sollte aktiviert werden. | 1 = aktiviert, 0 = deaktiviert | { "pairingEnabled": "0" } |
| ButtonEnabled | Ob die Taste aktiviert werden sollte oder nicht. | 1 = aktiviert, 0 = deaktiviert | { "buttonEnabled": "1" } |
| Ledenabled | Ob die blinkende LED aktiviert sein sollte oder nicht, um eine ungeschlossene Tür zu signalisieren. | 1 = aktiviert, 0 = deaktiviert | { "ledEnabled": "1" } |
| Ledbrightness | Die LED -Helligkeitsstufe | 0 = off,…, 5 = max | { "ledBrightness": "2" } |
| Zeitzoneoffset | Der Timezone -Offset (UTC) in Minuten | Ganzzahl zwischen 0 und 60 | { "timeZoneOffset": "0" } |
| dstmode | Der gewünschte Sommerzeitmodus. | 0 = deaktiviert, 1 = Europäer | { "dstMode": "0" } |
| FOBACTION1 | Die gewünschte Aktion, wenn ein Nuki -FOB einmal gedrückt wird. | "Keine Action", "freischalten", "Lock", "Lock n Go", "intelligent" | { "fobAction1": "Lock n Go" } |
| FOBACTION2 | Die gewünschte Aktion, wenn ein Nuki -FOB zweimal gedrückt wird. | "Keine Action", "freischalten", "Lock", "Lock n Go", "intelligent" | { "fobAction2": "Intelligent" } |
| FOBACTION3 | Die gewünschte Aktion, wenn ein Nuki -FOB dreimal gedrückt wird. | "Keine Action", "freischalten", "Lock", "Lock n Go", "intelligent" | { "fobAction3": "Unlock" } |
| Singlelock | Ob nur ein einzelnes Schloss oder eine Doppelschloss durchgeführt werden sollte | 0 = Doppelschloss, 1 = Einzelschloss | { "singleLock": "0" } |
| Werbungmode | Der gewünschte Werbemodus. | "Automatisch", "normal", "langsam", "langsamste" | { "advertisingMode": "Normal" } |
| Zeitzone | Die aktuelle Zeitzone oder "keine", wenn Timezones nicht unterstützt werden | "Keine" oder eines der Zeitzonen von Nuki Timezones | { "timeZone": "Europe/Berlin" } |
| entsperrtePositionOffsetDegrees | Versatz, der die entsperrte Position in Grad verändert. | Ganzzahl zwischen -90 und 180 | { "unlockedPositionOffsetDegrees": "-90" } |
| LockedPositionOffsetDegrees | Versatz, der die verschlossene Position in Grad verändert. | Ganzzahl zwischen -180 und 90 | { "lockedPositionOffsetDegrees": "80" } |
| EinzelpositionierpositionOffsetDegrees | Versatz, der die einzelne gesperrte Position in Grad verändert. | Ganzzahl zwischen -180 und 180 | { "singleLockedPositionOffsetDegrees": "120" } |
| entsperredTolockedTransitionOffsetDegrees | Offset, der die Position verändert, in der der Übergang von freigeschaltet zu gesperrt ist, erfolgt in Grad. | Ganzzahl zwischen -180 und 180 | { "unlockedToLockedTransitionOffsetDegrees": "180" } |
| LockkngoTimeout | Zeitüberschreitung für Lock 'n' in Sekunden | Ganzzahl zwischen 5 und 60 | { "lockNgoTimeout": "60" } |
| Einzelbuttonpression | Die gewünschte Aktion, wenn die Taste einmal gedrückt wird. | "Keine Action", "intelligent", "entsperren", "lock", "unpatch", "lock n go", "Status zeigen" | { "singleButtonPressAction": "Lock n Go" } |
| DoubleButtonpression | Die gewünschte Aktion, wenn die Taste zweimal gedrückt wird. | "Keine Action", "intelligent", "entsperren", "lock", "unpatch", "lock n go", "Status zeigen" | { "doubleButtonPressAction": "Show Status" } |
| Ablagerung | Wenn die innere Seite des gebrauchten Zylinders von der Außenseite abgelöst wird. | 0 = nicht abgelöst, 1 = abgelöst | { "detachedCylinder": "1" } |
| Akku-Typ | Die Art der Batterien im Smart Lock. | "Alkali", "Akkumulatoren", "Lithium" | { "batteryType": "Accumulators" } |
| AutomatikbatterieDeTection | Ob die automatische Erkennung des Batteriestyps aktiviert ist. | 1 = aktiviert, 0 = deaktiviert | { "automaticBatteryTypeDetection": "Lock n Go" } |
| Ablagerung | Dauer in Sekunden zum Halten des Riegels in der nicht schatmen Position. | Ganzzahl zwischen 1 und 30 | { "unlatchDuration": "3" } |
| Autolocktimeout | Sekunden, bis sich die Smart Lock selbst nach dem Entsperren entsperren. | Ganzzahl zwischen 30 und 1800 | { "autoLockTimeOut": "60" } |
| AutounlockDisabled | Ob die automatische Entsperrung im Allgemeinen deaktiviert werden sollte. | 1 = automatische Entsperren deaktiviert, 0 = automatische Entsperren aktiviert | { "autoUnLockDisabled": "1" } |
| nightmodeenabled | Ob Nightmode aktiviert ist. | 1 = aktiviert, 0 = deaktiviert | { "nightModeEnabled": "1" } |
| NightmodestartTime | Startzeit für NightMode, falls aktiviert. | Zeit im Format "HH: MM" | { "nightModeStartTime": "22:00" } |
| NightModeendTime | Endzeit für NightMode, falls aktiviert. | Zeit im Format "HH: MM" | { "nightModeEndTime": "07:00" } |
| NightModeAutolarenabled | Ob das automatische Schloss während des Albums aktiviert werden sollte. | 1 = aktiviert, 0 = deaktiviert | { "nightModeAutoLockEnabled": "1" } |
| nightmodeAtounlockdisabled | Ob automatische Entsperren während des Albums deaktiviert werden sollten. | 1 = automatische Entsperren deaktiviert, 0 = automatisches Entsperren aktiviert | { "nightModeAutoUnlockDisabled": "1" } |
| NightModeimmediatelockonstart | Ob die Tür sofort auf den Nightmode -Start eingesperrt sein sollte. | 1 = aktiviert, 0 = deaktiviert | { "nightModeImmediateLockOnStart": "1" } |
| autolarenabbart | Ob Auto Lock aktiviert ist. | 1 = aktiviert, 0 = deaktiviert | { "autoLockEnabled": "1" } |
| unmittelbarautolarenabled | Ob automatische Schloss unmittelbar nach der Schließung der Tür durchgeführt werden sollte. | 1 = aktiviert, 0 = deaktiviert | { "immediateAutoLockEnabled": "1" } |
| autoupDateEnabled | Ob automatische Firmware -Updates aktiviert sein sollten. | 1 = aktiviert, 0 = deaktiviert | { "autoUpdateEnabled": "1" } |
| Neustartnuki | Starten Sie das Nuki -Gerät sofort neu | 1 = Nuki neu starten | { "rebootNuki": "1" } |
| Einstellung | Verwendung | Mögliche Werte | Beispiel |
|---|---|---|---|
| Name | Der Name des Opener. | Alphanumerische Schnur, maximale Länge 32 Zeichen | { "name": "Frontdoor" } |
| Breite | Der Breitengrad der Opener Geoposition. | Schweben | { "latitude": "48.858093" } |
| Länge | Die Länge der Opener Geoposition | Schweben | { "longitude": "2.294694" } |
| pairingEnabled | Ob die Aktivierung des Paarungsmodus über Taste aktiviert wird oder nicht, sollte aktiviert werden. | 1 = aktiviert, 0 = deaktiviert | { "pairingEnabled": "0" } |
| ButtonEnabled | Ob die Taste aktiviert werden sollte oder nicht. | 1 = aktiviert, 0 = deaktiviert | { "buttonEnabled": "1" } |
| ledflashenabled | Ob die blinkende LED aktiviert werden sollte oder nicht, um CM oder RTO zu signalisieren. | 1 = aktiviert, 0 = deaktiviert | { "ledFlashEnabled": "1" } |
| Zeitzoneoffset | Der Timezone -Offset (UTC) in Minuten | Ganzzahl zwischen 0 und 60 | { "timeZoneOffset": "0" } |
| dstmode | Der gewünschte Sommerzeitmodus. | 0 = deaktiviert, 1 = Europäer | { "dstMode": "0" } |
| FOBACTION1 | Die gewünschte Aktion, wenn ein Nuki -FOB einmal gedrückt wird. | "Keine Aktion", "RTO", "Aktivieren Sie RTO", "deaktivieren Sie RTO", "Öffnen", "Ring" | { "fobAction1": "Toggle RTO" } |
| FOBACTION2 | Die gewünschte Aktion, wenn ein Nuki -FOB zweimal gedrückt wird. | "Keine Aktion", "RTO", "Aktivieren Sie RTO", "deaktivieren Sie RTO", "Öffnen", "Ring" | { "fobAction2": "Open" } |
| FOBACTION3 | Die gewünschte Aktion, wenn ein Nuki -FOB dreimal gedrückt wird. | "Keine Aktion", "RTO", "Aktivieren Sie RTO", "deaktivieren Sie RTO", "Öffnen", "Ring" | { "fobAction3": "Ring" } |
| operatingMode | Der gewünschte Betriebsmodus | "Generic Door Opener", "Analogue Intercom", "Digital Intercom", "Siedle", "TCS", "Bticino", "Siedle Hts", "Str", "Ritto", "Fermax", "Comelit", ",", ",", ",", ",", ",", ",", ",", ",", ",", ",", ",", ",", ",", " Urmet Bibus "," Urmet 2Voice "," Golmar "," SKS "," Spare " | { "operatingMode": "TCS" } |
| Werbungmode | Der gewünschte Werbemodus. | "Automatisch", "normal", "langsam", "langsamste" | { "advertisingMode": "Normal" } |
| Zeitzone | Die aktuelle Zeitzone oder "keine", wenn Timezones nicht unterstützt werden | "Keine" oder eines der Zeitzonen von Nuki Timezones | { "timeZone": "Europe/Berlin" } |
| Intercomid | Datenbank -ID der Connected Intercom. | Ganze Zahl | { "intercomID": "1" } |
| busmodeswitch | Methode zum Umschalten zwischen Daten und Analogemodus | 0 = keine, 1 = Vshortschaltung | { "busModeSwitch": "0" } |
| ShortcircuitDuration | Dauer des Kurzschlusses für das Schalten des Busmodus in MS. | Ganze Zahl | { "shortCircuitDuration": "250" } |
| ElectricStrikedelay | Verzögerung der MS der Aktivierung der elektrischen Streiks im Falle einer elektrischen Streikbeturung durch RTO | Ganzzahl zwischen 0 und 30000 | { "electricStrikeDelay": "2080" } |
| randomElectricStrikedelay | Zufällige Verzögerung (3-7s), um eine Person im Inneren des elektrischen Streiks zu simulieren. | 1 = aktiviert, 0 = deaktiviert | { "randomElectricStrikeDelay": "1" } |
| Elektrikstrikeduration | Dauer bei MS der Betätigung des elektrischen Streiks. . | Ganzzahl zwischen 1000 und 30000 | { "electricStrikeDuration": "5000" } |
| disablToafterring | Ob RTO nach Ring deaktiviert werden soll. | 1 = Deaktivieren Sie RTO nach dem Ring, 0 = Deaktivieren Sie RTO nach dem Ring nicht | { "disableRtoAfterRing": "0" } |
| rtotimeout | Nach dieser Zeit in Minuten wird RTO automatisch deaktiviert | Ganzzahl zwischen 5 und 60 | { "rtoTimeout": "60" } |
| Türklingel -Suppression | Ob die Türklingel unterdrückt wird, wenn Ring, CM und/oder RTO aktiv sind | "Off", "CM", "RTO", "CM & RTO", "Ring", "CM & Ring", "RTO & Ring", "CM & rto & Ring" | { "doorbellSuppression": "CM & Ring" } |
| Türklingel -Suppressionduration | Dauer in MS der Türklingelunterdrückung. | Ganzzahl zwischen 500 und 10000 | { "doorbellSuppressionDuration": "2000" } |
| klang | Der Ringgeräusch | "No Sound", "Sound 1", "Sound 2", "Sound 3" | { "soundRing": "No Sound" } |
| Soundopen | Der offene Klang. | "No Sound", "Sound 1", "Sound 2", "Sound 3" | { "soundOpen": "Sound 1" } |
| Soundrto | Der RTO -Sound. | "No Sound", "Sound 1", "Sound 2", "Sound 3" | { "soundRto": "Sound 2" } |
| SoundCM | Der CM -Sound. | "No Sound", "Sound 1", "Sound 2", "Sound 3" | { "soundCm": "Sound 3" } |
| SoundConfirmation | Schallbestätigung | 0 = kein Ton, 1 = Ton | { "soundConfirmation": "1" } |
| Soundlevel | Der Klangpegel für den Opener | Ganzzahl zwischen 0 und 255 | { "soundLevel": "200" } |
| Einzelbuttonpression | Die gewünschte Aktion, wenn die Taste einmal gedrückt wird. | "Keine Aktion", "RTO", "Aktivieren Sie RTO aktivieren", "deaktivieren Sie RTO", "Toggle CM", "Aktivieren Sie CM", "deaktivieren cm", "offen", "offen". | { "singleButtonPressAction": "Open" } |
| DoubleButtonpression | Die gewünschte Aktion, wenn die Taste zweimal gedrückt wird. | "Keine Aktion", "RTO", "Aktivieren Sie RTO aktivieren", "deaktivieren Sie RTO", "Toggle CM", "Aktivieren Sie CM", "deaktivieren cm", "offen", "offen". | { "doubleButtonPressAction": "No Action" } |
| Akku-Typ | Die Art der Batterien im Smart Lock. | "Alkali", "Akkumulatoren", "Lithium" | { "batteryType": "Accumulators" } |
| AutomatikbatterieDeTection | Ob die automatische Erkennung des Batteriestyps aktiviert ist. | 1 = aktiviert, 0 = deaktiviert | { "automaticBatteryTypeDetection": "1" } |
| Neustartnuki | Starten Sie das Nuki -Gerät sofort neu | 1 = Nuki neu starten | { "rebootNuki": "1" } |
Beispiel Verwendung zum Ändern mehrerer Einstellungen gleichzeitig:
{ "buttonEnabled": "1", "lockngoTimeout": "60", "automaticBatteryTypeDetection": "1" }{ "fobAction1": "Unlock", "fobAction2": "Intelligent", "nightModeImmediateLockOnStart": "1" } Das Ergebnis der letzten Aktion zur Änderung der Konfiguration wird im Thema configuration/commandResult MQTT als JSON -Daten veröffentlicht.
Die JSON -Daten enthalten einen Knoten namens "allgemein" und einen Knoten für jede Einstellung, die Nuki Hub in der Aktion erkannt hat.
Mögliche Werte für den "allgemeinen" Knoten sind "Novalidpinset", "InvalyJson", "InvalidConfig", "Erfolg" und "Nochange".
Mögliche Werte für den Knoten pro Einstellung sind "unverändert", "Novalueset", "InvalyValue", "Valuetoolong", "AccessDenied", "Erfolg", "fehlgeschlagen", "Timeout", "Arbeiten", "Notpaired", "Fehler", "Fehler", "Fehler "und" undefiniert "
Beispiel:
{"advertisingMode":"success","general":"success"}Wenn der Home -Assistant -Entdeckung aktiviert ist (siehe Abschnitt zur Entdeckung des Home -Assistants dieses Readme), schafft Nuki Hub für fast alle oben genannten Einstellungen Einheiten.
Nach der ersten Installation der Nuki Hub -Firmware über serielle Verbindung können weitere Aktualisierungen über OTA -Update von einem Browser bereitgestellt werden.
Wählen Sie im Konfigurationsportal "Firmware -Update" auf der Hauptseite.
Der einfachste Weg, um Nuki Hub zu verbessern, wenn Nuki Hub mit dem Internet verbunden ist, besteht darin, "Aktualisieren der neuesten Version" auszuwählen.
Dadurch wird der neueste Nuki Hub und Nuki Hub Updater heruntergeladen und beide Anwendungen automatisch aktualisiert.
Nuki Hub startet während dieses Prozesses dreimal neu, was etwa 5 Minuten dauert.
Wenn Sie aktiviert haben, dass "Aktualisierung mit MQTT zulassen" können, können Sie auch den Home -Assistant Updater verwenden oder "1" in das Thema nukihub/maintanance/update schreiben, um den Aktualisierungsprozess zu starten.
Alternativ können Sie eine Binärdatei aus Ihrem Dateisystem auswählen, um den Nuki Hub oder den Nuki Hub Updator manuell zu aktualisieren
Sie können Nuki Hub nur vom Nuki Hub Updater aktualisieren und den Updater nur von Nuki Hub aktualisieren
Sie können von Nuki Hub in den Updater neu starten und umgekehrt, indem Sie die Option Neustart auf der Seite "Firware -Update" auswählen
Wenn Sie sich in der richtigen Anwendung befinden, können Sie die neue Binärdatei hochladen, indem Sie auf "Durchsuchen" klicken und das neue "nuki_hub [board] .bin" oder "nuki_hub_updater [board] .bin" -Datei "auswählen und" hochladen ".
Nach ungefähr einer Minute sollte die neue Firmware nach dem ESP automatisch in die aktualisierte Binärdatei installiert werden.
Die Auswahl des falschen Binärs führt zu einem erfolglosen Update
Hinweis für Benutzer, die von Nuki Hub 8.35 oder niedriger aufrüsten:
Die Aktualisierung von Version 9.00 erfordert eine Änderung der Partitionstabelle des ESP32.
Bitte befolgen Sie die Anweisungen zum ersten Mal einmal bei der Aktualisierung von Nuki Hub 9.00 aus einer früheren Version.
Ihre Einstellungen werden bei der Aktualisierung der oben genannten Anweisungen nicht beeinflusst (wählen Sie bei der Aktualisierung von Webflash nicht das ERASE -Gerät).
Die Kommunikation über MQTT kann SSL verschlüsselt werden.
Um die SSL -Verschlüsselung zu aktivieren, liefern Sie die erforderlichen Informationen auf der Seite MQTT -Konfiguration.
Die folgenden Konfigurationen werden unterstützt:
CA, Cert und Schlüssel sind leer -> keine Verschlüsselung
CA ist gefüllt, aber zertifiziert und der Schlüssel ist leer -> verschlüsselte MQTT
CA, Cert und Key werden gefüllt -> verschlüsselte MQTT mit dem Kunden Vaildation
Beispielzertifikaterstellung für Ihren MQTT -Server:
# make a ca key
openssl genpkey -algorithm RSA -out ca.key
# make a CA cert
openssl req -new -x509 -days 3650 -key ca.key -out ca.crt -subj "/C=US/ST=YourState/L=YourCity/O=YourOrganization/OU=YourUnit/CN=YourCAName"
# make a server key
openssl genpkey -algorithm RSA -out server.key
# Make a sign request, MAKE SURE THE CN MATCHES YOUR MQTT SERVERNAME
openssl req -new -key server.key -out server.csr -subj "/C=US/ST=YourState/L=YourCity/O=YourOrganization/OU=YourUnit/CN=homeserver.local"
# sign it
openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt -days 3650 Diese Software unterstützt MQTT Discovery für die Integration von Nuki Hub in Home Assistant.
Aktivieren Sie das Kontrollkästchen auf der Seite "MQTT -Konfiguration", um die Autodiscovery zu aktivieren.
Sobald es aktiviert ist, sollten die Nuki -Sperre und/oder der Opener und die zugehörigen Entitäten automatisch in Ihrem Home Assistant MQTT -Geräte angezeigt werden.
Die folgende Zuordnung zwischen Home Assistant Services und Nuki -Befehlen ist eingerichtet, wenn die Autodiscovery aktiviert ist:
| Smartlock | Opener (Standard) | Opener (Alternative) | |
|---|---|---|---|
| lock.lock | Sperren | Ring deaktivieren, um sie zu öffnen | Deaktivieren Sie den kontinuierlichen Modus |
| lock.unlock | Entsperren | Ring aktivieren, um sich zu öffnen | Aktivieren Sie den kontinuierlichen Modus |
| lock.open | Entriegeln | Betätigung der elektrischen Streik | Betätigung der elektrischen Streik |
HINWEIS: MQTT Discovery verwendet zurückhaltende MQTT -Nachrichten, um Gerätekonfigurationen zu speichern. Um Waisenkonfigurationen in Ihrem Broker zu vermeiden, deaktivieren Sie bitte zuerst die Autodiscovery, wenn Sie diese Software nicht mehr verwenden möchten. Rückhaltenachrichten werden beim Auspaarenden und beim Ändern/Deaktivieren von Autodiscovery -Thema auf der MQTT -Konfigurationsseite automatisch gelöscht.
Note2: Home Assistant kann manuell mit der MQTT -Sperre -Integration einrichten, dies wird jedoch nicht empfohlen
Wenn eine Tastatur mit dem Schloss verbunden ist, können Tastaturcodes hinzugefügt, aktualisiert und entfernt werden. Dies muss zuerst im Konfigurationsportal aktiviert werden. Überprüfen Sie "Tastaturcodes hinzufügen, ändern und löschen" unter "Zugriffsebenekonfiguration" und speichern Sie die Konfiguration.
Informationen zu aktuellen Tastaturcodes werden als JSON -Daten an das Thema "[Sperre/Opener]/Tastatur/JSON" veröffentlicht.
Dies muss separat aktiviert werden, indem "Tastatur -Codes -Informationen veröffentlichen" unter "Zugriffsebenekonfiguration" und Speichern der Konfiguration. Aus Sicherheitsgründen wird der Code selbst nicht veröffentlicht, es sei denn, dies ist in den Einstellungen von Nuki Hub explizit aktiviert. Standardmäßig werden maximal 10 Einträge veröffentlicht.
So ändern Sie Nuki Lock/Opener -Tastatureinstellungen Einstellungen für [lock/opener]/keypad/actionJson -Thema in einen von den folgenden Knoten enthaltenden JSON -Wert.
| Knoten | Löschen | Hinzufügen | Aktualisieren | Überprüfen | Verwendung | Mögliche Werte |
|---|---|---|---|---|---|---|
| Aktion | Erforderlich | Erforderlich | Erforderlich | Erforderlich | Die Aktion zur Ausführung | "Löschen", "Hinzufügen", "Update", "Check" |
| Codeid | Erforderlich | Nicht verwendet | Erforderlich | Erforderlich | Die Code -ID des vorhandenen Code zum Löschen oder Aktualisieren | Ganze Zahl |
| Code | Nicht verwendet | Erforderlich | Optional | Erforderlich | Der Code zum Erstellen oder Aktualisieren | 6-stellige Ganzzahl ohne Null, kann nicht mit "12" beginnen |
| ermöglicht | Nicht verwendet | Nicht verwendet | Optional | Nicht verwendet | Aktivieren oder deaktivieren Sie den Code, der immer aktiviert ist, wenn Sie hinzufügen | 1 = aktiviert, 0 = deaktiviert |
| Name | Nicht verwendet | Erforderlich | Optional | Nicht verwendet | Der Name des Code zum Erstellen oder Aktualisieren | String, max 20 Zeichen |
| zeitlich | Nicht verwendet | Optional | Optional | Nicht verwendet | Wenn diese Genehmigung nur zu bestimmten Zeiten auf den Zugriff beschränkt ist, erfordert aktiviert = 1 | 1 = aktiviert, 0 = deaktiviert |
| erlaubt aus | Nicht verwendet | Optional | Optional | Nicht verwendet | Der Startzeitstempel, aus dem der Zugriff zulässig sein sollte (erfordert aktiviert = 1 und Timelimited = 1) | "Yyyy-mm-dd HH: MM: SS" |
| erlaubt | Nicht verwendet | Optional | Optional | Nicht verwendet | Der Endstempel, bis der Zugriff zulässig ist (erfordert aktiviert = 1 und Zeitraffer = 1) | "Yyyy-mm-dd HH: MM: SS" |
| degetiertWeekdays | Nicht verwendet | Optional | Optional | Nicht verwendet | Wochentags, auf denen der Zugriff zulässig sein sollte (erfordert aktiviert = 1 und timelimited = 1) | Array von Tagen: "Mon", "Di", "Mi", "Thu", "Fr" "Sat", "Sonne" |
| erlaubt aus der Zeit | Nicht verwendet | Optional | Optional | Nicht verwendet | Die Startzeit pro Tag, aus der der Zugriff zulässig ist (erfordert aktiviert = 1 und Zeitraffer = 1) | "HH: MM" |
| erlaubt | Nicht verwendet | Optional | Optional | Nicht verwendet | Die Endzeit pro Tag, bis der Zugang zulässig ist (erfordert aktiviert = 1 und Zeitarbeit = 1) | "HH: MM" |
Beispiele:
{ "action": "delete", "codeId": "1234" }{ "action": "add", "code": "589472", "name": "Test", "timeLimited": "1", "allowedFrom": "2024-04-12 10:00:00", "allowedUntil": "2034-04-12 10:00:00", "allowedWeekdays": [ "wed", "thu", "fri" ], "allowedFromTime": "08:00", "allowedUntilTime": "16:00" }{ "action": "update", "codeId": "1234", "enabled": "1", "name": "Test", "timeLimited": "1", "allowedFrom": "2024-04-12 10:00:00", "allowedUntil": "2034-04-12 10:00:00", "allowedWeekdays": [ "mon", "tue", "sat", "sun" ], "allowedFromTime": "08:00", "allowedUntilTime": "16:00" } Das Ergebnis der letzten Aktion der Tastaturänderung wird im Thema [lock/opener]/configuration/commandResultJson MQTT veröffentlicht.
Possible values are "noValidPinSet", "keypadControlDisabled", "keypadNotAvailable", "keypadDisabled", "invalidConfig", "invalidJson", "noActionSet", "invalidAction", "noExistingCodeIdSet", "noNameSet", "noValidCodeSet", "noCodeSet" , "Invalidalowed von", "InvalaLalowedUntil", "InvalidalowedFromTime", "InvalaLalowededUntiltImale", "Erfolg", "fehlgeschlagen", "Timeout", "Working", "Notpaired", "Fehler" und "Undefiniert".
Wenn eine Tastatur mit dem Schloss verbunden ist, können Tastaturcodes hinzugefügt, aktualisiert und entfernt werden. Dies muss zuerst im Konfigurationsportal aktiviert werden. Überprüfen Sie "Tastaturcodes hinzufügen, ändern und löschen" unter "Zugriffsebenekonfiguration" und speichern Sie die Konfiguration.
Informationen zu Codes werden unter "Tastaturen/Code_x" veröffentlicht. Dies muss separat aktiviert werden, indem "Tastatur -Codes -Informationen veröffentlichen" unter "Zugriffsebenekonfiguration" und Speichern der Konfiguration. Standardmäßig werden maximal 10 Einträge veröffentlicht.
Aus Sicherheitsgründen wird der Code selbst nicht veröffentlicht, es sei denn, dies ist in den Einstellungen von Nuki Hub explizit aktiviert. Um Tastaturcodes zu ändern, wird eine Befehlsstruktur unter Tastatur/Befehl eingerichtet:
Um Tastaturcodes zu ändern, müssen die ersten vier Parameterknoten abhängig vom Befehl festgelegt werden:
** Hinweis: Regeln für Codes sind:
Schreiben Sie nach Einstellung der erforderlichen Parameter die Aktion, die in den Befehlsknoten ausgeführt werden soll. Zum Beispiel einen Code hinzufügen:
TimeControl -Einträge können hinzugefügt, aktualisiert und entfernt werden. Dies muss zuerst im Konfigurationsportal aktiviert werden. Überprüfen Sie die Zeitcontrol -Einträge hinzufügen, ändern, ändern und löschen "unter" Zugriffsebenekonfiguration "und speichern Sie die Konfiguration.
Informationen zu aktuellen TimeControl -Einträgen werden als JSON -Daten an das Thema "[Lock/Opener]/TimeControl/JSON" veröffentlicht.
Dies muss separat aktiviert werden, indem "TimeControl -Einträge Informationen veröffentlichen" unter "Zugriffsebenekonfiguration" und das Speichern der Konfiguration veröffentlichen. Standardmäßig werden maximal 10 Einträge veröffentlicht.
So ändern Sie Nuki Lock/Opener TimeControl -Einstellungen Einstellungen Setzen Sie den [lock/opener]/timecontrol/actionJson -Thema in einen von den folgenden Knoten enthaltenden Wert für JSON -Formatierter.
| Knoten | Löschen | Hinzufügen | Aktualisieren | Verwendung | Mögliche Werte |
|---|---|---|---|---|---|
| Aktion | Erforderlich | Erforderlich | Erforderlich | Die Aktion zur Ausführung | "Löschen", "hinzufügen", "Update" |
| Eintragung | Erforderlich | Nicht verwendet | Erforderlich | Die Eintrags -ID des vorhandenen Eintrags zum Löschen oder Aktualisieren | Ganze Zahl |
| ermöglicht | Nicht verwendet | Nicht verwendet | Optional | Aktivieren oder deaktivieren Sie den Eintrag, der immer aktiviert ist, wenn Sie hinzufügen | 1 = aktiviert, 0 = deaktiviert |
| Wochentage | Nicht verwendet | Optional | Optional | Wochentage, an denen die gewählte Sperraktion exectiert werden sollte (erfordert aktiviert = 1) | Array von Tagen: "Mon", "Di", "Mi", "Thu", "Fr" "Sat", "Sonne" |
| Zeit | Nicht verwendet | Erforderlich | Optional | Die Zeit, in der die ausgewählte Sperraktion ausgeführt werden sollte (erfordert aktiviert = 1) | "HH: MM" |
| Schloss | Nicht verwendet | Erforderlich | Optional | Die Sperraktion, die am ausgewählten Wochentagen zum ausgewählten Zeitpunkt ausgeführt werden sollte (erfordert aktiviert = 1) | Für das Nuki -Schloss: "Entsperr", "Lock", "Unlatch", "Lockngo", "LocknGounlatch", "Fulllock". Für den Nuki -Opener: "Activaterto", "Deactivatero", "ElectricStrikeactuation", "Activatecm", "Deactivatecm |
Beispiele:
{ "action": "delete", "entryId": "1234" }{ "action": "add", "weekdays": [ "wed", "thu", "fri" ], "time": "08:00", "lockAction": "Unlock" }{ "action": "update", "entryId": "1234", "enabled": "1", "weekdays": [ "mon", "tue", "sat", "sun" ], "time": "08:00", "lockAction": "Lock" } Autorisierungseinträge können aktualisiert und entfernt werden. Dies muss zuerst im Konfigurationsportal aktiviert werden. Überprüfen Sie "Autorisierungseinträge ändern und löschen" unter "Zugriffsebenekonfiguration" und speichern Sie die Konfiguration. Es ist derzeit nicht (noch) möglich, auf diese Weise Autorisierungseinträge hinzuzufügen.
Informationen zu aktuellen Autorisierungseinträgen werden als JSON -Daten an das Thema "[Lock/Opener]/Autorisierung/JSON" veröffentlicht.
Dies muss separat aktiviert werden, indem "Informationen zur Veröffentlichung von Autorisierungseinträgen Informationen veröffentlichen" unter "Zugriffsebenekonfiguration" und Speichern der Konfiguration. Standardmäßig werden maximal 10 Einträge veröffentlicht.
So ändern Sie die Einstellungen für die Nuki -Sperr-/Opener -Autorisierungseinstellungen, setzen Sie den [lock/opener]/authorization/action in einen von den folgenden Knoten enthaltenden JSON -Format -Wert.
| Knoten | Löschen | Hinzufügen | Aktualisieren | Verwendung | Mögliche Werte |
|---|---|---|---|---|---|
| Aktion | Erforderlich | Erforderlich | Erforderlich | Die Aktion zur Ausführung | "Löschen", "hinzufügen", "Update" |
| Authid | Erforderlich | Nicht verwendet | Erforderlich | Die Auth -ID des vorhandenen Eintrags zum Löschen oder Aktualisieren | Ganze Zahl |
| ermöglicht | Nicht verwendet | Nicht verwendet | Optional | Aktivieren oder deaktivieren Sie die Autorisierung, die immer aktiviert ist | 1 = aktiviert, 0 = deaktiviert |
| Name | Nicht verwendet | Erforderlich | Optional | Der Name der Genehmigung zum Erstellen oder Aktualisieren | String, max 20 Zeichen |
| remoteallowed | Nicht verwendet | Optional | Optional | Wenn diese Autorisierung Remote -Zugriff zulässig ist, erfordert aktiviert = 1 | 1 = aktiviert, 0 = deaktiviert |
| zeitlich | Nicht verwendet | Optional | Optional | Wenn diese Genehmigung nur zu bestimmten Zeiten auf den Zugriff beschränkt ist, erfordert aktiviert = 1 | 1 = aktiviert, 0 = deaktiviert |
| erlaubt aus | Nicht verwendet | Optional | Optional | Der Startzeitstempel, aus dem der Zugriff zulässig sein sollte (erfordert aktiviert = 1 und Timelimited = 1) | "Yyyy-mm-dd HH: MM: SS" |
| erlaubt | Nicht verwendet | Optional | Optional | Der Endstempel, bis der Zugriff zulässig ist (erfordert aktiviert = 1 und Zeitraffer = 1) | "Yyyy-mm-dd HH: MM: SS" |
| degetiertWeekdays | Nicht verwendet | Optional | Optional | Wochentags, auf denen der Zugriff zulässig sein sollte (erfordert aktiviert = 1 und timelimited = 1) | Array von Tagen: "Mon", "Di", "Mi", "Thu", "Fr" "Sat", "Sonne" |
| erlaubt aus der Zeit | Nicht verwendet | Optional | Optional | Die Startzeit pro Tag, aus der der Zugriff zulässig ist (erfordert aktiviert = 1 und Zeitraffer = 1) | "HH: MM" |
| erlaubt | Nicht verwendet | Optional | Optional | Die Endzeit pro Tag, bis der Zugang zulässig ist (erfordert aktiviert = 1 und Zeitarbeit = 1) | "HH: MM" |
Beispiele:
{ "action": "delete", "authId": "1234" }{ "action": "update", "authId": "1234", "enabled": "1", "name": "Test", "timeLimited": "1", "allowedFrom": "2024-04-12 10:00:00", "allowedUntil": "2034-04-12 10:00:00", "allowedWeekdays": [ "mon", "tue", "sat", "sun" ], "allowedFromTime": "08:00", "allowedUntilTime": "16:00" } Das Schloss kann über GPIO gesteuert werden. Um Aktionen auszulösen, muss eine Verbindung zum Boden bei Leasing 300 ms (oder auf +3,3 V für "allgemeine Eingabe (Pulldown)") vorhanden sein.
Um die GPIO -Steuerung zu aktivieren, gehen Sie auf der Seite "GPIO -Konfiguration", auf der jeder GPIO für eine bestimmte Rolle konfiguriert werden kann:
Wenn Sie es vorziehen, über Ethernet anstelle von Wi-Fi herzustellen, verwenden Sie entweder eines der unterstützten ESP32-Module mit integriertem Ethernet (siehe Abschnitt "unterstützte Geräte") oder verdrahten Sie ein separates SPI-Ethernet-Modul.
Derzeit werden das Wiznet W5x00 -Modul (W5100, W5200, W5500), DN9051 und KSZ8851SNL -Chips unterstützt.
Um ein unterstütztes Modul zu verwenden, flashen Sie die Firmware, stellen Sie die Firmware über Wi-Fi an und wählen Sie die richtige Netzwerkhardware im Abschnitt "Netzwerkkonfiguration" aus.
Verwenden Sie dieses Verdrahtungsschema, um ein externes W5x00 -Modul mit dem ESP zu verdrahten:
Stellen Sie nun über Wi-Fi eine Verbindung her und ändern Sie die Netzwerkhardware in "Generic W5500".
Wenn die Ethernet-Hardware nach dem Ändern des Netzwerkgeräts nicht ordnungsgemäß erkannt oder initialisiert wird, wird Wi-Fi als Fallback verwendet.
Hinweis: LAN8720-Module werden nur am ESP32 und ESP32-Solo1 unterstützt, nicht auf dem ESP32-S3, ESP32-C3 oder ESP-C6
Leider hat der ESP32 Probleme mit einigen Zugriffspunkten und die Wiederverbindung schlägt fehl.
Als Problemumgehung können Sie zur "Netzwerkkonfiguration" navigieren und "Neustart auf Trennung" aktivieren.
Dies wird das ESP neu starten, sobald es von Wi-Fi getrennt wird.
Dies reduziert auch das Timeout des Konfigurationsportals auf drei Minuten, um zu verhindern, dass der ESP im Konfigurationsmodus steckt, falls ein Zugriffspunkt vorübergehend offline ist.
Wenn dies die Trennung immer noch nicht repariert und das ESP nicht erreichbar ist, kann die Option "Neustart -Timer" als letztes Ausweg verwendet werden.
Es wird das ESP nach einer konfigurierten Zeit neu starten.
Stellen Sie zunächst sicher, dass die Firmware-Version des NUKI-Geräts aktuell ist, ältere Versionen haben Probleme mit dem Paarung.
Versuchen Sie als nächstes, den ESP32-Flash zu löschen und dann (wieder) die Firmware zu blinken.
Verwenden Sie zum Löschen des Blitzes das Espressif -Download -Tool und klicken Sie auf die Schaltfläche "Erase".
Flash die Firmware wie in der Datei "How-to-Flash.txt" oder mit WebFlash beschrieben.
Überprüfen Sie auch, ob die Paarung erlaubt ist. Gehen Sie in der Nuki -Smartphone -App zu "Einstellungen" -> "Funktionen & Konfiguration" -> "Schaltfläche & LED" und stellen Sie sicher, dass die "Bluetooh -Paarung" aktiviert ist.
Als nächstes drücken Sie die Taste für einige Sekunden, bis das LED -Licht beleuchtet bleibt.
Ein Hinweis zur M5Stack Poesp32 -Einheit. Hier ist die anfängliche Bluetooth -Rezeption sehr schlecht (Bereich weniger als ein Meter). Der Grund dafür ist, dass das Modul keine Antenne auf der PCB hat, sondern nur einen IPEX -Anschluss. Durch Nachrüstung einer externen SMA-Antenne (IPEX oder andere Namen U.FL, IPAX, IPX, AMC, MHF, UMCC) funktioniert Bluetooth/Wi-Fi über mehrere Meter.
Stellen Sie sicher, dass Sie mindestens Version 2023.8.0 von Home Assistant verwenden.
Die Entwickler von Home Assistant haben Änderungen an der MQTT Auto Discovery vorgenommen, die die Unterstützung für ältere Version brechen, und Nuki Hub hat diese Änderungen übernommen.
Dies bedeutet leider, dass ältere Versionen von Home Assistant nicht mehr von der Implementierung der Nuki Hub -Entdeckung unterstützt werden.
Laut Nuki ist dies im Entwurf und Teil der Spezifikation der Pro -Lock.
Sie können entweder das eingebaute WLAN oder eine Brücke verwenden (die Nuki Hub als).
Oder verwenden Sie den Nuki-Hub im Hybridmodus mit Wi-Fi oder Thread, siehe Hybridmodus
Beide gleichzeitig wird nicht unterstützt.
Eine gewisse Funktionalität wird durch die Firmware der Sperre (oder Opener) eingeschränkt und ist nur dann zugänglich, wenn der PIN bereitgestellt wird.
Beim Einrichten des Schlosses (oder des Opener) müssen Sie eine PIN in der Nuki -Smartphone -App einstellen.
Navigieren Sie zur Seite zur Nuki Hub -Anmeldeinformationen, geben Sie diese PIN ein und klicken Sie auf Speichern.
Überprüfen Sie die Hauptseite des Konfigurators, um festzustellen, ob der eingegebene PIN gültig ist
Siehe den vorherigen Punkt, diese Funktionalität erfordert den richtigen PIN, der konfiguriert werden muss.
Stellen Sie sicher, dass die Option "Ablatch" unter "Zugriffsebenekonfiguration" überprüft wird.
Das Ablösen kann mit dem Lock.open -Dienst ausgelöst werden.
Alternativ wird eine "Ablagerungs" -Taste durch die Erkennung von Home Assistant entlarvt.
Diese Schaltfläche ist standardmäßig deaktiviert, kann jedoch in der Home Assistant UI aktiviert werden.
Bei Verwendung mehrerer NUKI -Geräte müssen für jedes Gerät unterschiedliche Pfade konfiguriert werden.
Navigieren Sie zu "MQTT -Konfiguration" und ändern Sie den "MQTT NukiHub -Pfad" unter "Basic MQTT -Konfiguration" für mindestens eines der Geräte.
Dies ist häufig ein Ergebnis des Aktivierens von "Register als App", wenn Sie den Hybridmodus nicht verwenden (offizieller MQTT / Nuki Hub-Koexistanz).
Dies führt dazu, dass der Nuki -Hub das Schloss ständig abfragt und als solches übermäßige Batterieabfluss verursacht.
Um dieses Verhalten zu verhindern, deaktivieren Sie "Register als App" deaktivieren und neu passen.
Aktivieren Sie niemals "Register als App", es sei denn, Sie beabsichtigen, zusätzlich zu Nuki Hub eine Nuki -Brücke zu verwenden, oder Sie verwenden den Hybridmodus!
Docker (bevorzugt)
In der Readme im Docker -Verzeichnis finden Sie Anweisungen zum Erstellen mit Docker.
Plattform IO, Anweisungen für Debian-basierte Linux-Distro (z. B. Ubuntu)
apt-get update
apt-get install -y git python3 pip make
python3 -m venv .venv
source .venv/bin/activate
git clone https://github.com/technyon/nuki_hub --recursive
cd nuki_hub
# install tools platformio and esptool
make deps
# build all binary boards
make updater
make release Dies ist Software von Drittanbietern für Nuki -Geräte.
Dieses Projekt oder eine seiner Autoren ist nicht mit Nuki Home Solutions GmbH verbunden.
Weitere offizielle Produkte und Unterstützung auf der offiziellen Website von Nuki:
https://nuki.io/
Weitere Lizenzdetails finden Sie in der enthaltenen Lizenzdatei.
