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

يرجى الرجوع إلى القسم التالي لمعرفة كيفية الاتصال بوسيط MQTT الخاص بـ a-TroniX: MQTT Broker Connection

وظائف VPP

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

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

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

عند إضافة إشارة MQTT لـ a-TroniX، يظهر حقل vpp/{MQTT Username}/{VPP ID}/warning. أدخل معرّف VPP المستلم هنا.

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

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

مواضيع MQTT

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

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

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

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

VPP مباشر

المحتوى:

{
    "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>

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

VPP مجدول

المحتوى:

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

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

موضوع الاستلام

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

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

المحتوى:

{
    "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}/warning

يحتوي موضوع الملاحظات على ردود الفعل التي ترجعها وحدات التحكم الفردية.

المحتوى:

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

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

موضوع الملاحظات المجمعة

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

يقوم VPP بتجميع الملاحظات التي تم استلامها من كل وحدة تحكم فردية.

المحتوى:

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

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

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

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

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

المحتوى:

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

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

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

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

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

المحتوى:

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