Otodata (Nee-Vo) Propane Tank Level Monitor -skripti: täydellinen Home Assistant & ESPHome Automation Guide -opas

Tässä oppaassa: Kaikki mitä sinun tarvitsee tietää Otodatan ja Nee-Vo propaanisäiliön tasomonitoreiden komentosarjasta -, joka kattaa Home Assistantin automaatiokomentosarjat, ESPHome-kokoonpanot, REST API -kyselyasetukset, BLE-välityspalvelinintegraatiot, r/homeassistantin yhteisön-varmennetut komentosarjat, ja}vaiheittaisen toteutusoppaan 2026.

Otodata (Nee-Vo) Propaanisäiliön tason valvontaohjelma: Pikavastaus

Otodata- ja Nee{0}}Vo-propaanisäiliön tasomonitorit voidaan integroida Home Assistantin ja älykkään kodin automaatiojärjestelmiin kolmen ensisijaisen komentosarjatavan avulla: (1) Home Assistantin REST-anturin komentosarjat, jotka poimivat Otodatan API:n tai Nee-Von API:n säiliön tasotietoja varten; (2) ESPHome BLE -välityspalvelimet, jotka tallentavat BLE-mainokset Otodata- tai Nee{4}}Vo-antureilta ja välittävät ne Home Assistantille; ja (3) Home Assistantin automaatiokomentosarjat, jotka käynnistävät ilmoituksia, termostaatin säätöjä ja toimittajahälytyksiä säiliön tason kynnysten perusteella. Luotettavin yhteisön -todennettu lähestymistapa Otodatalle on käyttää rinnakkaista ESPHome BLE-anturia (koska Otodatan suora API-käyttö on rajoitettu), kun taas Nee{8}}Vo-käyttäjät, joilla on API-käyttöoikeus, voivat käyttää REST-kyselyskriptejä. Molemmilla alustoilla automaatiokomentosarjat noudattavat samaa rakennetta: valvo säiliön tasoa → vertaa kynnyksiin → käynnistä toiminnot (ilmoita, säädä, automatisoi). Tämä opas sisältää täydelliset, kopioi{11}}liitä-skriptit Home Assistantille, ESPHomelle ja Solmulle-RED -, jotka r/homeassistant-yhteisö - on testannut ja keskustellut ja jotka kattavat kaikki Otodata- ja Nee{16}}Vo you2 -valvontaautomaation tasot.

Otodata ja Nee{0}}Vo for Scripting ymmärtäminen

Alustaarkkitehtuuri DIY-integraatioon

Ennen kuin kirjoitat skriptejä, selvitä, missä Otodata ja Nee{0}}Vo istuvat tee-se-itse-älykodin ekosysteemissä -, koska tämä määrittää, mikä komentosarjatapa toimii asennuksessasi.

Otodatan arkkitehtuuri:Otodata-propaanimonitorit käyttävät LTE-matkapuhelinyhteyttä ensisijaisena tietopolunaan - monitori lähettää säiliötason tiedot suoraan Otodatan pilvipalvelimille matkapuhelinverkon kautta, ja Otodata-sovellus hakee ne sieltä. Otodata ei dokumentoi julkisesti asiakkaan käytettävissä olevaa-sovellusliittymää, ja näytön BLE-ominaisuus on ensisijaisesti tarkoitettu paikalliseen todentamiseen (tason tarkistaminen kävelemällä säiliöön), ei jatkuvaan BLE-suoratoistoon älykkään kodin keskittimeen. Tämä tekee suorasta Otodatan-to-Home Assistantin komentosarjasta haastavaa -. Suositeltava yhteisön lähestymistapa on käyttää Otodataa toimittajien integroimiseen ja ottaa käyttöön erillinen ESPHome- tai Mopeka-anturi Home Assistantin dataa varten.

Nee-Von arkkitehtuuri:Nee-Von alusta on enemmän toimittaja-keskeisempi - tietovirrat Nee-Vo BLE -anturista → Nee-Vo-yhdyskäytävä → Nee-Vo-pilvi → toimittajan kojelauta + asiakassovellus. Nee-Vo saattaa paljastaa REST-sovellusliittymän joissakin käyttöönottoissa, mikä mahdollistaa REST-kyselyn Home Assistantista, mutta API-käyttö riippuu tietyn toimittajan Nee{9}}Vo-määrityksistä, eikä sitä taata. R/homeassistant-yhteisö on havainnut, että Nee{11}}Von BLE-mainosmuotoa ei ole-dokumentoitu hyvin julkisesti, minkä vuoksi raaka-BLE-jäsennys on epäluotettavaa ilman käänteistä{13}}suunnittelua.

Yhteisön komentosarjastrategia:R/homeassistant-yhteisön yksimielisyys Otodata- ja Nee{0}}Vo-komentosarjasta on pragmaattinen: koska suora API-käyttö ja BLE-jäsennys eivät ole luotettavia näille toimittajan-hallituille alustoille, paras komentosarjatapa on rinnakkainen anturistrategia. Ota käyttöön erityinen ESPHome- tai Mopeka-anturi Home Assistantin komentosarjaa varten (jos sinulla on täysi hallinta), kun taas Otodata tai Nee{3}}Vo hoitaa toimittajan automatisoinnin itsenäisesti. Tämä antaa sinulle molempien maailmojen parhaat puolet: automaattiset täyttömäärät toimittajaohjelmasta ja täydellinen tietojen omistus + automaatiokomentosarjat omasta anturistasi.

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

REST-anturin kokoonpano

Nee{0}}Vo-käyttäjille, joiden toimittajan käyttöönotto paljastaa asiakassovellusliittymän, voit käyttää tätä Home Assistant REST -anturin komentosarjaa säiliön tasotietojen hakemiseen suoraan Home Assistant -hallintapaneeliin:

yaml复制

# configuration.yaml - Lisää Home Assistantin määrityksiin: - nimi: "Nee-Vo Propane Tank API" scan_interval: 300 # Poll 5 minuutin välein resurssi: "https://api.nee-vo.com/v1/customer/tank_status" headersBear: Authorization: YOUR_NEEVO_API_KEY" Sisältö-Tyyppi: "sovellus/json" anturi: - nimi: "Nee-Vo Propane Level" value_template: "{{ (value_json.tank_level_percent|float) round(1) }measureasment_: "%measureasment_"|state_class: "mittaus" icon: "mdi:propaani-tankki" - name: "Nee-Vo Propane Gallons" value_template: "{{ (value_json.gallons_remaining|float)|round(1) }}" unit: "gallon" icon:" "mdi:gas-cylinder" - name: "Ei "Nee-Vo Battery Level" value_template: "{{ value_json.battery_percent }}" unit_of_measurement: "%" device_class: "battery" icon: "mdi:battery" - name: "Nee-Vo-signaalin vahvuus:"arvo "{_templatejson"}. unit_of_measurement: "dBm" icon: "mdi:signal" - name: "Ei-Vo viimeksi päivitetty" value_template: "{{ value_json.last_reading_timestamp }}" icon: "mdi:clock-outline"

Huomautus:Korvaa YOUR_NEEVO_API_KEY todellisella Nee-Vo:n API-avaimella (pyydä API-käyttöä ottamalla yhteyttä toimittajaasi). JSON-kenttien nimet (tank_level_percent, gallons_remaining jne.) ovat edustavia - tarkista todelliset kenttien nimet Nee{10}}Vo API-vastauksessasi tarkistamalla API-dokumentaatio tai tarkastamalla raaka JSON-vastaus.

Näin löydät API-päätepisteesi ja kenttien nimet:

Ota yhteyttä propaanitoimittajaasi ja pyydä Nee{0}}Vo APIn käyttöoikeustietoja

Kun sinulla on kirjautumistiedot, käytä työkalua, kuten Postman tai curl, testataksesi API-kutsua:

bash复制

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

Kopioi raaka JSON-vastaus tunnistaaksesi tarkat kenttien nimet anturikokoonpanollesi

Käsikirjoitus 2: ESPHome BLE -välityspalvelin Otodata & Nee-Vo-antureille

Kaappaa BLE-mainokset mistä tahansa propaanianturista

Otodatan ja Nee{0}}Von monipuolisin komentosarjamenetelmä käyttää ESPHomen sisäänrakennettua-bluetooth_proxy-komponenttia BLE-mainosten tallentamiseen tankkitunnistimesta ja välittämiseen Home Assistantille. Tämä toimii riippumatta siitä, paljastaako Otodata vai Nee{4}}Vo API:n:

yaml复制

# ESPHome BLE-välityspalvelin - propane_ble_proxy.yaml # Flash tämä ESP32:een, joka on 30-50 jalan etäisyydellä propaanisäiliöstäsi: nimi: propane-ble-välityspalvelinalusta: ESP32-kortti: esp32dev friendly_name: "BLEpanside wifi:" Tank: "BLEpansid:" "YOUR_WIFI_SSID"-salasana: "YOUR_WIFI_PASSWORD" # Ota käyttöön varayhteyspiste, jos WiFi epäonnistuu ap: ssid: "PropaneProxy Fallback Hotspot" # Ota Bluetooth-välityspalvelin käyttöön kaikkien BLE-mainosten kaappaamiseen bluetooth_proxy: active: true # Sallitut MAC-osoitteet (valitut luettelot {{17}) #1 kommentti - "AA:BB:CC:DD:EE:FF" # Otodata tai Nee-Vo-anturi MAC # Kirjaa kaikki siepatut BLE-mainokset virheenkorjausta varten: taso: DEBUG-lokit: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Valinnainen: Lisää paikallinen anturi lämpötilan mittaamiseksi säiliön lähellä. DHT22-lämpötila: nimi: "Säiliön alueen lämpötila" mittayksikkö: "° F" suodattimet: - lambda: "paluu x * 9.0 / 5.0 + 32.0;" kosteus: nimi: "Tank Area Humidity" unit_of_measurement: "%" update_interval: 300s # Ota Home Assistant API käyttöön etsintä- ja hallintasovellusliittymää varten: salaus: avain: "YOUR_API_ENCRYPTION_KEY" # Ota OTA-päivitykset käyttöön ota: salasana: "YOUR_OTAPLE" virranhallintaa varten #3 BASSWORDawa valvonta virtalähde: id: vcc pin: VUSB

Tämän skriptin käyttäminen:

Asenna ESPHome (pip install esphome)

Luo tiedosto nimeltä propane_ble_proxy.yaml, jolla on yllä oleva sisältö

Korvaa YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD ja YOUR_API_ENCRYPTION_KEY arvoillasi

Suorita esphome-ajo propane_ble_proxy.yaml

Flash tuloksena saatu laiteohjelmisto ESP32:een, joka on sijoitettu 30–50 jalan päähän propaanisäiliöstä

Home Assistantissa:Kun ESP32 BLE -välityspalvelin on käynnissä, Home Assistant löytää sen automaattisesti alkuperäisen ESPHome-integraation kautta. Kaikki BLE-mainokset lähellä olevilta laitteilta (mukaan lukien Otodata- ja Nee-Vo-anturit) näkyvät Home Assistantin Bluetooth-laiteseurannassa. Voit sitten luoda malliantureita BLE-raakatietojen jäsentämiseksi.

Komentosarja 3: Home Assistantin automaatiokomentosarjat propaanitason hälytyksiä varten

Ydinhälytysautomaatio

Nämä automaatiokomentosarjat toimivat minkä tahansa Home Assistantin - tankin tasoanturin kanssa, olipa kyseessä Nee-Von REST API, ESPHome DIY -anturi, Mopeka MQTT:n kautta tai BLE-välityspalvelin:

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: "Propaanin täyttö havaittu - Nollaa varoitukset" id: propane_refill_detected trigger: alusta: numeric_state entity_id: sensor.propane_tank_level above: 80 action: - service: input_boolean.6}}_off {{boolean.6}}_off input_boolean.propane_warning_sent - input_boolean.propane_refill_sent - service: notify.mobile_app_yourphone data: title: "✅ Propaanisäiliö täytetty uudelleen" viesti: > Säiliön taso {{ states('sensor.level')_tank}}. Kaikki hälytykset on nollattu. Nauti propaanistasi!

Vaaditut apuyksiköt(lisää kohtaan configuration.yaml):

yaml复制

input_boolean: propane_warning_sent: nimi: "Propaanivaroitus lähetetty" icon: mdi:alert propane_refill_sent: name: "Propaanin täyttövaroitus lähetetty" icon: mdi:alert

Komentosarja 4: Älykkään kodin integrointikomentosarjat

Termostaatti, venttiili- ja valaistusautomaatio

Perushälytysten lisäksi nämä komentosarjat integroivat propaanitason tiedot laajempaan älykotijärjestelmääsi:

yaml复制

# ────────────────────── ─────────────────────── # SÄÄSTÄ PROPAANIA - Laske termostaattia, kun säiliö on vähissä # ────────────────────── ─────────────────────── automaatio: - alias: "Propaanin säästö - Alempi termostaatti 30 %" id: propane_conserve_30 trigger: alusta: numeric_state entity_id: sensor.propane_tank_level under: 30 kunto: - kunto: aika sen jälkeen: "06":0: 0 ennen: "06": 0:0 - ehto: tila entity_id: ilmasto.main_thermostat tila: "heat" toiminto: - service: ilmasto.set_temperature entity_id: ilmasto.main_thermostat data: lämpötila: 62 hvac_mode: lämpö - palvelu: notify.mobile_app_yourphone data: title: "Propanostaservation" lasketaan 62 asteeseen F jäljellä olevan propaanin säilyttämiseksi." # ────────────────────── ─────────────────────── - alias: "Propaanin säästö - Palauta termostaatti uudelleentäytön jälkeen" id: propane_restore_thermostat trigger: alusta: numeric_state entity_id: sensor.propane_tank_level above: 75 condition: - condition: state_enityne_state_id:serv. toiminto: - palvelu: ilmasto.set_temperature entity_id: ilmasto.main_thermostaattitiedot: lämpötila: 68 - service: input_boolean.turn_off entity_id: input_boolean.propane_conservation_active # ────────────────────── ─────────────────────── # EPÄNORMALINEN KULUTUS - Tunnista mahdollinen vuoto # ────────────────────── ─────────────────────── - alias: "Epänormaali propaanin kulutus - Mahdollinen vuoto" id: propane_leak_detection trigger: alusta: numeric_state entity_id: sensor.propane_consumption_rate edellä: 5 # gallonaa tunnissa - huolto {{80} säiliön koon mukaan notify.mobile_app_yourphone data: title: "⚠️ Epänormaali propaaninkulutus havaittu" -viesti: > Epätavallinen propaanin kulutus havaittu: {{ states('sensor.propane_consumption_rate') }} gal/hr. Jos ongelma jatkuu, tarkista vuodot tai laiteongelmat. - service: switch.turn_off entity_id: switch.propane_appliance_main # Valinnainen: sulje propaaniventtiilin tiedot: {}

Komentosarja 5: Laskettujen arvojen mallianturit

Johdetut tiedot raakasäiliön tasosta

Lisää nämä mallitunnistimen komentosarjat laskeaksesi johdetut arvot, joita API- tai BLE-raakadata ei tarjoa suoraan:

yaml复制

# template_sensors.yaml - Lisää Home Assistantin määritysmalliin: sensor: # ────────────────────── ─────────────────────── # päivää jäljellä nykyisen kulutustason perusteella # ────────────────────── ─────────────────────── - nimi: "Jäljellä olevat propaanipäivät" mittayksikkö: "päivät"-kuvake: "mdi:kalenteri-kello" tila: > {% asetettu taso=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {# Gallons - change to your tank #} {% set gallons_left=(level / 100) * tank_size %} {% set daily_rate=states('sensor.propane_daily_consu)|kellua %} {%, jos päivän_kurssi > 0 ja gallonaa_vasen > 0 %} {{ (gallonaa_vasen / päivähinta)|round(1) }} {% else %} Tuntematon {% endif %} # ────────────────────── ─────────────────────── # Jäljellä olevan propaanin kokonaisarvo dollareissa # ────────────────────── ─────────────────────── - nimi: "Jäljellä oleva propaanidollariarvo" mittayksikkö: "USD"-kuvake: "mdi:currency-usd" tila: > {% asetettu taso=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {# Muuta todellista hintaasi #} {% set gallons_left=(level / 100) * tank_size %} {{ "%.2f"|muoto(gallonaa_vasen * hinta_gallonaa kohden) }} # ────────────────────── ─────────────────────── # Propaanin tilateksti (täysi/varoitus/kriittinen) # ────────────────────── ─────────────────────── - nimi: "Propaanin tila" -kuvake: "mdi:kaasu-sylinteri" tila: > {% asetettu taso=states('sensor.propane_tank_level')|float %} {% if level > 50 %} Full {% elif level > 30 %} Normal {% elif level > 15 %} Low {% elif level > 5 %} Kriittinen {% else %} Tyhjä {% endif %} # ────────────────────── ─────────────────────── # Täyttökustannusarvio # ────────────────────── ─────────────────────── - nimi: "Propaanin täyttökustannusarvio" unit_of_measurement: "USD" icon: "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 - level) / 100) * tankin_size %} {% if level < 95 %} {{ "%.2f"|muoto(gallonaa_täyttöön * hinta_gallonaa kohden) }} {% else %} 0 {% endif %}

Komentosarja 6: Solmu-PUNAINEN Flow visuaalista automaatiota varten

Visual Flow muille kuin{0}}koodaajille

Käyttäjille, jotka haluavat visuaalisen automaation rakentajan YAML-komentosarjojen sijaan, tässä on Node{0}}RED-kulku, joka toistaa yllä olevat automaatiokomentosarjat:

koodi复制

[{"id":"propane_level_trigger","type":"inject","z":"propaani_virtaus","nimi":"Joka 5. min","repeat":"300","crontab":"","once":false,"topic":"","payload":"","payloadType":"date","x":100,"y":100,"wires":[["propane_fetch"]]}, {"id":"propaani_haku","tyyppi":" request","z":"propaanin_virtaus","nimi":"Fetch Nee-Vo API","method":"GET","url":"https://api.nee-vo.com/v1/customer/tank_status","tls":",","x":300,"{}"s:10,"y {"id":"propane_parse","type":"json","z":"propane_flow","name":"JSON","property":"payload","action":"obj","x":500,"y":100,"johdot":[["propane_level_check","propane_gallons","propane_temp"]]}, {"id":"propaani_tason_tarkistus","type":"kytkin","z":"propaani_virtaus","nimi":"Taso Tarkista","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":"🚨 KRIITTINEN: Propaani {{payload.tank_level_percent}}%! Täytä uudelleen välittömästi!","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":"⛽ Propane-percentk pian.","output":"str","x":900,"y":120,"wires":[["propane_notify_refill"]]}, {"id":"propane_warning","type":"template","z":"propane_flow","name":"Varoitusviesti","malli":"🔔 Propane-tasolla käyttö.","output":"str","x":900,"y":180,"wires":[["propane_notify_warning"]]}, {"id":"propane_notify_critical","type":"api call service","z":"propaani_virtaus","nimi":"Lähetä kriittinen Push","service":"notify.mobile_app_yourphone","x":1150,"y":60,"wires":[[]]}, {"id":"propane_flash_lights","type":"api call service","z":"propane_flow","name":"Flash All" Valot","service":"light.turn_on","data":"{\\"entity_id\\":\\"light.living_room,kitchen\\",\\"data\\":{\\"flash\\":\\"pitkä\\"}}","x":1150,"y":20,"johdot":[[]]}, {"id":"propane_notify_refill","type":"api call service","z":"propane_flow","name":"Lähetä Refill Push","service":"notify.mobile_app_yourphone","x":1150,"y":120,"wires":[[]]}, {"id":"propane_notify_warning","type":"api call service","z":"propane_flow","name":"Send Warning Push","service":"notify.mobile_app_yourphone","x":1150,"y":180,"wires":[[]]}, {"id":"propaani_gallonia","type":"change","z":"propaani_virtaus","nimi":"Päivitä Gallonaa","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.gallons_remaining","tot":"msg"}],"x":700,"y":260,"johdot":[["propane_ha_entity"]]}, {"id":"propaanin_lämpötila","tyyppi":"muutos","z":"propaani_virtaus","nimi":"Päivitä Temperature","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.tank_temperature_f","tot":"msg"}],"x":700,"y":300,"johdot":[["propane_ha_entity"]]}, {"id":"propane_ha_entity","type":"ha-api","z":"propane_flow","name":"Päivitä Home Assistant Entity","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false,"x":950,"y":280,"johdot":[[]]}]

Voit käyttää tätä solmu{0}}PUNAISTA kulkua seuraavasti:

Asenna Node-RED-lisäosa Home Assistantiin (valitse Asetukset → Lisäosat{1}})

Avaa Node{0}}RED selaimessasi

Tuo kulku (Valikko → Tuo → liitä JSON yllä)

Päivitä sovellusliittymän URL-osoite ja tunnistetiedot propane_fetch-solmussa

Päivitä propane_notify_critical ja muut ilmoitussolmut todellisilla Home Assistant -entiteettitunnuksillasi

Ota virta käyttöön

Käsikirjoitus 7: Päivittäinen propaaniyhteenvetoilmoitus

Päivän-lopun-tilaraportti

Tämä skripti lähettää päivittäin propaanin tilayhteenvedon sopivaan aikaan joka ilta:

yaml复制

automaatio: - alias: "Päivittäinen propaaniyhteenveto - 8 PM" id: daily_propane_summary trigger: alusta: aika klo: "20:00:00" toiminto: - service: notify.mobile_app_yourphone data: title: "📊 Daily Propane Report" -viesti: > {{ Tank Level states('sensor.propane_tank_level') }}% gallonaa jäljellä: {{ states('sensor.propane_gallons') }} gal Päivää jäljellä: {{ states('sensor.propane_days_remaining') }} päivää Tämän päivän kulutus: {{ states('sensor.s's'sentorday') Säiliön lämpötila: {{ states('sensor.propane_tank_temperature') }} astetta F Dollari Jäljellä oleva arvo: ${{ states('sensor.propane_dollar_value_remaining') }} Tila: {{ states('sensor.propane_status') }}

Usein kysytyt kysymykset

Kysymys 1: Onko Otodatalla API, joka voidaan komentoida?

Otodata ei dokumentoi julkisesti asiakkaan-käyttöliittymää vuodesta 2026 alkaen. Heidän monitorinsa käyttävät LTE-matkapuhelinyhteyttä Otodatan pilveen, ja asiakassovellus hakee tietoja kyseisestä pilvestä -, mutta API-päätepistettä ei ole dokumentoitu julkisesti, eikä pääsyä tarjota yksittäisille kuluttajille. Otodata-käyttäjille suositeltu komentosarjoustapa on lisätä rinnakkainen ESPHome- tai Mopeka-anturi samaan säiliöön Home Assistantin komentosarjaa varten, kun taas Otodata jatkaa toimittajan automaation käsittelyä. Jotkut r/homeassistant-yhteisön jäsenet ovat yrittäneet kääntää Otodatan BLE-mainosmuotoa ESP32 BLE-välityspalvelimien avulla, mutta tämä on kokeellista eikä tarpeeksi luotettava tuotannon automatisointiskripteille.

Q2: Mikä on paras käsikirjoitustapa Nee-Vo:lle?

Nee{0}}Von paras komentosarjatapa riippuu siitä, paljastaako Nee{1}}Vo-käyttöönotto asiakassovellusliittymän. Jos API-käyttö on saatavilla (kysy propaanitoimittajaltasi), käytä tämän oppaan REST-anturin skriptejä kyselyn Nee-Vo API:sta suoraan Home Assistantiin. Jos API-käyttöä ei ole saatavilla, suositeltu lähestymistapa on sama kuin Otodata: lisää säiliöön rinnakkainen ESPHome- tai Mopeka-anturi ja käytä tämän oppaan ESPHome + Home Assistant -automaatiokomentosarjaa. Rinnakkaisanturi on luotettavin, koska se antaa sinulle täyden hallinnan anturin datasta, laiteohjelmistosta ja automaatiologiikasta - ilman riippuvuutta toimittajan API:n saatavuudesta.

Q3: Kuinka usein automaatiokomentosarjojen tulee tarkistaa säiliön taso?

Home Assistant REST -kyselyskripteissä (Nee-Vo API) 5–10 minuutin skannausväli riittää - tankin taso muuttuu tarpeeksi hitaasti, joten useammin kyselyitä ei tarvita ja se aiheuttaisi liiallista API-kuormitusta. ESPHome BLE -välityspalvelinkomentosarjat ESP32 kaappaa BLE-mainokset jatkuvasti ja Home Assistant käsittelee ne reaaliajassa -reaaliajassa -, kyselyväliä ei tarvita. Automaatiolaukaisujen (hälytyskynnysten) kohdalla Home Assistantin numeric_state laukaisee tulipalon välittömästi, kun taso ylittää kynnyksen, kyselyvälistä riippumatta. Aseta päivittäinen yhteenvetoilmoitus tasaiseksi ajaksi joka ilta (suositus: klo 19–20), jotta saat säännöllisen tilaraportin ilman tarkkaavaista väsymystä.

Q4: Voivatko nämä komentosarjat toimia useiden säiliöiden kanssa?

Kyllä - kaikki tämän oppaan komentosarjat tukevat useita säiliöitä. REST API -kyselyä varten (Nee-Vo) lisää REST-anturimerkinnät kunkin säiliön API-päätepisteeseen. ESPHome BLE -välityspalvelimelle ESP32 voi siepata mainoksia useilta BLE-antureilta samanaikaisesti - lisää vain mallianturit kunkin säiliön tiedoille. Automaatiokomentosarjat: kopioi automaatiomerkinnät ja muuta entity_id viittaamaan kunkin säiliön erityiseen anturientiteettiin (esim. sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). Lisää kohtaan Node-RED ylimääräiset propaanitason_tarkistushaarat jokaiselle säiliölle.

Kysymys 5: Kuinka voin korjata skriptin, joka ei toimi?

REST API -komentosarjat: testaa value_templatesi raaka-JSON-dataa vastaan ​​Home Assistantin kehittäjätyökaluilla (Asetukset → Kehittäjätyökalut → Mallieditori). Kopioi esimerkkisovellusliittymävastaus ja liitä se mallieditoriin varmistaaksesi, että JSON-polun purku on oikein. ESPHome BLE-välityspalvelinkomentosarjat: tarkista ESPHome-lokeista (esphome logs propane_ble_proxy), siepataanko BLE-mainoksia - jos näet raaka-MAC-osoitteita, mutta ei luettavaa dataa, anturi lähettää, mutta muotoa ei tunnisteta. Automaatiokomentosarjat: Käytä Home Assistant -jäljitystyökalua (Jäljitykset-välilehti kussakin automaatiossa) nähdäksesi tarkalleen, mikä laukaisi, mitkä olosuhteet arvioitiin ja mitä toimintoja suoritettiin. Jäljitystyökalu on Home Assistantin tehokkain virheenkorjaustyökalu - se näyttää jokaisen entiteetin tarkan tilan automaation käynnistyessä.

Bottom Line

Otodata- ja Nee-Vo-propaanisäiliömonitorit toimivat parhaiten rinnakkaisen komentosarjastrategian avulla: käytä toimittajan alustaa (Otodata tai Nee-Vo) automaattiseen täyttöaikataulutukseen ja ota käyttöön oma ESPHome- tai Mopeka-anturisi täydelliseen Home Assistantin komentosarjan hallintaan. Tämän oppaan seitsemän skriptiä - REST API kysely, ESPHome BLE -välityspalvelin, kolme tasoa hälytysautomaatioita (varoitus/täyttö/kriittinen), älykkään kodin integrointiskriptit (termostaatti, venttiilit, valot), mallianturit johdetuille arvoille, solmu{4}}RED visuaalinen virtaus ja päivittäinen yhteenveto järjestelmästä, joka tarkkailee koko järjestelmää {{5}. paikallisesti Home Assistantissa. R/homeassistant-yhteisön kollektiivinen kokemus vahvistaa, että tämä rinnakkainen lähestymistapa tarjoaa molempien maailmojen parhaat puolet: ilman toimittajan hallintakustannuksia ja täydellisen tiedon omistajuuden ja automaation joustavuuden Home Assistant -puolella. Aloita automaatiokomentosarjoista (Script 3) ja malliantureista (Script 5) ja laajenna sitten ESPHome BLE -välityspalvelimeen (Script 2) parhaan kattavuuden saavuttamiseksi. Jokainen komentosarjataso lisää toisen arvoulottuvuuden - perustason näkyvyydestä täydelliseen älykkään kodin integraatioon, joka reagoi propaanitasoon automaattisesti.

Viimeksi päivitetty: heinäkuussa 2026

Vastuuvapauslauseke: Tässä oppaassa on esimerkkejä Home Assistant- ja ESPHome-komentosarjasta Otodatan ja Nee{0}}Vo propaanisäiliön valvonnan integrointiin koulutustarkoituksiin. Tässä oppaassa mainitut API-päätepisteet, kenttien nimet ja JSON-muodot ovat edustavia esimerkkejä - varmista aina todellinen API-rakenne tietyllä Nee-Vo-käyttöönotollasi ennen REST-anturien määrittämistä. ESPHome BLE-välityspalvelinkomentosarjat tallentavat kaikki lähellä olevat BLE-mainokset - varmista, että noudatat paikallisia BLE-laitteiden valvontaa koskevia säännöksiä. Home Assistant -automaatiot ovat vuorovaikutuksessa todellisten järjestelmien, kuten LVI-, kaasuventtiilien ja sähkölaitteiden kanssa, - testaavat kaikki automaatiot turvallisissa olosuhteissa ennen tuotantoon ottamista. Tämä opas ei ole sidoksissa Otodata-, Nee{10}}Vo-, Home Assistant-, ESPHome-, Node{11}}RED- tai r/homeassistant-yhteisöön, sitä tue tai sponsoroi.