Nuki Smart Lock — KNX integrācija caur Home Assistant
Lokālais API, atbildes laiks zem 100 ms, viesu kodi ar automatizāciju un pilns audita žurnāls — kā pieslēgt Nuki slēdzenes jūsu KNX sistēmai bez mākoņa atkarības.
Nuki produktu līnija — kāds modelis kādam projektam
Nuki ražo viedās slēdzenes modernizācijai — tās uzstāda virs esošā durvju cilindra pagriežamā mehānisma, neaizstājot cilindru. Pareizais modelis ir atkarīgs no savienojamības prasībām un tā, vai jums ir durvju atvērējs (ieejas domofons), ko integrēt.
Nuki Smart Lock 4.0 Pro
Ieteicams KNX integrācijai- • Iebūvēts Wi-Fi (2,4 GHz) un Thread — tilts nav nepieciešams lokālā tīkla piekļuvei
- • Nuki Bridge joprojām nepieciešams lokālajam HTTP API (Wi-Fi tiešais režīms izmanto tikai mākoni)
- • Matter caur Thread — nākotnes protokola atbalsts
- • Automātiskā aizslēgšana, aktivitāšu žurnāls, DoorSense (durvju atvēršanas/aizvēršanas sensors)
- • Baterijas: 8× AA sārmainās, aptuveni 6 mēneši tipiskā lietošanā
Nuki Smart Lock 3.0
Budžeta variants — nepieciešams tilts- • Tikai Bluetooth — nepieciešams Nuki Bridge lokālā tīkla/API piekļuvei
- • Tilts savienojas caur Wi-Fi un pārveido Bluetooth uz lokālo tīklu
- • Pārbaudīta uzticamība — liela uzstādījumu bāze visā Eiropā
- • Nedaudz zemākas izmaksas nekā 4.0 Pro, ja tilts jau ir
- • Baterijas: 4× AA sārmainās
Nuki Combo (Lock + Opener)
Ēkām ar domofonu- • Ietver Nuki Opener — piestiprina pie domofona, atver ieejas durvis
- • Opener sazinās ar Smart Lock pa Bluetooth
- • Atbalsta atvēršanu pēc zvana: durvju zvans → Opener automātiski atver ieeju
- • Saderīgs ar lielāko daļu analogo domofonu sistēmu (BUS un 2-vadu)
- • Ideāli dzīvoklim: ar vienu pogu atver gan ieejas durvis, gan dzīvokļa durvis
Nuki Bridge — lokālais API vārteja
Nuki Bridge ir neliela ierīce (spraudnis, Wi-Fi), kas savieno Bluetooth no Nuki slēdzenes ar lokālo tīklu. Tā nodrošina HTTP API lokālajā tīklā, ļaujot tieši vadīt slēdzeni no Home Assistant vai jebkura LAN klienta — interneta pieslēgums nav nepieciešams bloķēšanas/atbloķēšanas komandām.
Bridge jāatrodas slēdzenes Bluetooth diapazonā. Lielos stāvu plānos rūpīgi plānojiet Bridge atrašanās vietu — sienas un metāla durvis būtiski vājina Bluetooth signālu. Bridge uztur pastāvīgu Bluetooth savienojumu ar slēdzeni, tāpēc komandas tiek pārraidītas gandrīz acumirklīgi bez atkārtotas savienošanas.
Lokālā API un mākoņa API atbildes laika salīdzinājums
| Metode | Ceļš | Tipisks latentums | Bezsaistes noturība |
|---|---|---|---|
| Lokālais Bridge HTTP API | HA → Bridge (LAN) → Bluetooth → Slēdzene | ~50–100 ms | Pilnīga — internets nav nepieciešams |
| Nuki mākoņa API | HA → mākonis → internets → Bridge → Bluetooth → Slēdzene | ~1.5–4 s | Nav — nedarbojas bez interneta |
| Nuki lietotne (manuāli) | Viedtālrunis → Bluetooth → Slēdzene | ~200–500 ms | Pilnīga — tiešs Bluetooth savienojums |
| Matter (4.0 Pro) | Viedā māja → Thread border router → Slēdzene | ~80–150 ms | Pilna — lokālais Thread tīkls |
Vienmēr izmantojiet lokālo Bridge API KNX integrācijai
Mākoņa API integrācija nozīmē, ka jebkurš interneta pārtraukums (maršrutētāja pārstartēšana, ISP dīkstāve, Nuki serveru apkope) izjauc jūsu KNX piekļuves vadības scenārijus. Lokālais Bridge API viss paliek uz vietas — KNX panelis un HA serveris kontrolē slēdzeni neatkarīgi no interneta savienojuma.
Home Assistant Nuki integrācija — iestatīšana un konfigurācija
Oficiālā Home Assistant Nuki integrācija savienojas, izmantojot lokālo Bridge HTTP API. Tā nodrošina reāllaika stāvokļa atjauninājumus, izmantojot webhooks — Bridge nosūta POST uz HA uzreiz pēc jebkuras slēdzenes stāvokļa maiņas, bez aptaujāšanas.
Home Assistant — Nuki Bridge lokālā integrācija
# Settings → Devices & Services → Add Integration → Nuki # (or configuration.yaml for manual setup) nuki: host: 192.168.1.90 # Nuki Bridge LAN IP (set static in router) token: !secret nuki_bridge_token port: 8080 # Bridge webhook registration (auto by HA integration) # Bridge will POST to http://HA_IP:8123/api/webhook/nuki_<id> # on every lock/unlock/door_open event # Resulting entities in HA: # lock.front_door — lock/unlock service # binary_sensor.front_door_door — door open/closed (DoorSense) # sensor.front_door_battery — battery level % # sensor.front_door_last_action — last action description
Pēc integrācijas pievienošanas HA izveido slēdzenes entītiju, durvju sensoru (ja ir uzstādīts DoorSense) un akumulatora sensoru. Slēdzenes entītija atbalsta lock, unlock un unlatch pakalpojumus. Stāvokļa atjauninājumi pienāk caur webhook ~100 ms laikā pēc fiziskas slēdzenes darbības.
KNX integrācijas ceļš — divvirzienu vadība
Home Assistant ar instalētu KNX integrāciju darbojas kā tilts starp KNX grupu adresēm un Nuki slēdzenes pakalpojumiem. Darbojas abos virzienos: KNX kontrolē Nuki, un Nuki stāvokļa izmaiņas atjaunina KNX grupu adreses.
automations.yaml — divvirzienu tilts KNX ↔ Nuki
# KNX scene → Nuki lock
automation:
- alias: "KNX Departure Scene → Nuki lock"
trigger:
platform: state
entity_id: binary_sensor.knx_departure_scene # GA 3/0/1
to: "on"
action:
- service: lock.lock
entity_id: lock.front_door
- service: knx.send
data:
address: "6/1/0" # lock status feedback GA
payload: [1]
type: "binary"
- alias: "KNX Arrival Pushbutton → Nuki unlock"
trigger:
platform: state
entity_id: binary_sensor.knx_arrival_button # GA 3/0/2
to: "on"
action:
- service: lock.unlock
entity_id: lock.front_door
# Nuki state change → update KNX group address
- alias: "Nuki state → KNX feedback"
trigger:
platform: state
entity_id: lock.front_door
action:
- service: knx.send
data:
address: "6/1/0"
payload: >
{{ [1] if trigger.to_state.state == 'locked' else [0] }}
type: "binary"
# configuration.yaml — expose KNX GAs for lock control
knx:
binary_sensor:
- name: "KNX Departure Scene"
address: "3/0/1"
- name: "KNX Arrival Button"
address: "3/0/2"
switch:
- name: "Nuki Lock Status KNX"
address: "6/1/0"
state_address: "6/1/1"KNX → Nuki
Jebkura KNX telegramma uz norādīto grupu adresi iedarbina HA automatizāciju, kas izsauc lock.lock vai lock.unlock pakalpojumu Nuki entītijā. Darbojas no KNX pogas, ainas, grafika vai loģiskā bloka.
Nuki → KNX
Jebkura Nuki stāvokļa maiņa (slēgšana/atvēršana no lietotnes, tastatūras vai fiziskas atslēgas) iedarbina HA automatizāciju, kas nosūta KNX telegrammu uz statusa grupu adresi. Tas uztur KNX vizualizāciju un loģiku sinhronizētā ar faktisko slēdzenes stāvokli.
Viesu piekļuve — laika ierobežoti kodi caur REST API
Nuki atbalsta laika ierobežotus piekļuves kodus (tastatūra vai lietotne). Home Assistant var tos izveidot automātiski, izmantojot Nuki Bridge REST API — noderīgi īres īpašumiem, servisa tehniķiem vai pagaidu darbiniekiem.
HA automatizācija — izveidot laika ierobežotu Nuki piekļuves kodu
# rest_command to create Nuki auth (requires Nuki Web API token)
rest_command:
nuki_create_auth:
url: "https://api.nuki.io/smartlock/{{ nukiId }}/auth"
method: POST
headers:
Authorization: "Bearer {{ secrets.nuki_web_token }}"
Content-Type: "application/json"
payload: >
{
"name": "{{ name }}",
"type": 13,
"allowedFromDate": "{{ from_date }}",
"allowedUntilDate": "{{ until_date }}",
"allowedWeekDays": 127,
"code": {{ code }}
}
# Trigger from HA script called by KNX or calendar event
script:
create_guest_code:
sequence:
- service: rest_command.nuki_create_auth
data:
nukiId: "{{ states('sensor.nuki_lock_id') }}"
name: "Guest {{ now().strftime('%Y-%m-%d') }}"
from_date: "{{ now().isoformat() }}"
until_date: "{{ (now() + timedelta(days=3)).isoformat() }}"
code: "{{ range(1000, 9999) | random }}"
- service: notify.mobile_app
data:
message: "Guest code created for 3 days"Lokālām instalācijām bez Nuki Web API viesu kodus var pārvaldīt tieši Nuki lietotnē mājas īpašnieks. HA integrācija nenodrošina lokālu tastatūras kodu pārvaldību — tam nepieciešams Nuki mākoņa API. Pilnībā lokālai darbībai izmantojiet laika ierobežotas KNX releju izejas vai piekļuves grafikus KNX paneļa līmenī.
Lietošanas piemēri
"Departure" KNX scene — lock + arm Ajax alarm
Resident presses "Departure" KNX pushbutton at exit. KNX logic simultaneously: (1) sends telegram to HA → HA locks Nuki, (2) sends KNX telegram to Ajax alarm integration → alarm armed. Confirmation: Nuki state telegram returns locked → KNX display indicator turns red. Total sequence time: ~300ms.
Ierašanās poga — atslēgšana un sagaidīšanas aina
KNX spiedpoga pie dzīvokļa durvīm (vai pirkstu nospiedumu lasītājs) nosūta atslēgšanas telegrammu → HA atslēdz Nuki ~100 ms laikā. Vienlaicīgi KNX aktivizē sagaidīšanas ainu: gaisma gaitenī, temperatūra komforta režīmā, žalūzijas pēdējā pozīcijā. Durvis atveras, DoorSense apstiprina → HA reģistrē ieejas notikumu.
Viesnīcas istabas RFID karte → KNX → HA → Nuki atslēgšana
Viesis ievieto RFID karti KNX karšu lasītājā pie istabas durvīm. KNX telegramma uz grupas adresi → HA automatizācija pārbauda derīgumu → atslēdz Nuki uz istabas durvīm (uzstādīts iekšpusē). Sagaidīšanas aina aktivizējas caur KNX: gaisma 80%, temperatūra 22°C, sagaidīšanas mūzika. Kartes izņemšana pēc 30s iedarbina aizslēgšanu ar aizkavi.
Piekļuves reģistrēšana — InfluxDB un HA Logbook
Katra Nuki slēdzenes darbība (kurš, ko, kad) ir pieejama Home Assistant kā sensora stāvoklis ar atribūtiem. Drošības audita vajadzībām visi notikumi tiek ierakstīti InfluxDB ilgtermiņa glabāšanai un vaicājumiem.
configuration.yaml — InfluxDB reģistrēšana Nuki notikumiem
influxdb:
host: 192.168.1.100
port: 8086
database: home_assistant
username: !secret influx_user
password: !secret influx_pass
include:
entities:
- lock.front_door
- binary_sensor.front_door_door
- sensor.front_door_last_action
- sensor.front_door_battery
# HA Logbook also records all lock state changes automatically
# Access via HA → Logbook → filter by lock.front_door
# Query example in InfluxDB / Grafana:
# SELECT "value" FROM "lock.front_door"
# WHERE time > now() - 30d
# GROUP BY "action"
# → shows lock/unlock count per day over 30 daysThe HA Logbook provides a human-readable event log accessible via the web UI. For compliance or insurance purposes, InfluxDB with Grafana provides query-able historical data — you can answer questions like "who unlocked the apartment door on Tuesday at 14:30?" or "how many times was the lock accessed last month?". Nuki also retains the last 100 events in its own activity log (visible in the Nuki app).
Piekļuves kontroles integrācija jūsu KNX panelī
Mēs iepriekš savienojam durvju kontrollera izejas, RFID lasītāja kopni un video domofona releju kontaktus CE sertificētos paneļos, gatavus pieslēgšanai objektā.
Pieprasīt piedāvājumu →