lifecycle.shutdown and lifecycle.shutdown_cancel
- Commands
lifecycle.shutdown,lifecycle.shutdown_cancel- Area
- device (
lifecycle) - Profile
- manageable
- Response
ok
lifecycle.shutdown#
{"v":1,"cmd":"lifecycle.shutdown","delay":120}
delay |
Effect |
|---|---|
| absent | shut down at once |
0 |
do not shut down, merely switch to the idle screen |
greater than 0 |
show the idle screen and shut down after that many seconds |
-1 |
use the period from the display's own setting |
The display answers before shutting down, so that the controlling program does not run into a dropped connection.
The period – what it is for#
When the controlling program is shut down it is seldom clear whether that was for the day or whether a new version is about to start. If the display vanishes at once, the library is left looking at a black screen mid-morning; if it stays without a limit, it runs all night.
The period solves both: the display switches to the idle screen immediately – where nothing personal remains – and shuts down only if nobody has come back.
lifecycle.shutdown_cancel#
{"v":1,"cmd":"lifecycle.shutdown_cancel"}
Cancels an announced shutdown. A controlling program sends it at start-up when it finds a display already running.