Widget guide — every device type
This chapter walks through every type of device you can meet in the HyperVisu app: what it shows at a glance, what every control does, and what you find on its detail page.
Before you dive in, a few things apply to every device (see “Controlling Devices — The Basics” for the full basics):
- Rows and tiles. Every device appears either as a row (a line in a list) or a tile (a card in a grid), depending on the page style you chose in Settings. Both show the same name, icon, and live value, and carry the same quick controls.
- Tap acts, long-press pins. Tapping a control acts immediately. A long press on the device pins it to (or unpins it from) your favorites.
- Instant feedback. The app shows the result of your tap right away, then confirms it with the real state reported by the device. If a device is unreachable, the value falls back to the last known state.
- Detail pages. Some types open a full detail page when you tap the device body (not a control): dimmers, color and tunable-white lights, shutters, thermostats, air conditioning, ventilation, audio zones, meters, EV chargers, cameras, trending measurements, and dashboards. Simple types (switches, push buttons, status displays) act directly from the row or tile.
Devices that are ON glow with the orange accent; devices that are OFF stay neutral.
Widget type reference
Every device in HyperVisu is a widget of one of the 22 types below. The type decides what the app shows, which controls exist, and which communication objects the widget carries. For the full walkthrough of each family, see this article; for adding and binding widgets, see “The Devices Workspace”.
| # | Type | What it controls or shows | Sub-types | Detail page | Schedules / Boost | Notes |
|---|---|---|---|---|---|---|
| 1 | Push button | Sends a momentary command | ON · OFF · TOGGLE | — | — | The sub-type decides what a press sends. Two identical presses are two commands. |
| 2 | Light switch | A light, on/off | — | — | — | The standard lighting toggle. |
| 3 | Analog output | A numeric setpoint you set | — | Setpoint slider | — | Writes a value to the installation (e.g. a target level). |
| 4 | Shutter / Blind | A shutter or venetian blind | Blind (no slats) · Shutter (with slat tilt) | Yes | — | Up/stop/down, position slider and presets; the Shutter sub-type adds slat tilt. 0 % = open, 100 % = closed. |
| 5 | Temperature / Thermostat | Room temperature control | Heating · Cooling · Auto · Value (display only) | Yes | Weekly schedule · Boost | Modes Comfort / Standby / Night; Boost 30 min–3 h; weekly program (see “Weekly Schedules”). |
| 6 | Dimmer | A dimmable light | — | Yes | — | Level slider with 25/50/75/100 % presets. |
| 7 | RGB dimmer | A color light | — | Yes | — | Color wheel, whites, favorite colors. |
| 8 | Tunable-white dimmer | Brightness + color temperature | — | Yes | — | Warm-to-cold white with presets. |
| 9 | Analog input | A measured value (read-only) | Trending | Trend page (Trending sub-type) | — | The Trending sub-type opens a chart with min/avg/max per period. |
| 10 | Digital input | A yes/no status (read-only) | — | — | — | Shows custom state labels (e.g. "Open" / "Closed"). |
| 11 | Camera | A live camera image | — | Full-screen stream | — | Tile preview opens the full-screen live view. |
| 12 | Videophone | Door calls: video, talk, open | — | Call screen | — | See “Notifications & Videophone”. |
| 13 | Switch | A generic on/off output | — | — | — | For anything switched that is not a light. |
| 14 | Web view | An embedded dashboard page | — | Opens the page | — | Typically a dashboard from Grafana service. |
| 15 | Text input | A short text you type | — | — | — | Sends the entered text to the installation. |
| 16 | Alarm | An intrusion alarm | Full · State-only · Arm-only | Yes | — | Arm / partial / disarm; an optional PIN can protect arm and/or disarm (see “Alarm PIN & Global-Command Exclusions”). |
| 17 | Audio | A multiroom audio zone | Full · No source · No zone | Yes | — | Volume, mute, transport, source, track display and cover artwork. One widget per zone; a Sonos zone uses the No-zone sub-type (see “Audio Zones”, “Devices Library & Sonos Binding”). |
| 18 | Ventilation | A ventilation unit | Automatic · Manual | Yes | Boost | Speeds low/medium/high; the Automatic sub-type adds an auto mode. |
| 19 | Air conditioning | An AC unit | — | Yes | Weekly schedule | Modes Off / Heat / Cool / Auto with setpoint (see “Weekly Schedules” for schedules). |
| 20 | Door lock | A door lock | — | — | — | Lock / unlock. |
| 21 | Meter | An energy, water or gas meter | Roles: grid · solar inverter · battery · EV charger · consumer · water · gas | Yes | — | Live reading, period tabs (Now/Day/Week/Month/Year), charts. The role decides where it appears in the Energy section (see “Energy Overview”). |
| 22 | EV charger | An electric-vehicle charger | — | Yes | — | Start/stop, charging current 6–32 A, session energy and duration. |
📘 Note: Grid and battery meters also report exported energy; a solar inverter reports production only.