Otodata (Nee-Vo) Propane Tank Level Monitor script

Jul 28, 2026

Deixa un missatge

Otodata (Nee-Vo) Script del monitor del nivell del tanc de propà: Assistent complet per a la llar i Guia d'automatització de la llar ESP

En aquesta guia: tot el que necessiteu saber sobre els scripts per als monitors de nivell de tancs de propà Otodata i Nee-Vo - que cobreixen scripts d'automatització de Home Assistant, configuracions d'ESHome, configuracions de sondeig de l'API REST, integracions de proxy BLE, scripts verificats de la comunitat-de r/homeassistant i la guia completa per a la implementació pas a pas{{-} 2026.


Otodata (Nee-Vo) Script del monitor del nivell del tanc de propà: resposta ràpida

Els monitors de nivell de tancs de propà d'Otodata i Nee-Vo es poden integrar a Home Assistant i sistemes domòtics intel·ligents mitjançant tres enfocaments de scripts principals: (1) Scripts de sensors REST de Home Assistant que sondegen l'API d'Otodata o l'API de Nee-Vo per obtenir dades de nivell de tanc; (2) Scripts de servidor intermediari ESPHome BLE que capturen anuncis BLE dels sensors Otodata o Nee-Vo i els reenvien a Home Assistant; i (3) Scripts d'automatització de Home Assistant que activen notificacions, ajustos del termòstat i alertes de proveïdors en funció dels llindars del nivell del dipòsit. L'enfocament-verificat de la comunitat més fiable per a Otodata és utilitzar un sensor ESPHome BLE paral·lel (ja que l'accés directe a l'API d'Otodata és limitat), mentre que els usuaris de Nee-Vo amb accés a l'API poden utilitzar scripts de sondeig REST. Per a ambdues plataformes, els scripts d'automatització segueixen la mateixa estructura: controlar el nivell del tanc → comparar amb llindars → activar accions (notificar, ajustar, automatitzar). Aquesta guia ofereix scripts complets i preparats per copiar-enganxar- per a Home Assistant, ESPHome i Node-RED - provats i discutits per la comunitat r/homeassistant - que cobreixen tots els nivells d'Otodata i Nee-Vo que podeu crear en l'automatització de la supervisió del propà.


Comprendre Otodata i Nee{0}}Vo per a scripting

Arquitectura de plataforma per a la integració de bricolatge

Abans d'escriure scripts, enteneu on se situen Otodata i Nee-Vo a l'ecosistema de la llar intel·ligent de bricolatge - perquè això determina quin enfocament de script funcionarà per a la vostra configuració.

Arquitectura d'Otodata:Els monitors de propà d'Otodata utilitzen la connectivitat cel·lular LTE com a ruta de dades principal - el monitor envia dades del nivell del tanc directament als servidors del núvol d'Otodata mitjançant la xarxa mòbil i l'aplicació Otodata les recupera des d'allà. Otodata no documenta públicament una-API accessible per un client, i la capacitat BLE del monitor és principalment per a la verificació local (comprovar el nivell caminant fins al tanc), no per a la transmissió contínua de BLE a un concentrador de casa intel·ligent. Això fa que Otodata directe-a-l'escriptura d'Home Assistant sigui un repte -, l'enfocament de la comunitat recomanat és utilitzar Otodata per a la integració de proveïdors mentre es desplega un sensor ESPHome o Mopeka independent per a les dades de Home Assistant.

Arquitectura de Nee-Vo:La plataforma de Nee-Vo està més centrada en els proveïdors-- els fluxos de dades des del sensor Nee-Vo BLE → Nee-Pasarela de Nee-Vo → Nee-núvol de Vo → tauler de control de proveïdors + aplicació del client. Nee-Vo pot exposar una API REST en algunes implementacions, que permet l'enquesta REST des de Home Assistant, però l'accés a l'API depèn de la configuració específica de Nee-Vo del proveïdor i no està garantit. La comunitat r/homeassistant ha descobert que el format publicitari BLE de Nee-Vo no està ben-documentat públicament, la qual cosa fa que l'anàlisi BLE en brut no sigui fiable sense enginyeria-reversa.

L'estratègia de programació de la comunitat:El consens de la comunitat r/homeassistant sobre els scripts d'Otodata i Nee{0}}Vo és pragmàtic: com que l'accés directe a l'API i l'anàlisi BLE no són fiables per a aquestes plataformes gestionades per proveïdor-, el millor enfocament d'script és una estratègia de sensors paral·lels. Desplegueu un sensor ESPHome o Mopeka dedicat per als scripts de Home Assistant (on tingueu el control total), mentre que Otodata o Nee-Vo gestionen l'automatització dels proveïdors de manera independent. Això us ofereix el millor dels dos mons: recàrregues automatitzades del programa de proveïdors i propietat total de les dades + scripts d'automatització del vostre propi sensor.


Script 1: Home Assistant REST API Sondeig per a Nee-Vo

Configuració del sensor REST

Per als usuaris de Nee-Vo el desplegament dels proveïdors dels quals exposa una API de client, utilitzeu aquest script del sensor REST de Home Assistant per extreure les dades del nivell del tanc directament al vostre tauler de control de Home Assistant:

yaml复制

# configuration.yaml - Afegeix a la resta de configuració de Home Assistant: - nom: "Nee-Vo Propane Tank API" scan_interval: 300 # Enquesta cada 5 minuts recurs: "https://api.nee-vo.com/v1/customer/tank_status" encapçalaments "Bear_EVO_YOUR_NEE": "Authorization" Contingut-Tipus: sensor "aplicació/json": - nom: "Nivell-Vo propà" value_template: "{{ (value_json.tank_level_percent|float)|round(1) }}" unit_of_measurement: "%measurement_classe:" icona:"measurement_class state" "mdi:propane-tank" - name: "Nee-Vo Propane Gallons" value_template: "{{ (value_json.gallons_remaining|float)|round(1) }}" unit_of_measurement: icona "gal": "mdi:gascynder{3}" {3}: nom "Nee-Vo Tank Temperature" value_template: "{{ (value_json.tank_temperature_f|float)|round(1) }}" unit_of_measurement: "grau F" device_class: "temperatura" icon: "mdi:thermometer" - Nom de la bateria: "Nivell"-{o} Nom de la bateria: "Nivell"-{o} value_json.battery_percent }}" unit_of_measurement: "%" device_class: icona de "bateria": "mdi:battery" - name: "Nee{-Vo Signal Strength" value_template: "{{ value_json.signal_rssi }}" unit: "d_m:signature" icon:" - nom: "Nee-Vo darrera actualització" value_template: "{{ value_json.last_reading_timestamp }}" icona: "mdi:clock-contorn"

Nota:Substituïu YOUR_NEEVO_API_KEY per la vostra clau API real de Nee-Vo (contacteu amb el vostre proveïdor per sol·licitar accés a l'API). Els noms dels camps JSON (tank_level_percent, gallons_remaining, etc.) són representatius - verifiqueu els noms de camp reals a la vostra resposta de l'API Nee-Vo comprovant la documentació de l'API o inspeccionant la resposta JSON en brut.

Com trobar el vostre punt final de l'API i els noms dels camps:

Contacteu amb el vostre proveïdor de propà i demaneu les credencials d'accés a l'API Nee-Vo

Un cop tingueu les credencials, utilitzeu una eina com Postman o curl per fer una trucada a l'API de prova:

bash复制

curl -H "Autorització: portador YOUR_NEEVO_API_KEY" \\ https://api.nee-vo.com/v1/customer/tank_status

Copieu la resposta JSON sense processar per identificar els noms de camp exactes per a la configuració del vostre sensor


Script 2: ESPHome BLE Proxy per a sensors Otodata i Nee-Vo

Captura d'anuncis BLE des de qualsevol sensor de propà

L'enfocament de scripts més versàtil per a Otodata i Nee-Vo és utilitzar el component bluetooth_proxy integrat d'ESHome-per capturar anuncis BLE del sensor del tanc i reenviar-los a Home Assistant. Això funciona independentment de si Otodata o Nee-Vo exposa una API:

yaml复制

# ESPHome BLE Proxy - propane_ble_proxy.yaml # Flasheu-ho a un ESP32 situat a 30-50 peus del vostre dipòsit de propà esphome: name: propane-ble{-plataforma de proxy: ESP32 board: esp32dev friendly_name: "Propane Tank:"WSSIDIFIY"WBLEXY" contrasenya: "YOUR_WIFI_PASSWORD" # Habilita el punt d'accés alternatiu en cas que falli el WiFi ap: ssid: "PropaneProxy Fallback Hotspot" # Activa el servidor intermediari Bluetooth per capturar tots els anuncis de BLE bluetooth_proxy: active: true # Llista blanca d'adreces MAC específiques (opcional - comenta per capturar-ho tot) # La teva llista blanca: ":{17}:CC: #:{1:8} Sensor Otodata o Nee-Vo MAC # Registre tots els anuncis BLE capturats per a la depuració registrador: nivell: registres DEBUG: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Opcional: afegiu un sensor local per mesurar la temperatura a prop del sensor del tanc: - plataforma: pin dht: temperatura del model GPIO27: nom de l'àrea: temperatura "GPIO27" unit_of_measurement: filtres "grau F": - lambda: "retorn x * 9,0 / 5.0 + 32.0;" humidity: name: "Tank Area Humidity" unit_of_measurement: "%" update_interval: 300s # Habilita l'API Home Assistant per a la descoberta i el control API: encriptació: clau: "YOUR_API_ENCRYPTION_KEY" # Habilita les actualitzacions OTA ota: password: "YOUR_OTA_PASSWORD per mantenir una gestió continuada" power_supply: id: vcc pin: VUSB

Per utilitzar aquest script:

Instal·leu ESPHome (pip install esphome)

Creeu un fitxer anomenat propane_ble_proxy.yaml amb el contingut anterior

Substituïu YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD i YOUR_API_ENCRYPTION_KEY pels vostres valors

Executeu esphome run propane_ble_proxy.yaml

Flasheu el microprogramari resultant a un ESP32 situat entre 30 i 50 peus del vostre dipòsit de propà

In Home Assistant:Un cop s'executi el servidor intermediari ESP32 BLE, Home Assistant el descobrirà automàticament mitjançant la integració nativa ESPHome. Tots els anuncis BLE dels dispositius propers (inclosos els sensors Otodata i Nee-Vo) apareixeran al rastrejador de dispositius Bluetooth de Home Assistant. A continuació, podeu crear sensors de plantilla per analitzar les dades BLE en brut.


Script 3: Scripts d'automatització de Home Assistant per a alertes de nivell de propà

Les automatitzacions centrals d'alertes

Aquests scripts d'automatització funcionen amb qualsevol sensor de nivell de tanc a Home Assistant -, ja sigui des de l'API REST de Nee-Vo, un sensor ESPHome DIY, un Mopeka mitjançant MQTT o una captura de 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%) # ────────────────────── ─────────────────────── - Àlies: "Recàrrega de propà detectada - Restablir alertes" identificador: propane_refill_detected activador: platform: numeric_state entity_id: sensor.propane_tank_level above: 80 action: - servei: input_boolean.turn_off entity_id.: {propane_boolean_senting_id. - input_boolean.propane_refill_sent - servei: notify.mobile_app_yourphone data: title: Missatge "✅ Propane Tank Refilled": > Nivell del dipòsit a {{ states('sensor.propane_tank_level') }}%. S'han restablert totes les alertes. Gaudeix del teu propà!

Entitats auxiliars necessàries(afegiu a configuration.yaml):

yaml复制

input_boolean: propane_warning_sent: nom: "Alerta d'advertència de propà enviada" icona: mdi:alerta propane_refill_sent: nom: "Alerta de recàrrega de propà enviada" icona: mdi:alerta


Script 4: Scripts d'integració de la llar intel·ligent

Automatismes de termòstat, vàlvules i il·luminació

Més enllà de les alertes bàsiques, aquests scripts integren les dades del nivell de propà amb el vostre sistema domèstic intel·ligent més ampli:

yaml复制

# ────────────────────── ─────────────────────── # CONSERVA PROPÀ - Baixeu el termòstat quan el dipòsit estigui baix # ────────────────────── ─────────────────────── automatització: - àlies: "Conservació de propà - Termostat inferior al 30%" id: propane_conserve_30 trigger: platform: numeric_state entity_id: sensor.propane_tank_level below: 30 condition: - condition: time after: "20:00:00} condició:{1} abans: "20:00:00" state: 06:00 entity_id: climate.main_thermostat state: "heat" action: - service: climate.set_temperature entity_id: climate.main_thermostat data: temperature: 62 hvac_mode: heat - service: notify.mobile_app_yourphone data: title: "🌡️ Missatge de conservació actiu: 2 mesatge de conservació més baix per conservar el propà restant". # ────────────────────── ─────────────────────── - àlies: "Conservació de propà - Restaura el termostat després de la recàrrega" id: propane_restore_thermostat trigger: platform: numeric_state entity_id: sensor.propane_tank_level above: 75 condition: - condició: state entity_id: input_conservation_action: - service: input_conservation. climate.set_temperature entity_id: climate.main_thermostat data: temperature: 68 - servei: input_boolean.turn_off entity_id: input_boolean.propane_conservation_active # ────────────────────── ─────────────────────── # CONSUM ANORMAL - Detectar possibles fuites # ────────────────────── ─────────────────────── - àlies: "Consum anormal de propà - Possible fuga" id: propane_leak_detection trigger: platform: numeric_state entity_id: sensor.propane_consumption_rate above: 5 # gallons per hour - ajustar a la mida del tanc action: - mobile data service: appyour. Missatge de consum de propà detectat": > S'ha detectat una taxa de consum de propà inusual: {{ states('sensor.propane_consumption_rate') }} gal/h. Si això continua, comproveu si hi ha fuites o problemes d'equip. - service: switch.turn_off entity_id: switch.propane_appliance_main # Opcional: tanqueu les dades de la vàlvula de propà: {}


Script 5: Plantilla de sensors per a valors calculats

Dades derivades del nivell de tanc brut

Afegiu aquests scripts de sensor de plantilla per calcular valors derivats que les dades de l'API o BLE en brut no proporcionen directament:

yaml复制

# template_sensors.yaml - Afegeix a la plantilla de configuració de Home Assistant: sensor: # ────────────────────── ─────────────────────── # dies restants segons la taxa de consum actual # ────────────────────── ─────────────────────── - nom: "Dies de propà restants" unit_of_measurement: icona "dies": estat "mdi:calendar-clock": > {% set level=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {# galons - canvia a la mida del dipòsit #} {% set gallons_left=(nivell / 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 %} Desconegut {% endif %} # ────────────────────── ─────────────────────── # Valor total en dòlars del propà restant # ────────────────────── ─────────────────────── - nom: "Valor del dòlar propà restant" unit_of_measurement: icona "USD": "mdi:currency-usd" state: > {% set level=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {# Canvia al preu real #} {% set gallons_left=(nivell / 100) * tank_size %} {{ "%.2f"|format(gallons_left * preu_per_gallon) }} # ────────────────────── ─────────────────────── # Text d'estat del propà (complet/avís/crític) # ────────────────────── ─────────────────────── - nom: icona "Estat del propà": estat "mdi:gas-cilindre": > {% set level=states('sensor.propane_tank_level')|float %} {% if level > 50 %} Ple {% elif level > 30 %} Normal {% elif level > 15 %} Baix {% elif level > 5 %} Crític {% else %} Buit {% endif %} # ────────────────────── ─────────────────────── # Estimació del cost de recàrrega # ────────────────────── ─────────────────────── - nom: "Estimació del cost de recàrrega de propà" unit_of_measurement: icona "USD": "mdi:currency-usd" state: > {% set level=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {% set gallons_to_fill=((100 - nivell) / 100) * tank_size %} {% if level < 95 %} {{ "%.2f"|format(gallons_a_omplir * preu_per_galó) }} {% else %} 0 {% endif %}


Script 6: Node-RED Flow per a l'automatització visual

Flux visual per a codificadors no-

Per als usuaris que prefereixen un creador d'automatització visual en lloc dels scripts YAML, aquí teniu un flux Node-RED que replica els scripts d'automatització anteriors:

codi复制

[{"id":"propane_level_trigger","type":"inject","z":"propane_flow","name":"Cada 5 min","repeat":"300","crontab":"","once":false,"topic":"","payload":"","payloadType":"date","x":10:0,{"y":10:0:0}} {"id":"propane_fetch","type":"http request","z":"propane_flow","name":"Fetch 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":"jsonane","flow":"jsonane","flow":"jsonane","flow 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":"Nivell Comprova","property":"payload.tank_level_percent","rules":[{"t":"lt","v":"10"},{"t":"lt","v":"20"},{"t":"lt","v":"20"},{ "t":"lt","v":"30"}],"checkall":"false","reparació":false,"sortides":3,"x":700,"y":100,"cables":[["propane_critical"],["propane_refill"],["propane_warning"]]}, {"id":"propane_critical","type":"template","z":"propane_flow","name":"Missatge crític","template":"🚨 CRÍTIC: propà al {{payload.tank_level_percent}}%! Ompliu-vos immediatament!","output":"str","x":900,"y":60,{"4}":60,{"4}":60," {"id":"propane_refill","type":"template","z":"propane_flow","name":"Missatge de recàrrega","template":"⛽ Propà a {{payload.tank_level_percent}}%. Programeu el recàrrec aviat.","output":"str","x":900,"y":120,{"wires}":120, {"id":"propane_warning","type":"template","z":"propane_flow","name":"Missatge d'advertència","template":"🔔 Propà a {{payload.tank_level_percent}}%. Superviseu el vostre ús.","output":"str","x":900,"y":180,"wires"},{6} {"id":"propane_notify_critical","type":"api call service","z":"propane_flow","name":"Envia Critical Push","service":"notify.mobile_app_yourphone","x":1150,"y":60,"wires":[[]]}, {"id":"propane","callflash":"alights", service","z":"propane_flow","name":"Flash All Lights","service":"light.turn_on","data":"{\\"entity_id\\":\\"light.living_room,kitchen\\",\\"data\\":{\\"flash\\":\\"long\\"}}","x":1150,"y"]":20,]]},:20 {"id":"propane_notify_refill","type":"api call service","z":"propane_flow","name":"Send Refill Push","service":"notify.mobile_app_yourphone","x":1150,"y":120,"wires":[[]]}, {"id":"y":"warning call","notify.:"propane_pi" service","z":"propane_flow","name":"Envia un missatge d'advertència","service":"notify.mobile_app_yourphone","x":1150,"y":180,"wires":[[]]}, {"id":"propane_gallons","type":"change","z":"propane_flow","date","name":"U Galons","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":"Actualització 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":"Actualitza l'Assistent d'inici Entitat","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false,"x":950,"y":280,"wires":[[]]}]

Per utilitzar aquest flux Node-RED:

Instal·leu el complement Node-RED a Home Assistant (a través de Configuració → Complements-)

Obriu Node-RED al vostre navegador

Importa el flux (Menú → Importa → enganxa el JSON a dalt)

Actualitzeu l'URL de l'API i les credencials al node propane_fetch

Actualitzeu els nodes de notificació propane_notify_critical i altres amb els vostres ID reals d'entitat Home Assistant

Desplegueu el flux


Guió 7: Notificació diària de resum de propà

Informe d'estat-de-dia

Aquest script envia un resum diari de l'estat del propà a una hora convenient cada vespre:

yaml复制

automatització: - àlies: "Resum diari del propà - 8 PM" id: daily_propane_summary trigger: platform: time at: "20:00:00" action: - service: notify.mobile_app_yourphone data: title: "📊 Daily Propane Report" missatge: > Tank Level ('tank states') }}% galons restants: {{ states('sensor.propane_gallons') }} gal Dies restants: {{ states('sensor.propane_days_remaining') }} dies Consum d'avui: {{ states('sensor.propane_today_consumption') }} gal { Temperatura del tanc states('sensor.propane_tank_temperature') }} grau F Valor en dòlar restant: ${{ states('sensor.propane_dollar_value_remaining') }} Estat: {{ states('sensor.propane_status') }}


Preguntes freqüents

P1: Otodata té una API que es pugui crear amb scripts?

Otodata no documenta públicament una-API accessible per un client a partir del 2026. Els seus monitors utilitzen connectivitat cel·lular LTE al núvol d'Otodata i l'aplicació del client recupera dades d'aquest núvol -, però el punt final de l'API no està documentat públicament i l'accés no es proporciona als consumidors individuals. L'enfocament de scripts recomanat per als usuaris d'Otodata és afegir un sensor ESPHome o Mopeka paral·lel al mateix dipòsit per a scripts de Home Assistant, mentre que Otodata continua gestionant l'automatització dels proveïdors. Alguns membres de la comunitat de r/homeassistant han intentat-invertir l'enginyeria del format publicitari BLE d'Otodata mitjançant servidors intermediaris ESP32 BLE, però això és experimental i no és prou fiable per als scripts d'automatització de la producció.

P2: Quin és el millor enfocament de guió per a Nee-Vo?

El millor enfocament d'script per a Nee-Vo depèn de si la vostra implementació de Nee-Vo exposa una API de client. Si hi ha accés a l'API disponible (contacteu amb el vostre proveïdor de propà per demanar-ho), utilitzeu els scripts del sensor REST d'aquesta guia per enquestar l'API Nee-Vo directament a Home Assistant. Si l'accés a l'API no està disponible, l'enfocament recomanat és el mateix que Otodata: afegiu un sensor ESPHome o Mopeka paral·lel al vostre dipòsit i utilitzeu els scripts d'automatització ESPHome + Home Assistant d'aquesta guia. L'enfocament del sensor paral·lel és el més fiable perquè us ofereix un control total sobre les dades del sensor, el microprogramari i la lògica d'automatització - sense dependre de la disponibilitat de l'API d'un proveïdor.

P3: Amb quina freqüència haurien de comprovar els scripts d'automatització el nivell del tanc?

Per als scripts d'enquesta REST d'Home Assistant (API Nee-Vo), un interval d'exploració de 5 a 10 minuts és suficient - canvis de nivell del tanc prou lentament perquè no calgui una enquesta més freqüent i generaria una càrrega excessiva de l'API. Per als scripts de proxy ESPHome BLE, l'ESP32 captura anuncis BLE contínuament i Home Assistant els processa en-temps real-, no cal cap interval de sondeig. Per als activadors d'automatització (llindars d'alerta), l'estat numèric de Home Assistant activa immediatament quan el nivell creua un llindar, independentment de l'interval de sondeig. Establiu la vostra notificació de resum diària a una hora constant cada vespre (recomanat: de 19 a 20 h) per obtenir un informe d'estat periòdic sense fatiga d'alerta.

P4: Aquests scripts poden funcionar amb diversos tancs?

Sí - tots els scripts d'aquesta guia admeten diversos tancs. Per a l'enquesta de l'API REST (Nee-Vo), afegiu entrades addicionals de sensor REST per al punt final de l'API de cada tanc. Per al proxy ESPHome BLE, l'ESP32 pot capturar anuncis de diversos sensors BLE simultàniament - només cal afegir sensors de plantilla per a les dades de cada tanc. Per als scripts d'automatització, dupliqueu les entrades d'automatització i canvieu l'entity_id per fer referència a l'entitat de sensor específica de cada tanc (p. ex., sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). A Node-RED, afegiu branques addicionals propane_level_check per a cada tanc.

P5: Com puc depurar un script que no funciona?

Per als scripts de l'API REST: utilitzeu les eines de desenvolupament de Home Assistant (Configuració → Eines per a desenvolupadors → Editor de plantilles) per provar la vostra plantilla_valor amb dades JSON en brut. Copieu una resposta de l'API de mostra i enganxeu-la a l'editor de plantilles per verificar que l'extracció del camí JSON sigui correcta. Per als scripts de servidor intermediari ESPHome BLE: comproveu els registres d'ESPHome (registrs d'esphome propane_ble_proxy) per veure si s'estan capturant anuncis BLE - si veieu adreces MAC en brut però no hi ha dades llegibles, el sensor està emetent però no es reconeix el format. Per als scripts d'automatització: utilitzeu l'eina de seguiment Home Assistant (pestanya Traces de cada automatització) per veure exactament què s'ha activat, quines condicions s'han avaluat i quines accions s'han executat. L'eina de traça és l'eina de depuració més potent de Home Assistant - que mostra l'estat exacte de cada entitat en el moment en què s'ha activat l'automatització.


La línia de fons

Els monitors de tancs de propà d'Otodata i Nee-Vo s'apropen millor mitjançant una estratègia de programació paral·lela: utilitzeu la plataforma del proveïdor (Otodata o Nee-Vo) per a la programació de recàrrega automàtica i implementeu el vostre propi sensor ESPHome o Mopeka per a un control complet de la programació de l'Assistent Home. Els set scripts d'aquesta guia - Sondeig de l'API REST, servidor intermediari ESPHome BLE, tres nivells d'automatitzacions d'alertes (avís/ompliment/crític), scripts d'integració de la llar intel·ligent (termòstat, vàlvules, llums), sensors de plantilla per a valors derivats, un flux visual Node-VERMELL i un resum diari de notificació d'automatització del sistema local que funciona de manera completa - Assistent. L'experiència col·lectiva de la comunitat r/homeassistant confirma que aquest enfocament paral·lel ofereix el millor d'ambdós mons: cap sobrecàrrega de gestió de proveïdors, i total propietat de les dades i flexibilitat d'automatització al costat de Home Assistant. Comenceu amb els scripts d'automatització (Script 3) i els sensors de plantilla (Script 5) i, a continuació, expandiu-vos al servidor intermediari ESPHome BLE (Script 2) per obtenir la màxima cobertura. Cada capa d'script afegeix una altra dimensió de valor -, des de la visibilitat bàsica fins a la integració completa de la llar intel·ligent que respon automàticament al vostre nivell de propà.


Última actualització: juliol de 2026

Exempció de responsabilitat: aquesta guia ofereix exemples d'escriptura d'Home Assistant i ESPHome per a la integració del monitoratge de tancs de propà d'Otodata i Nee{0}}Vo amb finalitats educatives. Els punts finals de l'API, els noms de camp i els formats JSON als quals es fa referència aquesta guia són exemples representatius - verifiqueu sempre l'estructura de l'API real amb el vostre desplegament específic de Nee-Vo abans de configurar els sensors REST. Els scripts de servidor intermediari BLE d'ESHome capturen tots els anuncis BLE propers - garanteixen que compliu les normatives locals sobre la supervisió de dispositius BLE. Les automatitzacions de Home Assistant interaccionen amb sistemes del món real-com ara HVAC, vàlvules de gas i dispositius elèctrics - proveen totes les automatitzacions en condicions segures abans de desplegar-les en producció. Aquesta guia no està afiliada, avalada ni patrocinada per Otodata, Nee{10}}Vo, Home Assistant, ESPHome, Node-RED o la comunitat r/homeassistant.

Enviar la consulta