Device
Integration
Device is one of the core domain entities in Sparrow Home and represents any physical device connected to the smart home ecosystem. Each device shares a common set of properties, such as:
- unique identifier,
- device name,
- device type,
- current status/state,
- capabilities defining supported actions and features.
This approach allows Sparrow Home to support multiple device categories — such as smart plugs, lights, sensors, alarms, or switches — while still keeping the UI and interaction model consistent across the application.
The device layer is tightly integrated with the local Zigbee2MQTT instance. When a new device is added to the Zigbee network, it is automatically discovered and registered in Sparrow Home. The application listens for device events and updates the device list accordingly, ensuring that users always have an up-to-date view of their smart home ecosystem. One of the key parts of the integration layer is automatic interface recognition. Based on the payloads and exposed capabilities received from Zigbee2MQTT, the application can dynamically determine which controls and UI interfaces should be rendered for a device.
For example, a smart plug may automatically expose power controls and energy monitoring widgets, while a sensor device may expose temperature or humidity panels.
Device Types
Currently, there are four device types:
| Device Type | What it does |
|---|---|
| Standard Device | A general-purpose device that can represent various smart home gadgets, such as smart plugs, lights, or switches. |
| Temperature Sensor | Measures ambient temperature and reports changes over time. |
| Door Sensor | Detects whether a door or window is open or closed. |
| Siren | Emits a loud alarm sound to warn about security events. |
| Remote | Lets users trigger predefined actions, such as arming or disarming the alarm. (Planned) |
Available devices
The Sparrow Home system currently supports Zigbee2MQTT devices. However, in rare cases, some devices may not be fully compatible with the system due to differences in how they expose capabilities or handle specific commands. In such situations, users may need to wait for future updates that improve device compatibility and integration support.
Please check for supported devices in the Zigbee2MQTT documentation.