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

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

برنامج نصي تجريبي بايثون

اتصل بـ Eniris لطلب برنامج نصي تجريبي.

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

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

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

إعداد الموقع

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

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

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

تحذير

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

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

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

معلومات

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

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

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

معلومات

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

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

لإرسال القياسات إلى SmartgridOne Controller، يمكن استخدام موضوع MQTT التالي للنشر: standard1/outbound/taylor_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": <قدرة الشبكة النشطة بالوات>,
                "today_imported_energy_Wh": <الطاقة المستوردة من الشبكة بالساعات الواط>,
                "today_exported_energy_Wh": <الطاقة المصدرة من الشبكة بالساعات الواط>,
            },
            "meter": {
                "active_power_W": <قدرة الشبكة النشطة بالوات>,
                "today_imported_energy_Wh": <الطاقة المستوردة من الشبكة بالساعات الواط>,
                "today_exported_energy_Wh": <الطاقة المصدرة من الشبكة بالساعات الواط>,
            },
            "storage": {
                "energy_stored_Wh": <الطاقة المخزنة بالساعات الواط>,
                "mean_soc_perc": <متوسط نسبة الشحن>,
                "active_power_W": <القدرة النشطة بالوات>,
                "today_charged_Wh": <الطاقة المشحونة اليوم بالساعات الواط>,
                "today_discharged_Wh": <الطاقة المفرغة اليوم بالساعات الواط>,
            },
            "solar": {
                "active_power_W": <قدرة الطاقة الشمسية النشطة بالوات>,
                "today_energy_Wh": <الطاقة المنتجة اليوم بالساعات الواط>.
            },
            "heat_pump": {
                "active_power_W": <قدرة المضخة الحرارية النشطة بالوات>,
                "operation_modes": <وضع تشغيل المضخة الحرارية>
            }
        },
        "response_code": <رمز الاستجابة>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

تأكيد القياس

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

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

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

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

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

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

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