Afstandsacties

Alle acties die je vanuit het panel op een scherm kunt uitvoeren, en hoe een opdracht aankomt.

Met afstandsacties herstart je een scherm, zet je het aan of uit, maak je caches leeg of haal je een diagnose op, zonder naar de locatie te rijden en zonder SSH. Alles hieronder kan zolang de Pi draait, internet heeft en de poller regelmatig ophaalt.

#Hoe een opdracht aankomt

Je kiest een actie op de schermpagina, of voor meerdere schermen tegelijk bij Opdrachten.
Het panel zet een opdracht klaar. De Pi haalt hem op bij de eerstvolgende ronde: binnen ongeveer een minuut, in de slaapstand tot ongeveer 5 minuten.
De Pi voert de opdracht uit en schrijft een ontvangstbevestiging. Die gaat mee met het volgende levensteken.
In het panel zie je de opdracht van wachtend, via afgeleverd naar klaar of mislukt. Een opdracht die niet wordt opgepakt verloopt na 7 dagen.

Ingrijpende acties vragen eerst een bevestiging. Bij meer dan vijf schermen tegelijk vraagt het panel een bevestiging met het exacte aantal.

Kent een Pi een actie niet, bijvoorbeeld omdat hij nog een oudere versie heeft, dan blijft de opdracht wachten ("Wacht op nieuwere poller") en wordt hij niet uitgevoerd. In een bulkopdracht wordt zo'n scherm overgeslagen, met de reden erbij.

#De acties

Actie	Naam	Wat het doet	Ingrijpend	Wachttijd
`reboot`	Pi herstarten	Herstart de hele Raspberry Pi (ongeveer 1 minuut respijt).	Ja, vraagt bevestiging	8 min
`restart-renderer`	Weergave herstarten	Herstart alleen het programma dat het beeld tekent.	Nee	5 min
`restart-poller`	Poller herstarten	Herstart de service die instellingen ophaalt en meldingen stuurt.	Nee	5 min
`restart-radio`	Radio herstarten	Herstart de audiostream.	Nee	5 min
`restart-all`	Alles herstarten	Herstart weergave, poller en radio.	Ja, vraagt bevestiging	8 min
`force-poll`	Direct synchroniseren	Haalt nu de nieuwste instellingen en slides op in plaats van te wachten op de volgende ronde.	Nee	5 min
`clear-image-cache`	Afbeeldingscache leegmaken	Alle slides worden opnieuw gedownload.	Nee	5 min
`clear-qr-cache`	QR-cache leegmaken	QR-codes worden opnieuw gemaakt.	Nee	5 min
`clear-cache`	Alle caches leegmaken	Afbeeldingen en QR-codes worden opnieuw opgebouwd.	Ja, vraagt bevestiging	5 min
`clear-logs`	Logs wissen	Verwijdert de lokale logbestanden op de Pi.	Nee	5 min
`screen-on`	Scherm aan	Zet het scherm direct aan (eenmalig).	Nee	5 min
`screen-off`	Scherm uit	Zet het scherm direct uit (eenmalig).	Nee	5 min
`apt-upgrade`	Systeemupdates	Draait de systeemupdates van Raspberry Pi OS. Kan lang duren.	Ja, vraagt bevestiging	25 min
`update`	Software bijwerken	Haalt de gekozen versie van de kiosk-software op, controleert die en herstart.	Ja, vraagt bevestiging	15 min
`collect-diagnostics`	Diagnose ophalen	Meldt een begrensde, geschoonde diagnose terug: temperatuur, throttling, geheugen, schijf, wifi-signaal, services en de laatste logregels. Nooit geheimen.	Nee	2 min
`set-token`	Scherm-token instellen	Wisselt het token van één scherm, met terugdraaien als het nieuwe token niet werkt. Het token wordt na aflevering gewist en nooit getoond.	Ja, vraagt bevestiging	30 min

#Diagnose ophalen

De actie collect-diagnostics vraagt de Pi een begrensde, geschoonde diagnose terug te melden:

de temperatuur en de throttling-vlaggen, het geheugen, de schijf en het wifi-signaal (alleen dBm, nooit de netwerknaam);
of poller, weergave en radio draaien;
de laatste regels van de logs van poller en weergave (standaard 50, maximaal 200 regels).

Tokens, wachtwoorden, sleutels en lange geheime reeksen worden vervangen door ***, het configuratiebestand wordt nooit gelezen en het geheel blijft klein. Je ziet het resultaat op de schermpagina onder Laatste diagnose en uitklapbaar bij de opdracht. Per scherm worden de laatste drie diagnoses 7 dagen bewaard.

#Het scherm aan of uit zetten

screen-on en screen-off zetten het scherm direct aan of uit, eenmalig. De schermtijden van het scherm blijven daarna gewoon gelden.

#Wat niet op afstand kan

Situatie	Waarom
De eerste installatie van een nieuwe Pi	SD-kaart flashen, `installer.env` plaatsen en de installer draaien. Daarna kan alles op afstand
Een Pi zonder internet of zonder werkende poller	Er komt geen opdracht aan. Alleen te herstellen via SSH of ter plaatse
Wifi of netwerk wijzigen	Het zit in de Pi zelf, en een verkeerd wachtwoord maakt hem onbereikbaar
Onderspanning, hitte, een defecte voeding, SD-kaart, HDMI-kabel of scherm	Hardware: het panel meldt het, de oplossing is fysiek
Een Pi die niet meer opstart	De kaart opnieuw flashen. Het scherm-id blijft gelijk, dus instellingen en slides blijven