AppleTv_button
ChatGPTPreme un tasto del telecomando dell'Apple TV. Tasti disponibili: up, down, left, right, select, menu, home, guide, pageUp, pageDown, screensaver, volumeUp, volumeDown. Per navigare i menu usare sequenze di tasti (home + frecce + select).
AppleTv_list_apps
ChatGPTElenca le app installate sull'Apple TV, con nome visualizzato e bundle id. Il bundle id è il valore da passare ad AppleTv_launch_app.
AppleTv_media
ChatGPTControlla la riproduzione: 'play', 'pause', 'stop', 'next', 'prev'. Nota: l'Apple TV non espone un vero comando di stop tramite questo protocollo (Companion), quindi 'stop' viene tradotto in una pausa.
AppleTv_set
ChatGPTImposta l'Apple TV: 'power' true/false invia Wake/Sleep (non è un vero accensione/spegnimento come su una TV — Companion non offre altro), 'volume' è assoluto 0-100. Passare solo i parametri da cambiare.
AppleTv_status
ChatGPTStato dell'Apple TV: associata (paired), connessa, app in primo piano, e l'elenco delle app installate (config.apps, con i bundle id da usare in AppleTv_launch_app). Senza id usa l'unica Apple TV del progetto.
AppleTv_unpair
ChatGPTRimuove l'associazione con un'Apple TV: Ilevia elimina le credenziali salvate LOCALMENTE e smette di controllarla. ATTENZIONE: non esiste nessuna revoca nota lato Apple TV — il dispositivo continuerà comunque a mostrare Ilevia tra i dispositivi associati finché non viene rimossa manualmente sull'Apple TV stessa (Impostazioni → Utenti e account) o l'Apple TV non viene ripristinata. Riferire sempre questa avvertenza all'utente.
SamsungTv_button
ChatGPTPresses a Samsung TV remote-control key. Available keys: up, down, left, right, select, back, home, menu, exit, info, guide, tools, red, green, yellow, blue, num0-num9, channelUp, channelDown, volumeUp, volumeDown, mute, source, hdmi, play, pause, stop, fastForward, rewind, record. To navigate menus, use sequences of keys (home + arrows + select).
SamsungTv_launch_app
ChatGPTLaunches an app on the Samsung TV given its id (e.g. Netflix '3201907018807', YouTube '111299001912'). Use SamsungTv_list_apps to discover the available ids.
SamsungTv_list_apps
ChatGPTLists the Samsung TV's apps, with display name and Samsung id. The id is the value to pass to SamsungTv_launch_app. On 2020+ models the list may come from an internal catalog.
SamsungTv_media
ChatGPTControls playback: 'play', 'pause', 'stop', 'next', 'prev'. Note: the Samsung protocol emulates remote-control key presses, so there is no state confirmation; 'next'/'prev' are translated into fast-forward/rewind.
SamsungTv_set
ChatGPTControls 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.
SamsungTv_status
ChatGPTSamsung 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.
SamsungTv_unpair
ChatGPTRemoves 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.
access_history_query
ChatGPTStorico 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.
energy_overview
ChatGPTPanoramica 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.
energy_query
ChatGPTInterroga 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.
get_component
ChatGPTDettaglio completo di un componente dato il suo id: valore corrente e precedente, tipo, behaviour, parametri di configurazione.
irrigation_configure
ChatGPTModifica 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.
irrigation_control
ChatGPTAvvia, 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.
irrigation_set_output
ChatGPTComando 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.
irrigation_status
ChatGPTStato 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.
list_broadlink_codes
ChatGPTElenca 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 +').
list_component_types
ChatGPTElenca 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.
list_components
ChatGPTElenca 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.
schedule_delete_event
ChatGPTElimina un evento di schedulazione dato il suo id (campo 'id' di schedule_list, es. 'event-01KM...'). Rimuove sia il job pianificato sia la persistenza.
schedule_delete_program
ChatGPTElimina 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.
schedule_execute_event
ChatGPTEsegue 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.
schedule_list
ChatGPTElenca 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.
schedule_next
ChatGPTProssime 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.
schedule_write_event
ChatGPTCrea 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).
schedule_write_program
ChatGPTCrea 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).
send_broadlink_code
ChatGPTInvia 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.
server_info
ChatGPTInformazioni sul server domotico locale: versione, progetto e conteggio componenti. Chiamalo per primo per capire con che impianto stai parlando.
set_component_value
ChatGPTInvia 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.
sonos_favorites
ChatGPTElenca i preferiti Sonos (favoriteId, nome, descrizione) dell'household. Usa il favoriteId con sonos_play_favorite per avviarli.
sonos_mute
ChatGPTMuta o riattiva l'audio del SONOS.
sonos_play_favorite
ChatGPTAvvia un preferito Sonos dato il suo favoriteId (dall'elenco di sonos_favorites).
sonos_play_playlist
ChatGPTAvvia una playlist Sonos dato il suo playlistId (dall'elenco di sonos_playlists).
sonos_playback
ChatGPTControlla la riproduzione del SONOS: 'play', 'pause', 'toggle' (play/pausa), 'next' (traccia successiva).
sonos_playlists
ChatGPTElenca le playlist Sonos (playlistId, nome, numero tracce) dell'household. Usa il playlistId con sonos_play_playlist.
sonos_status
ChatGPTStato 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.
sonos_volume
ChatGPTImposta il volume assoluto del SONOS (0-100).
tv_app
ChatGPTAvvia 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).
tv_button
ChatGPTPreme 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).
tv_channel
ChatGPTCambia canale TV: un numero di canale (es. '5') oppure 'up'/'down' per canale successivo/precedente.
tv_set
ChatGPTImposta 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'.
tv_status
ChatGPTStato 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.