Otodata (Nee{0}}Vo) Skript monitora hladiny propánovej nádrže: Kompletný sprievodca automatizáciou domáceho asistenta a ESPHome

V tejto príručke: Všetko, čo potrebujete vedieť o skriptovaní pre Otodata a Nee-Vo monitory hladiny propánovej nádrže - zahŕňajúce automatizačné skripty Home Assistant, konfigurácie ESPHome, nastavenia REST API, integrácie BLE proxy, komunitné-overené skripty od r/homeassistant a kompletnú implementáciu 202}krokov{4}{3}.

Otodata (Nee{0}}Vo) skript monitora hladiny propánovej nádrže: Rýchla odpoveď

Monitory hladiny propánu v nádrži Otodata a Nee-Vo možno integrovať do systémov Home Assistant a inteligentných domácich automatizačných systémov prostredníctvom troch základných skriptovacích prístupov: (1) skripty snímača REST Home Assistant, ktoré zisťujú údaje o hladine nádrže v rozhraní API Otodata alebo Nee{2}}Vo; (2) proxy skripty ESPHome BLE, ktoré zachytávajú reklamy BLE zo senzorov Otodata alebo Nee{4}}Vo a posielajú ich Home Assistant; a (3) Automatizačné skripty Home Assistant, ktoré spúšťajú upozornenia, nastavenia termostatu a upozornenia dodávateľa na základe prahových hodnôt hladiny v nádrži. Najspoľahlivejším komunitou-overeným prístupom pre Otodata je použitie paralelného senzora ESPHome BLE (keďže priamy prístup k API Otodata je obmedzený), zatiaľ čo používatelia Nee{8}}Vo s prístupom k API môžu používať REST prieskumné skripty. Pre obe platformy majú automatizačné skripty rovnakú štruktúru: monitorovať hladinu nádrže → porovnávať s prahovými hodnotami → spúšťať akcie (upozorňovať, upravovať, automatizovať). Táto príručka poskytuje kompletné skripty pripravené na kopírovanie{11}}prilepenie{12}}pre Home Assistant, ESPHome a Node{13}}RED - testované a diskutované komunitou r/homeassistant - pokrývajúce všetky úrovne Otodata a Nee{16}}Vo propane v automatizácii monitorovania 2026, ktorú môžete vytvoriť.

Pochopenie Otodata a Nee{0}}Vo for Scripting

Platformová architektúra pre DIY integráciu

Pred písaním skriptov pochopte, kde sa Otodata a Nee{0}}Vo nachádzajú v ekosystéme inteligentnej domácnosti pre domácich majstrov -, pretože to určuje, ktorý prístup k skriptovaniu bude pre vaše nastavenie fungovať.

Architektúra Otodata:Propánové monitory Otodata používajú ako primárnu dátovú cestu mobilné pripojenie LTE - monitor odosiela údaje o hladine nádrže priamo na cloudové servery spoločnosti Otodata prostredníctvom mobilnej siete a aplikácia Otodata ich odtiaľ získava. Otodata verejne nezdokumentuje zákaznícke-rozhranie API a schopnosť monitora BLE je primárne určená na miestne overenie (kontrola úrovne chôdzou k nádrži), nie na nepretržité streamovanie BLE do centra inteligentnej domácnosti. Vďaka tomu je priame skriptovanie Otodata-to-Home Assistant náročné -. Odporúčaným komunitným prístupom je použitie Otodata na integráciu dodávateľov pri nasadení samostatného senzora ESPHome alebo Mopeka pre údaje Home Assistant.

Architektúra Nee-Vo:Platforma Nee-Vo je viac zameraná na dodávateľa-- toky údajov zo snímača Nee-Vo BLE → Nee-brána Vo → Nee-Cloud Vo → panel dodávateľa + zákaznícka aplikácia. Nee-Vo môže v niektorých nasadeniach odhaliť rozhranie REST API, ktoré umožňuje prieskum REST z Home Assistant, ale prístup k API závisí od konfigurácie Nee-Vo konkrétneho dodávateľa a nie je zaručený. Komunita r/homeassistant zistila, že reklamný formát BLE spoločnosti Nee-Vo nie je dobre{12}}zdokumentovaný verejne, v dôsledku čoho je surová analýza BLE nespoľahlivá bez spätného{13}}inžinierstva.

Stratégia komunitného skriptovania:Konsenzus komunity r/homeassistant o skriptovaní Otodata a Nee-Vo je pragmatický: keďže priamy prístup k rozhraniu API a analýza BLE nie sú pre tieto platformy spravované dodávateľmi-spoľahlivé, najlepším skriptovacím prístupom je stratégia paralelných senzorov. Nasaďte vyhradený senzor ESPHome alebo Mopeka na skriptovanie Home Assistant (kde máte plnú kontrolu), zatiaľ čo Otodata alebo Nee-Vo zvláda automatizáciu dodávateľov nezávisle. To vám dáva to najlepšie z oboch svetov: automatické dopĺňanie z dodávateľského programu a úplné vlastníctvo údajov + automatické skriptovanie z vášho vlastného senzora.

Skript 1: Home Assistant REST API Polling for Nee-Vo

Konfigurácia snímača REST

Pre používateľov Nee-Vo, ktorých nasadenie dodávateľa odhaľuje zákaznícke API, použite tento skript REST senzora Home Assistant na načítanie údajov o hladine nádrže priamo do hlavného panela Home Assistant:

yaml复制

# configuration.yaml - Pridajte do konfigurácie Home Assistant zvyšok: - name: "Nee-Vo Propane Tank API" scan_interval: 300 # Anketa každých 5 minút zdroj: "https://api.nee-vo.com/v1/customer/status_tanku" "BearerO_Váš_stav" headers: Authorization: Content-Typ: "application/json" senzor: - name: "Nee-Vo Propane Level" value_template: "{{ (value_json.tank_level_percent|float)|round(1) }}" "jednotka_mernej jednotky: "%" device_class: "measurement state_class": "measurement_class" "mdi:propán-nádrž" - názov: "Nee-Vo propánové galóny" value_template: "{{ (value_json.gallons_remaining|float)|round(1) }}" merná_jednotka: "gal" icon: "mdi"{9}{}{}{38}{9}plyn{} "Nee-Vo Tank Temperature" value_template: "{{ (value_json.tank_temperature_f|float)|round(1) }}" unit_of_measurement: "stupeň F" device_class: "temperature" icon: "mdi:teplomer" -{50}name_template: "Nee Level: "{{51}"Hodnota batérie value_json.battery_percent }}" unit_of_measurement: "%" device_class: "battery" icon: "mdi:battery" - name: "Nee-Sila signálu VO" value_template: "{{ value_json.signal_rssi }asurement" "jednotka_B":" unit_of":me - name: "Nee{68}}Vo Last Updated" value_template: "{{ value_json.last_reading_timestamp }}" icon: "mdi:clock-obrys"

Poznámka:Nahraďte YOUR_NEEVO_API_KEY svojím skutočným kľúčom API od Nee-Vo (kontaktujte svojho dodávateľa so žiadosťou o prístup k API). Názvy polí JSON (tank_level_percent, gallons_remaining atď.) sú reprezentatívne - overte skutočné názvy polí vo svojej odpovedi rozhrania Nee{10}}Vo API skontrolovaním dokumentácie rozhrania API alebo kontrolou nespracovanej odpovede JSON.

Ako nájsť koncový bod rozhrania API a názvy polí:

Kontaktujte svojho dodávateľa propánu a požiadajte o prístupové údaje k Nee{0}}Vo API

Keď budete mať poverenia, použite nástroj ako Postman alebo curl na uskutočnenie testovacieho volania API:

bash复制

curl -H "Autorizácia: Bearer YOUR_NEEVO_API_KEY" \\ https://api.nee-vo.com/v1/customer/tank_status

Skopírujte nespracovanú odpoveď JSON, aby ste identifikovali presné názvy polí pre vašu konfiguráciu senzora

Skript 2: ESPHome BLE Proxy pre Otodata & Nee-Vo senzory

Zachytenie reklám BLE z akéhokoľvek propánového senzora

Najuniverzálnejším skriptovacím prístupom pre Otodata a Nee-Vo je použitie vstavaného{1}} komponentu bluetooth_proxy od ESPHome na zachytávanie reklám BLE z vášho snímača nádrže a ich posielanie Home Assistant. Funguje to bez ohľadu na to, či Otodata alebo Nee{4}}Vo odhaľuje rozhranie API:

yaml复制

# ESPHome BLE Proxy - propane_ble_proxy.yaml # Preneste to do ESP32 umiestneného do 30-50 stôp od vašej propánovej nádrže esphome: name: propane-ble-proxy platforma: ESP32 board: esp32" wifi: PropansBLE friendly_name "YOUR_WIFI_SSID" heslo: "YOUR_WIFI_PASSWORD" # Povoliť záložný hotspot v prípade zlyhania WiFi ap: ssid: "PropaneProxy Fallback Hotspot" # Povoliť Bluetooth proxy na zachytenie všetkých reklám BLE bluetooth_proxy: aktívne: true # Pridať na bielu listinu špecifických MAC adries (voliteľné - #8 pridať do zoznamu povolených adries na zachytenie #{8} #1 "AA:BB:CC:DD:EE:FF" # Vaše Otodata alebo Nee-Vo senzor MAC # Zaznamenajte všetky zachytené reklamy BLE pre ladenie logger: level: DEBUG logs: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Voliteľné: Pridajte miestny senzor na meranie teploty v blízkosti tanku} senzor 27 pin:{:2 Model 27 GP: {:2 Teplota DHT22: name: "Teplota oblasti nádrže" merná_jednotka: "stupeň F" filtre: - lambda: "návrat x * 9,0 / 5.0 + 32.0;" vlhkosť: name: "Vlhkosť oblasti nádrže" merná jednotka: "%" update_interval: 300s # Povolenie API Home Assistant na zisťovanie a ovládanie API: šifrovanie: kľúč: "YOUR_API_ENCRYPTION_KEY" # Povolenie OTA aktualizácií ota: heslo: "VYJŠIE_OTA_PASSWORD ESPWORD" #podržať nepretržité monitorovanie napájania ESP2 #supply: id: vcc pin: VUSB

Ak chcete použiť tento skript:

Nainštalujte ESPHome (pip install esphome)

Vytvorte súbor s názvom propane_ble_proxy.yaml s vyššie uvedeným obsahom

Nahraďte YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD a YOUR_API_ENCRYPTION_KEY svojimi hodnotami

Spustite esphome spustite propane_ble_proxy.yaml

Flash výsledný firmvér do ESP32 umiestneného do 30–50 stôp od vašej propánovej nádrže

V aplikácii Home Assistant:Keď je proxy server ESP32 BLE spustený, domáci asistent ho automaticky objaví prostredníctvom natívnej integrácie ESPHome. Všetky reklamy BLE zo zariadení v okolí (vrátane senzorov Otodata a Nee{2}}Vo) sa zobrazia v zariadení na sledovanie zariadení Bluetooth Home Assistant. Potom môžete vytvoriť senzory šablón na analýzu nespracovaných údajov BLE.

Skript 3: Automatizačné skripty domáceho asistenta pre výstrahy na úrovni propánu

Základné automatizácie varovania

Tieto automatizačné skripty fungujú s akýmkoľvek snímačom hladiny nádrže v aplikácii Home Assistant -, či už ide o REST API Nee-Vo, snímač ESPHome DIY, Mopeka cez MQTT alebo zachytávanie 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: "Zistila sa náplň propánu - Resetovať upozornenia" id: zistený_doplnok propánu spúšť: platforma: numerický_stav entity_id: sensor.propane_tank_level vyššie: 80 akcia: - služba: input_boolean.turn_off entity_warning_id_propane{16} - input_boolean.propane_refill_sent - service: notify.mobile_app_yourphone data: title: "✅ Propane Tank Refilled" message: > Tank level at {{ states('sensor.propane_tank_level') }}%. Všetky upozornenia boli resetované. Užite si svoj propán!

Požadované pomocné entity(pridať do configuration.yaml):

yaml复制

input_boolean: propane_warning_sent: name: ikona "Upozornenie na propán odoslané": mdi:alert propane_refill_sent: name: "Upozornenie na doplnenie propánu odoslané" ikona: mdi:alert

Skript 4: Skripty integrácie inteligentnej domácnosti

Automatizácia termostatov, ventilov a osvetlenia

Okrem základných upozornení tieto skripty integrujú údaje o úrovni propánu do vášho širšieho systému inteligentnej domácnosti:

yaml复制

# ────────────────────── ─────────────────────── # UŠETRTE PROPÁN - Znížte termostat, keď je nádrž nízka # ────────────────────── ─────────────────────── automatizácia: - alias: "Konzervácia propánu - Znížte termostat na 30 %" id: propán_conserve_30 spúšť: platforma: numeric_state entity_id: sensor.propane_tank_level nižšie: 30 stav: - stav: čas po: "20:00:00:00:" stav pred: entity_id: climate.main_thermostat state: "heat" action: - service: climate.set_temperature entity_id: klima.main_thermostat dáta: teplota: 62 hvac_mode: heat - service: notify.mobile_app_yourphone data: title: "🌡️ Správa propán zostáva F2 na úsporu 6" propán“. # ────────────────────── ─────────────────────── - alias: "Konzervácia propánu - Obnovenie termostatu po doplnení" id: propán_obnovenie_termostatu spúšť: platforma: numeric_state entity_id: sensor.propane_tank_level vyššie: 75 condition: - condition: state entity_id: input_boolean.53propane_con: service_con klima.set_teplota entity_id: klima.main_termostat údaje: teplota: 68 - služba: input_boolean.turn_off entity_id: input_boolean.propane_conservation_active # ────────────────────── ─────────────────────── # ABNORMÁLNA SPOTREBA - Zistiť potenciálny únik # ────────────────────── ─────────────────────── - alias: "Abnormálna spotreba propánu - Možný únik" id: spustenie_detekcie_úniku propánu: platforma: numeric_state entity_id: sensor.propane_consumption_rate vyššie: 5 # galónov za hodinu - prispôsobenie veľkosti vašej nádrže: - služba: notifyphone data: title.y‍} služba: Správa Abnormal Propane Consumption Detected": > Zistila sa nezvyčajná rýchlosť spotreby propánu: {{ state('sensor.propane_consumption_rate') }} gal/hod. Ak to pretrváva, skontrolujte netesnosti alebo problémy so zariadením. - služba: switch.turn_off entity_id: switch.propane_appliance_main # Voliteľné: vypnite údaje ventilu propánu: {}

Skript 5: Šablóna snímačov pre vypočítané hodnoty

Údaje odvodené z úrovne surovej nádrže

Pridajte tieto skripty senzorov šablón na výpočet odvodených hodnôt, ktoré nespracované údaje API alebo BLE priamo neposkytujú:

yaml复制

# template_sensors.yaml - Pridať do šablóny konfigurácie Home Assistant: senzor: # ────────────────────── ─────────────────────── # Počet zostávajúcich dní na základe aktuálnej miery spotreby # ────────────────────── ─────────────────────── - name: "Zostávajúce dni propánu" jednotka_of_mery: ikona "dni": "mdi:kalendár-hodiny" stav: > {% nastavenej úrovne=stavov('sensor.propane_tank_level')|float %} {% nastavená veľkosť nádrže=250 %} {# galónov - zmena veľkosti vašej nádrže #} {% nastavená veľkosť galons_left=(hladina / 100) * veľkosť_tanku %} {% nastavená denná_sadzba=state('sensor.propane_daily_consumption')|float %} {% if daily_rate > 0 and gallons_left > 0 %} {{ (gallons_left / daily_rate)|kolo(1) }} {% else %} Neznáme {% endif %} # ────────────────────── ─────────────────────── # Celková hodnota zvyšného propánu v dolároch # ────────────────────── ─────────────────────── - name: "Zostávajúca hodnota propánového dolára" unit_of_measurement: ikona "USD": "mdi:currency-usd" stav: > {% nastavená úroveň=stavov('sensor.propane_tank_level')|float %} {% set_tank_size=250 %} {% set price_per_gallon=3.50 %} {# Zmeniť na vašu skutočnú cenu #} {% set gallons_left=(úroveň / 100) * tank_size %} {{ "%.2f"|format(gallons_left * price_per_gallon) }} # ────────────────────── ─────────────────────── # Text stavu propánu (úplné/varovanie/kritické) # ────────────────────── ─────────────────────── - name: Ikona "Stav propánu": "mdi:plyn{52}}fľaša" stav: > {% nastavenej úrovne=stavov('sensor.propane_tank_level')|float %} {% if level > 50 %} Full {% elif level > 30 %} Normálne {% elif level > 15 %} Nízke {% elif level > 5 %} Kritické {% else %} Prázdne {% endif %} # ────────────────────── ─────────────────────── # Odhad nákladov na dopĺňanie # ────────────────────── ─────────────────────── - name: "Odhad nákladov na doplnenie propánu" unit_of_measurement: ikona "USD": "mdi:currency-usd" stav: > {% nastavená úroveň=stavov('sensor.propane_tank_level')|float %} {% nastavená veľkosť_tanku=250 %} {% nastavená cena_za_galón=3.50 %} {% nastavená galons_to_fill=((100 - úroveň) / 100) * veľkosť_tanky %} {% if úroveň < 95 %} {{ "%.2f"|format(gallons_to_fill * price_per_gallon) }} {% else %} 0 {% endif %}

Skript 6: Node-RED Flow pre vizuálnu automatizáciu

Vizuálny tok pre-nekódovačov

Pre používateľov, ktorí uprednostňujú vizuálny automatizačný nástroj pred skriptovaním YAML, je tu postup Node-RED, ktorý replikuje vyššie uvedené automatizačné skripty:

kód复制

[{"id":"propane_level_trigger","type":"inject","z":"propane_flow","name":"Každých 5 min","repeat":"300","crontab":"","once":false,"topic":"","payload":"","payloadType":"date","x":100,"y":100,"wires":[["propane_fetch"]]}, {"id":"propane_fetch"","type"""":F request","name""":http 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":"Parse 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":"Úroveň 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":"Critical Message","template":"🚨 KRITICKÉ: Propán pri {{payload.tank_level_percent}}}%! Okamžite doplňte!","output":"0"","6":9:{0} {"id":"propane_refill","type":"template","z":"propane_flow","name":"Refill Message","template":"⛽ Propán pri {{payload.tank_level_percent}}%. Naplánujte doplnenie čoskoro.","output":"str","x":1000,"{5":100"wi:{5":100,"{5}}} {"id":"propane_warning","type":"template","z":"propane_flow","name":"Varovná správa","template":"🔔 Propán pri {{payload.tank_level_percent}}%. Sledujte svoje využitie.","output":"str","x":1800,"yres":": {"id":"propane_notify_critical","type":"api call service","z":"propane_flow","name":"Odoslať kritické Push","service":"notify.mobile_app_yourphone","x":1150,"y call":60,"wires":[[]]type"propanlight_light_lash": service","z":"propane_flow","name":"Blikať všetky svetlá","service":"light.turn_on","data":"{\\"id_entity\\":\\"light.living_room,kitchen\\",\\"data\\":{\\"flash\\":\\"long\\"}}","x":1150,"wires":2,"[wiy":2 {"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":[[]]type"wires":[[]]type"propane_iding",": service","z":"propane_flow","name":"Odoslať upozornenie","service":"notify.mobile_app_yourphone","x":1150,"y":180,"wires":[[]]}, {"id":"propane_gallons","type":"change","z"","update_flow""""propane_flow" Galóny","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":"Aktualizovať Temperature","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":"Aktualizovať asistenta domácnosti Entity","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false,"x":950,"y":280,"wires":[[]]}]

Ak chcete použiť tento uzol-RED toku:

Nainštalujte doplnok Node-RED v aplikácii Home Assistant (cez Nastavenia → Doplnky-)

Otvorte Node-RED vo svojom prehliadači

Import toku (Menu → Importovať → prilepiť JSON vyššie)

Aktualizujte adresu URL API a poverenia v uzle propane_fetch

Aktualizujte propane_notify_critical a ďalšie notifikačné uzly pomocou vašich skutočných ID entity Home Assistant

Nasaďte tok

Skript 7: Denné súhrnné oznámenie propánu

Správa o stave na konci-dňa-

Tento skript odošle denný súhrn stavu propánu každý večer vo vhodnom čase:

yaml复制

automatizácia: - alias: "Daily Propane Summary - 8 PM" id: daily_propane_summary trigger: platform: time at: "20:00:00" action: - service: notify.mobile_app_yourphone data: title: "📊 Denná správa o hladine propánu": > správa: > States('sensor.propane_tank_level') }}% galónov zostávajúcich: {{ state('sensor.propane_gallons') }} gal Zostávajúce dni: {{ state('sensor.propane_days_remaining') }} dní Dnešná spotreba: {{ state_{'sensor.propane_gallons.propane':}} States('sensor.propane_tank_temperature') }} stupeň F Zostávajúca hodnota dolára: ${{ States('sensor.propane_dollar_value_remaining') }} Stav: {{ States('sensor.propane_status') }}

Často kladené otázky

Otázka 1: Má Otodata API, ktoré je možné skriptovať?

Otodata od roku 2026 verejne nezdokumentuje zákaznícke-rozhranie API. Ich monitory využívajú mobilné pripojenie LTE do cloudu Otodata a zákaznícka aplikácia získava údaje z tohto cloudu -, ale koncový bod API nie je verejne zdokumentovaný a prístup sa neposkytuje jednotlivým spotrebiteľom. Odporúčaný skriptovací prístup pre používateľov Otodata je pridať paralelný senzor ESPHome alebo Mopeka do rovnakej nádrže na skriptovanie Home Assistant, zatiaľ čo Otodata pokračuje v automatizácii dodávateľa. Niektorí členovia komunity r/homeassistant sa pokúsili zvrátiť-inžinier Otodata reklamný formát BLE pomocou serverov proxy ESP32 BLE, je to však experimentálne a nie je to dostatočne spoľahlivé pre skripty na automatizáciu výroby.

Otázka 2: Aký je najlepší prístup k skriptovaniu pre Nee-Vo?

Najlepší prístup k skriptovaniu pre Nee-Vo závisí od toho, či vaše nasadenie Nee{1}}Vo odhaľuje zákaznícke API. Ak je k dispozícii prístup k rozhraniu API (spýtajte sa svojho dodávateľa propánu), použite skripty snímača REST v tejto príručke na prieskum rozhrania Nee-Vo API priamo v aplikácii Home Assistant. Ak nie je dostupný prístup k API, odporúčaný prístup je rovnaký ako Otodata: pridajte do nádrže paralelný senzor ESPHome alebo Mopeka a použite automatizačné skripty ESPHome + Home Assistant v tejto príručke. Paralelný senzorový prístup je najspoľahlivejší, pretože vám poskytuje plnú kontrolu nad údajmi senzora, firmvérom a automatizačnou logikou - bez závislosti od dostupnosti API dodávateľa.

Otázka 3: Ako často by mali automatizačné skripty kontrolovať hladinu nádrže?

V prípade skriptov dopytovania REST Home Assistant (Nee{0}}Vo API) je interval skenovania 5 až 10 minút dostatočný - zmeny hladiny v nádrži dostatočne pomaly, takže častejšie dopytovanie nie je potrebné a generuje nadmerné zaťaženie rozhrania API. Pre proxy skripty ESPHome BLE ESP32 nepretržite zachytáva reklamy BLE a Home Assistant ich spracováva v reálnom-čase -, nie je potrebný žiadny interval dotazovania. V prípade automatických spúšťačov (výstražné prahy) sa spúšťače numeric_state spúšťajú okamžite, keď úroveň prekročí prah, bez ohľadu na interval dotazovania. Nastavte si denné súhrnné oznámenie na konzistentný čas každý večer (odporúčané: 19 – 20:00), aby ste dostávali pravidelné hlásenie o stave bez únavy z varovania.

Otázka 4: Môžu tieto skripty fungovať s viacerými nádržami?

Áno - všetky skripty v tejto príručke podporujú viacero tankov. Pre prieskum REST API (Nee-Vo) pridajte ďalšie položky REST senzora pre každý koncový bod API nádrže. V prípade proxy servera ESPHome BLE môže ESP32 zachytávať reklamy z viacerých snímačov BLE súčasne - stačí pridať snímače šablóny pre údaje každej nádrže. Pre automatizačné skripty duplikujte položky automatizácie a zmeňte entity_id tak, aby odkazovalo na špecifickú entitu senzora každej nádrže (napr. sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). V Node{19}}RED pridajte ďalšie vetvy propane_level_check pre každú nádrž.

Otázka 5: Ako odladím skript, ktorý nefunguje?

V prípade skriptov REST API: pomocou nástrojov pre vývojárov Home Assistant (Nastavenia → Nástroje pre vývojárov → Editor šablón) otestujte svoju šablónu value_template oproti nespracovaným údajom JSON. Skopírujte vzorovú odpoveď API a vložte ju do editora šablón, aby ste overili správnosť extrakcie cesty JSON. Pre proxy skripty ESPHome BLE: skontrolujte protokoly ESPHome (propane_ble_proxy protokoly esphome), aby ste zistili, či sa zachytávajú reklamy BLE -, ak vidíte nespracované adresy MAC, ale žiadne čitateľné údaje, senzor vysiela, ale formát nie je rozpoznaný. Pre automatizačné skripty: použite nástroj sledovania Home Assistant (karta Stopy na každej automatizácii), aby ste presne videli, čo sa spustilo, aké podmienky sa vyhodnotili a aké akcie sa spustili. Nástroj na sledovanie je najvýkonnejší nástroj na ladenie v aplikácii Home Assistant -, ktorý zobrazuje presný stav každej entity v momente spustenia automatizácie.

Zrátané a podčiarknuté

K monitorom propánových nádrží Otodata a Nee-Vo je najlepšie pristupovať prostredníctvom stratégie paralelného skriptovania: použite platformu dodávateľa (Otodata alebo Nee{1}}Vo) na automatické plánovanie doplňovania a nasaďte svoj vlastný senzor ESPHome alebo Mopeka pre úplnú kontrolu skriptovania Home Assistant. Sedem skriptov v tejto príručke - REST API prieskum, ESPHome BLE proxy, tri úrovne automatizácie upozornení (varovanie/dopĺňanie/kritické), skripty na integráciu inteligentnej domácnosti (termostat, ventily, svetlá), senzory šablón pre odvodené hodnoty, vizuálny tok Node-RED a denné súhrnné upozornenia - vám poskytujú kompletný domáci systém, ktorý funguje na lokálnom propáne. Kolektívne skúsenosti komunity r/homeassistant potvrdzujú, že tento paralelný prístup prináša to najlepšie z oboch svetov: nulovú réžiu na správu dodávateľov a úplnú flexibilitu vlastníctva údajov a automatizácie na strane domáceho asistenta. Začnite s automatizačnými skriptami (Script 3) a šablónovými senzormi (Script 5), potom rozšírte na proxy server ESPHome BLE (Script 2), aby ste dosiahli maximálne pokrytie. Každá vrstva skriptu pridáva ďalší rozmer hodnoty - od základnej viditeľnosti až po úplnú integráciu inteligentnej domácnosti, ktorá automaticky reaguje na úroveň propánu.

Posledná aktualizácia: júl 2026

Vyhlásenie: Táto príručka poskytuje príklady skriptovania Home Assistant a ESPHome pre integráciu monitorovania propánovej nádrže Otodata a Nee{0}}Vo na vzdelávacie účely. Koncové body rozhrania API, názvy polí a formáty JSON uvedené v tejto príručke sú reprezentatívne príklady - pred konfiguráciou senzorov REST vždy overte svoju skutočnú štruktúru rozhrania API pomocou konkrétneho nasadenia Nee-Vo. Proxy skripty ESPHome BLE zachytávajú všetky reklamy BLE v okolí - zaisťujú, že dodržiavate miestne predpisy týkajúce sa monitorovania zariadení BLE. Automatizácie Home Assistant interagujú so skutočnými-systémami vrátane HVAC, plynových ventilov a elektrických zariadení - testujú všetky automatizácie v bezpečných podmienkach pred nasadením do výroby. Táto príručka nie je pridružená, podporovaná ani sponzorovaná spoločnosťami Otodata, Nee{10}}Vo, Home Assistant, ESPHome, Node{11}}RED ani komunitou r/homeassistant.