برنامج تشغيل Scholt MQTT

يمكن استخدام التكامل التالي لإرسال قياسات الموقع عبر MQTT، واستلام الأوامر لأنواع الأجهزة المختلفة المثبتة.

برنامج تجريبي بلغة Python

يقوم هذا الكود التجريبي بمهمة بسيطة تتمثل في إرسال قياسات تجريبية باستمرار إلى تركيب ما، واستقبال الأوامر:

يرجى تحميل الملف أدناه في بيئة تطوير Python المفضلة لديك. املأ رقم السيريال، وفلتر الموقع، وبيانات اعتماد MQTT وقم بتنفيذ البرنامج:

المتطلبات الأساسية

وحدة التحكم السحابية

سيتم التحكم في المواقع عبر وحدة تحكم سحابية. يرجى التواصل مع Controller لإعداد وحدة تحكم سحابية جديدة

إعداد الموقع

بمجرد إنشاء وحدة تحكم سحابية، ستحتوي على رقم تسلسلي فريد (standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>).

يمكن إنشاء مواقع جديدة على وحدة التحكم السحابية باستخدام فلاتر موقع فريدة standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/

يجب استخدام هذين المتغيرين في مواضيع MQTT ومحتوى الرسالة.

اختيار الأجهزة

بيانات اعتماد MQTT

a-TroniX ستوفر بيانات اعتماد MQTT. يجب إدخال اسم مستخدم MQTT عند إنشاء موقع جديد.

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

لإرسال القياسات إلى a-TroniX Controller، يمكن استخدام موضوع MQTT التالي للنشر: standard1/outbound/scholt_meas/<site_filter>/<Controller SN>/

الحقول الاختيارية مذكورة بخط مائل *.

يمكن إرسال الحقول التالية حسب نوع الجهاز:

• التخزين

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• الطاقة الشمسية

  • active_power_W
  • today_energy_Wh

• مضخات الحرارة

  • operation_modes
    • أوضاع التشغيل المحتملة هي off, on
  • active_power_W
    • تعادل الطاقة الاسمية عندما تكون مضخة الحرارة on

• العدادات

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

يجب أن تكون رسالة القياس مهيكلة بالشكل التالي:

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <الطاقة النشطة في الشبكة بالواط>,
                "today_imported_energy_Wh": <الطاقة المستوردة اليوم بالشبكة بالواط-ساعة>

تأكيد استلام القياسات

عندما يتم استلام القياس بنجاح، سيتم إرسال تأكيد على الموضوع التالي: standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>

يمكن استخدام هذا التأكيد لـ:

1. التحقق من أن رسالة القياس تم استلامها بنجاح.
2. التحقق من أن رسالة القياس تحتوي على جميع البيانات اللازمة.

استلام الأوامر

لاستلام الأوامر من a-TroniX Controller، اشترك في موضوع MQTT التالي: standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/

يتم هيكلة الرد كما يلي:

{
    "extraTags": {
        "nodeId": "<رقم تسلسلي لوحدة التحكم>_site_0"
    },
    "time": "<Unix Timestamp>",
    "fields": {
        "solar_policy": "<السياسة>",
        "solar_power_setpoint_w": 5000,
        "storage_policy": "<السياسة>",
        "storage_power_setpoint_w": -5000
    }
}

قائمة السياسات التي يمكن استقبالها موجودة هنا: