برنامج تشغيل Taylor عبر MQTT
يمكن استخدام التكامل التالي لإرسال قياسات الموقع عبر MQTT واستقبال الأوامر لأنواع الأجهزة المختلفة المثبتة.
نص برمجي تجريبي بلغة Python
تواصل مع SmartgridOne لطلب نص برمجي تجريبي.
المتطلبات الأساسية
وحدة التحكم السحابية
ستتم إدارة المواقع عبر وحدة تحكم سحابية. يُرجى التواصل مع SmartgridOne لإعداد وحدة تحكم سحابية جديدة
إعداد الموقع
بعد إنشاء وحدة تحكم سحابية، ستتضمن رقمًا تسلسليًا فريدًا (<Controller SN>).
يمكن إنشاء مواقع جديدة على وحدة التحكم السحابية باستخدام عوامل تصفية مواقع فريدة <site_filter>
يجب استخدام هذين المتغيرين في موضوعات MQTT ومحتوى الرسالة.
تحذير
سيؤدي استخدام عوامل تصفية مواقع متطابقة إلى حدوث أخطاء.
اختيار الجهاز
| Device Type | Supported |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
ملاحظة
لا يمكن تحرير الأجهزة الموجودة في الموقع بعد إنشائه.
بيانات اعتماد MQTT
ستوفر SmartgridOne بيانات اعتماد 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
- أوضاع التشغيل المحتملة هي off, on
- active_power_W
- يساوي القدرة الاسمية عندما تكون المضخة الحرارية في وضع on
- operation_modes
-
العدادات
- 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"
}إقرار استلام القياس
عند استلام القياس بنجاح، سيتم إرسال تأكيد استلام إلى موضوع MQTT التالي: 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
}
}توجد قائمة السياسات التي يمكن استقبالها هنا: قائمة السياسات المحتملة
