برنامج تشغيل Taylor MQTT
يمكن استخدام التكامل التالي لإرسال قياسات الموقع عبر MQTT، واستقبال الأوامر لأنواع الأجهزة المختلفة المثبتة.
برنامج تجريبي بلغة Python
اتصل بـ a-TroniX لطلب برنامج تجريبي.
المتطلبات الأساسية
وحدة التحكم السحابية
سيتم التحكم في المواقع عبر وحدة تحكم سحابية. يرجى الاتصال بـ Controller لإعداد وحدة تحكم سحابية جديدة.
إعداد الموقع
بمجرد إنشاء وحدة تحكم سحابية، ستحتوي على رقم تسلسلي فريد (standard1/rp_one_s/taylor_ack/<site_filter>/<Controller SN>).
يمكن إنشاء مواقع جديدة على وحدة التحكم السحابية باستخدام فلترات مواقع فريدة standard1/outbound/taylor_cmd/<site_filter>/<Controller SN>/.
يجب استخدام هذين المتغيرين في مواضيع MQTT ونص الرسالة.
تحذير
استخدام فلترات مواقع متطابقة سيؤدي إلى حدوث أخطاء.
اختيار الجهاز
| Device Type | مدعوم |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
ملاحظة
لا يمكن تعديل الأجهزة في الموقع بعد إنشائه.
بيانات اعتماد MQTT
سيتم تزويد بيانات اعتماد MQTT من قبل a-TroniX. يجب إدخال اسم مستخدم MQTT عند إنشاء موقع جديد.
ملاحظة
يجب تزويد بيانات الاعتماد مرة واحدة فقط. يمكن استخدام مجموعة واحدة من بيانات اعتماد MQTT للتحكم في جميع المواقع.
إرسال القياسات
لإرسال القياسات إلى a-TroniX 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
- يساوي القدرة الاسمية أثناء تشغيل المضخة
- 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"
}تأكيد القياسات
عندما يتم استلام قياس بنجاح، سيتم إرسال تأكيد على الموضوع التالي: standard1/rp_one_s/taylor_ack/<site_filter>/<Controller SN>
يمكن استخدام هذا التأكيد لـ:
- التحقق من أن رسالة القياس تم استلامها بنجاح.
- التحقق من أن رسالة القياس تحتوي على جميع البيانات اللازمة.
استقبال الأوامر
لاستقبال الأوامر من a-TroniX 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
}
}قائمة السياسات التي يمكن استقبالها موجودة هنا: List of Potential Policies
