Nuki · Bluetooth · KNX · Home Assistant · 7 minūtes lasīšanai

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.

Lokālā API ports
8080 (HTTP)
Autentifikācija
API tokens (izveidots Nuki lietotnē)
Webhook atbalsts
Jā — notikumu sūtīšana uz HA, mainot stāvokli
Bluetooth darbības rādiuss
~10 m līdz Smart Lock
Barošana
Tīkla adapteris (vienmēr ieslēgts)
Maks. slēdzeņu skaits uz vienu Bridge
3 Nuki ierīces
Programmatūras atjauninājumi
OTA, izmantojot Nuki lietotni
Lokālā API dokumentācija
developer.nuki.io/bridge-api

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

MetodeCeļšTipisks latentumsBezsaistes noturība
Lokālais Bridge HTTP APIHA → Bridge (LAN) → Bluetooth → Slēdzene~50–100 msPilnīga — internets nav nepieciešams
Nuki mākoņa APIHA → mākonis → internets → Bridge → Bluetooth → Slēdzene~1.5–4 sNav — nedarbojas bez interneta
Nuki lietotne (manuāli)Viedtālrunis → Bluetooth → Slēdzene~200–500 msPilnīga — tiešs Bluetooth savienojums
Matter (4.0 Pro)Viedā māja → Thread border router → Slēdzene~80–150 msPilna — 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 days

The 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 →
Ielādējas...
Uz augšu