برنامج تشغيل Neargrid MQTT
يمكن استخدام التكامل التالي لإرسال قياسات الموقع عبر MQTT، واستقبال الأوامر للأنواع المختلفة من الأجهزة المثبتة.
سكريبت تجريبي بلغة بايثون
اتصل بـ a-TroniX لطلب سكريبت تجريبي.
المتطلبات المسبقة
متحكم السحابة
سيتم التحكم في المواقع عبر متحكم سحابي. يرجى الاتصال بـ Controller لإعداد متحكم سحابي جديد.
إعداد الموقع
بعد إنشاء متحكم السحابة، سيحتوي على رقم تسلسلي فريد (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).
يمكن إنشاء مواقع جديدة على متحكم السحابة باستخدام فلاتر موقع فريدة standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
يجب استخدام هذين المتغيرين في مواضيع MQTT وجسم الرسالة.
تحذير
استخدام فلاتر موقع متطابقة سيؤدي إلى حدوث أخطاء.
اختيار الجهاز
| Device Type | مدعوم |
|---|---|
| محولات الطاقة الشمسية | ✅ |
| أجهزة التخزين | |
| مضخات الحرارة | |
| عدادات الشبكة والاستهلاك | |
| شواحن السيارات الكهربائية | ❌ |
ملاحظة
لا يمكن تعديل الأجهزة في الموقع بعد إنشائه.
بيانات اعتماد MQTT
سيزود a-TroniX بيانات اعتماد MQTT. يجب إدخال اسم مستخدم MQTT عند إنشاء موقع جديد.
ملاحظة
يجب توفير بيانات الاعتماد مرة واحدة فقط. يمكن استخدام مجموعة واحدة من بيانات اعتماد MQTT للتحكم في جميع المواقع.
إرسال القياسات
لإرسال القياسات إلى a-TroniX 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
- تعادل القدرة الاسمية بينما تكون المضخة في وضع التشغيل
- operation_modes
-
العدادات
- active_power_W
- today_imported_energy_Wh
- today_exported_energy_Wh
يجب أن تكون الرسالة مصممة بالشكل التالي:
{
"time": "<Unix Timestamp>",
"data": {
"state": {
"grid": {
"active_power_W": <القدرة النشطة للشبكة بوحدة الواط>,
"today_imported_energy_Wh": <الطاقة المستوردة من الشبكة بوحدة
تأكيد الاستلام
عند استلام القياس بنجاح، سيتم إرسال تأكيد على الموضوع التالي: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>
يمكن استخدام هذا التأكيد لـ:
- التحقق من أن رسالة القياس تم استلامها بنجاح.
- التحقق من أن رسالة القياس تحتوي على جميع البيانات اللازمة.
استقبال الأوامر
لتلقي الأوامر من a-TroniX Controller، اشترك في موضوع MQTT التالي: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
الاستجابة مصممة بالشكل التالي:
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": "<Unix Timestamp>",
"fields": {
"solar_policy": "<السياسة>",
"solar_power_setpoint_w": 5000,
"storage_policy": "<السياسة>",
"storage_power_setpoint_w": -5000
}
}قائمة السياسات التي يمكن استقبالها موجودة هنا:
