Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update FAQ on secondary controllers #7190

Merged
merged 1 commit into from
Sep 25, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions docs/getting-started/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,20 @@

## Does Z-Wave JS support secondary controllers?

Yes and no.
Mostly.

Z-Wave JS expects to **be the primary controller** in the network and it will try to assume that role when started. It will not work correctly as a secondary controller.
Slightly longer answer:\
On startup, Z-Wave JS detects whether the Z-Wave module it controls is a primary controller or a secondary/inclusion controller.

It does however support **having secondary controllers in the network**. This includes:
Its default operation mode is acting as a **primary controller**, or assuming that role if there is none in the network. In this mode, it supports **having secondary controllers in the network**. This includes:

- Including/excluding a secondary controller
- Letting secondary controllers (inclusion controllers) include and exclude devices
- Perform network key exchange with devices included by a secondary controller

Z-Wave JS also supports joining other networks as a **secondary controller**. This mode is not meant for controlling a smart home, because reports are sent to the primary controller.

> [!WARNING] Secondary controller support is still experimental and has some limitations:
>
> - Including devices on behalf of the primary controller does not work
> - Devices won't be interviewed by default. Triggering an interview manually may set up the lifelines incorrectly.
Loading