ILEVIA

Elimina un evento di schedulazione dato il suo id (campo 'id' di schedule_list, es. 'event-01KM...'). Rimuove sia il job pianificato sia la persistenza.

Elimina un programma (calendario) dato il suo id (es. 'program-01KM...'). NB: gli eventi che gli appartenevano NON vengono eliminati: restano orfani e non compaiono più nelle prossime attivazioni — eliminarli con schedule_delete_event o riassegnarli con schedule_write_event.

Esegue SUBITO le azioni di un evento di schedulazione, senza aspettare il suo orario (l'evento e il suo programma devono essere attivi). Utile per testare un evento appena creato.

Elenca le schedulazioni: programmi (calendari, con stato attivo/disattivo) ed eventi (orario, tipo di ricorrenza, azioni sui componenti). Gli eventi appartengono a un programma tramite programId; un programma disattivo blocca tutti i suoi eventi.

Prossime attivazioni pianificate (data/ora locale + eventId), in ordine cronologico. Utile per rispondere a 'cosa succede stasera/domani?'. NB: elenca solo eventi appartenenti a un programma attivo.

Crea o aggiorna un evento di schedulazione: a un orario dato esegue una sequenza di azioni sui componenti (come farebbe l'utente dall'app). Esempi: 'accendi la lavanderia alle 18:30 tutti i giorni' → type=DAY, startTime=18:30:00, actions=[{"componentId":"<id>","value":true}]. Le azioni vengono eseguite in ordine; inserisci {"timerMs":5000} tra due azioni per una pausa. Consigliato associare un programId (schedule_list per vederli, schedule_write_program per crearne) altrimenti l'evento non compare tra le prossime attivazioni. Per aggiornare un evento passa il suo id e TUTTI i campi (sovrascrittura completa).

Crea o aggiorna un programma (calendario) di schedulazione. Un programma raggruppa più eventi e può essere attivato/disattivato in blocco. Per aggiornare passa l'id esistente (il JSON viene sovrascritto: ripassa tutti i campi che vuoi mantenere).

Informazioni sul server domotico locale: versione, progetto e conteggio componenti. Chiamalo per primo per capire con che impianto stai parlando.

Invia un comando (WRITE) a un componente, come farebbe l'app dell'utente. Esempi di 'value' per tipo: switch/lock/scenario: true o false; slider/dimmer (percentuale) e thermostat (setpoint): un numero, es. 21.5; shutter: {"position": 50}; rgb-light: un colore secondo i parametri del componente. In dubbio, leggi prima il valore corrente con get_component e replica il formato.

Elenca i preferiti Sonos (favoriteId, nome, descrizione) dell'household. Usa il favoriteId con sonos_play_favorite per avviarli.

Muta o riattiva l'audio del SONOS.

Avvia un preferito Sonos dato il suo favoriteId (dall'elenco di sonos_favorites).

Avvia una playlist Sonos dato il suo playlistId (dall'elenco di sonos_playlists).

Controlla la riproduzione del SONOS: 'play', 'pause', 'toggle' (play/pausa), 'next' (traccia successiva).

Elenca le playlist Sonos (playlistId, nome, numero tracce) dell'household. Usa il playlistId con sonos_play_playlist.

Stato del SONOS letto al volo: registrazione, volume (0-100), mute, stato riproduzione, traccia corrente, e gruppo/zona. Senza id usa l'unico SONOS del progetto.

Imposta il volume assoluto del SONOS (0-100).

Avvia un'app sulla TV (es. Netflix, YouTube) dato il suo uri applicativo Bravia. Se l'uri non è noto, spesso è più pratico navigare con tv_button (home + frecce + confirm).

Preme un tasto del telecomando della TV (IRCC). Tasti disponibili: up, down, left, right, confirm, back, home, options, display, input, red, green, yellow, blue, num0..num9, volumeUp, volumeDown, mute, channelUp, channelDown, play, pause, stop, next, prev, fastForward, rewind, subTitle, audio, wide, jump, syncMenu, actionMenu, androidMenu, help, tvPower, powerOff, sleep, sleepTimer, pictureMode, hdmi1, hdmi2, hdmi3, hdmi4. Per navigare i menu usare sequenze di tasti (up/down/left/right + confirm).

Cambia canale TV: un numero di canale (es. '5') oppure 'up'/'down' per canale successivo/precedente.

Imposta la TV: accensione/spegnimento, volume assoluto, mute, ingresso video. Passare solo i parametri da cambiare. Per l'ingresso accetta sia l'uri esatto (dal campo sources di tv_status, es. 'extInput:hdmi?port=2') sia la scorciatoia 'hdmi1'..'hdmi4'.

Stato della TV: accesa/spenta, volume, mute, ingresso video attivo, e l'elenco degli ingressi disponibili (sources, con gli uri da usare in tv_set). Senza id usa l'unica TV del progetto.