Getting started
This section explains how to start working with Plugwise Zigbee devices and how they integrate within your system.
Overview
Plugwise Zigbee devices communicate over a Zigbee mesh network and can be used in three main configurations:
-
With a Plugwise Hub (Adam HA)
Recommended for full functionality, including local API access, automation, and energy management. -
With third-party Zigbee hubs
Such as Home Assistant (ZHA or Zigbee2MQTT). Functionality depends on the integration. -
Standalone (limited cases)
Some devices can operate without a hub, but without advanced control or monitoring.
Zigbee basics
Zigbee is a low-power wireless protocol designed for reliable home automation.
Key characteristics:
- Mesh network: Devices relay messages to extend range and improve reliability
- 2.4 GHz band: Shared with Wi-Fi, potential interference should be considered
- Device roles:
- Coordinator: The network controller (e.g. Adam HA or USB Zigbee stick)
- Router: Mains-powered devices that extend the network
- End Device (SED): Battery-powered devices with low power consumption
A stable network depends on a healthy balance between routers and end devices.
Network design guidelines
For optimal performance:
- Ensure sufficient router density*
- Minimum: 1 router per 5–10 end devices
- Avoid placing devices near:
- Wi-Fi access points
- Metal enclosures
- Electrical cabinets
- Prefer powered devices (USB or mains) to act as routers where possible
- Limit the number of sleepy end devices (SEDs) per router
- Recommended: max. 6 per router
Pairing devices
General pairing steps
- Power the Zigbee device
- Put the coordinator (hub) into pairing mode
- Reset or activate pairing on the device
- Wait for the device to join the network
Notes
- Joining can take several seconds up to a minute
- Devices may initially join through a nearby router
- After joining, the network may take time to stabilise (routing optimisation)
Integration with Plugwise Hub
When connected to an Adam HA:
- Devices are automatically discovered and managed
- Data is available via the local REST API
- Advanced features become available:
- Scheduling
- Zone control
- AI-based heating strategies
- Weather-dependent control
Integration with Home Assistant
Plugwise Zigbee devices are compatible with:
- ZHA (Zigbee Home Automation)
- Zigbee2MQTT
Important considerations
- Default reporting intervals may not be optimal
- Some parameters should be tuned for stable control (e.g. temperature reporting)
- Firmware version may affect behaviour and available features
Refer to the product-specific pages for exact configuration details.
Firmware
Zigbee devices run embedded firmware that defines behaviour and capabilities.
- Firmware updates may:
- Improve stability
- Adjust reporting behaviour
- Add compatibility improvements
- Updates are typically delivered:
- Via Plugwise Hub (OTA)
- Or via supported third-party integrations (if available)
Troubleshooting
Common issues and causes:
| Issue | Possible cause | Solution |
|---|---|---|
| Device not pairing | Not in pairing mode | Reset device and retry |
| Unstable communication | Weak mesh network | Add routers / reposition devices |
| Delayed updates | Reporting interval too high | Adjust reporting settings |
| Device offline | Too many SEDs per router | Improve network distribution |
Next steps
- Continue with a product-specific page for detailed capabilities and configuration
- Review API documentation for integration via the Plugwise Hub
- Validate your Zigbee network design before large deployments