Script di monitoraggio del livello del serbatoio di propano Otodata (Nee-Vo).

Jul 28, 2026

Lasciate un messaggio

Script per il monitoraggio del livello del serbatoio di propano Otodata (Nee-Vo): assistente domestico completo e guida all'automazione domestica ESP

In questa guida: tutto ciò che devi sapere sugli script per i monitor del livello del serbatoio di propano Otodata e Nee-Vo - che copre gli script di automazione di Home Assistant, le configurazioni ESPHome, le configurazioni di polling dell'API REST, le integrazioni proxy BLE, gli script verificati dalla comunità-da r/homeassistant e la guida completa all'implementazione passo passo-per-per il 2026.


Script per il monitoraggio del livello del serbatoio di propano Otodata (Nee-Vo): risposta rapida

I monitor del livello del serbatoio di propano Otodata e Nee-Vo possono essere integrati in Home Assistant e nei sistemi di automazione domestica intelligente attraverso tre approcci di scripting principali: (1) script del sensore REST di Home Assistant che interrogano l'API di Otodata o l'API di Nee-Vo per i dati sul livello del serbatoio; (2) Script proxy ESPHome BLE che acquisiscono annunci BLE dai sensori Otodata o Nee-Vo e li inoltrano a Home Assistant; e (3) script di automazione Home Assistant che attivano notifiche, regolazioni del termostato e avvisi dei fornitori in base alle soglie del livello del serbatoio. L'approccio più affidabile verificato dalla community-per Otodata è l'utilizzo di un sensore BLE ESPHome parallelo (poiché l'accesso diretto all'API di Otodata è limitato), mentre gli utenti Nee-Vo con accesso API possono utilizzare gli script di polling REST. Per entrambe le piattaforme, gli script di automazione seguono la stessa struttura: monitorare il livello del serbatoio → confrontare con le soglie → attivare azioni (notificare, regolare, automatizzare). Questa guida fornisce script completi, pronti per essere copiati-incolla-per Home Assistant, ESPHome e Node-RED - testati e discussi dalla community r/homeassistant - che coprono ogni livello di automazione del monitoraggio del propano Otodata e Nee-Vo che puoi creare nel 2026.


Comprendere Otodata e Nee-Vo per gli script

Architettura della piattaforma per l'integrazione fai-da-te

Prima di scrivere gli script, comprendi la posizione di Otodata e Nee-Vo nell'ecosistema della casa intelligente fai-da-te - perché ciò determina quale approccio di scripting funzionerà per la tua configurazione.

Architettura di Otodata:I monitor del propano Otodata utilizzano la connettività cellulare LTE come percorso dati principale - il monitor invia i dati del livello del serbatoio direttamente ai server cloud di Otodata tramite la rete cellulare e l'app Otodata li recupera da lì. Otodata non documenta pubblicamente un'API accessibile al cliente-e la funzionalità BLE del monitor è principalmente per la verifica locale (controllo del livello avvicinandosi al serbatoio), non per lo streaming BLE continuo verso un hub di casa intelligente. Ciò rende difficile lo scripting diretto da Otodata-a-Home Assistant - l'approccio consigliato dalla comunità è quello di utilizzare Otodata per l'integrazione dei fornitori durante l'implementazione di un sensore ESPHome o Mopeka separato per i dati di Home Assistant.

Architettura di Nee-Vo:La piattaforma di Nee-Vo è più incentrata sul fornitore-- i dati fluiscono dal sensore BLE di Nee-Vo → gateway di Nee-Vo → cloud di Nee-Vo → dashboard del fornitore + app del cliente. Nee-Vo può esporre un'API REST in alcune distribuzioni, che abilita il polling REST da Home Assistant, ma l'accesso all'API dipende dalla configurazione Nee-Vo del fornitore specifico e non è garantito. La community r/homeassistant ha scoperto che il formato pubblicitario BLE di Nee-Vo non è ben-documentato pubblicamente, rendendo inaffidabile l'analisi BLE grezza senza-ingegneria inversa.

La strategia di scripting della comunità:Il consenso della comunità r/homeassistant sugli script Otodata e Nee-Vo è pragmatico: poiché l'accesso diretto alle API e l'analisi BLE non sono affidabili per queste piattaforme gestite dai fornitori-, il miglior approccio di scripting è una strategia di sensori paralleli. Implementa un sensore ESPHome o Mopeka dedicato per lo scripting di Home Assistant (dove hai il pieno controllo), mentre Otodata o Nee-Vo gestisce l'automazione dei fornitori in modo indipendente. Questo ti offre il meglio di entrambi i mondi: ricariche automatizzate dal programma del fornitore e piena proprietà dei dati + scripting di automazione dal tuo sensore.


Script 1: polling dell'API REST di Home Assistant per Nee-Vo

Configurazione del sensore REST

Per gli utenti Nee-Vo la cui distribuzione del fornitore espone un'API del cliente, utilizza questo script del sensore REST di Home Assistant per inserire i dati sul livello del serbatoio direttamente nella dashboard di Home Assistant:

yaml复制

# configurazione.yaml - Aggiungi al resto della configurazione di Home Assistant: - nome: "Nee-Vo Propane Tank API" scan_interval: 300 # Poll ogni 5 minuti risorsa: "https://api.nee-vo.com/v1/customer/tank_status" intestazioni: Autorizzazione: "Bearer YOUR_NEEVO_API_KEY" Contenuto-Tipo: sensore "application/json": - nome: "Nee-Vo Propane Level" value_template: "{{ (value_json.tank_level_percent|float)|round(1) }}" unit_of_measurement: "%" device_class: "measurement" state_class: "measurement" icona: "mdi:propane-tank" - nome: "Nee-Vo Propane Gallons" value_template: "{{ (value_json.gallons_remaining|float)|round(1) }}" unit_of_measurement: "gal" icona: "mdi:gas-cylinder" - nome: "Nee-Vo Tank Temperature" value_template: "{{ (value_json.tank_temperature_f|float) |. round(1) }}" unità_di_misura: " gradi F" classe_dispositivo: "temperatura" icona: "mdi:termometro" - nome: "Nee-Livello batteria Vo" valore_template: "{{ value_json.battery_percent }}" unità_di_misura: "%" classe_dispositivo: icona "batteria": "mdi:battery" - nome: "Nee-Vo Signal Strength" value_template: "{{ value_json.signal_rssi }}" unit_of_measurement: "dBm" icona: "mdi:signal" - nome: "Nee-Vo Last Updated" value_template: "{{ value_json.last_reading_timestamp }}" icona: "mdi:clock-outline"

Nota:Sostituisci YOUR_NEEVO_API_KEY con la tua chiave API effettiva di Nee-Vo (contatta il tuo fornitore per richiedere l'accesso API). I nomi dei campi JSON (tank_level_percent, gallons_remaining, ecc.) sono rappresentativi - verifica i nomi dei campi effettivi nella tua risposta API Nee-Vo controllando la documentazione dell'API o esaminando la risposta JSON non elaborata.

Come trovare l'endpoint API e i nomi dei campi:

Contatta il tuo fornitore di propano e chiedi le credenziali di accesso all'API Nee-Vo

Una volta ottenute le credenziali, utilizza uno strumento come Postman o curl per effettuare una chiamata API di prova:

bash复制

curl -H "Autorizzazione: Portatore YOUR_NEEVO_API_KEY" \\ https://api.nee-vo.com/v1/customer/tank_status

Copia la risposta JSON non elaborata per identificare i nomi esatti dei campi per la configurazione del sensore


Script 2: proxy BLE ESPHome per sensori Otodata e Nee-Vo

Acquisizione di annunci BLE da qualsiasi sensore di propano

L'approccio di scripting più versatile per Otodata e Nee-Vo consiste nell'utilizzare il componente bluetooth_proxy integrato-di ESPHome per acquisire annunci BLE dal sensore del serbatoio e inoltrarli a Home Assistant. Funziona indipendentemente dal fatto che Otodata o Nee-Vo espongano un'API:

yaml复制

# ESPHome BLE Proxy - propane_ble_proxy.yaml # Invia questo messaggio a un ESP32 posizionato entro 30-50 piedi dal serbatoio di propano esphome: name: propane-ble-proxy platform: Scheda ESP32: esp32dev friendly_name: "Propane Tank BLE Proxy" wifi: ssid: "YOUR_WIFI_SSID" password: "YOUR_WIFI_PASSWORD" # Abilita l'hotspot di fallback nel caso in cui il WiFi fallisca ap: ssid: "PropaneProxy Fallback Hotspot" # Abilita il proxy Bluetooth per acquisire tutti gli annunci BLE bluetooth_proxy: active: true # Inserisci nella whitelist indirizzi MAC specifici (facoltativo - commento per catturarli tutti) # whitelist: # - "AA:BB:CC:DD:EE:FF" # Il tuo Otodata o Nee-Vo sensore MAC # Registra tutti gli annunci BLE catturati per il logger di debug: livello: DEBUG logs: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Opzionale: aggiungi un sensore locale per misurare la temperatura vicino al serbatoio sensore: - piattaforma: dht pin: GPIO27 modello: DHT22 temperatura: nome: "Tank Area Temperature" unità_di_misura: " gradi F" filtri: - lambda: "return x *9.0/5.0 + 32.0;" umidità: nome: "Tank Area Humidity" unit_of_measurement: "%" update_interval: 300s # Abilita l'API Home Assistant per il rilevamento e il controllo api: crittografia: key: "YOUR_API_ENCRYPTION_KEY" # Abilita gli aggiornamenti OTA ota: password: "YOUR_OTA_PASSWORD" # Gestione energetica: mantieni ESP32 sveglio per il monitoraggio BLE continuo power_supply: id: vcc pin: VUSB

Per utilizzare questo script:

Installa ESPHome (pip installa esphome)

Crea un file denominato propane_ble_proxy.yaml con il contenuto sopra

Sostituisci YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD e YOUR_API_ENCRYPTION_KEY con i tuoi valori

Esegui esphome esegui propane_ble_proxy.yaml

Installa il firmware risultante su un ESP32 posizionato entro 30-50 piedi dal serbatoio di propano

Nell'assistente domestico:Una volta che il proxy ESP32 BLE è in esecuzione, Home Assistant lo rileverà automaticamente tramite l'integrazione nativa ESPHome. Tutti gli annunci BLE provenienti dai dispositivi vicini (inclusi i sensori Otodata e Nee-Vo) verranno visualizzati nel tracker del dispositivo Bluetooth di Home Assistant. È quindi possibile creare sensori modello per analizzare i dati BLE grezzi.


Script 3: script di automazione dell'assistente domestico per avvisi sul livello di propano

Le principali automazioni degli avvisi

Questi script di automazione funzionano con qualsiasi sensore di livello del serbatoio in Home Assistant - sia dall'API REST di Nee-Vo, un sensore ESPHome DIY, un Mopeka tramite MQTT o un'acquisizione proxy BLE:

yaml复制

# automations.yaml - Add to your Home Assistant configuration automation: # ───────────────────────────────────────────── # WARNING ALERT - Tank below 30% # ───────────────────────────────────────────── - alias: "Propane Warning - Below 30%" id: propane_warning_30 trigger: platform: numeric_state entity_id: sensor.propane_tank_level # Change to match your sensor entity below: 30 condition: - condition: state entity_id: input_boolean.propane_warning_sent state: "off" action: - service: notify.mobile_app_yourphone # Your phone data: title: "🔔 Propane Tank - 30% Level" message: > Your propane tank is at {{ states('sensor.propane_tank_level') }}%. Estimated {{ states('sensor.propane_days_remaining') }} days remaining. Consider scheduling a refill. - service: input_boolean.turn_on entity_id: input_boolean.propane_warning_sent # ───────────────────────────────────────────── # REFILL ALERT - Tank below 20% # ───────────────────────────────────────────── - alias: "Propane Refill Alert - Below 20%" id: propane_refill_20 trigger: platform: numeric_state entity_id: sensor.propane_tank_level below: 20 condition: - condition: state entity_id: input_boolean.propane_refill_sent state: "off" action: - service: notify.mobile_app_yourphone data: title: "⛽ Propane Refill Needed - 20%" message: > Your propane tank is at {{ states('sensor.propane_tank_level') }}%. Refill is recommended within the next 3–5 days. Contact your propane supplier or use automated refill request. - service: input_boolean.turn_on entity_id: input_boolean.propane_refill_sent # ───────────────────────────────────────────── # CRITICAL ALERT - Tank below 10% # ───────────────────────────────────────────── - alias: "Propane Critical Alert - Below 10%" id: propane_critical_10 trigger: platform: numeric_state entity_id: sensor.propane_tank_level below: 10 action: - service: notify.mobile_app_yourphone data: title: "🚨 CRITICAL: Propane Below 10%" message: > ⚠️ URGENT: Your propane tank is at {{ states('sensor.propane_tank_level') }}%. Refill immediately! Do not wait. - service: light.turn_on entity_id: - light.living_room - light.kitchen data: flash: long brightness_pct: 100 - service: notify.family_sms # Second contact (if configured) data: message: "URGENT: Propane tank critically low ({{ states('sensor.propane_tank_level') }}%). Refill needed immediately." # ───────────────────────────────────────────── # RESET ALERTS - When tank is refilled (level jumps >15%)# ────────────────────── ─────────────────────── - alias: "Ricarica propano rilevata - Reimposta avvisi" id: propane_refill_detected trigger: piattaforma: numeric_state entità_id: sensor.propane_tank_level sopra: 80 azione: - servizio: input_boolean.turn_off entità_id: - input_boolean.propane_warning_sent - input_boolean.propane_refill_sent - service: notify.mobile_app_yourphone data: title: "✅ Serbatoio di propano riempito" messaggio: > Livello del serbatoio a {{ states('sensor.propane_tank_level') }}%. Tutti gli avvisi sono stati ripristinati. Goditi il ​​tuo propano!

Entità di supporto richieste(aggiungi a Configuration.yaml):

yaml复制

input_boolean: propane_warning_sent: nome: Icona "Avviso propano inviato": mdi:alert propane_refill_sent: nome: Icona "Avviso ricarica propano inviato": mdi:alert


Script 4: script di integrazione Smart Home

Automazioni di termostati, valvole e illuminazione

Oltre agli avvisi di base, questi script integrano i dati sul livello di propano con il tuo più ampio sistema di casa intelligente:

yaml复制

# ────────────────────── ─────────────────────── # RISPARMIA PROPANO - Abbassa il termostato quando il serbatoio è basso # ────────────────────── ─────────────────────── automazione: - alias: "Conservazione propano - Termostato inferiore al 30%" id: propane_conserve_30 trigger: piattaforma: numeric_state entità_id: sensor.propane_tank_level di seguito: 30 condizione: - condizione: tempo dopo: "20:00:00" prima: "06:00:00" - condizione: stato entità_id: clima.main_thermostat stato: "calore" azione: - servizio: clima.set_temperature entità_id: clima.main_thermostat dati: temperatura: 62 hvac_mode: calore - servizio: notify.mobile_app_yourphone dati: titolo: "🌡️ Modalità di conservazione del propano attiva" messaggio: "Termostato abbassato a 62 gradi F per conservare il propano rimanente." # ────────────────────── ─────────────────────── - alias: "Propane Conservation - Ripristino termostato dopo ricarica" id: propane_restore_thermostat trigger: piattaforma: numeric_state entità_id: sensor.propane_tank_level sopra: 75 condizione: - condizione: stato entità_id: input_boolean.propane_conservation_active stato: "on" azione: - servizio: clima.set_temperature entità_id: clima.main_thermostat dati: temperatura: 68 - servizio: input_boolean.turn_off entità_id: input_boolean.propane_conservation_active # ────────────────────── ─────────────────────── # CONSUMO ANOMALO - Rileva potenziale perdita # ────────────────────── ─────────────────────── - alias: "Consumo anomalo di propano - Possibile perdita" id: propane_leak_detection trigger: piattaforma: numeric_state entità_id: sensor.propane_consumption_rate sopra: 5 # Galloni all'ora - adatta alla dimensione del serbatoio azione: - servizio: notify.mobile_app_yourphone data: titolo: "⚠️ Propano anormale Messaggio "Consumption Detected": > Tasso di consumo insolito di propano rilevato: {{ states('sensor.propane_consumption_rate') }} gal/hr. Se il problema persiste, controlla eventuali perdite o problemi con l'apparecchiatura. - service: switch.turn_offentity_id: switch.propane_appliance_main # Opzionale: shut off propano Valve data: {}


Script 5: sensori modello per valori calcolati

Dati derivati ​​dal livello del serbatoio grezzo

Aggiungi questi script del sensore modello per calcolare i valori derivati ​​che l'API grezza o i dati BLE non forniscono direttamente:

yaml复制

# template_sensors.yaml - Aggiungi al modello di configurazione di Home Assistant: sensor: # ────────────────────── ─────────────────────── # Giorni rimanenti in base al consumo attuale # ────────────────────── ─────────────────────── - nome: "Giorni di propano rimanenti" unità_di_misura: "giorni" icona: "mdi:calendar-orologio" stato: > {% set level=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {# Gallons - cambia la dimensione del serbatoio #} {% set gallons_left=(livello / 100) * tank_size %} {% set daily_rate=states('sensor.propane_daily_consumption')|float %} {% if daily_rate > 0 and gallons_left > 0 %} {{ (gallons_left / daily_rate)|round(1) }} {% else %} Sconosciuto {% endif %} # ────────────────────── ─────────────────────── # Valore totale in dollari del propano rimanente # ────────────────────── ─────────────────────── - nome: "Propane Dollar Value Remaining" unità_di_misura: "USD" icona: "mdi:currency-usd" stato: > {% set level=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {# Modifica il prezzo effettivo #} {% set gallons_left=(livello / 100) * tank_size %} {{ "%.2f"|format(galloni_sinistra * prezzo_per_gallone) }} # ────────────────────── ─────────────────────── # Testo sullo stato del propano (pieno/avviso/critico) # ────────────────────── ─────────────────────── - nome: "Stato propano" icona: "mdi:gas-bombola" stato: > {% set level=states('sensor.propane_tank_level')|float %} {% if level > 50 %} Pieno {% elif level > 30 %} Normale {% elif level > 15 %} Basso {% elif level > 5 %} Critico {% else %} Vuoto {% endif %} # ────────────────────── ─────────────────────── # Preventivo costo ricarica # ────────────────────── ─────────────────────── - nome: "Stima dei costi di ricarica del propano" unità_di_misura: "USD" icona: "mdi:currency-usd" stato: > {% set level=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {% set gallons_to_fill=((100 - level) / 100) * tank_size %} {% if level < 95 %} {{ "%.2f"|format(gallons_to_fill * price_per_gallon) }} {% else %} 0 {% endif %}


Script 6: Flusso Nodo-RED per l'automazione visiva

Flusso visivo per non-programmatori

Per gli utenti che preferiscono uno strumento di creazione dell'automazione visiva rispetto allo scripting YAML, ecco un flusso Node-RED che replica gli script di automazione sopra:

codice复制

[{"id":"propane_level_trigger","type":"inject","z":"propane_flow","name":"Ogni 5 minuti","repeat":"300","crontab":"","once":false,"topic":"","payload":"","payloadType":"date","x":100,"y":100,"wires":[["propane_fetch"]]}, {"id":"propane_fetch","type":"http request","z":"propane_flow","name":"Recupera Nee-Vo API","method":"GET","url":"https://api.nee-vo.com/v1/customer/tank_status","tls":"","x":300,"y":100,"wires":[["propane_parse","propane_debug"]]}, {"id":"propane_parse","type":"json","z":"propane_flow","name":"Analizza JSON","property":"payload","action":"obj","x":500,"y":100,"wires":[["propane_level_check","propane_gallons","propane_temp"]]}, {"id":"propane_level_check","type":"switch","z":"propane_flow","name":"Livello Check","property":"payload.tank_level_percent","rules":[{"t":"lt","v":"10"},{"t":"lt","v":"20"},{"t":"lt","v":"30"}],"checkall":"false","repair":false,"outputs":3,"x":700,"y":100,"wires":[["propane_critical"],["propane_refill"],["propane_warning"]]}, {"id":"propane_critical","type":"template","z":"propane_flow","name":"Messaggio critico","template":"🚨 CRITICO: propano al {{payload.tank_level_percent}}%! Ricarica immediatamente!","output":"str","x":900,"y":60,"wires":[["propane_notify_critical","propane_flash_lights"]]}, {"id":"propane_refill","type":"template","z":"propane_flow","name":"Messaggio di ricarica","template":"⛽ Propano al {{payload.tank_level_percent}}%. Pianifica la ricarica a breve.","output":"str","x":900,"y":120,"wires":[["propane_notify_refill"]]}, {"id":"propane_warning","type":"template","z":"propane_flow","name":"Messaggio di avviso","template":"🔔 Propano al {{payload.tank_level_percent}}%. Monitora il tuo utilizzo.","output":"str","x":900,"y":180,"wires":[["propane_notify_warning"]]}, {"id":"propane_notify_critical","type":"api call service","z":"propane_flow","name":"Invia push critico","service":"notify.mobile_app_yourphone","x":1150,"y":60,"wires":[[]]}, {"id":"propane_flash_lights","type":"api call service","z":"propane_flow","name":"Flash tutto Lights","service":"light.turn_on","data":"{\\"entity_id\\":\\"light.living_room,kitchen\\",\\"data\\":{\\"flash\\":\\"long\\"}}","x":1150,"y":20,"wires":[[]]}, {"id":"propane_notify_refill","type":"api call service","z":"propane_flow","name":"Invia ricarica Push","service":"notify.mobile_app_yourphone","x":1150,"y":120,"wires":[[]]}, {"id":"propane_notify_warning","type":"api call service","z":"propane_flow","name":"Invia avviso Push","service":"notify.mobile_app_yourphone","x":1150,"y":180,"wires":[[]]}, {"id":"propane_gallons","type":"change","z":"propane_flow","name":"Aggiorna galloni","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.gallons_remaining","tot":"msg"}],"x":700,"y":260,"wires":[["propane_ha_entity"]]}, {"id":"propane_temp","type":"change","z":"propane_flow","name":"Aggiorna temperatura","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.tank_temperature_f","tot":"msg"}],"x":700,"y":300,"wires":[["propane_ha_entity"]]}, {"id":"propane_ha_entity","type":"ha-api","z":"propane_flow","name":"Aggiorna Assistente domestico Entità","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false,"x":950,"y":280,"wires":[[]]}]

Per utilizzare questo flusso del Nodo-ROSSO:

Installa il componente aggiuntivo Node-RED in Home Assistant (tramite Impostazioni → Componenti aggiuntivi-on)

Apri Node-RED nel tuo browser

Importa il flusso (Menu → Importa → incolla il JSON sopra)

Aggiorna l'URL dell'API e le credenziali nel nodo propane_fetch

Aggiorna propane_notify_critical e altri nodi di notifica con i tuoi ID entità Home Assistant effettivi

Distribuire il flusso


Script 7: notifica di riepilogo giornaliera del propano

Rapporto sullo stato di fine-del-giorno

Questo script invia un riepilogo giornaliero dello stato del propano ogni sera a un orario conveniente:

yaml复制

automazione: - alias: "Riepilogo giornaliero del propano - 8 PM" id: daily_propane_summary trigger: piattaforma: ora alle: "20:00:00" azione: - servizio: notify.mobile_app_yourphone data: titolo: "📊 Report giornaliero del propano" messaggio: > Livello del serbatoio: {{ states('sensor.propane_tank_level') }}% galloni Rimanente: {{ states('sensor.propane_gallons') }} gal Giorni rimanenti: {{ states('sensor.propane_days_remaining') }} giorni Consumo odierno: {{ states('sensor.propane_today_consumption') }} gal Temperatura del serbatoio: {{ states('sensor.propane_tank_temperature') }} gradi F Valore in dollari rimanente: ${{ states('sensor.propane_dollar_value_remaining') }} Stato: {{ states('sensor.propane_status') }}


Domande frequenti

Q1: Otodata dispone di un'API che può essere scritta tramite script?

Otodata non documenta pubblicamente un'API accessibile al cliente- a partire dal 2026. I loro monitor utilizzano la connettività cellulare LTE al cloud di Otodata e l'app del cliente recupera i dati da quel cloud - ma l'endpoint API non è documentato pubblicamente e l'accesso non viene fornito ai singoli consumatori. L'approccio di scripting consigliato per gli utenti di Otodata è quello di aggiungere un sensore ESPHome o Mopeka parallelo allo stesso serbatoio per lo scripting di Home Assistant, mentre Otodata continua a gestire l'automazione dei fornitori. Alcuni membri della comunità r/homeassistant hanno tentato di decodificare-il formato pubblicitario BLE di Otodata utilizzando i proxy BLE ESP32, ma questo è sperimentale e non sufficientemente affidabile per gli script di automazione della produzione.

D2: Qual è il miglior approccio allo scripting per Nee-Vo?

Il miglior approccio di scripting per Nee-Vo dipende dal fatto che la tua distribuzione Nee-Vo esponga un'API del cliente. Se l'accesso API è disponibile (contatta il tuo fornitore di propano per chiedere), utilizza gli script del sensore REST in questa guida per eseguire il polling dell'API Nee-Vo direttamente in Home Assistant. Se l'accesso API non è disponibile, l'approccio consigliato è lo stesso di Otodata: aggiungi un sensore ESPHome o Mopeka parallelo al tuo acquario e utilizza gli script di automazione ESPHome + Home Assistant in questa guida. L'approccio con sensori paralleli è il più affidabile perché ti offre il pieno controllo sui dati dei sensori, sul firmware e sulla logica di automazione - senza alcuna dipendenza dalla disponibilità dell'API di un fornitore.

Q3: Con quale frequenza gli script di automazione dovrebbero controllare il livello del serbatoio?

Per gli script di polling REST di Home Assistant (API Nee-Vo), è sufficiente un intervallo di scansione di 5–10 minuti. - il livello del serbatoio cambia abbastanza lentamente da rendere superflui polling più frequenti e da generare un carico API eccessivo. Per gli script proxy BLE ESPHome, ESP32 acquisisce continuamente annunci BLE e Home Assistant li elabora in tempo reale- - senza intervallo di polling. Per i trigger di automazione (soglie di avviso), i trigger numeric_state di Home Assistant si attivano immediatamente quando il livello supera una soglia, indipendentemente dall'intervallo di polling. Imposta la notifica di riepilogo giornaliera per un orario costante ogni sera (consigliato: 19:00-20:00) per ottenere un rapporto sullo stato regolare senza affaticare gli avvisi.

Q4: Questi script possono funzionare con più carri armati?

Sì - tutti gli script in questa guida supportano più serbatoi. Per il polling dell'API REST (Nee-Vo), aggiungi ulteriori voci del sensore REST per l'endpoint API di ciascun serbatoio. Per il proxy ESPHome BLE, ESP32 può acquisire annunci pubblicitari da più sensori BLE contemporaneamente - è sufficiente aggiungere sensori modello per i dati di ciascun serbatoio. Per gli script di automazione, duplica le voci di automazione e modifica l'entity_id per fare riferimento all'entità del sensore specifica di ciascun serbatoio (ad esempio, sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). Nel Nodo-RED, aggiungi ulteriori rami propane_level_check per ogni serbatoio.

Q5: Come posso eseguire il debug di uno script che non funziona?

Per gli script API REST: utilizza gli strumenti per sviluppatori di Home Assistant (Impostazioni → Strumenti per sviluppatori → Editor di modelli) per testare il tuo value_template rispetto ai dati JSON non elaborati. Copia una risposta API di esempio e incollala nell'editor del modello per verificare che l'estrazione del percorso JSON sia corretta. Per gli script proxy BLE ESPHome: controlla i log ESPHome (esphome logs propane_ble_proxy) per vedere se gli annunci BLE vengono catturati - se vedi indirizzi MAC non elaborati ma nessun dato leggibile, il sensore sta trasmettendo ma il formato non è riconosciuto. Per gli script di automazione: utilizza lo strumento di tracciamento di Home Assistant (scheda Tracce su ciascuna automazione) per vedere esattamente cosa è stato attivato, quali condizioni sono state valutate e quali azioni sono state eseguite. Lo strumento di tracciamento è lo strumento di debug più potente in Home Assistant - mostra lo stato esatto di ogni entità nel momento in cui è stata attivata l'automazione.


La linea di fondo

Il modo migliore per gestire i monitor dei serbatoi di propano Otodata e Nee-Vo è attraverso una strategia di scripting parallela: utilizza la piattaforma del fornitore (Otodata o Nee-Vo) per la pianificazione automatizzata della ricarica e distribuisci il tuo sensore ESPHome o Mopeka per il controllo completo dello scripting di Home Assistant. I sette script in questa guida - polling API REST, proxy ESPHome BLE, tre livelli di automazione degli avvisi (avviso/ricarica/critica), script di integrazione domestica intelligente (termostato, valvole, luci), sensori modello per valori derivati, un flusso visivo Nodo-RED e una notifica di riepilogo giornaliera - ti offrono un sistema di automazione completo del monitoraggio del propano che funziona interamente localmente in Home Assistant. L'esperienza collettiva della comunità r/homeassistant conferma che questo approccio parallelo offre il meglio di entrambi i mondi: zero costi di gestione dei fornitori e completa proprietà dei dati e flessibilità di automazione da parte di Home Assistant. Inizia con gli script di automazione (Script 3) e i sensori dei modelli (Script 5), quindi espandi al proxy ESPHome BLE (Script 2) per la massima copertura. Ogni livello di script aggiunge un'altra dimensione di valore - dalla visibilità del livello di base all'integrazione completa della casa intelligente che risponde automaticamente al tuo livello di propano.


Ultimo aggiornamento: luglio 2026

Dichiarazione di non responsabilità: questa guida fornisce esempi di scripting per Home Assistant ed ESPHome per l'integrazione del monitoraggio dei serbatoi di propano Otodata e Nee-Vo per scopi didattici. Gli endpoint API, i nomi dei campi e i formati JSON a cui si fa riferimento in questa guida sono esempi rappresentativi - verifica sempre la struttura API effettiva con la tua distribuzione Nee-Vo specifica prima di configurare i sensori REST. Gli script proxy BLE ESPHome catturano tutti gli annunci BLE nelle vicinanze - assicurano la conformità alle normative locali relative al monitoraggio dei dispositivi BLE. Le automazioni di Home Assistant interagiscono con i sistemi-del mondo reale, tra cui HVAC, valvole del gas e dispositivi elettrici. - testano tutte le automazioni in condizioni di sicurezza prima di metterle in produzione. Questa guida non è affiliata, approvata o sponsorizzata da Otodata, Nee-Vo, Home Assistant, ESPHome, Node-RED o dalla community r/homeassistant.

Invia la tua richiesta