عدادات معرّفة من قبل المستخدم

ملاحظة: يمكن لـ cFos Charging Manager قراءة معظم محولات الطاقة الشمسية باستخدام SunSpec (نوع الجهاز "SunSpec Solar Inverter / Meter"). في هذه الحالة لا تحتاج إلى إنشاء تعريف العداد الخاص بك.

يتيح لك برنامج cFos Charging Manager إنشاء تعريفات العدادات الخاصة بك لدعم العدادات غير الموجودة في الذخيرة القياسية. يوجد حاليًا ثلاثة أنواع: عدادات Modbus، وعدادات HTTP/JSON، وعدادات MQTT/JSON. ملفات تعريف هذه العدادات متشابهة جدًا. تقرأ عدادات Modbus بياناتها من سجلات محددة عبر Modbus، بينما تقوم عدادات HTTP/JSON بجلب بياناتها عبر طلب HTTP وقراءة JSON كاستجابة. بالنسبة لأجهزة قياس MQTT/JSON، يشترك cFos Charging Manager في موضوعات MQTT ويقرأ الرسائل المنشورة تحت الموضوع بتنسيق JSON. يستخدم برنامج cFos Charging Manager "لغة استعلام" صغيرة لقراءتها. فيما يلي توثيق إمكانيات MQTT في cFos Charging Manager.

بالإضافة إلى عدد من المتغيرات المحددة مسبقًا مثل التيار والجهد، يمكن لأجهزة القياس المحددة من قبل المستخدم أيضًا قراءة متغيرات غير معروفة ومحددة من قبل المستخدم، ومدخلات الاستعلام وتعيين المخرجات. تسمح قراءة المتغيرات وتحديد المخرجات بتقييم الصيغ. هذه ميزة قوية مع متغيرات Charging Manager ومخرجات Charging Manager العالمية الموضحة أدناه وتسمح أيضًا بمهام معينة لأتمتة المنزل والتحكم في الأجهزة الخارجية مثل تخزين البطارية. إذا كنت تستخدم هذا لتنفيذ مهام التحكم، يرجى تزويدنا بتعليقاتك. نحن مهتمون جدًا بما يتحكم فيه عملاؤنا من خلال cFos Charging Manager ويساعدنا ذلك في تطوير مدير الشحن بشكل أكبر وفقًا لاحتياجات العملاء.

فيما يلي مثال بسيط لتعريف Modbus يقرأ سجل طاقة نشط واحد. يمكنك ببساطة تغيير رقم التسجيل لتطبيقك المحدد:
تعريف مثال لسجل واحد.

فيما يلي تعريف نموذجي لـ Modbus وواحد لـ HTTP/JSON:
قم بتنزيل نموذج تعريف لمقياس Modbus
تنزيل تعريف عينة لجهاز قياس/

يأتي Charging Manager بالفعل مع عدد قليل من هذه الملفات ، ولكن يمكنك تحميل ملفاتك الخاصة ضمن "تكوين النظام" وحذفها أيضًا مرة أخرى.
ستجد هنا جزءًا كبيرًا من تعريفات العداد التي نقدمها:
قم بتنزيل تعريفات العداد المرفقة

إذا أنشأت ملفًا مضادًا خاصًا بك ويمكن أن يكون ذا صلة بالمستخدمين الآخرين ، سنكون ممتنين جدًا إذا أمكنك إتاحته لنا. ثم سنقوم بتسليمه مع الإصدارات المستقبلية من Charging Manager.

هيكل ملف التعريف:

تعريفات العداد هي ملفات JSON ذات كائن JSON عام له خصائص وكائنات فرعية. يحدد "rtype" نوع عملية القراءة: 0 = Modbus، 1 = HTTP/JSON، 2 = MQTT/JSON. يحدد "mtype" نوع الجهاز: 0 = جهاز آخر، 1 = متر، 2 = عاكس، 4 = تخزين البطارية.

يمكنك تحديد الأرقام إما بالنظام العشري أو السداسي باستخدام البادئة "0x". يُسمح أيضًا بالتعليقات ذات السطر الواحد باستخدام '//'. نوصي بتشغيل ملفات التعريف الخاصة بك من خلال مدقق JSON5، على سبيل المثال مدقق JSON5 هذا

تأكد من قراءة فصل الصيغ لفهم القيم التي يمكن استخدامها في الصيغ في المرجع التالي.

تحتوي تعريفات Modbus على كائن "rtu" بالخصائص التالية:

Silence_period ، بالميللي ثانية: يحدد طول الإيقاف المؤقت قبل الوصول إلى Modbus RTU حتى يتعرف الجهاز على بداية الرسالة.
Silence_same_slave ، صحيح: يتم الحفاظ على الإيقاف المؤقت حتى لو كان هناك وصولات متعددة لنفس الجهاز.
عدد مرات إعادة المحاولة: عدد مرات إعادة المحاولة في حالة عدم استجابة الجهاز.
rcv_timeout: بالميللي ثانية: الحد الأقصى لوقت الانتظار حتى يستجيب الجهاز، لكل وصول.

تنطبق هذه الخصائص العامة على Modbus TCP و RTU:

modbus_read: رقم وظيفة أمر Modbus للقراءة، عادةً 3 أو 4.
modbus_read_max_registers: الحد الأقصى لعدد السجلات التي يمكن قراءتها دفعة واحدة.
modbus_allow_gaps: true = يمكن قراءة مناطق التسجيل غير المستخدمة في عملية القراءة.

بالنسبة إلى Modbus TCP و HTTP/JSON ، يوجد كائن "tcp" بالخصائص التالية:

Connect_timeout: هو msec: الحد الأقصى لوقت الانتظار لاتصال TCP.
Delay_after_connect: بالميللي ثانية: توقف مؤقتًا بعد إنشاء الاتصال قبل إرسال الأمر الأول.

كلا نوعي التعريف (Modbus و HTTP/JSON) لهما أيضًا الخصائص التالية:

upd_delay: بالميللي ثانية: يحدد الفاصل الزمني الذي يمكن من خلاله قراءة الجهاز. تصبح بعض الأجهزة محملة بشكل زائد إذا تم استطلاعها كثيرًا.
الشركة المصنعة: السلسلة، اسم الشركة المصنعة. سيتم عرض هذا في المعلومات الموسعة للبلاط.
Delay_accumulated: true = يتم الاستعلام عن القيم المتراكمة (kWh) كل 3 ثوانٍ فقط أو عند وجود طاقة كافية. false = يتم الاستعلام عن هذه القيم دائمًا.
ui_addr: عنوان URL، إذا كان مختلفًا عن عنوان الجهاز للاتصال بواجهة الويب.
محجوز: صفيف ذو قيم يتم تفسيرها على أنها 0 (مفيد إذا كان الجهاز يدعم قيمًا معينة حسب الطراز).

إذا قمت بحذف الخصائص المذكورة أعلاه، فإن cFos Charging Manager يأخذ القيم الافتراضية، والتي تعمل بشكل جيد في معظم الحالات.

التالي في تعريف JSON هو تعريف المتغيرات التي يستخدمها العداد لقراءة أو حساب قيم التيار والجهد وما إلى ذلك. يعرف مدير الشحن المتغيرات التالية:
type_designation، version، Firmware_version، serial: تشكل هذه تعيين النموذج كما هو موضح في المعلومات الموسعة الخاصة بالتجانب. يتم الاستعلام عنها مرة واحدة عند إعداد العداد أو إعادة ضبطه.
voltage_l1..voltage_l3, current_l1..current_l3, power_w, power_var, power_va, power_w_l1..power_w_l3: يحاول cFos Charging Manager حساب current_l1..l3 وpower_w وpower_va الموقع من هذه القيم لـvoltage_l1..l3. ليس عليك تحديد كافة المتغيرات. يحاول cFos Charging Manager حساب القيم من المتغيرات الموجودة.
import_wh,export_wh: يستخدم مدير الشحن هذه المتغيرات لعرض import_wh وexport_wh. بالنسبة للعدادات أحادية الاتجاه (مثل العاكسات)، يجب عليك دائمًا تحديد import_wh فقط. يجب تحديد Export_wh فقط للعدادات ثنائية الاتجاه (مثل عدادات التخزين أو استهلاك الشبكة).

soc: إذا كان ذلك متاحًا، فسيتم عرض حالة شحن وحدة تخزين البطارية هنا بنسبة % في المربع.
بالإضافة إلى ذلك، يمكنك تحديد متغيرات إضافية بأسماء مختلفة، والتي تتم قراءتها أو حسابها باستخدام الصيغ مع كل تحديث. إذا قمت بتعريف متغيرات تبدأ بـ "CM". ابدأ، على سبيل المثال CM._set_price، يتم تخزين القيم المخصصة في متغيرات Charging Manager العالمية (انظر أدناه) ويمكن الاستعلام عنها وفقًا لذلك.
المتغيرات مع *: إذا قمت بتحديد المتغيرات التي تبدأ بـ '*'، فسيتم عرضها في واجهة المستخدم في لوحة العدادات ضمن المعلومات الموسعة، على سبيل المثال درجة حرارة تخزين البطارية.
ملحوظة: يمكن استخدام الأرقام والحروف az وAZ فقط كأسماء للمتغيرات.

تعريف المتغير:

يتم تسمية الكائن باسم المتغير المذكور أعلاه ويتمتع بالخصائص التالية:
ثابت: سلسلة ذات قيمة ثابتة. يكون هذا مفيدًا، على سبيل المثال، إذا لم يكن من الممكن تحديد قيمة، على سبيل المثال لتحديد النوع أو الجهد.
إكسبر: سلسلة. لا تتم قراءة المتغير، ولكن يتم تقييمه كصيغة.
النوع: إذا لم يكن ثابتًا أو expr، فإن نوع المتغير هو: int16، uint16، int32، uint32، float، int64، string. هذا مهم لـ Modbus لقراءة السجلات بالتنسيق الصحيح. uint16 وuint32 هما أنواع يمكنها قبول الأرقام الموجبة فقط. مع JSON/HTTP، يمكنك عادةً استخدام float.
القرار: تعويم. يتم ضرب قيمة القراءة بـ "الدقة". يجب أن تكون قيم الجهد بالفولت، والتيارات بالمللي أمبير، والطاقة بالواط، والطاقة بالواط/ساعة (Wh). باستخدام "الدقة" السالبة، يمكنك عكس القيمة إذا كانت تحمل علامة معاكسة.
مرة واحدة: منطقي (صواب أو خطأ). إذا كان صحيحًا، فستتم قراءة القيمة مرة واحدة فقط عند تهيئة الجهاز، وإلا بشكل دوري.
العنوان: رقم (Modbus) أو سلسلة (HTTP/JSON). رقم تسجيل Modbus أو عنوان URL HTTP للقيمة المراد قراءتها.
الاستعلام: سلسلة. بالنسبة إلى HTTP JSON، المعلومات الموجودة في لغة استعلام مدير الشحن والتي يجد من خلالها القيمة المراد قراءتها في استجابة JSON.
الترتيب: سلسلة. بالنسبة إلى Modbus، ترتيب البايت، إما "hl" أو "lh"، والذي تتوفر فيه القيمة. الطول: العدد. مع Modbus، يتم استخدام طول السلسلة في السجلات، مع المتغيرات "version" و"firmware_version" "length" لتحويل الإصدارات الرقمية إلى سلاسل ذات نقاط. يُسمح بقيم 2 أو 4 لـ "length"، مما يؤدي بعد ذلك إلى تنسيقات الإصدار ab وabcd. بالنسبة لـ "length" 2 واكتب "int16" أو "uint16"، يفصل مدير الشحن بين البايتات المنخفضة والعالية بنقطة، للكلمة المنخفضة والعالية "int32" أو "uint32"، للكلمة المنخفضة والعالية "int64". باستخدام "lenth" 4 و"int32" أو "uint32"، يقوم مدير الشحن بتقسيم القيمة إلى 4 بايت مفصولة بنقاط. بالنسبة لـ "int64" فإن الكلمات الأربع تتوافق.
ريكس: سلسلة. إذا تم تحديد تعبير عادي، فلا يلزم أن تكون استجابة العداد بتنسيق JSON. ونتيجة لذلك، يتم تقييم المطابقة الكاملة للتعبير العادي أو المجموعة الأولى. يُرجى الاستخدام فقط إذا لم يُرجع الجهاز JSON. فيما يلي قائمة بميزات تعبيراتنا العادية:
أي حرف: .
الفئات المسماة: \d \s \w \D \S \W
فئات مجهولة: [a-z0-9_]، [^0-9]، [^\d]
المجموعات ذات البدائل: (ab|cd|ef)
المجموعات غير الملتقطة: (?:ab|cd)
(الجشع) مرة واحدة أو لا شيء: أ؟؟، أ؟؟
(الجشع) كثير أو لا شيء: a*, a*?
(الجشع) مرة أو أكثر: أ+، أ+؟
بداية السلسلة: ^
نهاية السلسلة: $

تعريف المدخلات:

يمكن لمدير الشحن الاستعلام عن ما يصل إلى 32 قيمة إدخال من سجلات مختلفة أو عناصر JSON لكل جهاز. خاصية المدخلات هي مصفوفة JSON. يجب عليك تحديد الخصائص التالية لكل إدخال:
العنوان: العنوان (سجل Modbus أو URL).
العد: عدد بتات الإدخال التي تتم قراءتها مع هذا الطلب.
الاستعلام: بالنسبة إلى HTTP/JSON، لغة الاستعلام للعثور على القيمة في الاستجابة.

مع كل تحديث، يقرأ cFos Charging Manager جميع المدخلات المحددة بهذه الطريقة ويضع البتات داخليًا في مصفوفة يمكن بعد ذلك الاستعلام عنها في الصيغ، Input1..InputN.

تعريف المخرجات:

يمكن لمدير الشحن تبديل ما يصل إلى 32 مخرجًا لكل جهاز. يتم تعريف المخرجات في "المخرجات" كمصفوفة JSON لكائنات الإخراج. يتم تبديل كافة النواتج في نهاية كل دورة تحديث إذا تغيرت حالة المخرجات المعنية.
لكل مخرجات يجب عليك تحديد الخصائص التالية في كائن الإخراج:
العنوان: عنوان URL لـ HTTP مع طريقة HTTP اختيارية، على سبيل المثال GET//}. لتعيين سجلات Modbus، يمكنك استخدام cFos Charging Manager HTTP API. يكتشف مدير الشحن عمليات الوصول المناسبة إلى المضيف المحلي ويعيد توجيه الطلب إلى المعالج الداخلي، لذلك لا تحتاج إلى ترخيص كما هو الحال مع عمليات الوصول الخارجية لواجهة برمجة تطبيقات HTTP. إذا كان عنوان URL فارغًا بعد كل عمليات الاستبدال، فلن يتم تعيين أي مخرجات. على سبيل المثال، يمكنك فقط تبديل المخرجات في حالة وجود متغيرات معينة (راجع الصيغ: دالة موجودة ()). يمكنك أيضًا تحديد ${address} و${id} في العنوان. هذا هو عنوان الجهاز الحالي ومعرف Modbus كما هو محدد في الإعدادات. يتم استخدام "العنوان" و"المعرف" بشكل أساسي لاستخدام Modbus API (انظر أدناه).
body: نص HTTP اختياري لـ POST أو PUT.
في عنوان URL والنص، يمكنك استخدام صيغ ${expr} التي تشير إلى متغيرات Charging Manager العالمية أو المقياس المعني. يتم تقييم الصيغة "expr" عند تعيين الإخراج واستبدالها في نص عنوان URL أو النص. في المثال أعلاه، إذا قام http://www.example.com?output1=1 بتعيين الإخراج وقام http://www.example.com?output1=0 بمسحه، فيمكنك تحديد متغير "var1" وتعيينه إلى 1 حسب الرغبة أو تعيين 0. يمكنك أيضًا كتابة قيم رقمية للتحكم في أداء الذاكرة في سجلات Modbus التي قمت بتخزينها مسبقًا في متغير باستخدام صيغة.
إذا كنت بحاجة، بدلاً من تمرير قيمة رقمية، إلى استبدال نص واحد في عنوان URL بآخر اعتمادًا على الصيغة، كما هو الحال مع مقابس Shelly WLAN، فيمكنك كتابتها على النحو التالي: ${if expr`text1`text2}. "الفاصلة العليا" هي علامة خلفية (رمز ASCII 96). إذا كانت قيمة 'expr' != 0، فسيتم استخدام text1، وإلا فسيتم استخدام text2. بالنسبة لمقبس Shelly WLAN، يبدو عنوان URL كما يلي: http://<ip-addr>/Relay/0?turn=${if expr`on`off}، على سبيل المثال، if expr != 0 يستدعي مدير الشحن ثم http ://<ip-addr>/Relay/0?turn=on on وإلا http://<ip-addr>/Relay/0?turn=off.

إذا قمت بإدخال مسار نسبي كعنوان URL، فسيأخذ مدير الشحن العنوان الذي تم تكوينه للجهاز المعني. إذا قمت بتحديد "المضيف المحلي" كمجال، فسيأخذ مدير الشحن عنوان الجهاز الذي يعمل عليه. إذا اكتشف الوصول إلى واجهة برمجة التطبيقات (API) الخاصة به، فإنه يستخدم المعالج الداخلي بدلاً من تنفيذ وصول HTTP كامل، بحيث لا يتعين عليك تخزين اسم مستخدم وكلمة مرور في تعريف العداد. يؤدي عنوان URL الذي يبدأ بالعلامة '*' إلى قيام مدير الشحن دائمًا بإجراء وصول كامل إلى HTTP.

إعادة تعيين المخرجات: بالإضافة إلى مصفوفة "المخرجات"، يمكنك أيضًا تحديد مصفوفة تسمى "إعادة التعيين" منظمة مثل مصفوفة "المخرجات". يتيح ذلك إعادة ضبط المخرجات على قيمها الأولية عند إلغاء تنشيط الجهاز. يتيح لك هذا، بالإضافة إلى المتغيرات المعرفة من قبل المستخدم و"مرة": true، إعادة الجهاز إلى حالته الأولية.
كتابة المخرجات بشكل دوري: في بعض الأجهزة يجب كتابة المخرجات بشكل دوري، وإلا يقوم الجهاز بإعادة القيم إلى "قياسي". على سبيل المثال، ستعود ذاكرة Kostal إلى قواعدها الافتراضية إذا لم تتم كتابة وحدة التحكم في الذاكرة بشكل نشط لفترة من الوقت. لتعيين المخرجات بشكل دوري، يمكنك بادئة العنوان بـ #xxx#، حيث يشير xxx إلى كل ثانية ستتم إعادة كتابة المخرجات فيها، حتى لو ظلت القيمة المراد كتابتها كما هي. على سبيل المثال، إذا كان العنوان هو /cnf?cmd=set_cm_vars&name=test&val=42، فيمكنك استخدام #30#/cnf?cmd=set_cm_vars&name=test&val=42 للتأكد من كتابة هذه القيمة كل 30 ثانية تصبح.

تعريف لغة الاستعلام:

حاليًا ، يمكن استخدام أسماء الأعضاء وعوامل التشغيل "." في تعبيرات البحث "الاستعلام". و "[]" ، أمثلة:

متغيرات مدير الشحن العالمي:

يمكنك إنشاء متغيرات في تكوين Charging Manager. يمكنك استخدام قيمة ثابتة أو صيغة كقيمة. وفي نهاية كل دورة تحديث، قد يقوم مدير الشحن بإعادة حساب قيمة هذا المتغير. يمكنك بعد ذلك استخدامها في (معينة) معلمات مدير الشحن أو قواعد الشحن أو للتحكم في المخرجات. يمكنك أيضًا كتابة E x.member أو M x.member كمتغير. هنا E x و M x هما معرف الجهاز الخاص بصندوق الحائط أو جهاز القياس الذي تم إعداده في مدير الشحن. "العضو" هو متغير "مخصص" يتم تخزينه في الجهاز المقابل. بعض المتغيرات يمكن أن يكون لها معنى خاص: بالنسبة لـ KEBA، "out1" هو مخرج تبديل، بالنسبة لـ ABB B23، فإن متري "out1" و"out2" عبارة عن مخرجات تبديل (في الطرز التي تدعم ذلك). يقوم 1 بتبديل الإخراج، بينما يقوم 0 بإيقاف تشغيله مرة أخرى.

إذا كان لديك أجهزة يجب تشغيلها في ظل ظروف معينة ولكن بعد ذلك يجب تشغيلها لفترة (مثل الغسالة وغسالة الصحون) ، يمكنك أيضًا تحديد المتغير على أنه "مشغل". ثم صيغة المتغير هي الشرط الذي يحدد المتغير على 1. بعد وقت قابل للتعديل ، تتم إعادة تعيينه بعد ذلك إلى 0. يسمح "شرط retrigger" بتمديد الوقت حتى إيقاف التشغيل (أي ضبط المتغير على 0) مرارًا وتكرارًا طالما تم استيفاء الشرط.

ملحوظة: يمكن استخدام الأرقام والحروف az وAZ فقط كأسماء للمتغيرات.

لأغراض الاختبار، يمكنك عرض مدير الشحن ومتغيرات العداد، على سبيل المثال الأسعار الحالية من أوتار:

مخرجات مدير الشحن العالمي:

في تكوين مدير الشحن، يمكنك تكوين المخرجات العالمية كما هو موضح أعلاه في تعريف جهاز القياس ضمن "المخرجات". يتم تعيينها في نهاية كل دورة تحديث إذا تغيرت حالتها. إذا كنت تريد التحكم في تحويل المخرجات في الأجهزة المحددة من قبل المستخدم، يوصى بالاتفاقية المذكورة أعلاه (راجع متغيرات إدارة الشحن): يمكنك تعيين المتغيرات بالاسم "out1"، "out2"، وما إلى ذلك في العداد المحدد من قبل المستخدم وإعدادها تقوم المخرجات في العداد المحدد من قبل المستخدم بتبديل الإخراج اعتمادًا على قيمة هذا المتغير.

واجهة برمجة تطبيقات Modbus العالمية لمدير الشحن:

يتم استخدام Modbus API الخاص بـ Charging Manager للتحكم في أجهزة Modbus التي تحتوي على أي عنوان Modbus RTU أو TCP (يمكن الوصول إليه بواسطة Charging Manager). كعنوان لـ Modbus RTU، أدخل COMx,bd,8,p,s، كما هو الحال في تكوين الأجهزة الفردية، حيث x هو رقم منفذ COM، وbd هو معدل الباود، وp هو التكافؤ ('N'، 'E' أو 'O') وs هو عدد بتات التوقف (1 أو 2). مع Modbus TCP، العنوان هو عنوان IP الخاص بالجهاز في شبكة Charging Manager بما في ذلك رقم المنفذ.
عنوان URL (لـ HTTP GET) لواجهة برمجة تطبيقات Modbus هو:
/cnf?cmd=modbus_get أو /cnf?cmd=modbus_set
يدعم cFos Charging Manager معلمات الاستعلام الإضافية التالية:
addr: عنوان جهاز Modbus RTU أو TCP المذكور أعلاه.
func: رقم وظيفة Modbus، على سبيل المثال، لقراءة 3 أو 4، لكتابة 6 أو 16.
المعرف: معرف الجهاز لجهاز Modbus.
reg: رقم تسجيل Modbus. يمكن تحديد القيمة بالنظام العشري أو السداسي (مع البادئة 0x).
val: الرقم: القيمة التي سيتم كتابتها في السجل. تجاهل عند القراءة.
النوع: 'w' 16 بت (افتراضي)، d = 32 بت، f = تعويم، q = 64 بت، s = سلسلة.
cnt: number: الحد الأقصى لطول السلسلة في السجلات، بالنسبة للأنواع الأخرى، يتم حذفه أو تعيينه على 1.
الترتيب: سلسلة: ترتيب البايت، إما "hl" أو "lh".

ملاحظة: إذا تم استخدام "جهاز القياس" بشكل أساسي لأغراض التحكم ، فيمكنك تحديد خيار "إخفاء الجهاز" في إعدادات هذا المربع بحيث لا يظهر هذا الجهاز في صفحة البداية.

ملاحظة: تتطلب بعض المقاييس التي تتم قراءتها عبر HTTP اسم المستخدم/كلمة المرور كتخويل. يمكنك تحديد هذا في العنوان الخاص بوصول HTTP ، على سبيل المثال مع http://username:password@192.168.2.111. إذا كان اسم المستخدم أو كلمة المرور يحتويان على "@" ، فيجب استبدالهما بـ "%40".