Z-Wave Protocol Controller (ZPC)¶

ZPC is a Linux/macOS Z-Wave gateway application that acts as the host-side static controller for a Silicon Labs NCP. It exposes network management, device interview, and Command Class control over MQTT, and persists state in an attribute store with a reported/desired value model.

This site is the full documentation for ZPC. For a quick project overview, the feature list, the supported-command-class table, and the Switch On/Off end-to-end demo, see the top-level project README on GitHub.

Start here¶

Getting started — dependencies, NCP setup, build, configure, and run
High-Level Architecture — overview of ZPC's main components and their roles
Debian packaging — build a .deb on Linux
Switch On/Off demo — full end-to-end walk-through in the top-level README
Command Class Implementation Guide — add or modify Z-Wave command classes
Known Failing CTT Test Cases — automated CTT test failures tracked against ZPC

MQTT API¶

MQTT API index — single source of truth for every MQTT topic (Discovery, Network Management, SmartStart, Device Interview, Network Status, OTA, Command Classes)
MQTT API Overview — architecture and per-component initialization
MQTT API Interface — MqttApiBase reference and topic conventions

Component documentation¶

Network Management — Add/Remove, Remove Failed, DSK/Grant Keys, Node List, Factory Reset, NLS
Device Interviewer — interview state machine and Interview/Report
Network Status — unsolicited Network/Status/Report
OTA Firmware Manager — firmware update state machine, MQTT commands/reports, end-to-end example

Command classes¶

Command Classes MQTT Interface — endpoint addressing and per-CC MQTT topic references

Sequences¶

Inclusion flow — from Add / SmartStart through S2/DSK to interview completion
Exclusion flow — from Node Remove to node removed

Resources¶

Legal info¶

The licensor of this software is Silicon Laboratories Inc. Your use of this software is governed by the terms of the Silicon Labs Master Software License Agreement (MSLA), available at www.silabs.com/about-us/legal/master-software-license-agreement. This software is distributed in Source Code format and is governed by the sections of the MSLA applicable to Source Code.