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

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

كود تجريبي بلغة بايثون

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

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

متطلبات مسبقة

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

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

إعداد الموقع

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

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

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

تحذير

استخدام مرشحات المواقع المتطابقة سيؤدي إلى حدوث أخطاء.

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

Device Type	مدعومة
محولات الطاقة الشمسية	✅
أجهزة التخزين
مضخات الحرارة
عدادات الشبكة والاستهلاك
شواحن السيارات الكهربائية	❌

معلومات

لا يمكن تعديل الأجهزة في الموقع بعد الإنشاء.

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

ستقوم Eniris بتزويد بيانات اعتماد MQTT. يجب إدخال اسم مستخدم 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
  - أوضاع التشغيل الممكنة هي إيقاف، تشغيل
- active_power_W
  - تساوي القدرة الاسمية أثناء تشغيل مضخة الحرارة
عدادات
- 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"
}

تأكيد القياس

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

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

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

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

لاستلام الأوامر من 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
    }
}

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

كود تجريبي بلغة بايثون​

متطلبات مسبقة​

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

إعداد الموقع​

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

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

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

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