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

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

سكربت عرض Python

يرجى التواصل مع Eniris لطلب سكربت عرض.

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

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

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

إعداد الموقع

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

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

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

تحذير

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

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

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

معلومات

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

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

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

معلومات

يجب توفير بيانات الاعتماد مرة واحدة فقط. يمكن استخدام مجموعة واحدة من بيانات اعتماد MQTT للتحكم في جميع المواقع.

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

لإرسال القياسات إلى SmartgridOne Controller، يمكن استخدام موضوع MQTT التالي للنشر: standard1/outbound/neargrid_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
  - تساوي الطاقة الاسمية أثناء تشغيل مضخة الحرارة
عدادات
- 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/neargrid_ack/<site_filter>/<Controller SN>

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

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

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

لاستقبال الأوامر من SmartgridOne Controller، اشترك في موضوع MQTT التالي: standard1/outbound/neargrid_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
    }
}

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

سكربت عرض Python​

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

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

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

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

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

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

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