Otodata (neee-Vo) Propane Tank Level Monitor Script: Heill Home Assistant & ESPHome Automation Guide
Í þessari handbók: Allt sem þú þarft að vita um forskriftir fyrir Otodata og Nee-Vo própan tankstigsmæla - sem fjallar um Home Assistant sjálfvirkniforskriftir, ESPHome stillingar, REST API skoðanakönnunaruppsetningar, BLE proxy-samþættingu, samfélags-staðfest forskriftir frá r/homeassistant, og heill skref{2} fyrir innleiðingu{2}.
Otodata (Nee-Vo) Propane Tank Level Monitor Script: Fljótt svar
Otodata og Nee-Vo própan tankstigsskjáir geta verið samþættir Home Assistant og snjallheima sjálfvirknikerfi með þremur aðal forskriftaraðferðum: (1) Home Assistant REST skynjara forskriftir sem skoða API Otodata eða Nee-Vo's API fyrir tankhæðargögn; (2) ESPHome BLE proxy forskriftir sem fanga BLE auglýsingar frá Otodata eða Nee-Vo skynjara og framsenda þær til Home Assistant; og (3) Home Assistant sjálfvirkni forskriftir sem kalla fram tilkynningar, hitastillastillingar og birgjaviðvaranir byggðar á tankhæðarmörkum. Áreiðanlegasta samfélags-staðfesta nálgunin fyrir Otodata er að nota samhliða ESPHome BLE skynjara (þar sem beinn API aðgangur Otodata er takmarkaður), en Nee-Vo notendur með API aðgang geta notað REST könnunarforskriftir. Fyrir báða vettvangana fylgja sjálfvirkniforskriftirnar sömu uppbyggingu: fylgjast með tankstigi → bera saman við þröskulda → kveikja á aðgerðum (tilkynna, stilla, gera sjálfvirkan). Þessi handbók veitir fullkomnar, afrita-líma-forskriftir fyrir Home Assistant, ESPHome og Node-RED - prófaðar og ræddar af r/homeassistant samfélaginu - sem ná yfir öll stig Otodata og Nee-Vo própan vöktunar sjálfvirkni 2026.
Skilningur á Otodata og Nee-Vo for Scripting
Platform arkitektúr fyrir DIY samþættingu
Áður en þú skrifar forskriftir skaltu skilja hvar Otodata og Nee-Vo sitja í DIY snjallheimavistkerfinu - því þetta ákvarðar hvaða forskriftaraðferð mun virka fyrir uppsetninguna þína.
Arkitektúr Otodata:Otodata própan skjáir nota LTE farsímatengingu sem aðal gagnaslóð sína - skjárinn sendir tankhæðargögn beint til skýjaþjóna Otodata í gegnum farsímakerfi og Otodata appið sækir þau þaðan. Otodata skráir ekki opinberlega forritaskil sem-viðskiptavinur er aðgengilegur og BLE-geta skjásins er fyrst og fremst til staðbundinnar sannprófunar (athugaðu stig með því að ganga upp að tankinum), ekki fyrir stöðuga BLE streymi til snjallheimamiðstöðvar. Þetta gerir það að verkum að beina Otodata-til-Home Assistant forskriftagerð krefjandi - að ráðlögð samfélagsaðferð er að nota Otodata fyrir samþættingu birgja á meðan þú setur upp sérstakan ESPHome eða Mopeka skynjara fyrir Home Assistant gögn.
Nei-arkitektúr Vo:Nee-Vo er vettvangur birgja-miðlægari - gögnin streyma frá Nee-Vo BLE skynjara → Nee-Vo gátt → Nee-Vo ský → mælaborð birgja + viðskiptavinaforrit. Nee-Vo gæti afhjúpað REST API í sumum uppfærslum, sem gerir REST könnun frá Home Assistant kleift, en API aðgangur fer eftir Nee-Vo stillingum viðkomandi birgis og er ekki tryggð. R/homeassistant samfélagið hefur komist að því að Nee-BLE auglýsingasniði Nee-Vo er ekki vel-skjalfest opinberlega, sem gerir óáreiðanlega BLE þáttun óáreiðanlega án bakvísandi-verkfræði.
Forskriftarstefna samfélagsins:Samstaða r/homeassistant samfélagsins um Otodata og Nee-Vo forskriftir er raunsær: þar sem bein API aðgangur og BLE þáttun eru óáreiðanleg fyrir þessa birgja-stýrðu vettvanga, er besta forskriftaraðferðin samhliða skynjarastefna. Settu upp sérstakan ESPHome eða Mopeka skynjara fyrir Home Assistant forskriftir (þar sem þú hefur fulla stjórn), en Otodata eða Nee-Vo annast sjálfvirkni birgja sjálfstætt. Þetta gefur þér það besta af báðum heimum: sjálfvirkar áfyllingar frá birgðaforritinu og fulla eignarhald á gögnum + sjálfvirkni forskrift frá þínum eigin skynjara.
Handrit 1: Home Assistant REST API Polling fyrir Nee-Vo
Stilling REST skynjara
Fyrir Nee-Vo notendur sem birta birgðaforritaskil viðskiptavina, nota þetta Home Assistant REST skynjara forskrift til að draga gögn um tankhæð beint inn í Home Assistant mælaborðið þitt:
yaml复制
# configuration.yaml - Bættu við stillingar fyrir heimili aðstoðarmanninn þinn: - nafn: "Nee-Vo Propane Tank API" scan_interval: 300 # Könnun á 5 mínútna fresti tilfang: "https://api.nee-vo.com/v1/customer/tank_YOUR_status:_EYKEVOer" headers: Author: Efni-Tegund: "application/json" skynjari: - nafn: "Nee-Vo Propane Level" value_template: "{{ (value_json.tank_level_percent|float)|round(1) }}" unit_of_measurement: "%" device_class: icona "mdi:propane-tank" - nafn: "Nee-Vo Propane Gallons" value_template: "{{ (value_json.gallons_remaining|flot)|round(1) }}" unit_of_measurement: "gal" icon: "mdi:gascylinder{3}{3} name" "Nee-Vo Tank Hiti" value_template: "{{ (value_json.tank_temperature_f|flot)|round(1) }}" unit_of_measurement: "℃F" device_class: "hitastig" tákn: "mdi:hitamælir" - nafn: "NeeV"{_1templa:{_1 value_json.battery_percent }}" unit_of_measurement: "%" device_class: "battery" icon: "mdi:battery" - nafn: "Nee-Vo Signal Strength" value_template: "{{ value_json.signal_rssi }}" táknmynd "mdimea" eining::_dmea - name: "Nee-Vo Last Updated" value_template: "{{ value_json.last_reading_timestamp }}" icon: "mdi:clock-outline"
Athugið:Skiptu um YOUR_NEEVO_API_KEY fyrir raunverulegan API lykil frá Nee-Vo (hafðu samband við birgjann þinn til að biðja um API aðgang). JSON svæðisnöfnin (tank_level_percent, gallons_remaining o.s.frv.) eru dæmigerð - staðfestu raunveruleg svæðisnöfn í Nee-Vo API svarinu þínu með því að skoða API skjölin eða skoða hráa JSON svarið.
Hvernig á að finna API endapunkt og sviðsheiti:
Hafðu samband við própan birgirinn þinn og biddu um Nee-Vo API aðgangsskilríki
Þegar þú hefur fengið skilríki, notaðu tól eins og Postman eða curl til að hringja í prófunar API:
bash复制
krulla -H "Authorization: Bearer YOUR_NEEVO_API_KEY" \\ https://api.nee-vo.com/v1/customer/tank_status
Afritaðu hráa JSON-svarið til að bera kennsl á nákvæm svæðisheiti fyrir uppsetningu skynjarans
Handrit 2: ESPHome BLE Proxy fyrir Otodata & Nee-Vo skynjara
Handtaka BLE auglýsingar frá hvaða própanskynjara sem er
Fjölhæfasta forskriftaraðferðin fyrir Otodata og Nee-Vo er að nota ESPHome's innbyggða- bluetooth_proxy íhlut til að fanga BLE auglýsingar frá tankskynjaranum þínum og áframsenda þær til Home Assistant. Þetta virkar óháð því hvort Otodata eða Nee-Vo afhjúpar API:
yaml复制
# ESPHome BLE Proxy - propane_ble_proxy.yaml # Flassaðu þessu á ESP32 sem er staðsettur innan 30-50 feta frá própantankinum þínum esphome: name: propane-ble-proxy pallur: ESP32 borð: esp32dev friendly_name: "Proxyspaneid wifi Tank: BLEProspaneid "YOUR_WIFI_SSID" lykilorð: "YOUR_WIFI_PASSWORD" # Virkja varareit ef WiFi bilar ap: ssid: "PropaneProxy Fallback Hotspot" # Virkja Bluetooth umboð til að fanga allar BLE auglýsingar bluetooth_proxy: virkt: satt # Hvítlista sértæk MAC vistföng (valfrjálst # hvíta lista yfir allt: #{17}) {8}) "AA:BB:CC:DD:EE:FF" # Otodata eða Nee-Vo skynjari MAC # Skráðu allar teknar BLE auglýsingar fyrir kembiforritara: stig: DEBUG logs: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Valfrjálst: Bættu við staðbundnum skynjara til að mæla hitastig nálægt tanknum} skynjara:{27 pinna}: GP7: DHT22 hitastig: nafn: "Tank Area Hite" unit_of_measurement: "℃F" síur: - lambda: "return x * 9.0 / 5.0 + 32.0;" raki: nafn: "Raki tanksvæðis" unit_of_measurement: "%" update_interval: 300s # Virkja Home Assistant API fyrir uppgötvun og stjórna API: dulkóðun: lykill: "YOUR_API_ENCRYPTION_KEY" # Virkja OTA uppfærslur ota: lykilorð: "YOUR_OTA" #_PASSWORD eftirlit með áframhaldandi orkustjórnun BORD power_supply: auðkenni: vcc pinna: VUSB
Til að nota þetta handrit:
Settu upp ESPHome (pip install esphome)
Búðu til skrá sem heitir propane_ble_proxy.yaml með innihaldinu hér að ofan
Skiptu um YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD og YOUR_API_ENCRYPTION_KEY fyrir gildin þín
Keyra esphome run propane_ble_proxy.yaml
Flassaðu fastbúnaðinum sem myndast á ESP32 sem er staðsettur innan 30–50 feta frá própantankinum þínum
In Home Assistant:Þegar ESP32 BLE umboðið er í gangi mun Home Assistant sjálfkrafa uppgötva það með innfæddri ESPHome samþættingu. Allar BLE auglýsingar frá nálægum tækjum (þar á meðal Otodata og Nee-Vo skynjara) munu birtast í Bluetooth tæki rekja spor einhvers Home Assistant. Þú getur síðan búið til sniðmátskynjara til að flokka hrá BLE gögnin.
Script 3: Home Assistant Automation Scripts fyrir própanstigsviðvaranir
The Core Alerting Automations
Þessar sjálfvirkniforskriftir virka með hvaða tankhæðarskynjara sem er í Home Assistant - hvort sem það er frá Nee-Vo REST API, ESPHome DIY skynjara, Mopeka í gegnum MQTT, eða BLE proxy capture:
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%) # ────────────────────── ─────────────────────── - samnefni: "Própáfylling fannst - Endurstilla viðvaranir" auðkenni: propane_refill_detected trigger: pallur: numeric_state entity_id: sensor.propane_tank_level above: 80 action: - þjónusta: input_boolean.turn_offane entity6}._sent: input_boolean. - input_boolean.propane_refill_sent - þjónusta: notify.mobile_app_yourphone data: title: "✅ Propane Tank Refilled" skilaboð: > Tankhæð við {{ states('sensor.propane_tank_level') }}%. Allar viðvaranir hafa verið endurstilltar. Njóttu própansins!
Nauðsynlegar hjálpareiningar(bæta við configuration.yaml):
yaml复制
input_boolean: propane_warning_sent: nafn: "Própanviðvörun sent" tákn: mdi:alert propane_refill_sent: nafn: "Própáfyllingarviðvörun sent" tákn: mdi:alert
Handrit 4: Forskriftir fyrir samþættingu snjallheima
Hitastillir, lokar og sjálfvirkni lýsingar
Fyrir utan grunnviðvaranir, samþætta þessar forskriftir gögn um própanstig við víðtækara snjallheimakerfið þitt:
yaml复制
# ────────────────────── ─────────────────────── # GEYMÐ PRÓPAN - Lækkið hitastillinn þegar tankurinn er lítill # ────────────────────── ─────────────────────── sjálfvirkni: - alias: "Propane Conservation - Lower Thermostat at 30%" id: propane_conserve_30 trigger: platform: numeric_state entity_id: sensor.propane_tank_level below: 30 condition: - condition: time after: "06":0:0: "20:0:0" - ástand: ástand entity_id: climate.main_thermostat ástand: "hiti" aðgerð: - þjónusta: climate.set_temperature entity_id: climate.main_thermostat gögn: hitastig: 62 hvac_mode: hiti - þjónusta: notify.mobile_app_yourphone dataservation: Name: Active "Hitastillir lækkaður í 62 gráður F til að varðveita eftirstandandi própan." # ────────────────────── ─────────────────────── - samnefni: "Propane Conservation - Endurheimta hitastillir eftir áfyllingu" auðkenni: propane_restore_thermostat trigger: pallur: numeric_state entity_id: sensor.propane_tank_level above: 75 ástand: - ástand: state entity_id.propane: input_boonconservation_activ: input_boonconservation_id. - þjónusta: climate.set_temperature entity_id: climate.main_thermostat data: temperature: 68 - þjónusta: input_boolean.turn_off entity_id: input_boolean.propane_conservation_active # ────────────────────── ─────────────────────── # ÓEðlileg neysla - Finndu hugsanlegan leka # ────────────────────── ─────────────────────── - samnefni: "Óeðlileg própneysla - Hugsanleg leki" auðkenni: propane_leak_detection trigger: pallur: numeric_state entity_id: sensor.propane_consumption_rate hér að ofan: 5 # lítrar á klukkustund - stilla að tankstærð þinni aðgerð: {{800.símanúmer: farsíma} þjónustu: "⚠️ Óeðlileg própanneysla greind" skilaboð: > Óvenjuleg própanneysluhraði fannst: {{ states('sensor.propane_consumption_rate') }} gal/klst. Ef þetta er viðvarandi, athugaðu hvort leka eða búnaðarvandamál séu til staðar. - þjónusta: switch.turn_off entity_id: switch.propane_appliance_main # Valfrjálst: slökktu á gögnum um própanventil: {}
Forskrift 5: Sniðskynjarar fyrir reiknuð gildi
Afleidd gögn frá Raw Tank Level
Bættu við þessum sniðmátskynjara forskriftum til að reikna út afleidd gildi sem hrá API eða BLE gögnin veita ekki beint:
yaml复制
# template_sensors.yaml - Bæta við stillingarsniðmát Home Assistant: skynjari: # ────────────────────── ─────────────────────── # Dagar eftir miðað við núverandi neysluhlutfall # ────────────────────── ─────────────────────── - nafn: "Própandagar sem eftir eru" unit_of_measurement: "days" icon: "mdi:calendar-clock" state: > {% stillt stig=states('sensor.propane_tank_level')|flot %} {% set tank_size=250 %} {# lítrar - breyttu í tankstærð #} {% set gallons_left=(stig / 100) * tank_size %} {% set daily_rate=states('sensor.propane_daily_consumption')|float %} {% if daily_rate > 0 and gallons_left > 0 %} {{ (litra_left / daily_rate)|umferð(1) }} {% else %} Óþekkt {% endif %} # ────────────────────── ─────────────────────── # Heildardollarverðmæti eftirstandandi própans # ────────────────────── ─────────────────────── - nafn: "Propane Dollar Value Remaining" unit_of_measurement: "USD" tákn: "mdi:currency-usd" ástand: > {% stillt stig=states('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {# Breyta í raunverulegt verð #} {% set gallons_left=(stig / 100) * tank_size %} {{ "%.2f"|snið(gallons_left * price_per_gallon) }} # ────────────────────── ─────────────────────── # Texti própanstöðu (fullur/viðvörun/mikilvægur) # ────────────────────── ─────────────────────── - nafn: "Propane Status" tákn: "mdi:gas-cylinder" ástand: > {% stillt stig=states('sensor.propane_tank_level')|fljóta %} {% ef stig > 50 %} Fullt {% elif stig > 30 %} Venjulegt {% elif stig > 15 %} Lágt {% elif stig > 5 %} Mikilvægt {% else %} Tómt {% endif %} # ────────────────────── ─────────────────────── # Kostnaðaráætlun áfyllingar # ────────────────────── ─────────────────────── - nafn: "Própáfyllingarkostnaður Estimate" unit_of_measurement: "USD" tákn: "mdi:currency-usd" ástand: > {% stillt stig=states('sensor.propane_tank_level')|flot %} {% sett tank_stærð=250 %} {% sett verð_per_gallon=3.50 %} {% stillt gallon_to_fill=((100 - stig) / 100) * tank_size %} {% ef stig < 95 %} {{ "%.2f"|format(gallons_to_fill * price_per_gallon) }} {% else %} 0 {% endif %}
Forskrift 6: Node-RED Flow fyrir sjónræn sjálfvirkni
Sjónflæði fyrir ekki-kóðara
Fyrir notendur sem kjósa sjónrænan sjálfvirkni byggir fram yfir YAML forskriftir, hér er hnútur-RED flæði sem endurtekur sjálfvirkni forskriftirnar hér að ofan:
kóða复制
[{"id":"propane_level_trigger","type":"sprauta","z":"propane_flow","name":"Á fimmta fresti mín","repeat":"300","crontab":"","once":false,"topic":"","payload":"","payloadType":"date","x":100,"y":100,"wires":[["propane_fetch"]]}, {"id":"propane_fetch","type": 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,"y":10,{1}wires" {"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":"Stig Athugaðu","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":"🚨 CRITICAL: Própan á {{payload.tank_level_percent}}%! Fylltu strax aftur!","output":"str","x":},400":900,"wireys":{0},"wireys {"id":"propane_refill","type":"template","z":"propane_flow","name":"Refill Message","template":"⛽ Própan á {{payload.tank_level_percent}}%. Skipuleggðu áfyllingu fljótlega.","output":"str","x":900,"y":120,"y":120,"y":120," {"id":"propane_warning","type":"template","z":"propane_flow","name":"Viðvörunarskilaboð","template":"🔔 Própan á {{payload.tank_level_percent}}%. Fylgstu með notkun þinni.","output":"str","x":900,"y":180,"y":18,"{6} {"id":"propane_notify_critical","type":"api call service","z":"propane_flow","name":"Senda Critical Push","service":"notify.mobile_app_yourphone","x":1150,"y":60,"wires":[[]]}, {"apane"flash":"light" service","z":"propane_flow","name":"Flash All Lights","service":"light.turn_on","data":"{\\"entity_id\\":\\"light.living_room,eldhús\\",\\"data\\":{\\"flash\\":\\"long\\"}}","x":1150],"ys":1150],"ys {"id":"propane_notify_refill","type":"api call service","z":"propane_flow","name":"Senda Refill Push","service":"notify.mobile_app_yourphone","x":1150,"y":120,"vírar":[[]]}, {"notify":warapningi"notify":" service","z":"propane_flow","name":"Senda viðvörun Push","service":"notify.mobile_app_yourphone","x":1150,"y":180,"wires":[[]]}, {"id":"propane_gallons","type":"change","z":"nafn":_flow", Gallons","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":"breyting","z":"propane_flow","name":"Uppfærsla Hitastig","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":"Uppfæra aðstoðarmann heimilisins Entity","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false,"x":950,"y":280,"wires":[[]]}]
Til að nota þetta hnút-RAUTA flæði:
Settu upp Node-RED viðbótina í Home Assistant (í gegnum Stillingar → Viðbætur-)
Opnaðu Node-RED í vafranum þínum
Flytja inn flæðið (Valmynd → Flytja inn → límdu JSON hér að ofan)
Uppfærðu API vefslóðina og skilríkin í propane_fetch hnútnum
Uppfærðu propane_notify_critical og aðra tilkynningahnúta með raunverulegum auðkenni heimilisaðstoðareiningarinnar
Dreifðu flæðinu
Handrit 7: Dagleg tilkynning um yfirlit yfir própan
Stöðuskýrsla dags--
Þetta handrit sendir daglegt própanstöðuyfirlit á hentugum tíma á hverju kvöldi:
yaml复制
sjálfvirkni: - alias: "Daglegt própanyfirlit - 8 PM" id: daily_propane_summary trigger: pallur: tími kl: "20:00:00" aðgerð: - þjónusta: notify.mobile_app_yourphone data: title: "📊 Dagleg própanskýrsla" skilaboð {propanes('tanks Level:') Tank Level: }}% lítrar eftir: {{ states('sensor.propane_gallons') }} gal. Dagar sem eftir eru: {{ states('sensor.propane_days_remaining') }} dagar Neysla í dag: {{ states('sensor.propane_today_consumption') }} própan_tankur_hitastig('hitastig) geymir_hitastig ('hitastig) dollarastig' Gildi eftir: ${{ states('sensor.propane_dollar_value_remaining') }} Staða: {{ states('sensor.propane_status') }}
Algengar spurningar
Spurning 1: Er Otodata með API sem hægt er að skrifa forskriftir?
Otodata skjalfestir ekki opinberlega-aðgengilegt forritaskil viðskiptavinar frá og með 2026. Skjár þeirra nota LTE farsímatengingu við ský Otodata og viðskiptavinaforritið sækir gögn úr því skýi - en API endapunkturinn er ekki opinberlega skjalfestur og aðgangur er ekki veittur einstökum neytendum. Ráðlagð forskriftaraðferð fyrir Otodata notendur er að bæta samhliða ESPHome eða Mopeka skynjara við sama tank fyrir Home Assistant forskriftir, á meðan Otodata heldur áfram að sjá um sjálfvirkni birgja. Sumir meðlimir r/homeassistant samfélags hafa reynt að snúa við-BLE auglýsingasniði Otodata með því að nota ESP32 BLE umboð, en þetta er tilraunaverkefni og ekki nógu áreiðanlegt fyrir framleiðslu sjálfvirkni forskriftir.
Spurning 2: Hver er besta forskriftaraðferðin fyrir Nee-Vo?
Besta forskriftaraðferðin fyrir Nee-Vo fer eftir því hvort Nee-Vo dreifing þín afhjúpar API viðskiptavina. Ef API aðgangur er tiltækur (hafðu samband við própan birgjann þinn til að spyrjast fyrir), notaðu REST skynjara forskriftirnar í þessari handbók til að skoða Nee-Vo API beint í Home Assistant. Ef API aðgangur er ekki tiltækur er ráðlagð nálgun sú sama og Otodata: bættu samhliða ESPHome eða Mopeka skynjara við tankinn þinn og notaðu ESPHome + Home Assistant sjálfvirkniforskriftirnar í þessari handbók. Samhliða skynjaraaðferðin er sú áreiðanlegasta vegna þess að hún veitir þér fulla stjórn á skynjaragögnum, fastbúnaði og sjálfvirknirökfræði - án þess að vera háð framboði API birgja.
Q3: Hversu oft ættu sjálfvirkniforskriftirnar að athuga tankstigið?
Fyrir Home Assistant REST könnunarforskriftir (Nee-Vo API), er 5–10 mínútna skannabil nægilegt - tankstig breytist nógu hægt til að tíðari könnun sé óþörf og myndi valda of miklu API álagi. Fyrir ESPHome BLE proxy-forskriftir fangar ESP32 BLE auglýsingar stöðugt og Home Assistant vinnur þær í rauntíma - og - er ekki þörf á könnunarbili. Fyrir sjálfvirkni kveikja (viðvörunarþröskuldar), numeric_state Home Assistant kveikir strax þegar stigið fer yfir þröskuld, óháð könnunarbilinu. Stilltu daglega yfirlitstilkynninguna þína á sama tíma á hverju kvöldi (ráðlagt: 19–20) til að fá reglulega stöðuskýrslu án viðvörunarþreytu.
Spurning 4: Geta þessi forskrift virkað með mörgum skriðdrekum?
Já - öll forskriftir í þessari handbók styðja marga tanka. Fyrir REST API skoðanakönnun (Nee-Vo), bættu við viðbótar REST skynjarafærslum fyrir API endapunkt hvers tanks. Fyrir ESPHome BLE proxy getur ESP32 fanga auglýsingar frá mörgum BLE skynjurum samtímis - bara bætt við sniðmátskynjara fyrir gögn hvers tanks. Fyrir sjálfvirkniforskriftir, afritaðu sjálfvirknifærslurnar og breyttu entity_id til að vísa til sérstakra skynjaraeininga hvers tanks (td sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). Í Node-RED skaltu bæta við fleiri propane_level_check greinum fyrir hvern tank.
Spurning 5: Hvernig kemba ég skriftu sem virkar ekki?
Fyrir REST API forskriftir: notaðu Home Assistant þróunarverkfærin (Stillingar → Verkfæri þróunaraðila → Sniðmátaritill) til að prófa value_template þitt gegn hráum JSON gögnum. Afritaðu sýnishorn af API-svari og límdu það inn í sniðmátaritilinn til að ganga úr skugga um að útdráttur JSON-slóðar þinnar sé réttur. Fyrir ESPHome BLE proxy forskriftir: athugaðu ESPHome logs (esphome logs propane_ble_proxy) til að sjá hvort BLE auglýsingar séu teknar upp - ef þú sérð hrá MAC vistföng en engin læsileg gögn, skynjarinn er að senda út en sniðið er ekki þekkt. Fyrir sjálfvirkni forskriftir: notaðu Home Assistant rekja tólið (Traces flipann á hverri sjálfvirkni) til að sjá nákvæmlega hvað kveikti, hvaða aðstæður voru metnar og hvaða aðgerðir voru í gangi. Rekja tólið er öflugasta kembiforritið í Home Assistant - það sýnir nákvæma stöðu hverrar einingar á því augnabliki sem sjálfvirknin fór af stað.
The Bottom Line
Best er að nálgast Otodata og Nee-Vo própan tankvökta með samhliða forskriftarstefnu: notaðu vettvang birgjans (Otodata eða Nee-Vo) fyrir sjálfvirka áfyllingaráætlun og settu upp þinn eigin ESPHome eða Mopeka skynjara fyrir fulla forskriftarstýringu Home Assistant. Forskriftirnar sjö í þessari handbók - REST API skoðanakönnun, ESPHome BLE umboð, þrjú stig viðvörunar sjálfvirkni (viðvörun/áfylling/mikilvæg), samþættingarforskriftir fyrir snjallheimili (hitastillir, lokar, ljós), sniðmátskynjara fyrir afleidd gildi, hnút-RED allt sjónflæði og daglegt yfirlitseftirlit sem gefur þér fullkomið staðbundið kerfi sem virkar sjálfvirkt á heimilinu {{5} Aðstoðarmaður. Sameiginleg reynsla r/homeassistant samfélagsins staðfestir að þessi samhliða nálgun skilar því besta af báðum heimum: núll birgðastjórnunarkostnaður og fullkomið gagnaeignarhald og sveigjanleiki í sjálfvirkni á heimilisaðstoðarhliðinni. Byrjaðu á sjálfvirkniforskriftum (Script 3) og sniðmátskynjara (Script 5), stækkaðu síðan í ESPHome BLE proxy (Script 2) fyrir hámarks umfang. Hvert skriftulag bætir við annarri gildisvídd - frá grunnsýnileika til fullrar samþættingar snjallhúsa sem bregst sjálfkrafa við própanstiginu þínu.
Síðast uppfært: júlí 2026
Fyrirvari: Þessi handbók veitir Home Assistant og ESPHome forskriftardæmi fyrir Otodata og Nee-Vo própan tankvöktunarsamþættingu í fræðsluskyni. API-endapunktar, reitaheiti og JSON-snið sem vísað er til í þessari handbók eru dæmigerð dæmi - staðfestu alltaf raunverulega API-uppbyggingu þína með þinni tilteknu Nee-Vo dreifingu áður en þú stillir REST-skynjara. ESPHome BLE proxy forskriftir fanga allar nálægar BLE auglýsingar - tryggja að þú uppfyllir staðbundnar reglur varðandi eftirlit með BLE tækjum. Sjálfvirkni heimahjálpar hefur samskipti við raunverulega-heimskerfi, þar á meðal loftræstikerfi, gasventla og rafmagnstæki - prófa allar sjálfvirkni við öruggar aðstæður áður en þær eru notaðar í framleiðslu. Þessi handbók er ekki tengd, samþykkt af eða styrkt af Otodata, Nee-Vo, Home Assistant, ESPHome, Node-RED eða r/homeassistant samfélaginu.
