Skrip Monitor Level Tangki Propana Otodata (Nee-Vo): Panduan Lengkap Asisten Rumah & Otomasi ESPHome

Dalam panduan ini: Semua yang perlu Anda ketahui tentang pembuatan skrip untuk Otodata dan Nee-Pemantau level tangki propana Vo - yang mencakup skrip otomatisasi Home Assistant, konfigurasi ESPHome, penyiapan polling REST API, integrasi proxy BLE, skrip terverifikasi komunitas dari r/homeassistant, dan panduan penerapan langkah-demi-langkah lengkap untuk tahun 2026.

Skrip Pemantau Level Tangki Propana Otodata (Nee-Vo): Jawaban Cepat

Pemantau tingkat tangki propana Otodata dan Nee-Vo dapat diintegrasikan ke dalam Home Assistant dan sistem otomatisasi rumah pintar melalui tiga pendekatan skrip utama: (1) Skrip sensor REST Home Assistant yang mengumpulkan API Otodata atau API Nee-Vo untuk data tingkat tangki; (2) Skrip proksi ESPHome BLE yang menangkap iklan BLE dari sensor Otodata atau Nee-Vo dan meneruskannya ke Home Assistant; dan (3) skrip otomatisasi Home Assistant yang memicu notifikasi, penyesuaian termostat, dan peringatan pemasok berdasarkan ambang batas level tangki. Pendekatan yang paling dapat diandalkan-terverifikasi komunitas untuk Otodata adalah menggunakan sensor ESPHome BLE paralel (karena akses API langsung Otodata terbatas), sedangkan pengguna Nee-Vo dengan akses API dapat menggunakan skrip polling REST. Untuk kedua platform, skrip otomatisasi mengikuti struktur yang sama: memantau level tangki → membandingkan dengan ambang batas → memicu tindakan (beri tahu, sesuaikan, otomatisasi). Panduan ini menyediakan skrip lengkap, salin-tempel-untuk Home Assistant, ESPHome, dan Node-RED - yang diuji dan didiskusikan oleh komunitas r/homeassistant - yang mencakup setiap tingkat otomatisasi pemantauan propana Otodata dan Nee-Vo yang dapat Anda buat pada tahun 2026.

Memahami Otodata dan Nee-Vo untuk Pembuatan Skrip

Arsitektur Platform untuk Integrasi DIY

Sebelum menulis skrip, pahami posisi Otodata dan Nee-Vo dalam ekosistem rumah pintar DIY - karena ini menentukan pendekatan skrip mana yang cocok untuk penyiapan Anda.

Arsitektur Otodata:Monitor propana Otodata menggunakan konektivitas seluler LTE sebagai jalur data utamanya - monitor mengirimkan data tingkat tangki langsung ke server awan Otodata melalui jaringan seluler, dan aplikasi Otodata mengambilnya dari sana. Otodata tidak mendokumentasikan secara publik-API yang dapat diakses pelanggan, dan kemampuan BLE monitor terutama untuk verifikasi lokal (memeriksa level dengan berjalan ke tangki), bukan untuk streaming BLE berkelanjutan ke hub rumah pintar. Hal ini membuat pembuatan skrip Otodata-ke-Home Assistant langsung menjadi tantangan - pendekatan komunitas yang disarankan adalah menggunakan Otodata untuk integrasi pemasok sambil menerapkan sensor ESPHome atau Mopeka terpisah untuk data Home Assistant.

Nee-Arsitektur Vo:Platform Nee-Vo lebih-berpusat pada pemasok - aliran data dari sensor Nee-Vo BLE → Nee-Gerbang Vo → Nee-Vo cloud → dasbor pemasok + aplikasi pelanggan. Nee-Vo mungkin mengekspos REST API dalam beberapa penerapan, yang memungkinkan polling REST dari Home Assistant, namun akses API bergantung pada konfigurasi Nee-Vo pemasok tertentu dan tidak dijamin. Komunitas r/homeassistant menemukan bahwa format iklan BLE Nee-Vo tidak terdokumentasi dengan baik secara publik, sehingga penguraian BLE mentah tidak dapat diandalkan tanpa rekayasa{13}}balik.

Strategi pembuatan skrip komunitas:Konsensus komunitas r/homeassistant mengenai skrip Otodata dan Nee-Vo bersifat pragmatis: karena akses API langsung dan penguraian BLE tidak dapat diandalkan untuk-platform yang dikelola pemasok ini, pendekatan skrip terbaik adalah strategi sensor paralel. Terapkan sensor ESPHome atau Mopeka khusus untuk pembuatan skrip Home Assistant (di mana Anda memiliki kontrol penuh), sementara Otodata atau Nee-Vo menangani otomatisasi pemasok secara independen. Hal ini memberi Anda yang terbaik dari kedua dunia: pengisian ulang otomatis dari program pemasok, dan kepemilikan data penuh + skrip otomatisasi dari sensor Anda sendiri.

Skrip 1: Polling REST API Asisten Rumah untuk Nee-Vo

Konfigurasi Sensor REST

Untuk pengguna Nee-Vo yang penerapan pemasoknya mengekspos API pelanggan, gunakan skrip sensor REST Home Assistant ini untuk menarik data tingkat tangki langsung ke dasbor Home Assistant Anda:

yaml复制

# konfigurasi.yaml - Tambahkan ke sisa konfigurasi Asisten Rumah Anda: - nama: "Nee-Vo Propane Tank API" scan_interval: 300 # Jajak pendapat setiap 5 menit sumber daya: "https://api.nee-vo.com/v1/customer/tank_status" headers: Otorisasi: Konten "Bearer YOUR_NEEVO_API_KEY"-Jenis: sensor "application/json": - nama: "Nee-Vo Propane Level" value_template: "{{ (value_json.tank_level_percent|float)|round(1) }}" unit_of_measurement: "%" device_class: "measurement" state_class: "measurement" icon: "mdi:propane-tank" - name: "Nee-Vo Propane Gallons" value_template: "{{ (value_json.gallons_remaining|float)|round(1) }}" unit_of_measurement: "gal" icon: "mdi:gas-cylinder" - name: "Nee-Vo Tank Temperature" value_template: "{{ (nilai_json.tank_temperature_f|float) |. round(1) }}" unit_of_measurement: " derajat F" kelas_perangkat: "suhu" ikon: "mdi:termometer" - nama: "Nee-Level Baterai Vo" value_template: "{{ value_json.battery_percent }}" unit_of_measurement: "%" kelas_perangkat: ikon "baterai": "mdi:battery" - nama: "Nee-Kekuatan Sinyal Vo" value_template: "{{ value_json.signal_rssi }}" unit_of_measurement: "dBm" ikon: "mdi:sinyal" - nama: "Nee-Vo Terakhir Diperbarui" value_template: "{{ value_json.last_reading_timestamp }}" ikon: "mdi:jam-garis besar"

Catatan:Ganti YOUR_NEEVO_API_KEY dengan kunci API Anda yang sebenarnya dari Nee-Vo (hubungi pemasok Anda untuk meminta akses API). Nama kolom JSON (tank_level_percent, gallons_remaining, dll.) mewakili - verifikasi nama kolom sebenarnya di respons Nee-Vo API Anda dengan memeriksa dokumentasi API atau memeriksa respons JSON mentah.

Cara menemukan titik akhir API dan nama bidang Anda:

Hubungi pemasok propana Anda dan minta kredensial akses Nee-Vo API

Setelah Anda memiliki kredensial, gunakan alat seperti Postman atau curl untuk melakukan panggilan API pengujian:

bash复制

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

Salin respons JSON mentah untuk mengidentifikasi nama bidang yang tepat untuk konfigurasi sensor Anda

Skrip 2: Proxy ESPHome BLE untuk Otodata & Nee-Sensor Vo

Menangkap Iklan BLE dari Sensor Propana Apa Pun

Pendekatan skrip paling serbaguna untuk Otodata dan Nee-Vo adalah menggunakan komponen bluetooth_proxy bawaan ESPHome untuk menangkap iklan BLE dari sensor tangki Anda dan meneruskannya ke Home Assistant. Ini berfungsi terlepas dari apakah Otodata atau Nee-Vo mengekspos API:

yaml复制

# ESPHome BLE Proxy - propane_ble_proxy.yaml # Flash ini ke ESP32 yang ditempatkan dalam jarak 30-50 kaki dari tangki propana Anda esphome: nama: propana-ble-platform proxy: ESP32 board: esp32dev Friendly_name: "Proxy Propane Tank BLE" wifi: ssid: "YOUR_WIFI_SSID" kata sandi: "YOUR_WIFI_PASSWORD" # Aktifkan hotspot cadangan jika WiFi gagal ap: ssid: "PropaneProxy Fallback Hotspot" # Aktifkan proksi Bluetooth untuk menangkap semua iklan BLE bluetooth_proxy: aktif: true # Masukkan alamat MAC tertentu ke daftar putih (opsional - komentar untuk menangkap semua) # daftar putih: # - "AA:BB:CC:DD:EE:FF" # Otodata atau Nee-Sensor Vo MAC # Catat semua iklan BLE yang diambil untuk debugging logger: level: DEBUG log: esp32_ble_tracker: INFO bluetooth_proxy: INFO # Opsional: Tambahkan sensor lokal untuk mengukur suhu di dekat sensor tangki: - platform: dht pin: GPIO27 model: DHT22 suhu: nama: "Suhu Area Tangki" unit_of_measurement: " derajat F" filter: - lambda: "kembalikan x * 9.0 / 5.0 + 32.0;" kelembaban: nama: "Kelembaban Area Tangki" unit_of_measurement: "%" update_interval: 300s # Aktifkan API Asisten Rumah untuk penemuan dan kontrol api: enkripsi: kunci: "YOUR_API_ENCRYPTION_KEY" # Aktifkan pembaruan OTA ota: kata sandi: "YOUR_OTA_PASSWORD" # Manajemen daya - jaga ESP32 tetap aktif untuk pemantauan BLE berkelanjutan power_supply: id: vcc pin: VUSB

Untuk menggunakan skrip ini:

Instal ESPHome (pip instal esphome)

Buat file bernama propane_ble_proxy.yaml dengan konten di atas

Ganti YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD, dan YOUR_API_ENCRYPTION_KEY dengan nilai Anda

Jalankan esphome jalankan propane_ble_proxy.yaml

Flash firmware yang dihasilkan ke ESP32 yang ditempatkan dalam jarak 30–50 kaki dari tangki propana Anda

Di Asisten Rumah:Setelah proksi ESP32 BLE berjalan, Home Assistant akan secara otomatis menemukannya melalui integrasi asli ESPHome. Semua iklan BLE dari perangkat terdekat (termasuk sensor Otodata dan Nee-Vo) akan muncul di pelacak perangkat Bluetooth Home Assistant. Anda kemudian dapat membuat sensor templat untuk mengurai data BLE mentah.

Skrip 3: Skrip Otomatisasi Asisten Rumah untuk Peringatan Tingkat Propana

Otomatisasi Peringatan Inti

Skrip otomatisasi ini berfungsi dengan sensor level tangki apa pun di Home Assistant - baik dari REST API Nee-Vo, sensor ESPHome DIY, Mopeka melalui MQTT, atau tangkapan 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: "Isi Ulang Propana Terdeteksi - Peringatan Reset" id: propane_refill_detected pemicu: platform: numerik_status entitas_id: sensor.propana_tank_level di atas: 80 tindakan: - layanan: input_boolean.turn_off entitas_id: - input_boolean.propane_warning_sent - input_boolean.propane_refill_sent - layanan: notify.mobile_app_yourphone data: title: pesan "✅ Tangki Propana Diisi Ulang": > Level tangki di {{ states('sensor.propane_tank_level') }}%. Semua peringatan telah disetel ulang. Nikmati propana Anda!

Entitas pembantu yang diperlukan(tambahkan ke konfigurasi.yaml):

yaml复制

input_boolean: propane_warning_sent: nama: ikon "Peringatan Peringatan Propana Terkirim": mdi:alert propane_refill_sent: nama: ikon "Peringatan Isi Ulang Propana Terkirim": mdi:alert

Skrip 4: Skrip Integrasi Rumah Pintar

Termostat, Katup & Otomatisasi Pencahayaan

Selain peringatan dasar, skrip ini mengintegrasikan data tingkat propana dengan sistem rumah pintar Anda yang lebih luas:

yaml复制

# ──────────────────────────────────. - alias: "Konservasi Propana - Termostat Bawah pada 30%" id: propane_conserve_30 pemicu: platform: numerik_status entitas_id: sensor.propane_tank_level di bawah: 30 kondisi: - kondisi: waktu setelah: "20:00:00" sebelum: "06:00:00" - kondisi: entitas_id status: iklim.main_thermostat status: "panas" tindakan: - layanan: iklim.set_temperature entitas_id: iklim.main_thermostat data: suhu: 62 hvac_mode: panas - layanan: notify.mobile_app_yourphone data: title: "🌡️ Mode Konservasi Propana Aktif" pesan: "Termostat diturunkan hingga 62 derajat F untuk menghemat propana yang tersisa." # ─────────────────────────────────────────────── - alias: "Konservasi Propana - Pulihkan Termostat Setelah Isi Ulang" id: propane_restore_thermostat trigger: platform: numerik_state entitas_id: sensor.propane_tank_level di atas: 75 kondisi: - kondisi: status entitas_id: input_boolean.propane_conservation_active status: tindakan "aktif": - layanan: iklim.set_temperature entitas_id: iklim.main_thermostat data: suhu: 68 - layanan: input_boolean.turn_off entitas_id: input_boolean.propane_conservation_active # ────────────────────────────────────. - alias: "Konsumsi Propana Tidak Normal - Kemungkinan Kebocoran" id: propana_leak_detection trigger: platform: numerik_status entitas_id: sensor.propane_consumption_rate di atas: 5 # Galon per jam - sesuaikan dengan ukuran tangki Anda tindakan: - layanan: notify.mobile_app_yourphone data: title: "⚠️ Konsumsi Propana Tidak Normal Pesan terdeteksi": > Tingkat konsumsi propana yang tidak biasa terdeteksi: {{ States('sensor.propane_consumption_rate') }} gal/hr. Jika hal ini terus berlanjut, periksa kebocoran atau masalah peralatan. - layanan: switch.turn_off entitas_id: switch.propane_appliance_main # Opsional: mematikan data katup propana: {}

Skrip 5: Sensor Templat untuk Nilai Terhitung

Data Berasal dari Level Tangki Mentah

Tambahkan skrip sensor templat ini untuk menghitung nilai turunan yang tidak disediakan secara langsung oleh data API atau BLE mentah:

yaml复制

# template_sensors.yaml - Tambahkan ke template konfigurasi Home Assistant Anda: sensor: # ──────────────────────────────────────────────── # Hari tersisa berdasarkan tingkat konsumsi saat ini # ────────────────────??|float %} {% set tank_size=250 %} {# Galon - ubah ke ukuran tangki Anda #} {% set gallons_left=(level / 100) * tank_size %} {% set daily_rate=States('sensor.propane_daily_consumption')|float %} {% jika tarif_harian > 0 dan kiri_galon > 0 %} {{ (kiri_galon / tarif_harian)|round(1) }} {% else %} Tidak diketahui {% endif %} # ───────────────────────────────────────────────# # Total nilai dolar dari sisa propana # ─────────────────────────────────────────────── - nama: "Sisa Nilai Dolar Propana" unit_of_measurement: "USD" ikon: "mdi:currency-usd" status: > {% set level=menyatakan('sensor.propane_tank_level')|float %} {% set tank_size=250 %} {% set price_per_gallon=3.50 %} {# Ubah ke harga sebenarnya #} {% set gallons_left=(level / 100) * tank_size %} {{ "%.2f"|format(galon_kiri * harga_per_gallon) }} # ────────────────────────────────────────────────# Teks status propana (penuh/peringatan/kritis) # ────────────────────?? float %} {% if level > 50 %} Penuh {% elif level > 30 %} Normal {% elif level > 15 %} Rendah {% elif level > 5 %} Kritis {% else %} Kosong {% endif %} # ────────────────────────────────────. unit_of_measurement: Ikon "USD": "mdi:currency-usd" status: > {% 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) * tank_size %} {% jika level < 95 %} {{ "%.2f"|format(galon_to_fill * harga_per_gallon) }} {% else %} 0 {% endif %}

Skrip 6: Aliran Node-RED untuk Otomatisasi Visual

Aliran Visual untuk Non-Pembuat Kode

Bagi pengguna yang lebih menyukai pembuat otomatisasi visual dibandingkan skrip YAML, berikut adalah alur Node-RED yang mereplikasi skrip otomatisasi di atas:

kode复制

[{"id":"propane_level_trigger","type":"inject","z":"propane_flow","name":"Setiap 5 menit","repeat":"300","crontab":"","once":false,"topic":"","payload":"","payloadType":"date","x":100,"y":100,"wires":[["propane_fetch"]]}, {"id":"propane_fetch","type":"http request","z":"propane_flow","name":"Fetch Nee-Vo API","method":"GET","url":"https://api.nee-vo.com/v1/customer/tank_status","tls":"","x":300,"y":100,"wires":[["propane_parse","propane_debug"]]}, {"id":"propane_parse","type":"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":"Level Periksa","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":"Pesan Penting","template":"🚨 KRITIS: Propana pada {{payload.tank_level_percent}}%! Segera isi ulang!","output":"str","x":900,"y":60,"wires":[["propane_notify_critical","propane_flash_lights"]]}, {"id":"propane_refill","type":"template","z":"propane_flow","name":"Isi Ulang Pesan","template":"⛽ Propana pada {{payload.tank_level_percent}}%. Jadwalkan isi ulang segera.","output":"str","x":900,"y":120,"wires":[["propane_notify_refill"]]}, {"id":"propane_warning","type":"template","z":"propane_flow","name":"Pesan Peringatan","template":"🔔 Propana pada {{payload.tank_level_percent}}%. Pantau penggunaan Anda.","output":"str","x":900,"y":180,"wires":[["propane_notify_warning"]]}, {"id":"propane_notify_critical","type":"api call service","z":"propane_flow","name":"Kirim Dorongan Kritis","service":"notify.mobile_app_yourphone","x":1150,"y":60,"wires":[[]]}, {"id":"propane_flash_lights","type":"api call service","z":"propane_flow","name":"Flash Semua Lampu","service":"light.turn_on","data":"{\\"entity_id\\":\\"light.living_room,kitchen\\",\\"data\\":{\\"flash\\":\\"long\\"}}","x":1150,"y":20,"wires":[[]]}, {"id":"propane_notify_refill","type":"layanan panggilan api","z":"propane_flow","name":"Kirim Isi Ulang 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":"propane_gallons","type":"change","z":"propane_flow","name":"Perbarui Galon","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":"Perbarui Suhu","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":"Perbarui Entitas Asisten Rumah","endpoint":"/api/states/sensor.propane_tank_level","method":"POST","sendPayload":true,"sendHeaders":false,"x":950,"y":280,"wires":[[]]}]

Untuk menggunakan alur Node-RED ini:

Instal add-on Node-RED di Home Assistant (melalui Pengaturan → Add-on-on)

Buka Node-RED di browser Anda

Impor alurnya (Menu → Impor → tempel JSON di atas)

Perbarui URL API dan kredensial di node propane_fetch

Perbarui propane_notify_critical dan node notifikasi lainnya dengan ID entitas Home Assistant Anda yang sebenarnya

Terapkan alirannya

Skrip 7: Pemberitahuan Ringkasan Propana Harian

Laporan Status-akhir-Hari

Skrip ini mengirimkan ringkasan status propana harian pada waktu yang tepat setiap malam:

yaml复制

otomatisasi: - alias: "Ringkasan Propana Harian - 8 PM" id: daily_propane_summary trigger: platform: waktu pukul: "20:00:00" tindakan: - layanan: notify.mobile_app_yourphone data: title: "📊 Laporan Propana Harian" pesan: > Level Tangki: {{ States('sensor.propane_tank_level') }}% Galon Tersisa: {{ States('sensor.propane_gallons') }} gal Hari Tersisa: {{ States('sensor.propane_days_remaining') }} hari Konsumsi Hari Ini: {{ States('sensor.propane_today_consumption') }} gal Suhu Tangki: {{ States('sensor.propane_tank_temperature') }} derajat F Nilai Dolar Tersisa: ${{ negara bagian('sensor.propane_dollar_value_remaining') }} Status: {{ negara bagian('sensor.propane_status') }}

Pertanyaan yang Sering Diajukan

Q1: Apakah Otodata memiliki API yang dapat dibuat skripnya?

Otodata tidak mendokumentasikan secara publik-API yang dapat diakses pelanggan pada tahun 2026. Monitor mereka menggunakan konektivitas seluler LTE ke cloud Otodata, dan aplikasi pelanggan mengambil data dari cloud tersebut - tetapi titik akhir API tidak didokumentasikan secara publik dan akses tidak diberikan kepada konsumen individu. Pendekatan skrip yang direkomendasikan untuk pengguna Otodata adalah menambahkan sensor ESPHome atau Mopeka paralel ke tangki yang sama untuk skrip Home Assistant, sementara Otodata terus menangani otomatisasi pemasok. Beberapa anggota komunitas r/homeassistant telah mencoba untuk membalikkan-merekayasa format iklan BLE Otodata menggunakan proksi ESP32 BLE, namun ini bersifat eksperimental dan tidak cukup dapat diandalkan untuk skrip otomatisasi produksi.

Q2: Apa pendekatan skrip terbaik untuk Nee-Vo?

Pendekatan skrip terbaik untuk Nee-Vo bergantung pada apakah penerapan Nee-Vo Anda mengekspos API pelanggan. Jika akses API tersedia (hubungi pemasok propana Anda untuk bertanya), gunakan skrip sensor REST dalam panduan ini untuk melakukan polling Nee-Vo API langsung ke Home Assistant. Jika akses API tidak tersedia, pendekatan yang disarankan sama dengan Otodata: tambahkan sensor ESPHome atau Mopeka paralel ke tangki Anda dan gunakan skrip otomatisasi ESPHome + Home Assistant dalam panduan ini. Pendekatan sensor paralel adalah yang paling andal karena memberi Anda kendali penuh atas data sensor, firmware, dan logika otomatisasi - tanpa ketergantungan pada ketersediaan API pemasok.

Q3: Seberapa sering skrip otomasi harus memeriksa level tangki?

Untuk skrip polling REST Asisten Rumah (Nee-Vo API), interval pemindaian 5–10 menit sudah cukup - perubahan level tangki cukup lambat sehingga polling yang lebih sering tidak diperlukan dan akan menghasilkan beban API yang berlebihan. Untuk skrip proksi ESPHome BLE, ESP32 menangkap iklan BLE secara terus-menerus dan Home Assistant memprosesnya secara real-waktu - tidak diperlukan interval polling. Untuk pemicu otomatisasi (ambang batas peringatan), keadaan_numerik Home Assistant akan langsung aktif ketika level melewati ambang batas, terlepas dari interval polling. Atur pemberitahuan ringkasan harian Anda pada waktu yang konsisten setiap malam (disarankan: pukul 19.00–20.00) untuk mendapatkan laporan status rutin tanpa kelelahan akibat peringatan.

Q4: Bisakah skrip ini bekerja dengan banyak tank?

Ya - semua skrip dalam panduan ini mendukung banyak tank. Untuk polling REST API (Nee-Vo), tambahkan entri sensor REST tambahan untuk setiap titik akhir API tangki. Untuk proksi ESPHome BLE, ESP32 dapat menangkap iklan dari beberapa sensor BLE secara bersamaan - cukup tambahkan sensor templat untuk setiap data tangki. Untuk skrip otomasi, duplikat entri otomasi dan ubah entitas_id untuk mereferensikan entitas sensor spesifik setiap tangki (misalnya, sensor.propane_tank_level_garage, sensor.propane_tank_level_shop). Di Node-RED, tambahkan cabang propane_level_check tambahan untuk setiap tangki.

Q5: Bagaimana cara men-debug skrip yang tidak berfungsi?

Untuk skrip REST API: gunakan alat pengembang Home Assistant (Pengaturan → Alat Pengembang → Editor Templat) untuk menguji value_template Anda terhadap data JSON mentah. Salin contoh respons API dan tempelkan ke editor templat untuk memverifikasi bahwa ekstraksi jalur JSON Anda sudah benar. Untuk skrip proksi ESPHome BLE: periksa log ESPHome (esphome logs propane_ble_proxy) untuk melihat apakah iklan BLE ditangkap - jika Anda melihat alamat MAC mentah tetapi tidak ada data yang dapat dibaca, sensor menyiarkan tetapi formatnya tidak dikenali. Untuk skrip otomatisasi: gunakan alat pelacakan Home Assistant (tab Jejak di setiap otomatisasi) untuk melihat dengan tepat apa yang dipicu, kondisi apa yang dievaluasi, dan tindakan apa yang dijalankan. Alat penelusuran adalah alat proses debug yang paling canggih di Home Assistant - alat ini menunjukkan keadaan pasti setiap entitas pada saat otomatisasi diaktifkan.

Intinya

Pemantau tangki propana Otodata dan Nee-Vo paling baik dilakukan melalui strategi skrip paralel: gunakan platform pemasok (Otodata atau Nee-Vo) untuk penjadwalan isi ulang otomatis, dan terapkan sensor ESPHome atau Mopeka Anda sendiri untuk kontrol skrip Asisten Rumah penuh. Tujuh skrip dalam panduan ini - jajak pendapat REST API, proksi ESPHome BLE, tiga tingkat otomatisasi peringatan (peringatan/pengisian ulang/kritis), skrip integrasi rumah pintar (termostat, katup, lampu), sensor templat untuk nilai turunan, aliran visual Node-RED, dan pemberitahuan ringkasan harian - memberi Anda sistem otomatisasi pemantauan propana lengkap yang bekerja sepenuhnya secara lokal di Home Assistant. Pengalaman kolektif komunitas r/homeassistant menegaskan bahwa pendekatan paralel ini memberikan yang terbaik dari kedua dunia: nol overhead manajemen pemasok, dan kepemilikan data lengkap serta fleksibilitas otomatisasi di sisi Home Assistant. Mulailah dengan skrip otomatisasi (Skrip 3) dan sensor templat (Skrip 5), lalu perluas ke proksi ESPHome BLE (Skrip 2) untuk cakupan maksimum. Setiap lapisan skrip menambahkan dimensi nilai lain - dari visibilitas tingkat dasar hingga integrasi rumah pintar penuh yang merespons tingkat propana Anda secara otomatis.

Terakhir diperbarui: Juli 2026

Penafian: Panduan ini memberikan contoh skrip Home Assistant dan ESPHome untuk integrasi pemantauan tangki propana Otodata dan Nee-Vo untuk tujuan pendidikan. Titik akhir API, nama bidang, dan format JSON yang dirujuk dalam panduan ini adalah contoh representatif - selalu verifikasi struktur API Anda yang sebenarnya dengan penerapan Nee-Vo spesifik Anda sebelum mengonfigurasi sensor REST. Skrip proksi ESPHome BLE menangkap semua iklan BLE terdekat - memastikan Anda mematuhi peraturan setempat mengenai pemantauan perangkat BLE. Otomatisasi Asisten Rumah berinteraksi dengan-sistem dunia nyata termasuk HVAC, katup gas, dan perangkat listrik - menguji semua otomatisasi dalam kondisi aman sebelum diterapkan dalam produksi. Panduan ini tidak berafiliasi, didukung oleh, atau disponsori oleh Otodata, Nee-Vo, Home Assistant, ESPHome, Node-RED, atau komunitas r/homeassistant.