ILEVIA

Controls the Samsung TV: 'power' true turns it on via Wake-on-LAN (needs the MAC and 'Power On with Mobile' enabled on the TV), false turns it off (POWER key, sent only if the TV is currently on); 'volume' is absolute 0-100 and is only available if the TV exposes UPnP control, otherwise use SamsungTv_button volumeUp/volumeDown. Pass only the parameters you want to change.

Samsung TV status: paired, power (awake/asleep/shutting-down/unreachable, plus artmode on Frame TVs -- 'shutting-down' means it was just told to power off and has not actually left the network yet, so it will not respond to a power-on), foreground app, volume if available, and the list of apps (config.apps, with the ids to use in SamsungTv_launch_app). Without an id, uses the project's only Samsung TV.

Removes the pairing with a Samsung TV: Ilevia deletes the LOCALLY saved token and stops controlling it. WARNING: the TV will keep listing Ilevia under 'Device Connection Manager' until it's removed manually on the TV.

Storico degli accessi rilevati dai dealer di controllo accessi (lettori badge/PIN, es. Dahua o BX-KNX): chi ha provato ad accedere, quando (UTC), se autorizzato o negato, con quale card/PIN e su quale device/porta. Risultati dal più recente. Usa list_components(type="access_control_dealer") per trovare gli id dei dealer se vuoi filtrare per uno specifico impianto/varco; senza filtro dealerId interroga tutti i dealer del progetto. Per sapere CHI ha accesso configurato adesso (non lo storico) usa invece get_component sul dealer.

Panoramica energetica dell'impianto ADESSO: potenza ed energia di consumo, produzione (fotovoltaico), export, più l'elenco dei carichi monitorati (clima, luce, cucina...) con i rispettivi valori correnti. Legge il componente 'energy_overview' del progetto e risolve tutti i componenti che referenzia. NB: i contatori di energia sono totalizzatori cumulativi; per lo storico (oggi, ieri, un mese) usa energy_query.

Interroga l'ARCHIVIO STORICO dei dati di energia con una query Flux (InfluxDB, bucket 'ProjectsData'). USALO SEMPRE, direttamente, quando l'utente chiede consumi/produzione/import/export su un periodo (oggi, ieri, settimana, mese): è l'unico modo per rispondere e non richiede alcuna abilitazione aggiuntiva. La risposta grezza dell'archivio (JSON o CSV annotato InfluxDB) è nel campo 'raw'. SCHEMA: il bucket è multi-impianto, filtra SEMPRE per il tag device_id. Serie complessive dell'impianto: _measurement 'energy_production', 'energy_in' (import da rete), 'energy_export', 'power_production', 'power_consumption', con device_id = '<projectId>_<energyOverviewId>' (projectId da server_info, energyOverviewId = id del componente energy_overview). Serie per singolo carico: _measurement '<componentId>_energy' e '<componentId>_power' (gli id dei loads di energy_overview). I contatori di energia sono totalizzatori cumulativi in Wh: il valore su un periodo si calcola con spread() sul range. Esempio, produzione di oggi: from(bucket: "ProjectsData") |> range(start: today()) |> filter(fn: (r) => r._measurement == "energy_production" and r.device_id == "<projectId>_<energyOverviewId>") |> spread(). NB: range(start: today()) è mezzanotte UTC; per la mezzanotte locale italiana usa un timestamp esplicito (es. 2026-07-22T22:00:00Z in estate). Per lo schema completo: import "influxdata/influxdb/schema" + schema.measurements(bucket: "ProjectsData"). Aggrega sempre (spread, aggregateWindow, sum): risposte oltre 60KB vengono troncate.

Dettaglio completo di un componente dato il suo id: valore corrente e precedente, tipo, behaviour, parametri di configurazione.

Modifica la configurazione dell'irrigazione: numero di ripetizioni del ciclo, percentuale di durata (100 = durate nominali, 50 = tempi dimezzati), e/o l'elenco delle zone. Passare solo i parametri da cambiare. La modifica delle zone SOSTITUISCE l'intero elenco: leggere prima irrigation_status e ripassare tutte le zone con le modifiche.

Avvia, ferma o mette in pausa il ciclo di irrigazione. 'play' esegue il ciclo delle zone abilitate nell'ordine configurato (rispetta l'interruttore di abilitazione: se l'irrigazione è disabilitata il play non parte); 'stop' ferma tutto e chiude le zone; 'pause' sospende mantenendo la posizione nel ciclo.

Comando MANUALE delle uscite dell'irrigazione, fuori dal ciclo automatico: pompa principale, valvola di scarico, o una singola zona/attuatore (componentId dall'elenco actuators/zone di irrigation_status). Usare con criterio: durante un ciclo in corso conviene passare da irrigation_control.

Stato completo dell'irrigazione: in esecuzione o ferma (workingState: idle/running/paused), zona attiva corrente, stato pompa, allarmi/sensori di blocco attivi, e configurazione (elenco zone con durate, ripetizioni del ciclo, percentuale di durata, sensori). Senza id usa l'unico impianto di irrigazione del progetto.

Elenca i codici IR (telecomando) appresi sui BroadLink del progetto, per dispositivo. I nomi sono quelli da passare a send_broadlink_code (es. 'TV power', 'Volume +').

Elenca i tipi di componente presenti nell'impianto con il conteggio per tipo (campo 'types'). Utile per capire cosa c'è prima di usare list_components con filtro.

Elenca i componenti dell'impianto (luci, tapparelle, termostati, sensori...). Ogni voce ha id, nome, tipo, gateway e valore corrente. Filtra per tipo e/o per sottostringa del nome (case-insensitive) per non scaricare tutto.

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).

Invia un codice IR appreso tramite un BroadLink (es. 'TV power'). Il nome si confronta senza maiuscole; se non c'è un nome identico va bene un'unica corrispondenza parziale. Usare list_broadlink_codes per i nomi disponibili.

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.