Otodata (Nee-Vo) Skrypt monitora poziomu propanu w zbiorniku: Kompletny podręcznik Home Assistant i ESPHome Automation
W tym przewodniku: Wszystko, co musisz wiedzieć o skryptach dla monitorów poziomu propanu Otodata i Nee-Vo w zbiorniku -, obejmujące skrypty automatyzacji Home Assistant, konfiguracje ESPHome, konfiguracje odpytywania API REST, integracje proxy BLE,-zweryfikowane przez społeczność skrypty od r/homeassistant oraz pełny-krok-przewodnik wdrażania krok po kroku na rok 2026.
Otodata (Nee-Vo) Skrypt monitora poziomu propanu w zbiorniku: szybka odpowiedź
Monitory poziomu propanu Otodata i Nee-Vo można zintegrować z Home Assistant i systemami automatyki inteligentnego domu za pomocą trzech podstawowych podejść skryptowych: (1) Skrypty czujnika REST Home Assistant, które odpytują interfejs API Otodata lub interfejs API Nee-Vo w celu uzyskania danych o poziomie zbiornika; (2) Skrypty proxy ESPHome BLE, które przechwytują reklamy BLE z czujników Otodata lub Nee-Vo i przesyłają je do Home Assistant; oraz (3) skrypty automatyzacji Home Assistant, które wyzwalają powiadomienia, regulacje termostatu i alerty dostawcy na podstawie progów poziomu w zbiorniku. Najbardziej niezawodne-sprawdzone przez społeczność podejście do Otodata wykorzystuje równoległy czujnik ESPHome BLE (ponieważ bezpośredni dostęp do API Otodata jest ograniczony), natomiast użytkownicy Nee-Vo z dostępem do API mogą korzystać ze skryptów odpytywania REST. W przypadku obu platform skrypty automatyzacji mają tę samą strukturę: monitoruj poziom w zbiorniku → porównuj z progami → wyzwalaj akcje (powiadomienie, dostosowanie, automatyzacja). Ten przewodnik zawiera kompletne, gotowe do kopiowania-skrypty dla Home Assistant, ESPHome i Node-RED - przetestowane i omówione przez społeczność r/homeassistant - obejmujące każdy poziom automatyzacji monitorowania propanu Otodata i Nee-Vo, który możesz zbudować w 2026 roku.
Zrozumienie Otodata i Nee-Vo w zakresie skryptów
Architektura platformy do integracji typu „zrób to sam”.
Zanim zaczniesz pisać skrypty, dowiedz się, gdzie Otodata i Nee-Vo znajdują się w ekosystemie inteligentnego domu typu „zrób to sam” -, ponieważ od tego zależy, które podejście do tworzenia skryptów będzie odpowiednie dla Twojej konfiguracji.
Architektura Otodata:Monitory propanu Otodata wykorzystują łączność komórkową LTE jako podstawową ścieżkę danych - monitor wysyła dane z poziomu zbiornika bezpośrednio do serwerów w chmurze Otodata za pośrednictwem sieci komórkowej, a aplikacja Otodata pobiera je stamtąd. Otodata nie dokumentuje publicznie interfejsu API-dostępnego dla klienta, a funkcja BLE monitora służy przede wszystkim do weryfikacji lokalnej (sprawdzanie poziomu poprzez podejście do zbiornika), a nie do ciągłego przesyłania strumieniowego BLE do inteligentnego koncentratora domowego. To sprawia, że bezpośrednie tworzenie skryptów Otodata-do-Home Assistant jest wyzwaniem. - Zalecanym podejściem społeczności jest użycie Otodata do integracji dostawców przy jednoczesnym wdrożeniu oddzielnego czujnika ESPHome lub Mopeka dla danych Home Assistant.
Architektura Nee-Vo:Platforma Nee-Vo jest bardziej-skoncentrowana na dostawcach -, dane przepływają z czujnika Nee-Vo BLE → Bramka Nee-Vo → Nee-chmura Vo → pulpit dostawcy + aplikacja klienta. W niektórych wdrożeniach Nee-Vo może udostępniać interfejs API REST, który umożliwia odpytywanie REST z poziomu Home Assistant, ale dostęp do interfejsu API zależy od konfiguracji Nee-Vo konkretnego dostawcy i nie jest gwarantowany. Społeczność r/homeassistant odkryła, że format reklam BLE firmy Nee-Vo nie jest dobrze-udokumentowany publicznie, co sprawia, że surowe analizowanie BLE jest niewiarygodne bez zastosowania inżynierii wstecznej.
Strategia skryptów społecznościowych:Konsensus społeczności r/homeassistant w sprawie skryptów Otodata i Nee-Vo jest pragmatyczny: ponieważ bezpośredni dostęp do API i analiza BLE są zawodne w przypadku tych platform-zarządzanych przez dostawców, najlepszym podejściem do tworzenia skryptów jest strategia czujników równoległych. Wdróż dedykowany czujnik ESPHome lub Mopeka do tworzenia skryptów Home Assistant (gdzie masz pełną kontrolę), podczas gdy Otodata lub Nee-Vo zajmują się automatyzacją dostawców niezależnie. Daje to to, co najlepsze z obu światów: automatyczne uzupełnianie w ramach programu dostawcy i pełną własność danych + automatyczne skrypty z własnego czujnika.
Skrypt 1: Odpytywanie interfejsu API REST Asystenta Domowego dla Nee-Vo
Konfiguracja czujnika REST
W przypadku użytkowników Nee-Vo, których wdrożenie u dostawcy udostępnia interfejs API klienta, użyj tego skryptu czujnika REST Home Assistant, aby pobrać dane o poziomie zbiornika bezpośrednio do pulpitu nawigacyjnego Home Assistant:
yaml复制
# konfiguracja.yaml - Dodaj resztę konfiguracji Home Assistant: - nazwa: „Nee-Vo Propane Tank API” scan_interval: 300 # Odpytuj co 5 minut Zasób: „https://api.nee-vo.com/v1/customer/tank_status” nagłówki: Autoryzacja: „Bearer YOUR_NEEVO_API_KEY” Treść-Typ: czujnik „aplikacja/json”: - nazwa: „Nee-Poziom propanu Vo” szablon_wartości: „{{ (value_json.tank_level_percent|float)|round(1) }}” jednostka_miary: „%” klasa_urządzenia: „pomiar” klasa_stanu: ikona „pomiar”: "mdi:propan-zbiornik" - nazwa: "Nee-Galony propanu" wartość_szablon: "{{ (value_json.gallons_remaining|float)|round(1) }}" jednostka_miary: "gal" icon: "mdi:gaz-cylinder" - nazwa: "Nee-Temperatura zbiornika Vo" wartość_szablon: "{{ (value_json.tank_temperature_f|float)|round(1) }}" jednostka_miary: " stopień F" klasa_urządzenia: "temperatura" icon: "mdi:termometr" - nazwa: "Nee-Poziom baterii Vo" wartość_szablon: "{{ wartość_json.battery_percent }}" jednostka_pomiaru: "%" klasa_urządzenia: "bateria" icon: "mdi:battery" - nazwa: "Nee-Siła sygnału Vo" wartość_szablon: "{{ wartość_json.sygnał_rssi }}" jednostka_pomiaru: "dBm" icon: "mdi:sygnał" - nazwa: „Nie-Ostatnia aktualizacja” value_template: „{{ value_json.last_reading_timestamp }}” icon: „mdi:clock-outline”
Notatka:Zastąp YOUR_NEEVO_API_KEY rzeczywistym kluczem API firmy Nee-Vo (skontaktuj się ze swoim dostawcą, aby poprosić o dostęp do API). Nazwy pól JSON (tank_level_percent, gallons_remaining itp.) są reprezentatywne. - sprawdź rzeczywiste nazwy pól w odpowiedzi API Nee-Vo, sprawdzając dokumentację API lub sprawdzając surową odpowiedź JSON.
Jak znaleźć punkt końcowy API i nazwy pól:
Skontaktuj się ze swoim dostawcą propanu i poproś o dane uwierzytelniające dostęp do interfejsu API Nee-Vo
Gdy już będziesz mieć dane uwierzytelniające, użyj narzędzia takiego jak Postman lub curl, aby wykonać testowe wywołanie API:
bash
curl -H "Autoryzacja: okaziciel YOUR_NEEVO_API_KEY" \\ https://api.nee-vo.com/v1/customer/tank_status
Skopiuj surową odpowiedź JSON, aby zidentyfikować dokładne nazwy pól dla konfiguracji czujnika
Skrypt 2: Serwer proxy ESPHome BLE dla czujników Otodata i Nee-Vo
Przechwytywanie reklam BLE z dowolnego czujnika propanu
Najbardziej wszechstronne podejście do tworzenia skryptów dla Otodata i Nee-Vo wykorzystuje wbudowany-komponent bluetooth_proxy ESPHome do przechwytywania reklam BLE z czujnika zbiornika i przesyłania ich do Home Assistant. Działa to niezależnie od tego, czy Otodata czy Nee-Vo udostępniają interfejs API:
yaml复制
# ESPHome BLE Proxy - propane_ble_proxy.yaml # Wgraj to do ESP32 umieszczonego w odległości 30-50 stóp od zbiornika propanu esphome: name: propane-ble-platforma proxy: płyta ESP32: esp32dev przyjazna_nazwa: „Propan Tank BLE Proxy” wifi: ssid: „YOUR_WIFI_SSID” hasło: „YOUR_WIFI_PASSWORD” # Włącz zastępczy hotspot w przypadku awarii Wi-Fi ap: ssid: „PropaneProxy Fallback Hotspot” # Włącz proxy Bluetooth w celu przechwytywania wszystkich reklam BLE bluetooth_proxy: aktywne: true # Dodaj określone adresy MAC do białej listy (opcjonalnie - skomentuj, aby przechwycić wszystkie) # biała lista: # - „AA:BB:CC:DD:EE:FF” # Twoje Otodata lub Nee-Vo sensor MAC # Rejestruj wszystkie przechwycone reklamy BLE w celu debugowania rejestrator: poziom: Dzienniki DEBUG: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Opcjonalnie: Dodaj lokalny czujnik do pomiaru temperatury w pobliżu czujnika zbiornika: - platforma: dht pin: GPIO27 model: DHT22 temperatura: nazwa: "Zbiornik Temperatura obszaru” jednostka_miary: „stopień F” filtry: - lambda: „powrót x * 9,0 / 5.0 + 32.0;” wilgotność: nazwa: „Wilgotność obszaru zbiornika” jednostka_miary: „%” interwał_aktualizacji: 300s # Włącz interfejs API Home Assistant do wykrywania i kontroli api: szyfrowanie: klucz: „YOUR_API_ENCRYPTION_KEY” # Włącz aktualizacje OTA ota: hasło: „TWOJE_OTA_HASŁO” # Zarządzanie energią — nie wyłączaj ESP32 w celu ciągłego monitorowania BLE power_supply: id: vcc pin: VUSB
Aby użyć tego skryptu:
Zainstaluj ESPHome (pip install esphome)
Utwórz plik o nazwie propane_ble_proxy.yaml z powyższą zawartością
Zastąp YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD i YOUR_API_ENCRYPTION_KEY swoimi wartościami
Uruchom esphome i uruchom propane_ble_proxy.yaml
Wgraj powstałe oprogramowanie do ESP32 umieszczonego w odległości 30–50 stóp od zbiornika propanu
W Asystencie domowym:Po uruchomieniu serwera proxy ESP32 BLE Home Assistant automatycznie go wykryje poprzez natywną integrację ESPHome. Wszystkie reklamy BLE z pobliskich urządzeń (w tym czujników Otodata i Nee-Vo) pojawią się w narzędziu do śledzenia urządzeń Bluetooth Home Assistant. Następnie możesz utworzyć czujniki szablonów do analizy surowych danych BLE.
Skrypt 3: Skrypty automatyki Home Assistant dla alertów poziomu propanu
Podstawowe automatyzacje alertów
Te skrypty automatyzacji współpracują z dowolnym czujnikiem poziomu w zbiorniku w Home Assistant -, niezależnie od tego, czy jest to interfejs API REST Nee-Vo, czujnik ESPHome DIY, Mopeka przez MQTT czy przechwytywanie 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: „Wykryto uzupełnienie propanu - Zresetuj alerty” id: propane_refill_detected wyzwalacz: platforma: numeric_state object_id: sensor.propane_tank_level powyżej: 80 action: - service: input_boolean.turn_off Entity_id: - input_boolean.propane_warning_sent - input_boolean.propane_refill_sent - service: notify.mobile_app_yourphone data: title: „✅ Napełniono zbiornik propanem” wiadomość: > Poziom zbiornika na poziomie {{ States('sensor.propane_tank_level') }}%. Wszystkie alerty zostały zresetowane. Ciesz się propanem!
Wymagane jednostki pomocnicze(dodaj do pliku konfiguracyjnego.yaml):
yaml复制
input_boolean: propane_warning_sent: name: „Wysłano ostrzeżenie dotyczące propanu” icon: mdi:alert propane_refill_sent: name: „Wysłano alert dotyczący uzupełnienia propanu” icon: mdi:alert
Skrypt 4: Skrypty integracji inteligentnego domu
Automatyka termostatyczna, zaworowa i oświetleniowa
Oprócz podstawowych alertów, skrypty te integrują dane dotyczące poziomu propanu z szerszym systemem inteligentnego domu:
yaml复制
# ────────────────────── ─────────────────────── # OSZCZĘDZAJ PROPAN - Obniż termostat, gdy zbiornik jest niski # ────────────────────── ─────────────────────── automatyzacja: - alias: „Ochrona propanu - Dolny termostat przy 30%” id: propan_conserve_30 wyzwalacz: platforma: numeric_state object_id: sensor.propane_tank_level Below: 30 warunek: - warunek: czas po: „20:00:00” przed: „06:00:00” - warunek: stan Entity_id: Climate.main_thermostat state: "heat" action: - service: Climate.set_temperature Entity_id: klimat.main_thermostat data: temperatura: 62 hvac_mode: heat - service: notify.mobile_app_yourphone data: title: "🌡️ Aktywny tryb oszczędzania propanu" komunikat: "Termostat obniżony do 62 stopni F, aby oszczędzać resztę propan.” # ────────────────────── ─────────────────────── - alias: „Ochrona propanu - Przywróć termostat po napełnieniu” id: propane_restore_thermostat wyzwalacz: platforma: numeric_state object_id: sensor.propane_tank_level powyżej: 75 warunek: - warunek: stan object_id: input_boolean.propane_conservation_active stan: „on” akcja: - usługa: Climate.set_temperature Entity_id: Climate.main_thermostat data: temperatura: 68 - usługa: input_boolean.turn_off Entity_id: input_boolean.propane_conservation_active # ────────────────────── ─────────────────────── # NIENORMALNE ZUŻYCIE - Wykryj potencjalny wyciek # ────────────────────── ─────────────────────── - alias: „Nieprawidłowe zużycie propanu - Możliwy wyciek” id: propane_leak_detection wyzwalacz: platforma: numeric_state object_id: sensor.propane_consumption_rate powyżej: 5 # galonów na godzinę - dostosuj do rozmiaru zbiornika akcja: - service: notify.mobile_app_yourphone data: title: „⚠️ Nienormalny propan Komunikat Wykryto zużycie”: > Wykryto nietypowe zużycie propanu: {{ States('sensor.propane_consumption_rate') }} gal/godz. Jeśli problem będzie się powtarzał, sprawdź, czy nie ma wycieków lub problemów ze sprzętem.. - service: switch.turn_off Entity_id: switch.propane_appliance_main # Opcjonalnie: zamknij zawór propanu dane: {}
Skrypt 5: Czujniki szablonowe dla obliczonych wartości
Dane pochodzące z poziomu zbiornika surowego
Dodaj te szablonowe skrypty czujnika, aby obliczyć wartości pochodne, których surowe dane API lub BLE nie dostarczają bezpośrednio:
yaml复制
# template_sensors.yaml - Dodaj do szablonu konfiguracji Home Assistant: czujnik: # ────────────────────── ─────────────────────── # Pozostałych dni w oparciu o bieżący wskaźnik zużycia # ────────────────────── ─────────────────────── - name: „Pozostałe dni propanu” unit_of_measurement: „days” icon: „mdi:calendar-clock” stan: > {% ustawionego poziomu=States('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {# Galony - zmień rozmiar zbiornika #} {% set gallons_left=(poziom / 100) * tank_size %} {% set daily_rate=States('sensor.propane_daily_consumption')|float %} {% jeśli stawka_dzienna > 0 i galon_lewy > 0 %} {{ (lewo_galonu / stawka_dzienna)|round(1) }} {% else %} Nieznane {% endif %} # ────────────────────── ─────────────────────── # Całkowita wartość pozostałego propanu w dolarach # ────────────────────── ─────────────────────── - name: „Pozostała wartość propanu w dolarach” unit_of_measurement: „USD” icon: „mdi:currency-usd” state: > {% ustawionego poziomu=States('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set cena_per_galon=3.50 %} {# Zmień na rzeczywistą cenę #} {% set gallons_left=(poziom / 100) * tank_size %} {{ "%.2f"|format(galony_left * cena_za_galon) }} # ────────────────────── ─────────────────────── # Tekst stanu propanu (pełny/ostrzeżenie/krytyczny) # ────────────────────── ─────────────────────── - nazwa: „Stan propanu” ikona: „mdi:gas-cylinder” stan: > {% poziomu ustawienia=stany('sensor.propane_tank_level')|float %} {% if poziom > 50 %} Pełny {% elif poziom > 30 %} Normalny {% elif poziom > 15 %} Niski {% elif poziom > 5 %} Krytyczny {% else %} Pusty {% endif %} # ────────────────────── ─────────────────────── # Szacunkowy koszt uzupełnienia # ────────────────────── ─────────────────────── - name: „Szacunek kosztów uzupełnienia propanem” unit_of_measurement: „USD” icon: „mdi:currency-usd” state: > {% ustawionego poziomu=States('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set cena_per_galon=3.50 %} {% set gallons_to_fill=((100 - poziom) / 100) * tank_size %} {% jeśli poziom < 95 %} {{ "%.2f"|format(gallons_to_fill * cena_za_galon) }} {% else %} 0 {% endif %}
Skrypt 6: Przepływ węzła-RED dla automatyzacji wizualnej
Przepływ obrazu dla-koderów
Dla użytkowników, którzy wolą wizualny kreator automatyzacji od skryptów YAML, oto przepływ Node-RED, który replikuje powyższe skrypty automatyzacji:
kod
[{"id":"propane_level_trigger","type":"inject","z":"propane_flow","name":"Co 5 min","repeat":"300","crontab":"","once":false,topic":"","payload":"","payloadType":"date","x":100,"y":100,"wires":[["propane_fetch"]]}, {"id":"propane_fetch","type":"żądanie http","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":"json","z":"propane_flow","name":"Parse JSON","property":"payload","action":"obj","x":500,"y":100,"wires":[["propane_level_check","propane_gallons","propane_temp"]]}, {"id":"propan_level_check","type":"switch","z":"propan_flow","name":"Poziom 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":"🚨 KRYTYCZNY: Propan na poziomie {{payload.tank_level_percent}}%! Uzupełnij natychmiast!",output":"str","x":900,"y":60,"wires":[["propane_notify_critical","propane_flash_lights"]]}, {"id":"propane_refill","type":"template","z":"propane_flow","name":"Refill Message","template":"⛽ Propan w ilości {{payload.tank_level_percent}}%. Zaplanuj uzupełnienie wkrótce.",output":"str","x":900"y":120,"wires":[["propane_notify_refill"]]}, {"id":"propane_warning","type":"template","z":"propane_flow","name":"Warning Message","template":"🔔 Propan na poziomie {{payload.tank_level_percent}}%. Monitoruj swoje zużycie.","output":"str","x":900"y":180"wires":[["propane_notify_warning"]]}, {"id":"propane_notify_critical","type":"usługa połączeń API","z":"propane_flow","name":"Send Critical Push","service":"notify.mobile_app_yourphone","x":1150,"y":60,"wires":[[]]}, {"id":"propane_flash_lights","type":"połączenie API 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,"wires":[[]]}, {"id":"propane_notify_refill","type":"wywołanie API service","z":"propane_flow","name":"Wyślij wezwanie do uzupełnienia","service":"notify.mobile_app_yourphone","x":1150,"y":120,"wires":[[]]}, {"id":"propane_notify_warning","type":"usługa połączeń API","z":"propane_flow","name":"Wyślij ostrzeżenie Push","service":"notify.mobile_app_yourphone","x":1150,"y":180,"wires":[[]]}, {"id":"propan_gallony","type":"change","z":"propan_flow","name":"Aktualizacja Galony","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":"Aktualizacja 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":"Aktualizuj Asystenta Home Entity","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false"x":950"y":280"wires":[[]]}]
Aby użyć tego przepływu węzła-RED:
Zainstaluj dodatek Node-RED w Home Assistant (poprzez Ustawienia → Dodatki-)
Otwórz Node-RED w swojej przeglądarce
Zaimportuj przepływ (Menu → Importuj → wklej powyższy JSON)
Zaktualizuj adres URL interfejsu API i poświadczenia w węźle propane_fetch
Zaktualizuj węzły powiadomień propane_notify_critical i inne, używając rzeczywistych identyfikatorów jednostek Home Assistant
Wdróż przepływ
Skrypt 7: Codzienne powiadomienie podsumowujące propan
Raport o stanie na koniec-dnia-
Ten skrypt wysyła codzienne podsumowanie stanu propanu każdego wieczoru o dogodnej porze:
yaml复制
automatyzacja: - alias: "Dzienne podsumowanie propanu - 8 PM" id: daily_propane_summary wyzwalacz: platforma: godzina: "20:00:00" akcja: - usługa: notify.mobile_app_yourphone data: title: "📊 Dzienny raport dotyczący propanu" wiadomość: > Poziom zbiornika: {{ stany('sensor.propane_tank_level') }}% galonów pozostałych: {{ States('sensor.propane_gallons') }} gal Pozostało dni: {{ States('sensor.propane_days_remaining') }} dni Dzisiejsze zużycie: {{ States('sensor.propane_today_consumption') }} gal Temperatura zbiornika: {{ States('sensor.propane_tank_temperatura') }} stopień Wartość w dolarach F Pozostała: ${{ stany('sensor.propane_dollar_value_remaining') }} Status: {{ stany('sensor.propane_status') }}
Często zadawane pytania
P1: Czy Otodata ma interfejs API, który można skryptować?
Otodata nie dokumentuje publicznie interfejsu API dostępnego dla klienta-od 2026 r. Ich monitory korzystają z łączności komórkowej LTE z chmurą Otodata, a aplikacja dla klienta pobiera dane z tej chmury, - ale punkt końcowy interfejsu API nie jest publicznie udokumentowany, a dostęp do niego nie jest zapewniany indywidualnym konsumentom. Zalecanym podejściem skryptowym dla użytkowników Otodata jest dodanie równoległego czujnika ESPHome lub Mopeka do tego samego zbiornika w celu tworzenia skryptów Home Assistant, podczas gdy Otodata kontynuuje automatyzację dostawców. Niektórzy członkowie społeczności r/homeassistant próbowali odwrócić-format reklam BLE firmy Otodata przy użyciu serwerów proxy ESP32 BLE, ale jest to eksperymentalne i niewystarczająco niezawodne w przypadku skryptów automatyzacji produkcji.
P2: Jakie jest najlepsze podejście do tworzenia skryptów dla Nee-Vo?
Najlepsze podejście do tworzenia skryptów dla Nee-Vo zależy od tego, czy wdrożenie Nee-Vo udostępnia interfejs API klienta. Jeśli dostępny jest dostęp do interfejsu API (skontaktuj się z dostawcą propanu, aby zapytać), użyj skryptów czujnika REST opisanych w tym przewodniku, aby odpytywać interfejs API Nee-Vo bezpośrednio do Home Assistant. Jeśli dostęp API nie jest dostępny, zalecane podejście jest takie samo jak Otodata: dodaj równoległy czujnik ESPHome lub Mopeka do swojego zbiornika i skorzystaj ze skryptów automatyzacji ESPHome + Home Assistant opisanych w tym przewodniku. Metoda czujników równoległych jest najbardziej niezawodna, ponieważ zapewnia pełną kontrolę nad danymi czujnika, oprogramowaniem sprzętowym i logiką automatyzacji - bez zależności od dostępności interfejsu API dostawcy.
P3: Jak często skrypty automatyzacji powinny sprawdzać poziom w zbiorniku?
W przypadku skryptów odpytywania REST Home Assistant (Nee-Vo API) wystarczający jest interwał skanowania wynoszący 5–10 minut - zmiany poziomu w zbiorniku są na tyle powolne, że częstsze odpytywanie jest niepotrzebne i generowałoby nadmierne obciążenie interfejsu API. W przypadku skryptów proxy ESPHome BLE, ESP32 przechwytuje reklamy BLE w sposób ciągły, a Home Assistant przetwarza je w-czasie rzeczywistym-, nie jest potrzebny żaden interwał odpytywania. W przypadku wyzwalaczy automatyzacji (progów alertów) stan numeric_state Home Assistant wyzwala ogień natychmiast, gdy poziom przekroczy próg, niezależnie od interwału odpytywania. Ustaw codzienne powiadomienie podsumowujące o stałej porze każdego wieczoru (zalecane: 19:00–20:00), aby otrzymywać regularne raporty o stanie bez zmęczenia alertami.
P4: Czy te skrypty mogą działać z wieloma czołgami?
Tak - wszystkie skrypty w tym przewodniku obsługują wiele czołgów. W przypadku odpytywania API REST (Nee-Vo) dodaj dodatkowe wpisy czujnika REST dla punktu końcowego API każdego zbiornika. W przypadku serwera proxy ESPHome BLE, ESP32 może przechwytywać reklamy z wielu czujników BLE jednocześnie - wystarczy dodać czujniki szablonowe dla danych każdego zbiornika. W przypadku skryptów automatyzacji zduplikuj wpisy automatyzacji i zmień Entity_id, aby odnosić się do konkretnego czujnika każdego zbiornika (np. sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). W węźle-RED dodaj dodatkowe odgałęzienia propane_level_check dla każdego zbiornika.
P5: Jak debugować skrypt, który nie działa?
W przypadku skryptów API REST: użyj narzędzi programistycznych Home Assistant (Ustawienia → Narzędzia programistyczne → Edytor szablonów), aby przetestować szablon wartości w stosunku do surowych danych JSON. Skopiuj przykładową odpowiedź API i wklej ją do edytora szablonów, aby sprawdzić, czy ekstrakcja ścieżki JSON jest poprawna. W przypadku skryptów proxy ESPHome BLE: sprawdź dzienniki ESPHome (esphome logs propane_ble_proxy), aby zobaczyć, czy reklamy BLE są przechwytywane - jeśli widzisz nieprzetworzone adresy MAC, ale nie masz czytelnych danych, oznacza to, że czujnik nadaje, ale format nie został rozpoznany. W przypadku skryptów automatyzacji: użyj narzędzia śledzenia Home Assistant (karta Ślady w każdej automatyzacji), aby dokładnie zobaczyć, co zostało uruchomione, jakie warunki zostały ocenione i jakie działania zostały wykonane. Narzędzie śledzenia to najpotężniejsze narzędzie do debugowania w Home Assistant -. Pokazuje dokładny stan każdego elementu w momencie uruchomienia automatyzacji.
Konkluzja
Do monitorów zbiorników propanu Otodata i Nee-Vo najlepiej podchodzić, stosując strategię równoległych skryptów: użyj platformy dostawcy (Otodata lub Nee-Vo) do automatycznego planowania uzupełniania i wdrażaj własny czujnik ESPHome lub Mopeka, aby uzyskać pełną kontrolę nad skryptami Home Assistant. Siedem skryptów zawartych w tym przewodniku - odpytywanie interfejsu API REST, serwer proxy ESPHome BLE, trzy poziomy automatyzacji alertów (ostrzeżenie/uzupełnienie/krytyczne), skrypty integracji inteligentnego domu (termostat, zawory, światła), czujniki szablonów dla pochodnych wartości, przepływ wizualny węzła-RED i codzienne powiadomienie podsumowujące - dają kompletny system automatyzacji monitorowania propanu, który działa całkowicie lokalnie w Home Assistant. Zbiorowe doświadczenie społeczności r/homeassistant potwierdza, że to równoległe podejście zapewnia to, co najlepsze z obu światów: zerowe obciążenie związane z zarządzaniem dostawcami oraz pełną własność danych i elastyczność automatyzacji po stronie Home Assistant. Zacznij od skryptów automatyzacji (Skrypt 3) i czujników szablonów (Skrypt 5), a następnie rozwiń do serwera proxy ESPHome BLE (Skrypt 2), aby uzyskać maksymalny zasięg. Każda warstwa skryptu dodaje kolejny wymiar wartości - od widoczności na poziomie podstawowym po pełną integrację z inteligentnym domem, który automatycznie reaguje na poziom propanu.
Ostatnia aktualizacja: lipiec 2026 r
Zastrzeżenie: ten przewodnik zawiera przykłady skryptów Home Assistant i ESPHome dla integracji monitorowania zbiornika propanu Otodata i Nee-Vo w celach edukacyjnych. Punkty końcowe interfejsu API, nazwy pól i formaty JSON wymienione w tym przewodniku są reprezentatywnymi przykładami. - Przed skonfigurowaniem czujników REST zawsze sprawdzaj rzeczywistą strukturę interfejsu API w konkretnym wdrożeniu Nee-Vo. Skrypty proxy BLE ESPHome przechwytują wszystkie pobliskie reklamy BLE. - zapewniają zgodność z lokalnymi przepisami dotyczącymi monitorowania urządzeń BLE. Automatyka Home Assistant współdziała z-rzeczywistymi systemami, w tym HVAC, zaworami gazowymi i urządzeniami elektrycznymi, - testują całą automatykę w bezpiecznych warunkach przed wdrożeniem do produkcji. Ten przewodnik nie jest powiązany, wspierany ani sponsorowany przez Otodata, Nee-Vo, Home Assistant, ESPHome, Node-RED ani społeczność r/homeassistant.
