محطة الطاقة الافتراضية

تلميح

بروتوكول VPP يعتمد على بروتوكول MQTT المباشر. يرجى الرجوع إلى هذه الصفحة قبل ذلك. انظر تحكم MQTT المباشر.

تلميح

يجب أن يتم إعداد VPP الأولي من قبل Eniris. يرجى الاتصال بـ Eniris قبل اتباع الخطوات التالية.

الاتصال بوسيط MQTT

يرجى الإشارة إلى القسم التالي لمعرفة كيفية الاتصال بوسيط MQTT الخاص بـ Eniris: اتصال وسيط MQTT

وظائف VPP

تم تصميم VPP لتلقي نقطة تعيين/استراتيجية واحدة لكل مجموعة أجهزة (مثل: الطاقة الشمسية، التخزين)، وتجميع نقطة التعيين بين وحدات التحكم المتصلة بـ VPP.

بينما يقوم بروتوكول MQTT المباشر بإرسال أمر لوحدة تحكم واحدة، فإن VPP يسمح للمستخدم بإرسال أمر واحد إلى مجموعة من وحدات التحكم.

إضافة وحدات التحكم إلى VPP

عند إضافة إشارة MQTT الخاصة بـ Eniris، يتم عرض حقل VPP ID. أدخل VPP ID المستلم هنا.

خوارزمية التجميع

يتم تجميع نقاط التعيين بناءً على سعة الأجهزة التي تقع تحت وحدات التحكم الفردية.

مواضيع MQTT

بمجرد اكتمال الإعداد الأولي، سيتم توفير VPP ID و اسم مستخدم MQTT (وكلمة المرور).

الموضوع الوارد

الموضوع: vpp/{MQTT Username}/{VPP ID}

يستخدم هذا الموضوع من قبل المستخدم لإرسال أمر مجمع إلى VPP.

Body:

{
    "msg_id": <Incremental message id>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix Timestamp>(int)",
    "fields": {
        "<Component Policy>": "<Policy Type>",
        "<Component Power Setpoint>": <Setpoint in watts>
    }
}

يمكن العثور على سياسات المكونات ونقاط التعيين هنا: مكونات وسياسات MQTT

موضوع الإقرار

الموضوع: vpp/{MQTT Username}/{VPP ID}/acknowledgement

بعد إرسال أمر، سترد VPP بإقرار، يشير إلى ما إذا تم استلام الأمر بنجاح أم لا.

Body:

{
    "payload": {
        "fields": {
            "responseCode": <Success/Failure Code>(int),
            "ack": <Acknowledgement Message>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type of Message>(str)
}

موضوع التغذية الراجعة

الموضوع: vpp/{MQTT Username}/{VPP ID}/feedback

يحتوي موضوع التغذية الراجعة على التغذية المرتدة التي تعود من وحدات التحكم الفردية.

Body:

{
    "payload": {
        "updated_on": <Unix Timestamp of the data>(str)
        "feedback_dict": {
            <Feedback Dict>(dict)
        },
        "target": <Site Node ID>(str)
    },
    "message_type": <Type of Message>(str)
}

يمكن العثور على هيكل قاموس التغذية الراجعة هنا: هيكل حمولة تغذية MQTT

موضوع التغذية الراجعة المجمع

الموضوع: vpp/{MQTT Username}/{VPP ID}/aggregated_feedback

يجمع VPP التغذية المرتدة المستلمة من كل وحدة تحكم فردية.

Body:

{
    "payload": {
        "updated_on": <Unix Timestamp of the data>(str)
        "feedback_dict": {
            <Aggregated Feedback Dict>(dict)
        },
    },
    "message_type": <Type of Message>(str)
}

يتم هيكلة قاموس التغذية الراجعة المجمع بشكل مماثل لهيكل حمولة تغذية MQTT. ومع ذلك، لا يمكن تجميع القيم النصية، مثل الاستراتيجيات المنفذة، وبالتالي لا يتم تضمينها.

موضوع الأوامر المرسلة

الموضوع: vpp/{MQTT Username}/{VPP ID}/dispatched_commands

عندما يتم إرسال الأوامر إلى وحدات التحكم بواسطة VPP، يتم الإبلاغ عن ذلك باستخدام هذا الموضوع.

Body:

{
    "payload": {
        "aggregated": {
            <Component Name>(str): <CommandPower Value>(float)...
        },
        "dispatched_commands": [
            <List of individual commands sent to the controllers>
        ],
    },
    "message_type": <Type of Message>(str)
}

يمكن العثور على هيكل الحمولة للأوامر الفردية المرسلة هنا: هيكل حمولة تغذية MQTT.

موضوع التحذير

الموضوع: vpp/{MQTT Username}/{VPP ID}/warning

إذا حدث خطأ أو تحذير في VPP، سيتم إرسال رسالة عبر هذا الموضوع MQTT.

Body:

{
    "payload": {
        "fields": {
            <Field Dictionary>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type of Message>(str)
}