MeshCore

حول MeshCore

MeshCore هي مكتبة C++ خفيفة ومحمولة تتيح توجيه الحزم متعدد القفزات للمشاريع المدمجة باستخدام LoRa وراديو الحزم الأخرى. وهي مصممة للمطورين الذين يرغبون في إنشاء شبكات اتصال لامركزية ومرنة تعمل دون إنترنت.

🔍 ما هو MeshCore؟

يدعم MeshCore الآن مجموعة من أجهزة LoRa، مما يسمح ببرمجة سهلة دون الحاجة إلى تجميع البرنامج الثابت يدويًا. يمكن للمستخدمين برمجة ملف ثنائي جاهز باستخدام أدوات مثل Adafruit ESPTool والتفاعل مع الشبكة عبر وحدة تحكم تسلسلية. يوفر MeshCore القدرة على إنشاء شبكات لاسلكية متداخلة، على غرار Meshtastic وReticulum ولكن مع التركيز على توجيه الحزم متعدد القفزات الخفيف للمشاريع المدمجة. على عكس Meshtastic، المصمم للاتصالات العادية عبر LoRa، أو Reticulum، الذي يوفر شبكات متقدمة، يوازن MeshCore بين البساطة وقابلية التوسع، مما يجعله مثاليًا للحلول المدمجة المخصصة، حيث يمكن للأجهزة (العقد) التواصل عبر مسافات طويلة من خلال تمرير الرسائل عبر عقد وسيطة. هذا مفيد بشكل خاص في المواقف خارج الشبكة أو الطارئة أو التكتيكية حيث تكون البنية التحتية للاتصالات التقليدية غير متوفرة.

⚡ الميزات الرئيسية

• توجيه الحزم متعدد القفزات
  • يمكن للأجهزة تمرير الرسائل عبر عقد متعددة، مما يوسع النطاق إلى ما هو أبعد من مدى راديو واحد.
  • يدعم عددًا قابلًا للتكوين من القفزات لموازنة كفاءة الشبكة ومنع حركة المرور المفرطة.
  • تستخدم العقد أدوارًا ثابتة حيث لا تقوم عقد "Companion" بتمرير الرسائل على الإطلاق لمنع استخدام مسارات التوجيه الضارة.
• يدعم راديو LoRa – يعمل مع Heltec وRAK Wireless وأجهزة أخرى قائمة على LoRa.
• لامركزي ومرن – لا حاجة لخادم مركزي أو إنترنت؛ الشبكة ذاتية الإصلاح.
• استهلاك منخفض للطاقة – مثالي للأجهزة التي تعمل بالبطارية أو بالطاقة الشمسية.
• سهل النشر – تطبيقات نموذجية جاهزة تجعل البدء سهلًا.

🎯 ما الذي يمكنك استخدام MeshCore من أجله؟

• الاتصال خارج الشبكة: ابقَ متصلًا حتى في المناطق النائية.
• الاستجابة للطوارئ والتعافي من الكوارث: أنشئ شبكات فورية حيث تكون البنية التحتية معطلة.
• الأنشطة الخارجية: التنزه والتخييم وسباقات المغامرات والتواصل.
• التطبيقات التكتيكية والأمنية: حالات استخدام عسكرية وإنفاذ القانون والأمن الخاص.
• إنترنت الأشياء وشبكات الاستشعار: اجمع البيانات من أجهزة استشعار بعيدة وأعد إرسالها إلى موقع مركزي.

🚀 كيفية البدء

• شاهد قائمة تشغيل MeshCore QuickStart من The Comms Channel
• شاهد العرض التقني لـ MeshCore من Liam Cottle.
• اقرأ الأسئلة الشائعة والتوثيق.
• قم ببرمجة البرنامج الثابت MeshCore على جهاز مدعوم.
• اتصل بعميل مدعوم.

للمطورين:

• قم بتثبيت PlatformIO في Visual Studio Code.
• استنسخ مستودع MeshCore وافتحه في Visual Studio Code.
• اطلع على التطبيقات النموذجية التي يمكنك تعديلها وتشغيلها:
  • Companion Radio - للاستخدام مع تطبيق دردشة خارجي، عبر BLE أو USB أو Wi-Fi.
  • KISS Modem - جسر بروتوكول KISS التسلسلي لتطبيقات المضيف. (توثيق البروتوكول)
  • Simple Repeater - يوسع تغطية الشبكة من خلال تمرير الرسائل.
  • Simple Room Server - خادم BBS بسيط للمنشورات المشتركة.
  • Simple Secure Chat - اتصال نصي آمن قائم على الطرفية بين الأجهزة.
  • Simple Sensor - عقدة استشعار بعيدة مع القياس عن بعد والتنبيه.

يمكن التفاعل مع نموذج Simple Secure Chat من خلال Serial Monitor في Visual Studio Code، أو باستخدام Serial USB Terminal على Android.

⚡️ MeshCore Flasher

لدينا برنامج ثابت جاهز للبرمجة على الأجهزة المدعومة.

• افتح https://meshcore.io/flasher
• اختر جهازًا مدعومًا
• قم ببرمجة أحد أنواع البرامج الثابتة:
  • Companion أو Repeater أو Room Server
• بمجرد اكتمال البرمجة، يمكنك الاتصال بأحد عملاء MeshCore أدناه.

📱 عملاء MeshCore

البرنامج الثابت Companion

يمكن الاتصال بالبرنامج الثابت companion عبر BLE أو USB أو Wi-Fi حسب نوع البرنامج الثابت الذي قمت ببرمجته.

• الويب: https://app.meshcore.nz
• Android: https://play.google.com/store/apps/details?id=com.liamcottle.meshcore.android
• iOS: https://apps.apple.com/us/app/meshcore/id6742354151?platform=iphone
• NodeJS: https://github.com/liamcottle/meshcore.js
• Python: https://github.com/fdlamotte/meshcore-cli

البرنامج الثابت Repeater وRoom Server

يمكن إعداد البرنامج الثابت repeater وroom server عبر USB في أداة التكوين على الويب.

• https://config.meshcore.io

يمكن أيضًا إدارتها عبر LoRa في تطبيق الهاتف المحمول باستخدام ميزة Remote Management.

🛠 توافق الأجهزة

MeshCore مصمم للأجهزة المدرجة في MeshCore Flasher

📜 الترخيص

MeshCore هو برنامج مفتوح المصدر صادر بموجب ترخيص MIT. أنت حر في استخدامه وتعديله وتوزيعه للمشاريع الشخصية والتجارية.

المساهمة

يرجى تقديم طلبات السحب (PR's) باستخدام 'dev' كفرع أساسي! بالنسبة للتغييرات الطفيفة، ما عليك سوى تقديم طلب السحب الخاص بك وسنحاول مراجعته، ولكن لأي شيء أكثر "تأثيرًا" يرجى فتح Issue أولاً وبدء مناقشة. من الأفضل أن توضح ما تريد تحقيقه أولاً، وتحاول التوصل إلى توافق في الآراء حول أفضل نهج، خاصة عندما يؤثر ذلك على بنية أو معمارية قاعدة الشيفرة هذه.

فيما يلي بعض المبادئ العامة التي يجب أن تحاول الالتزام بها:

• اجعلها بسيطة. من فضلك، لا تفكر كمبرمج بلغة عالية المستوى. فكر بشكل مدمج، واجعل الشيفرة موجزة، دون أي طبقات غير ضرورية.
• لا تخصيص ذاكرة ديناميكي، باستثناء أثناء دوال الإعداد/البدء.
• استخدم نفس نمط الأقواس والمسافات البادئة الموجود في وحدات الشيفرة الأساسية. (من المحتمل إضافة ملف .clang-format قريبًا، ولكن من فضلك لا تُعد تنسيق الشيفرة الموجودة بأثر رجعي. هذا يخلق فقط فروقات غير ضرورية تجعل العثور على المشكلات أكثر صعوبة)

ساعدنا في تحديد الأولويات! يرجى التفاعل بإبهام لأعلى على Issues/PRs التي تهتم بها أكثر. نحن ننظر إلى عدد التفاعلات عند التخطيط للعمل.

تشغيل اختبارات الوحدة

لتشغيل اختبارات الوحدة، نفذ الأمر التالي:

pio test --environment native --verbose

خارطة الطريق / المهام

هناك عدد من الميزات الرئيسية إلى حد ما في خط الأنابيب، دون أطر زمنية محددة مرتبطة بها بعد. بترتيب زمني تقريبي جدًا:

• Companion radio: إعادة تصميم واجهة المستخدم
• Repeater + Room Server: إضافة ACL's (مثل Sensor Node)
• توحيد وضع Bridge للـ repeaters
• Repeater/Bridge: توحيد Transport Codes للتقسيم/التصفية
• Core + Repeater: اكتشاف الجيران المحسّن بدون قفزات
• Core: دعم المسار اليدوي ذهابًا وإيابًا
• Companion + Apps: دعم شبكات فرعية متعددة (ووضع تكرار العميل 'off-grid')
• Core + Apps: دعم ضغط رسائل LZW
• Core: CR (معدل الترميز) الديناميكي للقفزات الضعيفة مقابل القوية
• Core: إطار عمل جديد لاستضافة عقد افتراضية متعددة على جهاز مادي واحد
• مواصفات بروتوكول V2: مناقشة وتوافق حول بروتوكول حزم V2، بما في ذلك تجزئات المسار، ومواصفات التشفير الجديدة، إلخ

📞 الحصول على الدعم

• أبلغ عن الأخطاء واطلب الميزات على صفحة GitHub Issues.
• ابحث عن أدلة ومكونات إضافية على موقعي.
• انضم إلى MeshCore Discord للدردشة مع المطورين والحصول على المساعدة من المجتمع.