Z-Wave in Nodlyn: Node Control, Smart Sensors, and Z-Wave JS UI Integration

Z-Wave is a secure, low-power mesh protocol used in smart-home devices such as locks, switches, dimmers, thermostats, and sensors. Nodlyn integrates with Z-Wave networks through the Z-Wave JS UI REST API, allowing you to read node information, list devices, and send commands directly from your workflows.

The Z-Wave connector exposes three capabilities:

• List Nodes — fetch all nodes paired with your Z-Wave controller
• Get Node Info — read detailed information and current values from a specific node
• Send Command — control switches, locks, alarms, and other Z-Wave actuators

Step 1: Configure Z-Wave JS UI

Nodlyn communicates with Z-Wave JS UI via HTTP. Each node requires:

• apiUrl — default: http://localhost:8091
• apiKey — optional Bearer token
• timeoutMs — request timeout

The executors use a shared HTTP client with optional authentication headers.

Step 2: List Z-Wave Nodes

The Z-Wave List Nodes capability calls:

GET /api/nodes

Z-Wave JS UI returns a JSON array describing every node in the network:

• Node ID
• Device type
• Command classes
• Endpoints
• Current values

This is ideal for dashboards, device selectors, or automation logic.

Step 3: Read Node Information

The Z-Wave Get Node Info node fetches detailed information for a specific node:

GET /api/nodes/{nodeId}

Typical values include:

• Binary Switch state
• Multilevel Sensor readings
• Door Lock status
• Battery level
• Supported command classes

This capability is marked as Safe because it is read-only.

Step 4: Send Z-Wave Commands

The Z-Wave Send Command node allows you to control actuators such as:

• Lights
• Switches
• Door locks
• Sirens
• Thermostats

It uses the Z-Wave JS UI setValue API:

POST /api/nodes/{nodeId}/values
{
    "commandClass": "Binary Switch",
    "endpoint": 0,
    "property": "targetValue",
    "value": true
}

This capability is marked as Dangerous because it can unlock doors, activate alarms, or change device state.

Step 5: Example Workflow

Here's a practical automation you can build:

1. List all Z-Wave nodes.
2. Read the current state of a Binary Switch node.
3. If the switch is OFF, send a command to turn it ON.
4. Send a Telegram notification confirming the action.

This creates a smart-home routine that reacts to real-time Z-Wave data.

Advanced Use Cases

The Z-Wave connector becomes extremely powerful when combined with other nodes:

• Unlock doors when BLE presence sensors detect a trusted device
• Turn on lights when ZigBee occupancy sensors trigger
• Activate alarms when Tuya contact sensors detect intrusion
• Build dashboards showing real-time Z-Wave telemetry

Because Z-Wave JS UI exposes a stable REST API, Nodlyn can run in local or cloud environments.

What's Next?

Try combining Z-Wave with Weather API, ZigBee, Tuya Local, or scheduled workflows. Build smart-home automations that react to sensors, conditions, and user input.

Nodlyn's Z-Wave connector gives you full control over your Z-Wave network — secure, reliable, and deeply integrated.