Otodata (Nee-Vo) البرنامج النصي لمراقبة مستوى خزان البروبان

Jul 28, 2026

ترك رسالة

Otodata (Nee-Vo) النصي لمراقبة مستوى خزان البروبان: مساعد منزلي كامل ودليل أتمتة ESPHome

في هذا الدليل: كل ما تحتاج إلى معرفته حول البرمجة النصية لشاشات مراقبة مستوى خزان Otodata وNee-Vopropane - التي تغطي البرامج النصية لأتمتة Home Assistant، وتكوينات ESPHome، وإعدادات استقصاء REST API، وعمليات تكامل وكيل BLE، والنصوص البرمجية التي تم التحقق منها من قبل المجتمع-من r/homeassistant، ودليل التنفيذ الكامل-بواسطة-خطوة لعام 2026.


Otodata (Nee-Vo) النص البرمجي لمراقبة مستوى خزان البروبان: إجابة سريعة

يمكن دمج أجهزة مراقبة مستوى خزان البروبان Otodata وNee-Vo في Home Assistant وأنظمة أتمتة المنزل الذكي من خلال ثلاثة أساليب برمجة نصية أساسية: (1) البرامج النصية لمستشعر Home Assistant REST التي تستقصي واجهة برمجة تطبيقات Otodata أو Nee-Vo's API لبيانات مستوى الخزان؛ (2) البرامج النصية لوكيل ESPHome BLE التي تلتقط إعلانات BLE من أجهزة استشعار Otodata أو Nee-Vo وتعيد توجيهها إلى Home Assistant؛ و(3) البرامج النصية لأتمتة Home Assistant التي تقوم بتشغيل الإشعارات وتعديلات الحرارة وتنبيهات الموردين بناءً على عتبات مستوى الخزان. إن النهج الأكثر موثوقية الذي تم التحقق منه من قبل المجتمع-لـ Otodata هو استخدام مستشعر ESPHome BLE المتوازي (نظرًا لأن الوصول المباشر إلى واجهة برمجة التطبيقات لـ Otodata محدود)، بينما يمكن لمستخدمي Nee-Vo الذين لديهم وصول إلى واجهة برمجة التطبيقات استخدام البرامج النصية لاستقصاء REST. بالنسبة لكلا النظامين الأساسيين، تتبع نصوص الأتمتة نفس البنية: مراقبة مستوى الخزان ← المقارنة مع الحدود ← تشغيل الإجراءات (الإخطار، الضبط، التشغيل الآلي). يوفر هذا الدليل نصوصًا برمجية جاهزة كاملة ونسخ-لصق- لـ Home Assistant وESPHome وNode-RED - التي تم اختبارها ومناقشتها بواسطة مجتمع r/homeassistant - الذي يغطي كل مستوى من Otodata وNee-Vo أتمتة مراقبة البروبان التي يمكنك إنشاؤها في عام 2026.


فهم Otodata وNee-Vo للبرمجة النصية

بنية النظام الأساسي للتكامل DIY

قبل كتابة البرامج النصية، افهم موقع Otodata وNee-Vo في نظام DIY للمنزل الذكي - لأن هذا يحدد أسلوب البرمجة النصية الذي سيعمل مع الإعداد لديك.

بنية Otodata:تستخدم شاشات البروبان Otodata اتصال LTE الخلوي كمسار بيانات أساسي - ترسل الشاشة بيانات مستوى الخزان مباشرة إلى خوادم Otodata السحابية عبر الشبكة الخلوية، ويقوم تطبيق Otodata باستردادها من هناك. لا تقوم Otodata بتوثيق واجهة برمجة التطبيقات (API) التي يمكن للعميل الوصول إليها- بشكل علني، كما أن قدرة BLE الخاصة بالشاشة مخصصة في المقام الأول للتحقق المحلي (التحقق من المستوى عن طريق المشي إلى الخزان)، وليس لتدفق BLE المستمر إلى مركز المنزل الذكي. وهذا يجعل البرمجة النصية المباشرة لـ Otodata-إلى-Home Assistant تتحدى - نهج المجتمع الموصى به هو استخدام Otodata لتكامل الموردين أثناء نشر مستشعر ESPHome أو Mopeka منفصل لبيانات Home Assistant.

ني-هندسة Vo:تعد منصة Nee-Vo أكثر تركيزًا على الموردين-من - حيث تتدفق البيانات من مستشعر Nee-Vo BLE → Nee-Vo gate → Nee-Vo cloud → لوحة تحكم المورد + تطبيق العميل. قد يعرض Nee-Vo واجهة برمجة تطبيقات REST في بعض عمليات النشر، مما يتيح استقصاء REST من Home Assistant، لكن الوصول إلى واجهة برمجة التطبيقات يعتمد على تكوين Nee-Vo الخاص بالمورد المحدد وهو غير مضمون. اكتشف مجتمع r/homeassistant أن تنسيق إعلان Nee-Vo’s BLE غير موثق بشكل جيد-علنيًا، مما يجعل تحليل BLE الأولي غير موثوق به بدون هندسة-عكسية.

استراتيجية البرمجة المجتمعية:يعد إجماع مجتمع r/homeassistant على البرمجة النصية لـ Otodata وNee-Vo أمرًا واقعيًا: نظرًا لأن الوصول المباشر إلى واجهة برمجة التطبيقات (API) وتحليل BLE لا يمكن الاعتماد عليهما بالنسبة لهذه الأنظمة الأساسية التي يديرها الموردون-، فإن أفضل نهج للبرمجة النصية هو استراتيجية استشعار متوازية. انشر مستشعر ESPHome أو Mopeka مخصصًا للبرمجة النصية لـ Home Assistant (حيث يكون لديك تحكم كامل)، بينما يتعامل Otodata أو Nee-Vo مع أتمتة الموردين بشكل مستقل. يمنحك هذا أفضل ما في كلا العالمين: عمليات إعادة التعبئة التلقائية من برنامج المورد، والملكية الكاملة للبيانات + البرمجة النصية التلقائية من المستشعر الخاص بك.


البرنامج النصي 1: استطلاع واجهة برمجة تطبيقات REST لمساعد المنزل لـ Nee-Vo

تكوين مستشعر REST

بالنسبة لمستخدمي Nee-Vo الذين يكشف نشرهم للموردين عن واجهة برمجة تطبيقات العميل، استخدم البرنامج النصي لمستشعر Home Assistant REST لسحب بيانات مستوى الخزان مباشرة إلى لوحة تحكم Home Assistant:

yaml复制

# التكوين.yaml - أضف إلى بقية تكوين مساعد المنزل الخاص بك: - الاسم: "Nee-Vo Propane Tank API" scan_interval: 300 # استطلاع كل 5 دقائق للموارد: "https://api.nee-vo.com/v1/customer/tank_status" الرؤوس: التفويض: "Bearer YOUR_NEEVO_API_KEY" المحتوى -النوع: مستشعر "التطبيق/json": - الاسم: "Nee-Vo Propane Level" value_template: "{{ (value_json.tank_level_percent|float)|round(1) }}" وحدة_القياس: "%" فئة_الجهاز: "القياس" State_class: رمز "القياس": "mdi:propane-tank" - الاسم: "Nee-Vo Propane Gallons" value_template: "{{ (value_json.gallons_remaining|float)|round(1) }}" وحدة_القياس: رمز "gal": "mdi:gas-cylinder" - الاسم: "Nee-درجة حرارة خزان الصوت" value_template: "{{ (value_json.tank_temperature_f|float)|round(1) }}" وحدة_القياس: "درجة F" فئة_الجهاز: أيقونة "درجة الحرارة": "mdi: مقياس الحرارة" - الاسم: "Nee-مستوى بطارية الصوت" value_template: "{{ value_json.battery_percent }}" وحدة_القياس: "%" فئة_الجهاز: أيقونة "فئة البطارية": "mdi:battery" - الاسم: "Nee-قوة إشارة الصوت" value_template: "{{ value_json.signal_rssi }}" وحدة_القياس: أيقونة "dBm": "mdi:signal" - الاسم: "Nee-Vo Last Update" value_template: "{{ value_json.last_reading_timestamp }}" أيقونة: "mdi:clock-مخطط تفصيلي"

ملحوظة:استبدل YOUR_NEEVO_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي الخاص بك من Nee-Vo (اتصل بالمورد الخاص بك لطلب الوصول إلى واجهة برمجة التطبيقات). تمثل أسماء حقول JSON (tank_level_percent،gallons_remaining، وما إلى ذلك) - التحقق من أسماء الحقول الفعلية في استجابة Nee-Vo API عن طريق التحقق من وثائق API أو فحص استجابة JSON الأولية.

كيفية العثور على نقطة نهاية API وأسماء الحقول:

اتصل بمورد البروبان الخاص بك واطلب بيانات اعتماد الوصول إلى Nee-Vo API

بمجرد حصولك على بيانات الاعتماد، استخدم أداة مثل Postman أو Curl لإجراء اختبار استدعاء API:

باش

حليقة -H "التفويض: الحامل YOUR_NEEVO_API_KEY" \\ https://api.nee-vo.com/v1/customer/tank_status

انسخ استجابة JSON الأولية لتحديد أسماء الحقول الدقيقة لتكوين المستشعر الخاص بك


البرنامج النصي 2: وكيل ESPHome BLE لأجهزة استشعار Otodata & Nee-Vo

التقاط إعلانات بليه من أي جهاز استشعار البروبان

أسلوب البرمجة النصية الأكثر تنوعًا لـ Otodata وNee-Vo هو استخدام مكون bluetooth_proxy المدمج في ESPHome- لالتقاط إعلانات BLE من مستشعر الخزان وإعادة توجيهها إلى Home Assistant. يعمل هذا بغض النظر عما إذا كان Otodata أو Nee-Vo يعرض واجهة برمجة التطبيقات:

yaml复制

# ESPHome BLE Proxy -propane_ble_proxy.yaml # أرسل هذا إلى ESP32 الموجود على مسافة 30-50 قدمًا من خزان البروبان esphome: الاسم: البروبان-ble-منصة الوكيل: لوحة ESP32: esp32dev Friendly_name: "Propane Tank BLE Proxy" wifi: ssid: كلمة المرور "YOUR_WIFI_SSID": "YOUR_WIFI_PASSWORD" # تمكين نقطة الاتصال الاحتياطية في حالة فشل WiFi ap: ssid: "PropaneProxy Fallback Hotspot" # تمكين وكيل Bluetooth لالتقاط جميع إعلانات BLE bluetooth_proxy: active: true # عناوين MAC المحددة في القائمة البيضاء (اختياري - قم بالتعليق لالتقاط الكل) # القائمة البيضاء: # - "AA:BB:CC:DD:EE:FF" # Otodata أو Nee-Vo Sensor MAC # تسجيل جميع إعلانات BLE التي تم التقاطها لمسجل تصحيح الأخطاء: المستوى: سجلات DEBUG: esp32_ble_tracker: INFO bluetooth_proxy: INFO # اختياري: أضف مستشعرًا محليًا لقياس درجة الحرارة بالقرب من مستشعر الخزان: - النظام الأساسي: dht pin: GPIO27 model: DHT22 درجة الحرارة: name: "درجة حرارة منطقة الخزان" وحدة_القياس: مرشحات "الدرجة F": - لامدا: "return x * 9.0 / 5.0 + 32.0;" الرطوبة: الاسم: "رطوبة منطقة الخزان" Unit_of_measurement: "%" update_interval: 300s # تمكين واجهة برمجة تطبيقات Home Assistant للاكتشاف والتحكم API: التشفير: مفتاح: "YOUR_API_ENCRYPTION_KEY" # تمكين تحديثات OTA عبر الإنترنت: كلمة المرور: "YOUR_OTA_PASSWORD" # إدارة الطاقة - احتفظ بـ ESP32 مستيقظًا لمراقبة مستمرة لإمدادات الطاقة المنخفضة (BLE) power_supply: id: vcc دبوس: في يو اس بي

لاستخدام هذا البرنامج النصي:

تثبيت ESPHome (تثبيت النقطة esphome)

قم بإنشاء ملف باسمpropane_ble_proxy.yaml بالمحتوى أعلاه

استبدل YOUR_WIFI_SSID و YOUR_WIFI_PASSWORD و YOUR_API_ENCRYPTION_KEY بالقيم الخاصة بك

قم بتشغيل esphome، قم بتشغيلpropane_ble_proxy.yaml

قم بتمرير البرنامج الثابت الناتج إلى ESP32 الموجود على مسافة 30-50 قدمًا من خزان البروبان الخاص بك

مساعد منزلي:بمجرد تشغيل وكيل ESP32 BLE، سوف يكتشفه Home Assistant تلقائيًا عبر تكامل ESPHome الأصلي. ستظهر جميع إعلانات BLE من الأجهزة القريبة (بما في ذلك مستشعرات Otodata وNee-Vo) في جهاز تعقب جهاز Bluetooth الخاص بـ Home Assistant. يمكنك بعد ذلك إنشاء مستشعرات قالب لتحليل بيانات BLE الأولية.


البرنامج النصي 3: البرامج النصية لأتمتة مساعد المنزل لتنبيهات مستوى البروبان

أتمتة التنبيه الأساسية

تعمل نصوص الأتمتة هذه مع أي مستشعر لمستوى الخزان في Home Assistant - سواء من Nee-Vo's REST API، أو مستشعر ESPHome DIY، أو Mopeka عبر MQTT، أو التقاط وكيل 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%) # ──────────────────── ───────────────────── - الاسم المستعار: "تم اكتشاف إعادة تعبئة البروبان - معرف إعادة تعيين التنبيهات: مشغل Propane_refill_detected: النظام الأساسي: numeric_state الكيان_id: Sensor.propane_tank_level أعلاه: 80 إجراء: - الخدمة: input_boolean.turn_off الكيان_id: - input_boolean.propane_warning_sent - input_boolean.propane_refill_sent خدمة -: notify.mobile_app_yourphone data: العنوان: رسالة ""إعادة تعبئة خزان البروبان": > مستوى الخزان عند {{states('sensor.propane_tank_level') }}%. تمت إعادة ضبط جميع التنبيهات. استمتع بالبروبان الخاص بك!

الكيانات المساعدة المطلوبة(أضف إلى التكوين.yaml):

yaml复制

input_boolean:propane_warning_sent: الاسم: "تم إرسال تنبيه تحذير البروبان" أيقونة: mdi: تنبيهpropane_refill_sent: الاسم: "تم إرسال تنبيه إعادة تعبئة البروبان" أيقونة: mdi: تنبيه


البرنامج النصي 4: البرامج النصية للتكامل مع المنزل الذكي

أتمتة الحرارة والصمامات والإضاءة

بالإضافة إلى التنبيهات الأساسية، تقوم هذه البرامج النصية بدمج بيانات مستوى البروبان مع نظام المنزل الذكي الأوسع لديك:

yaml复制

# ──────────────────── ───────────────────── # حافظ على البروبان - اخفض منظم الحرارة عندما يكون الخزان منخفضًا # ──────────────────── ───────────────────── التشغيل الآلي: - الاسم المستعار: "حفظ البروبان - انخفاض ترموستات عند 30%" المعرف:propane_conserve_30 المشغل: النظام الأساسي: numeric_state الكيان_id: Sensor.propane_tank_level أدناه: 30 الحالة: - الحالة: الوقت بعد: "20:00:00" قبل: "06:00:00" - الحالة: الحالة الكيان_id: حالة المناخ.main_thermostat: الإجراء "الحرارة": - الخدمة: Climate.set_temperature الكيان_id: بيانات المناخ.main_thermostat: درجة الحرارة: 62 hvac_mode: الحرارة - الخدمة: notify.mobile_app_yourphone data: العنوان: "🌡️ وضع الحفاظ على البروبان نشط" الرسالة: "تم خفض منظم الحرارة إلى 62 درجة فهرنهايت للحفاظ على البروبان المتبقي." # ──────────────────── ───────────────────── - الاسم المستعار: "حفظ البروبان - معرّف استعادة منظم الحرارة بعد إعادة الملء": مشغل Propane_restore_thermostat: النظام الأساسي: numeric_state الكيان_id: Sensor.propane_tank_level أعلاه: 75 الحالة: - الحالة: معرف الكيان_الحالة: input_boolean.propane_conservation_active الحالة: "التشغيل": - الخدمة: مناخ.set_temperature كيان_id: مناخ.main_thermostat بيانات: درجة الحرارة: 68 - الخدمة: input_boolean.turn_off كيان_id: input_boolean.propane_conservation_active # ──────────────────── ───────────────────── # الاستهلاك غير الطبيعي - اكتشاف التسرب المحتمل # ──────────────────── ───────────────────── - الاسم المستعار: "استهلاك البروبان غير الطبيعي - معرّف التسرب المحتمل: مشغل Propane_leak_detection: النظام الأساسي: numeric_state الكيان_id: Sensor.propane_consumption_rate أعلاه: 5 # جالون في الساعة - ضبط على إجراء حجم الخزان الخاص بك: - الخدمة: notify.mobile_app_yourphone data: العنوان: "⚠️ تم اكتشاف استهلاك غير طبيعي للبروبان": > تم اكتشاف معدل استهلاك غير عادي للبروبان: {{states('sensor.propane_consumption_rate') }} جالون/ساعة. إذا استمر هذا، فتحقق من وجود تسربات أو مشكلات في المعدات. - الخدمة: Switch.turn_off Entity_id: Switch.propane_appliance_main # اختياري: إيقاف تشغيل بيانات صمام البروبان: {}


البرنامج النصي 5: أجهزة استشعار القالب للقيم المحسوبة

البيانات المشتقة من مستوى الخزان الخام

أضف هذه البرامج النصية لمستشعر القالب لحساب القيم المشتقة التي لا توفرها واجهة برمجة التطبيقات الأولية أو بيانات BLE بشكل مباشر:

yaml复制

# template_sensors.yaml - أضف إلى قالب تكوين المساعد المنزلي الخاص بك: المستشعر: # ──────────────────── ───────────────────── # الأيام المتبقية على أساس معدل الاستهلاك الحالي # ──────────────────── ───────────────────── - الاسم: "أيام البروبان المتبقية" وحدة_القياس: رمز "الأيام": حالة "mdi:calendar-الساعة": > {% تعيين المستوى=States('sensor.propane_tank_level')|تعويم %} {% ضبط حجم الخزان=250 %} {# جالون - التغيير إلى حجم الخزان الخاص بك #} {% تعيين جالون_يسار=(المستوى / 100) * حجم الخزان %} {% ضبط المعدل اليومي=حالات('sensor.propane_daily_consumption')|تعويم %} {% إذا كان المعدل اليومي > 0 وgallons_left > 0 %} {{ (gallons_left / daily_rate)|round(1) }} {% else %} غير معروف {% endif %} # ──────────────────── ───────────────────── # إجمالي قيمة الدولار للبروبان المتبقي # ──────────────────── ───────────────────── - الاسم: "قيمة الدولار البروبان المتبقية" وحدة_القياس: رمز "الدولار الأمريكي": حالة "mdi:currency-usd": > {% مجموعة المستوى=States('sensor.propane_tank_level')|تعويم %} {% ضبط حجم الخزان=250 %} {% تحديد السعر_لكل_جالون=3.50 %} {# التغيير إلى السعر الفعلي الخاص بك #} {% تعيين جالون_يسار=(المستوى / 100) * حجم الخزان %} {{ "%.2f"|تنسيق (جالون_يسار * سعر_الغالون) }} # ──────────────────── ───────────────────── # نص حالة البروبان (كامل/تحذير/حرج) # ──────────────────── ───────────────────── - الاسم: رمز "حالة البروبان": حالة "mdi:gas-اسطوانة": > {% مجموعة المستوى =states('sensor.propane_tank_level')|تعويم %} {% إذا المستوى > 50 %} كامل {% مستوى elif > 30 %} عادي {% مستوى elif > 15 %} منخفض {% مستوى elif > 5 %} حرج {% else %} فارغ {% endif %} # ──────────────────── ───────────────────── # تقدير تكلفة إعادة الملء # ──────────────────── ───────────────────── - الاسم: "تقدير تكلفة إعادة تعبئة البروبان" وحدة_القياس: رمز "الدولار الأمريكي": "mdi:currency-usd" الحالة: > {% مستوى المجموعة =states('sensor.propane_tank_level')|تعويم %} {% ضبط حجم الخزان=250 %} {% تحديد سعر_الجالون=3.50 %} {% ضبط الجالون_إلى_الملء=((100 - المستوى) / 100) * حجم الخزان %} {% إذا كان المستوى < 95 %} {{ "%.2f"|تنسيق (gallons_to_fill * Price_per_gallon) }} {% else %} 0 {% endif %}


البرنامج النصي 6: عقدة -تدفق أحمر للأتمتة المرئية

التدفق المرئي لغير-المبرمجين

بالنسبة للمستخدمين الذين يفضلون أداة إنشاء الأتمتة المرئية على البرمجة النصية لـ YAML، إليك تدفق Node-RED الذي يكرر نصوص الأتمتة أعلاه:

رمز المنتج

[{"id": "propane_level_trigger"، "type": "inject"، "z": "propane_flow"، "name": "كل 5 دقائق"، "repeat": "300"، "crontab": ""، "once": false، "topic": ""، "payload": ""، "payloadType": "date"، "x": 100، "y": 100، "wires": [["propane_fetch"]]}، {"id": "propane_fetch"، "type": "طلب"، "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" 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": "رسالة حرجة"، "template": "🚨 حرج: البروبان عند {{payload.tank_level_percent}}٪! قم بإعادة الملء على الفور! "، output": "str"، "x": 900، "y": 60، "wires": [["propane_notify_critical","propane_flash_lights"]]}، {"id": "propane_refill"، "type": "template"، "z": "propane_flow"، "name": "Refill". الرسالة، "قالب": "⛽ البروبان عند {{payload.tank_level_percent}}%. جدول إعادة التعبئة قريبًا."، "output": "str"، "x": 900، "y": 120، "wires": [["propane_notify_refill"]]}، {"id": "propane_warning"، "type": "template"، z": "propane_flow"، "name": "رسالة تحذير"، "template": "🔔 البروبان في {{payload.tank_level_percent}}٪ use."،output":"str"،x":900"،y":180،wires":[["propane_notify_warning"]]}، {"id":propane_notify_critical"،type":api call Service"،z":propane_flow"،name":"Send Critical 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 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":api call Service"، "z": "propane_flow"، "name": "Send Refill Push"، "service": "notify.mobile_app_yourphone"، "x": 1150، "y": 120، "wires":[[]]}، {"id": "propane_notify_warning"، "type": api call Service"، "z": "propane_flow"، "name": "إرسال تحذير". Push"، "service": "notify.mobile_app_yourphone"، "x": 1150، "y": 180، "wires":[[]]}، {"id": "propane_gallons"، "type": "change"، "z": "propane_flow"، "name": "Update" جالون"، "قواعد":[{"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": "تحديث" "درجة الحرارة"، "القواعد":[{"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": "تحديث مساعد المنزل" Entity"، "endpoint": "/api/states/sensor.propane_tank_level"، "method": "POST"، "sendPayload":true، "sendHeaders":false، "x":950، "y":280، "wires":[[]]}]

لاستخدام العقدة-التدفق الأحمر هذه:

قم بتثبيت الملحق Node-RED في Home Assistant (عبر الإعدادات → الإضافات-إضافات)

افتح العقدة-RED في متصفحك

استيراد التدفق (القائمة → استيراد → لصق JSON أعلاه)

قم بتحديث عنوان URL لواجهة برمجة التطبيقات وبيانات الاعتماد في عقدةpropane_fetch

قم بتحديث Propane_notify_critical وعقد الإشعارات الأخرى باستخدام معرفات كيان Home Assistant الفعلية الخاصة بك

نشر التدفق


البرنامج النصي 7: إشعار ملخص البروبان اليومي

نهاية-من-تقرير حالة اليوم

يرسل هذا البرنامج النصي ملخصًا يوميًا لحالة البروبان في وقت مناسب كل مساء:

yaml复制

التشغيل الآلي: - الاسم المستعار: "ملخص البروبان اليومي - 8 PM" المعرف: daily_propane_summary المشغل: النظام الأساسي: الوقت في: "20:00:00" الإجراء: - الخدمة: notify.mobile_app_yourphone data: العنوان: "📊 تقرير البروبان اليومي" الرسالة: > مستوى الخزان: {{states('sensor.propane_tank_level') }}% جالون المتبقي: {{states('sensor.propane_gallons') }} جالون الأيام المتبقية: {{states('sensor.propane_days_remaining') }} أيام استهلاك اليوم: {{states('sensor.propane_today_consumption') }} جالون درجة حرارة الخزان: {{states('sensor.propane_tank_temperature') }} درجة F قيمة الدولار المتبقي: ${{states('sensor.propane_dollar_value_remaining') }} الحالة: {{states('sensor.propane_status') }}


الأسئلة المتداولة

س1: هل لدى Otodata واجهة برمجة تطبيقات يمكن كتابتها؟

لا تقوم Otodata بتوثيق واجهة برمجة التطبيقات التي يمكن للعملاء الوصول إليها - بشكل علني اعتبارًا من عام 2026. وتستخدم شاشاتهم اتصال LTE الخلوي بسحابة Otodata، ويسترد تطبيق العميل البيانات من تلك السحابة - ولكن لم يتم توثيق نقطة نهاية واجهة برمجة التطبيقات بشكل عام ولا يتم توفير الوصول للمستهلكين الفرديين. يتمثل أسلوب البرمجة النصية الموصى به لمستخدمي Otodata في إضافة مستشعر ESPHome أو Mopeka الموازي إلى نفس الخزان للبرمجة النصية لـ Home Assistant، بينما تستمر Otodata في التعامل مع أتمتة الموردين. لقد حاول بعض أعضاء مجتمع r/homeassistant عكس-تنسيق إعلان BLE الخاص بشركة Otodata باستخدام وكلاء ESP32 BLE، ولكن هذا يعد تجريبيًا وغير موثوق به بدرجة كافية للنصوص البرمجية لأتمتة الإنتاج.

س2: ما هو أفضل أسلوب للبرمجة النصية لـ Nee-Vo؟

يعتمد أفضل أسلوب للبرمجة النصية لـ Nee-Vo على ما إذا كان نشر Nee-Vo يعرض واجهة برمجة تطبيقات العميل. إذا كان الوصول إلى واجهة برمجة التطبيقات (API) متاحًا (اتصل بمورد البروبان للاستفسار)، فاستخدم البرامج النصية لمستشعر REST في هذا الدليل لاستقصاء Nee-Vo API مباشرة في Home Assistant. إذا لم يكن الوصول إلى واجهة برمجة التطبيقات متاحًا، فإن النهج الموصى به هو نفس Otodata: قم بإضافة مستشعر ESPHome أو Mopeka الموازي إلى خزان الوقود الخاص بك واستخدم البرامج النصية للأتمتة ESPHome + Home Assistant في هذا الدليل. يعد أسلوب المستشعر المتوازي هو الأكثر موثوقية لأنه يمنحك التحكم الكامل في بيانات المستشعر والبرامج الثابتة ومنطق التشغيل الآلي - دون الاعتماد على توفر واجهة برمجة التطبيقات الخاصة بالمورد.

س 3: كم مرة يجب على البرامج النصية للتشغيل الآلي التحقق من مستوى الخزان؟

بالنسبة للبرامج النصية لاستقصاء Home Assistant REST (Nee-Vo API)، يعد الفاصل الزمني للمسح من 5 إلى 10 دقائق كافيًا - يتغير مستوى الخزان ببطء كافٍ بحيث لا يكون الاستقصاء الأكثر تكرارًا ضروريًا وقد يؤدي إلى تحميل زائد لواجهة برمجة التطبيقات. بالنسبة للبرامج النصية لوكيل ESPHome BLE، يلتقط ESP32 إعلانات BLE بشكل مستمر ويقوم Home Assistant بمعالجتها في الوقت الفعلي-في الوقت الفعلي - دون الحاجة إلى فاصل زمني للاستقصاء. بالنسبة لمشغلات الأتمتة (عتبات التنبيه)، يتم إطلاق حالة numeric_state الخاصة بـ Home Assistant فورًا عندما يتجاوز المستوى الحد، بغض النظر عن الفاصل الزمني للاستقصاء. قم بتعيين إشعار الملخص اليومي الخاص بك لوقت ثابت كل مساء (موصى به: 7-8 مساءً) للحصول على تقرير حالة منتظم دون إرهاق التنبيه.

س 4: هل يمكن لهذه البرامج النصية العمل مع خزانات متعددة؟

نعم - جميع البرامج النصية في هذا الدليل تدعم خزانات متعددة. بالنسبة لاستقصاء REST API (Nee-Vo)، قم بإضافة إدخالات مستشعر REST إضافية لنقطة نهاية API لكل دبابة. بالنسبة لوكيل ESPHome BLE، يمكن لـ ESP32 التقاط الإعلانات من عدة مستشعرات BLE في وقت واحد - فقط أضف مستشعرات القالب لبيانات كل خزان. بالنسبة للبرامج النصية للتشغيل الآلي، قم بتكرار إدخالات التشغيل الآلي وتغيير الكيان_id للإشارة إلى كيان المستشعر المحدد لكل خزان (على سبيل المثال، Sensor.propane_tank_level_garage، وsensor.propane_tank_level_shop). في العقدة-RED، أضف فروعًا إضافية لمستوى البروبان_الفحص لكل خزان.

س5: كيف يمكنني تصحيح البرنامج النصي الذي لا يعمل؟

بالنسبة للبرامج النصية لـ REST API: استخدم أدوات مطور Home Assistant (الإعدادات → أدوات المطور → محرر القوالب) لاختبار value_template مقابل بيانات JSON الأولية. انسخ نموذج استجابة واجهة برمجة التطبيقات (API) والصقه في محرر القالب للتحقق من صحة استخراج مسار JSON. بالنسبة للبرامج النصية لوكيل ESPHome BLE: تحقق من سجلات ESPHome (سجلات esphomepropane_ble_proxy) لمعرفة ما إذا تم التقاط إعلانات BLE - إذا رأيت عناوين MAC أولية ولكن لا توجد بيانات قابلة للقراءة، فهذا يعني أن المستشعر يبث ولكن لم يتم التعرف على التنسيق. بالنسبة للبرامج النصية للأتمتة: استخدم أداة التتبع Home Assistant (علامة التبويب "تتبعات" في كل عملية أتمتة) لمعرفة ما تم تشغيله بالضبط، والظروف التي تم تقييمها، والإجراءات التي تم تنفيذها. تعد أداة التتبع أقوى أداة تصحيح أخطاء في Home Assistant - فهي تعرض الحالة الدقيقة لكل كيان في لحظة تشغيل التشغيل الآلي.


الخط السفلي

من الأفضل التعامل مع أجهزة مراقبة خزانات غاز البروبان Otodata وNee-Vo من خلال استراتيجية برمجة نصية متوازية: استخدم النظام الأساسي للمورد (Otodata أو Nee-Vo) لجدولة إعادة التعبئة التلقائية، ونشر مستشعر ESPHome أو Mopeka الخاص بك للتحكم الكامل في البرمجة النصية لـ Home Assistant. البرامج النصية السبعة في هذا الدليل - استقصاء REST API، وكيل ESPHome BLE، وثلاثة مستويات من أتمتة التنبيه (تحذير/إعادة التعبئة/حرجة)، والنصوص البرمجية لتكامل المنزل الذكي (منظم الحرارة، والصمامات، والأضواء)، وأجهزة استشعار القالب للقيم المشتقة، والعقدة-التدفق المرئي RED، وإشعار الملخص اليومي - تمنحك نظامًا آليًا كاملاً لمراقبة البروبان يعمل محليًا بالكامل في Home Assistant. تؤكد الخبرة الجماعية لمجتمع r/homeassistant أن هذا النهج الموازي يقدم أفضل ما في كلا العالمين: عدم تحمل أي تكاليف إضافية لإدارة الموردين، وملكية البيانات الكاملة ومرونة الأتمتة على جانب Home Assistant. ابدأ بالبرامج النصية للأتمتة (البرنامج النصي 3) وأجهزة استشعار القالب (البرنامج النصي 5)، ثم قم بالتوسيع إلى وكيل ESPHome BLE (البرنامج النصي 2) للحصول على أقصى قدر من التغطية. تضيف كل طبقة نصية بُعدًا آخر للقيمة - بدءًا من مستوى الرؤية الأساسي وحتى تكامل المنزل الذكي الكامل الذي يستجيب لمستوى البروبان الخاص بك تلقائيًا.


آخر تحديث: يوليو 2026

إخلاء المسؤولية: يوفر هذا الدليل أمثلة على البرمجة النصية لـ Home Assistant وESPHome لتكامل مراقبة خزان البروبان Otodata وNee-Vo للأغراض التعليمية. تعد نقاط نهاية واجهة برمجة التطبيقات وأسماء الحقول وتنسيقات JSON المشار إليها في هذا الدليل أمثلة تمثيلية - تحقق دائمًا من بنية واجهة برمجة التطبيقات الفعلية باستخدام نشر Nee-Vo المحدد قبل تكوين مستشعرات REST. تلتقط البرامج النصية لوكيل ESPHome BLE جميع إعلانات BLE القريبة - وتضمن امتثالك للوائح المحلية المتعلقة بمراقبة جهاز BLE. تتفاعل عمليات التشغيل الآلي لمساعد المنزل مع-أنظمة العالم الحقيقي، بما في ذلك أنظمة التدفئة والتهوية وتكييف الهواء (HVAC)، وصمامات الغاز، والأجهزة الكهربائية - التي تختبر جميع عمليات التشغيل الآلي في ظروف آمنة قبل نشرها في الإنتاج. هذا الدليل ليس تابعًا أو معتمدًا أو برعاية Otodata أو Nee-Vo أو Home Assistant أو ESPHome أو Node-RED أو مجتمع r/homeassistant.

إرسال التحقيق