ربط الشاحن بخادم OCPP مهمة قصيرة في العادة، لكن الأخطاء الصغيرة قد تكلّف ساعات: حرف خاطئ واحد في معرّف نقطة الشحن، أو استخدام ws بدلًا من wss، أو منفذ محجوب. وتعود معظم مشكلات الاتصال إلى عدد قليل من الأسباب المعتادة، ويسهل تجنّبها متى عرفتها.
يشرح هذا الدليل خطوة بخطوة كيفية ربط الشاحن بخادم OCPP (نظام CSMS)، ويتناول المتطلبات المسبقة، ومكان الإعدادات، ومعنى كل حقل، وكيفية اختبار الاتصال، وطريقة حل أكثر المشكلات شيوعًا. وستجد في النهاية مثالًا يستخدم صيغة عنوان URL الخاصة بـ Üreticy.
- تحتاج إلى أربعة أمور: اتصال إنترنت يعمل، وبرنامج ثابت يدعم OCPP، وعنوان URL للخادم، ومعرّف فريد لنقطة الشحن.
- معرّف نقطة الشحن هو عادةً الجزء الأخير من مسار عنوان URL، ويجب أن يتطابق تمامًا، بما في ذلك الأحرف الكبيرة والصغيرة.
- استخدم
wss://(TLS) كلما دعمه الشاحن، وتأكد من صحة ساعة الشاحن. - يظهر نجاح الاتصال في ثلاث علامات: قبول BootNotification، ووصول رسائل Heartbeat بانتظام، وصحة حالة الموصل.
المتطلبات المسبقة قبل البدء
تحقق من النقاط التالية قبل فتح إعدادات الشاحن:
- اتصال الإنترنت: عبر Ethernet أو Wi-Fi أو شريحة SIM. وفي حالة شرائح SIM، تأكد من أن باقة البيانات مفعّلة وأن إعدادات APN صحيحة.
- الوصول الصادر: يجب أن تسمح الشبكة بالاتصالات الصادرة إلى الخادم، عادةً عبر المنفذ 443 لاتصال
wss://. فالشاحن هو من يفتح الاتصال، لذا لا حاجة إلى منافذ واردة. - البرنامج الثابت: يجب أن يعمل الشاحن ببرنامج ثابت يدعم OCPP. تحقق من الإصدار الذي يدعمه (1.6J أو 2.0.1 أو 2.1)، وحدّثه عند الحاجة إلى أحدث إصدار مستقر من المصنّع.
- بيانات الاتصال من نظام CSMS: عنوان URL للخادم، وإصدار البروتوكول، وكلمة المرور إن وُجدت.
- صلاحية الوصول للمركّب: بيانات الدخول إلى واجهة الويب للشاحن أو تطبيق التركيب أو أداة الإعداد.
أين توجد إعدادات OCPP
يضع كل مصنّع الإعدادات في مكان مختلف، لكن هناك ثلاثة خيارات شائعة:
- واجهة الويب: توصل حاسوبًا محمولًا بالشاحن بكابل أو بنقطة Wi-Fi الخاصة به، ثم تفتح عنوان IP محليًا في المتصفح.
- تطبيق التركيب: تطبيق جوال يتصل بالشاحن عبر Bluetooth أو Wi-Fi.
- أداة الإعداد: برنامج لسطح المكتب، يتصل أحيانًا عبر USB أو كابل تسلسلي. ويتيح بعض المصنّعين أيضًا الإعداد عبر بوابتهم السحابية الخاصة.
ابحث عن قوائم بأسماء مثل "Backend" أو "OCPP" أو "Central System" أو "Network". وعادةً ما يتضمن دليل التركيب قسمًا مخصصًا لذلك.
الحقول التي تحتاج إلى تعبئتها
| الحقل (الأسماء الشائعة) | ما الذي تُدخله | ملاحظات |
|---|---|---|
| Central System URL، CSMS URL، OCPP server URL | عنوان WebSocket الذي يوفّره نظام CSMS | يبدأ بـ ws:// أو wss:// |
| Charge Point ID، ChargeBoxIdentity، Station ID | اسم فريد لهذا الشاحن | يُضاف عادةً إلى مسار عنوان URL؛ ويميّز بين الأحرف الكبيرة والصغيرة |
| إصدار البروتوكول | OCPP 1.6J أو 2.0.1 أو 2.1 | يجب أن يطابق ما يتوقعه نظام CSMS لهذا الشاحن |
| كلمة المرور، مفتاح التفويض | كلمة مرور مصادقة HTTP Basic | اختيارية؛ تُستخدم مع ملفَّي الأمان 1 و2 |
| شهادة TLS | شهادة الجذر أو شهادة العميل | مطلوبة لاتصال wss:// إذا لم يكن الشاحن يثق افتراضيًا بشهادة الخادم، ولملف الأمان 3 |
كيف يعمل عنوان URL والمعرّف معًا
في OCPP، يتصل الشاحن بعنوان URL للخادم مع إضافة معرّف نقطة الشحن في نهاية المسار. فمثلًا، إذا كان عنوان الخادم wss://csms.example.com/ocpp والمعرّف CP001، فسيتصل الشاحن بالعنوان wss://csms.example.com/ocpp/CP001.
تضيف بعض الشواحن المعرّف تلقائيًا، فتُدخل عنوان URL الأساسي فقط، بينما تتوقع شواحن أخرى العنوان الكامل متضمنًا المعرّف. اقرأ الدليل بعناية؛ فإذا أُضيف المعرّف مرتين أو لم يُضف إطلاقًا، فلن يتعرّف نظام CSMS على الشاحن.
خطوة بخطوة: ربط الشاحن
- أنشئ الشاحن أو احجزه في نظام CSMS، أو دوّن معرّف نقطة الشحن الذي تنوي استخدامه. واعتمد نمط تسمية واضحًا، مثل رمز الموقع متبوعًا برقم.
- افتح إعدادات الشاحن عبر واجهة الويب أو التطبيق أو الأداة.
- اضبط اتصال الشبكة وتأكد من أن الشاحن متصل بالإنترنت.
- أدخل عنوان URL للخادم ومعرّف نقطة الشحن تمامًا كما هو موضح أعلاه.
- اختر إصدار البروتوكول المطابق لإعدادات نظام CSMS.
- أدخل كلمة المرور والشهادة إذا كان إعداد الأمان لديك يستخدمهما.
- تحقق من إعدادات الوقت. فعّل NTP إذا كان الشاحن يدعمه، واضبط المنطقة الزمنية الصحيحة.
- احفظ الإعدادات وأعد تشغيل الشاحن أو وحدة الاتصال.
كيف تختبر الاتصال
بعد إعادة التشغيل، تحقق من العلامات التالية في نظام CSMS وفي سجلات رسائل OCPP:
- قبول BootNotification: يرسل الشاحن اسم المصنّع والطراز والبرنامج الثابت، ويرد نظام CSMS بـ Accepted. أما الرد بـ Pending أو Rejected فيعني أن الشاحن معروف لكنه لم يُعتمد بعد.
- Heartbeat: تصل رسائل Heartbeat وفق الفاصل الزمني المحدد في رد BootNotification، عادةً كل 60 إلى 300 ثانية.
- StatusNotification: يُبلغ كل موصل عن حالته، وتكون عادةً Available عند عدم توصيل أي سيارة.
- أمر عن بُعد: أرسل TriggerMessage أو غيّر الإتاحة، وتحقق من استجابة الشاحن.
- جلسة اختبار: قدّم بطاقة RFID، واشحن سيارة لبضع دقائق، وتحقق من ظهور الجلسة وقيم العدّاد.
للاطلاع على خلفية هذه الرسائل، اقرأ ما هو OCPP؟
المشكلات الشائعة وكيفية حلها
| العَرَض | السبب المرجّح | ما الذي تفعله |
|---|---|---|
| لا يظهر الشاحن أبدًا في نظام CSMS | لا يوجد اتصال بالإنترنت، أو عنوان URL خاطئ، أو المنفذ الصادر محجوب | تحقق من حالة الشبكة على الشاحن؛ واختبر عنوان URL؛ واطلب من فريق تقنية المعلومات السماح بالحركة الصادرة عبر المنفذ 443 |
| يُرفض الاتصال فورًا | معرّف نقطة الشحن خاطئ أو غير معروف | قارن المعرّف حرفًا بحرف، بما في ذلك حالة الأحرف والمسافات والشرطات |
يعمل الاتصال عبر ws:// ولا يعمل عبر wss:// | الشهادة غير موثوقة أو TLS غير مدعوم | ثبّت شهادة الجذر الصحيحة أو حدّث البرنامج الثابت |
| يفشل TLS رغم صحة الشهادة | ساعة الشاحن غير صحيحة | فعّل NTP أو اضبط الوقت يدويًا؛ فالتحقق من الشهادة يعتمد على التاريخ |
| خطأ في المصادقة | كلمة مرور خاطئة أو ملف أمان خاطئ | أعد إدخال كلمة المرور وتحقق من إعداد ملف الأمان لدى الطرفين |
| ينقطع الاتصال بشكل متكرر | إشارة جوال ضعيفة أو شبكة غير مستقرة | تحقق من قوة الإشارة وموضع الهوائي وإعدادات Heartbeat وping |
| يتصل الشاحن لكن الرسائل تفشل | عدم تطابق إصدار البروتوكول | تأكد من أن الشاحن ونظام CSMS يستخدمان إصدار OCPP نفسه |
مثال: ربط شاحن بمنصة Üreticy
في Üreticy، يحصل كل عميل على عنوان OCPP URL خاص به بالصيغة التالية:
wss://ocpp.ureticy.com/URT{customer-no}/{charge-point-id}فمثلًا، لو كان رقم العميل 1001 ومعرّف الشاحن HOTEL-01، لكان العنوان الكامل wss://ocpp.ureticy.com/URT1001/HOTEL-01. وإذا كان شاحنك يضيف المعرّف تلقائيًا، فأدخل wss://ocpp.ureticy.com/URT1001 فقط بصفته عنوان URL الأساسي وHOTEL-01 بصفته معرّف نقطة الشحن.
عندما يتصل الشاحن بمعرّف غير موجود بعد في حسابك، يظهر تلقائيًا في لوحة التحكم بحالة "قيد الانتظار". تضيفه بنقرة واحدة، ثم يعرض الشاحن حالته وقدرته وطاقته لحظيًا. ويستغرق الإعداد المعتاد نحو عشر دقائق. وتستخدم شواحن OCPP 1.6J و2.0.1 و2.1 صيغة العنوان نفسها، عبر WS أو WSS. وإذا لم يعمل شيء كما ينبغي، تُظهر سجلات رسائل OCPP القابلة للبحث الرسائل المتبادلة بدقة. تجد مزيدًا من التفاصيل في صفحة برنامج OCPP.
بعد الاتصال: الخطوات التالية
- امنح كل موصل اسمًا واضحًا، واطبع ملصقات رمز QR ليتعرّف عليه السائقون والفنيون.
- أضف بطاقات RFID والسائقين، وحدّد المحطات التي يحق لكل سائق استخدامها.
- فعّل التنبيهات للأعطال وانقطاع الاتصال وانتهاء مهلة الأوامر.
- إذا كنت تستخدم حصص الطاقة، فاضبط قواعد حدود kWh لكل سائق أو مركبة. وتشرح صفحة حدود kWh والشحن الذكي طريقة عملها.
الأسئلة الشائعة
هل أحتاج إلى عنوان IP ثابت لربط الشاحن بخادم OCPP؟
عادةً لا. ففي OCPP-J، يفتح الشاحن اتصال WebSocket صادرًا إلى الخادم، لذا لا يحتاج إلى عنوان IP عام أو ثابت. يكفي أن تسمح الشبكة بالاتصالات الصادرة إلى عنوان الخادم ومنفذه.
ما الفرق بين ws:// وwss://؟
كلاهما عنوان WebSocket. يرسل ws:// البيانات دون تشفير، بينما يشفّر wss:// الاتصال عبر TLS. استخدم wss:// كلما دعمه الشاحن، لأنه يحمي معرّفات البطاقات وقيم العدّاد وكلمات المرور.
هل يمكنني تغيير معرّف نقطة الشحن لاحقًا؟
تقنيًا نعم، لكن نظام CSMS سيتعامل مع المعرّف الجديد على أنه شاحن جديد. ويبقى سجل الجلسات والإعدادات مرتبطين بالمعرّف القديم ما لم يتح لك برنامجك نقلها. لذا من الأفضل اعتماد نمط تسمية واضح ودائم منذ البداية.
لماذا يظهر شاحني بحالة Pending بعد BootNotification؟
تعني حالة Pending أن نظام CSMS استقبل الشاحن لكنه لم يقبله بالكامل بعد، مثلًا لأنه لم يُخصَّص لحساب بعد. اعتمد الشاحن أو أضفه في نظام CSMS، وسيُقبل عند الإقلاع التالي أو المحاولة التالية.
كيف أنقل شاحنًا من خادم OCPP إلى آخر؟
غيّر عنوان URL للخادم، ومعرّف نقطة الشحن وكلمة المرور عند الحاجة، في إعدادات الشاحن، ثم أعد تشغيله. وصدّر سجل الجلسات من النظام القديم أولًا. ولأن OCPP بروتوكول مفتوح، فلا حاجة إلى استبدال المعدات.
هل أنت مستعد لربط أول شاحن لديك؟ احصل على عنوان OCPP URL الخاص بك مع برنامج OCPP من Üreticy، أو تواصل معنا إذا احتجت مساعدة في طراز شاحن معيّن.