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

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

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

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

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

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

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

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

إعداد الموقع

بعد إنشاء وحدة تحكم سحابية، ستتضمن رقمًا تسلسليًا فريدًا (<Controller SN>).

يمكن إنشاء مواقع جديدة على وحدة التحكم السحابية باستخدام عوامل تصفية مواقع فريدة <site_filter>

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

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

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

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

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

لإرسال القياسات إلى SmartgridOne 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": <Grid Active Power in Watts>,
                "today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
                "today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>,
            },
            "meter": {
                "active_power_W": <Grid Active Power in Watts>,
                "today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
                "today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>,
            },
            "storage": {
                "energy_stored_Wh": <Energy Stored in Watt-hours>,
                "mean_soc_perc": <Mean State of Charge Percentage>,
                "active_power_W": <Active Power in Watts>,
                "today_charged_Wh": <Energy Charged on the Current Today in Watt-hours>,
                "today_discharged_Wh": <Energy Discharged on the Current Today in Watt-hours>,
            },
            "solar": {
                "active_power_W": <Solar Active Power in Watts>,
                "today_energy_Wh": <Energy Produced Today in Watt-hours>.
            },
            "heat_pump": {
                "active_power_W": <Heat Pump Active Power in Watts>,
                "operation_modes": <Heat Pump Operation Mode>
            }
        },
        "response_code": <Response Code>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

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

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

يمكن استخدام إقرار الاستلام هذا من أجل:

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

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

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

تُنظَّم الاستجابة كما يلي:

{
    "extraTags": {
        "nodeId": "<Controller SN>_site_0"
    },
    "time": "<Unix Timestamp>",
    "fields": {
        "solar_policy": "<policy>",
        "solar_power_setpoint_w": 5000,
        "storage_policy": "<policy>",
        "storage_power_setpoint_w": -5000
    }
}

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