بالشرح الوثائقي

قراءة والتحكم في cFos Charging Manager عبر Modbus

بالإضافة إلى HTTP وMQTT، يوفر cFos Charging Manager أيضًا واجهة برمجة تطبيقات Modbus. تم تصميم هذا على غرار SunSpec. ضمن تكوين Charging Manager، يمكنك تحديد منفذ TCP أو معلمة منفذ COM بالإضافة إلى معرف Modbus ضمن "إعدادات عنوان SunSpec. وهذا يعني أن cFos Charging Manager يستمع إلى منفذ TCP أو منفذ COM ضمن المعلمات المحددة وإلى معرف Modbus ومعرف Modbus + 1. تتوفر قيم مدير الشحن العام والمعلمات والأعلام والمتغيرات ضمن معرف Modbus. يمكن الاستعلام عن الأجهزة (صناديق الحائط والعدادات) التي تم إعدادها في مدير الشحن تحت ID + 1. وباعتبارك وظيفة Modbus، يمكن استخدام 3 واستخدام 4 للقراءة و6 و16 للكتابة. تنبيه: في Raspberry، يتم حجز منافذ TCP الأقل من 1024 للبرامج التي لها حقوق المسؤول. لذلك من الأفضل اختيار رقم منفذ أعلى، على سبيل المثال 1502.

تنص مواصفات SunSpec Modbus على أن نطاق عناوين Modbus يبدأ بمعرف "SunS" ثم يحتوي على ما يسمى بنماذج SunSpec. يحتوي كل نموذج على رقم مفتاح نموذج عند الإزاحة 0 وطول السجلات المتبقية التابعة للنموذج عند الإزاحة 1. ثم تتبع قيم النموذج من الإزاحة 2. هام: يجب عليك مسح نطاق عنوان SunSpec وتجاوز الطول دائمًا عند الإزاحة 1. لا تفترض أطوالًا ثابتة أو عناوين تسجيل ثابتة، فمن المحتمل جدًا أن نضيف قيمًا إضافية إلى النماذج بمرور الوقت. يأتي الطراز 1 (المشترك) دائمًا في المقام الأول مع تفاصيل الشركة المصنعة وأرقام الإصدار وما إلى ذلك. يرجى تنزيل مواصفات SunSpec Modbus من SunSpec Alliance للحصول على معلومات مفصلة. يبدأ نطاق عناوين SunSpec الخاص بـ cFos Charging Manager بالعنوان 40000.

يعرض cFos Charging Manager في البداية القيم التالية تحت معرف Modbus وفقًا للنموذج الشائع كنموذج 213 (عداد ثلاثي الطور، عائم):
إشارة الشبكة
إجمالي المستهلكين
المنتج الشامل
فائض الطاقة الكهروضوئية
الطاقة المستخدمة لصندوق الحائط
أداء صندوق الحائط المتوفر
أداء الخطأ

ثم يتبع النموذج "المخصص" 60000 مع إعداد معلمات مدير الشحن cFos: وفقًا للنموذج والطول، توجد حاليًا 8 قيم تعويم: الحد الأقصى لإجمالي التيار، والاحتياطي، والسحب على المكشوف، والحد الأقصى لإجمالي تيار صندوق الحائط بوحدة مللي أمبير لكل مرحلة، والحد الأقصى لانحراف الطور (بالمللي أمبير)، إدارة الحمل نشطة (1 = نشط، 0 = غير نشط)، الانحراف بما في ذلك المستهلك (1 = نشط، 0 = غير نشط)، الحد الأقصى لإجمالي التيار بالنسبة المئوية. هذه هي معلمات Charging Manager العالمية التي يمكن تعيينها أيضًا في واجهة المستخدم. يتم حفظ التغييرات التي تم إجراؤها على هذه القيم (بحد أقصى للتأخير قدره 150 ثانية). يمكن استخدام النسبة المئوية لإجمالي التيار لضبط قوة الشحن ديناميكيًا، على سبيل المثال بناءً على طلب مشغل الشبكة.

ويتبع ذلك النموذج "المخصص" 60001. ويتبع 32 سجلًا (16 بت) النموذج والطول. يمكن أن تحتوي هذه على القيمتين 0 و1 وقراءة أو كتابة ما يصل إلى 32 علامة من علامات Charging Manager. يمكن بعد ذلك الاستعلام عن حالة هذه العلامات في الصيغ باستخدام CM._flag1 إلى CM._flag32 واستخدامها في العمليات الحسابية.

ثم يتبع النموذج "المخصص" 60002. وتتبع متغيرات مدير الشحن المحتملة النموذج والطول. هناك 22 سجلًا متاحًا لكل متغير. أول 20 تسجيلًا عبارة عن سلسلة Modbus لاسم المتغير (سيتم اقتطاع الأسماء الطويلة جدًا). يحتوي السجلان التاليان على القيمة العائمة الحالية للمتغير. عند كتابة القيمة العائمة لمتغير Charging Manager، فإنك تقوم بحذف أي صيغة موجودة وتعيين المتغير إلى قيمة ثابتة.

يتم عرض العدادات وصناديق الحائط التي تم إعدادها في Charging Manager على النحو التالي ضمن Modbus ID + 1. مثل SunSpec Model 113، يتم توسيع صناديق الحائط لتشمل مسجلين 16 بت. الإزاحة 62 توضح حالة صندوق الحائط (1= انتظار، 2= موصل بالكهرباء، 3= الشحن، 4= الشحن مع التهوية، 5= خطأ) والإزاحة 63 توضح معرف الجهاز. 1 = E1، 2 = E2، وما إلى ذلك. يتم تمثيل العدادات بالنموذج 213 الموسع بواسطة مسجلين 16 بت. عند الإزاحة 126 يكون دور العداد (0= العرض، 1= الاستهلاك، 2= الإنتاج، 3= إمدادات الشبكة، 4= استهلاك السيارات الإلكترونية، 5= تخزين المنزل، 6= تخزين كل شيء)، عند الإزاحة 127 هو دور العداد معرف الجهاز (-1 لـ M1، -2 لـ M2، وما إلى ذلك). إذا كان العداد عبارة عن ذاكرة (الدور 5 أو 6)، فإن الطراز 213 يتبعه النموذج 124، الذي يتم توسيعه بواسطة سجل 16 بت. ويكون معرف الجهاز مرة أخرى عند الإزاحة 26. لكي يتم عرض الأجهزة ضمن Modbus ID + 1، يجب عليك تفعيل "نشر معلومات الجهاز عبر Modbus" في إعدادات الجهاز.

Aufstellung Start-Addressen der Modelle:
Modbus ID:
Model: 1, Addr: 40002
Model: 213, Addr: 40070, Netzbezugszähler
Model: 213, Addr: 40196, Summe Verbraucher
Model: 213, Addr: 40322, Sume Erzeuger
Model: 213, Addr: 40448, PV Überschuss
Model: 213, Addr: 40574, Genutzte Wallboxleistung
Model: 213, Addr: 40700, Verfügbare Wallboxleistung
Model: 213, Addr: 40826, Fehler-Leistung
Model: 60000, Addr: 40952
Model: 60001, Addr: 40970
Model: 60002, Addr: 41004
Die konkreten Start-Addressen können bei späteren Versionen des cFos Charging Managers variieren, daher sollte der Register-Bereich, wie oben beschrieben, gescannt werden.
Modbus ID + 1:
Modelle und Startadressen hängen von den eingeblendeten Geräten ab.

قائمة القيم للنموذج 213:
إزاحة 0: 213
الإزاحة 1: الطول
الإزاحة 2: إجمالي التيارات L1-L3 (A)
الإزاحة 4: التيار L1 (A)
الإزاحة 6: L2 الحالي (A)
الإزاحة 8: L3 الحالي (A)
الإزاحة 10: الجهد (V)
الإزاحة 12: الجهد L1 (V)
الإزاحة 14: الجهد L2 (V)
الإزاحة 16: الجهد L3 (V)
إزاحة 26: 50 هرتز
الإزاحة 28: الطاقة (W)
الإزاحة 30: الطاقة L1 (W)
الإزاحة 32: الطاقة L2 (W)
الإزاحة 34: الطاقة L3 (W)
الإزاحة 36: القوة الظاهرة (VA)
الإزاحة 38: الطاقة الظاهرة L1 (VA)
الإزاحة 40: الطاقة الظاهرة L2 (VA)
الإزاحة 42: الطاقة الظاهرة L3 (VA)
الإزاحة 44: الطاقة التفاعلية (VAr)
الإزاحة 60: التصدير، الطاقة النشطة (وات)
الإزاحة 68: الاستيراد، الطاقة النشطة (وات)
الإزاحة 126: الدور (مع معرف Modbus + 1)
الإزاحة 127: معرف الجهاز (لمعرف Modbus + 1)

قائمة القيم للنموذج 113:
إزاحة 0: 113
الإزاحة 1: الطول
الإزاحة 2: إجمالي التيارات L1-L3 (A)
الإزاحة 4: التيار L1 (A)
الإزاحة 6: L2 الحالي (A)
الإزاحة 8: L3 الحالي (A)
الإزاحة 16: الجهد L1 (V)
الإزاحة 18: الجهد L2 (V)
الإزاحة 20: الجهد L3 (V)
الإزاحة 22: الطاقة (W)
إزاحة 24: 50 هرتز
الإزاحة 26: القوة الظاهرة (VA)
الإزاحة 32: الاستيراد، الطاقة النشطة (وات)
الإزاحة 62: الحالة (مع معرف Modbus + 1)
الإزاحة 63: معرف الجهاز (لمعرف Modbus + 1)

قائمة القيم للنموذج 124:
إزاحة 0: 124
الإزاحة 1: الطول
الإزاحة 2: الحد الأقصى لطاقة الشحن/التفريغ (W)
الإزاحة 3: النسبة المئوية لحد طاقة الشحن الحالي
الإزاحة 4: النسبة المئوية لحد طاقة التفريغ الحالي
الإزاحة 8: حالة الشحن بالنسبة المئوية
الإزاحة 18: عامل القياس للإزاحة 2
الإزاحة 19: عامل القياس للإزاحات 3 و4
الإزاحة 26: معرف الجهاز (لمعرف Modbus + 1)

قائمة القيم للنموذج 60000:
جميع القيم في التعويم، الوصول للقراءة/الكتابة، تؤدي إلى تحديث الفلاش، أي لا تتغير كثيرًا لتجنب التلف.
الإزاحة 0: 60000 (unt16، للقراءة فقط)
الإزاحة 1: الطول (uint16، للقراءة فقط)
الإزاحة 2: الحد الأقصى للتيار الإجمالي (مللي أمبير)
الإزاحة 4: احتياطي الطاقة (مللي أمبير)
الإزاحة 6: السحب على المكشوف (مللي أمبير)
الإزاحة 8: أقصى تيار إجمالي لصندوق الحائط (مللي أمبير)
الإزاحة 10: الحد الأقصى لانحراف الطور (مللي أمبير)
الإزاحة 12: 1 = إدارة التحميل نشطة، 0 = غير نشطة
الإزاحة 14: 1 = إضافة استهلاك المنزل إلى الخلل، 0 = غير نشط
الإزاحة 16: لا يتم حفظ نسبة الحد الأقصى لإجمالي التيار، ويمكن تغييرها كثيرًا.

قائمة القيم للنموذج 60001:
لا يتم حفظ جميع القيم 0 أو 1، int16، الوصول للقراءة/الكتابة، ويمكن تغييرها كثيرًا.
الإزاحة 0: 60001 (uint16، للقراءة فقط)
الإزاحة 1: الطول (uint16، للقراءة فقط)
الإزاحة 2: CM._flag1
...
الإزاحة 33: CM._flag32

قائمة القيم للنموذج 60002:
جميع القيم تطفو، ويمكن الوصول إليها للقراءة/الكتابة، ولا يتم حفظها، ويمكن تغييرها كثيرًا. الإزاحة 0: 60002 (uint16، للقراءة فقط)
الإزاحة 1: الطول (uint16، للقراءة فقط)
الإزاحة 2..22: اسم مدير الشحن المتغير 1
الإزاحة 23..24: متغير مدير شحن القيمة 1
الإزاحة 25..45: اسم مدير الشحن المتغير 2
الإزاحة 46..47: متغير مدير شحن القيمة 2
...