Docs

Scene

The Scene widget writes several pins at once. One tap, a list of actions.

Use it for: Movie night that dims the lights and closes the blinds, Away that turns everything off, Morning that starts the heater and opens the shutters.

SettingWhat it does
Actionsthe list of pin and value pairs to send
Orderthe order the actions go out in
Icon, colour, namehow the tile looks

Open these from the canvas: tap Edit, then long press the widget and choose Configure.

The Scene runs in the app. Each action is a normal write to a pin, so your sketch needs no new code: the handlers you already have for those pins run as if you had tapped each control.

Setting one up

Add a Scene widget, then add an action for every pin it should set. Each action picks a pin and a value.

A scene that dims the lights and closes the blinds is two actions: V3 to 40, and V26 to 0.

What it does not do

A Scene sends its actions when you tap it. Nothing runs on a schedule, and nothing reacts to a sensor. For those, use Automation or Rules.

The actions go out with a short gap between them, not all at once, so a board receiving five writes has time to act on each.

Troubleshooting

ProblemCheck
Tapping does nothingthe Scene has no actions yet
Some actions work, others do notthose pins have no handler in the sketch
Actions fire on the wrong deviceeach action carries its own board; check the device on each
Nothing happens with a board offlinethe writes need the board online, the same as any control

Next