Nuki Bridge

    The Nuki Bridge integration allows you to control Nuki Smart Locks via a Nuki Bridge. Many Nuki Smart Locks also support local integrations using a different integration.

    Prerequisites

    要将 Nuki 桥添加到您的安装中，您需要将设备连接到 WiFi、启用开发人员模式并定义端口和访问令牌。这可以使用 Android 应用程序 或 iPhone 应用程序 来实现。转到管理我的设备，然后选择支持桥接或 WiFi 的智能锁并连接到设备。打开 HTTP API 并检查屏幕中的详细信息。请注意，API 令牌的长度应为 6-20 个字符，即使应用程序允许您设置更长的字符。 为了更快地更新，可以使用 Nuki 桥的回调函数。这要求 Nuki 桥可通过 HTTP 访问您的 Home Assistant，因为 Nuki 桥不支持 HTTPS。

    Configuration

    To add the Nuki Bridge hub to your Home Assistant instance, use this My button:

    Open Add integration in your Home Assistant instance.

    Nuki Bridge can be auto-discovered by Home Assistant. If an instance is found, it will be shown as Discovered and can be set up right away.

    Manual configuration steps
    • Browse to your Home Assistant instance.
    • Go to Settings > Devices & services.
    • In the lower-right corner, select Add integration.
    • From the list, select Nuki Bridge.
    • Follow the instructions on screen to complete the setup.
    Host:
  description: Hostname or IP address of your Nuki bridge, e.g., `192.168.1.25`.
Port:
  description: Port of the Nuki bridge HTTP API, default is `8080`.
Token:
  description: Token to authenticate against the Nuki bridge HTTP API.
Use an encrypted token for authentication:
  description: Use an encrypted token for API calls to the bridge. This should only be deactivated if you experience issues with the API (authentication, etc). The default is `True`.

    Actions

    Action nuki.lock_n_go

    这将首先解锁，等待几秒钟（默认为 20 秒），然后重新锁定。等待时间可以通过应用程序自定义。 有关此功能的更多详细信息，请参阅 Nuki 网站。

    Data attributeOptionalDescription
    entity_idyesString or list of strings that point at entity_ids Nuki Locks.
    unlatchyesBoolean - Whether to unlatch the door when first opening it.

    动作 nuki.set_continuous_mode

    此操作允许您启用或禁用 Nuki Openers 的“连续模式”功能。这类似于映射到“锁定/解锁”的响铃开门功能，但它没有时间限制 - 只要启用此模式，按下蜂鸣器按钮时门就会打开，类似于它在例如白天去医生办公室或其他场所。在其他 Nuki 产品上，此操作是无操作的。

    Data attributeOptionalDescription
    entity_idyesString or list of strings that point at entity_ids Nuki Locks.
    enabledyesBoolean - Set to true to enable Continuous Mode, or false to disable.

    Events

    Event nuki_event

    Nuki 生成的事件作为“nuki_event”类型的事件发送，内容如下：

    Event data attributeDescription
    typeThe type of the event. Values: ring
    entity_idThe ID of the entity generating the event.

    本地集成替代方案

    许多 Nuki 智能锁支持本地替代品。请参阅 Nuki 网站，获取最新的集成选项和支持的设备列表。

    HomeKit support

    第二代和第三代智能锁支持HomeKit via Bluetooth，并可以通过HomeKit集成直接与Home Assistant集成。

    MQTT support

    Nuki Smart Lock 3.0 Pro和第四代设备支持MQTT，并可以通过MQTT discovery直接与Home Assistant集成。 详细信息可以在此处找到。

    Matter Support

    Smart Lock Ultra、Smart Lock Pro、Smart Lock Go、第四代智能锁支持 Thread 上的 Matter，并可以通过 Matter 集成 直接与 Home Assistant 集成。