MeshCore

حول MeshCore

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

🔍 ما هو MeshCore؟

يدعم MeshCore الآن مجموعة من أجهزة LoRa، مما يسمح بالوميض السهل دون الحاجة إلى تجميع البرنامج الثابت يدويًا. يمكن للمستخدمين وميض ملف ثنائي مُعد مسبقًا باستخدام أدوات مثل Adafruit ESPTool والتفاعل مع الشبكة من خلال وحدة تحكم تسلسلية.

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

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

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

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

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

🚀 كيف تبدأ

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

للمطورين:

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

يمكن التفاعل مع مثال الدردشة الآمنة البسيطة من خلال المراقب التسلسلي في Visual Studio Code، أو باستخدام طرفية USB تسلسلية على Android.

⚡️ أداة وميض MeshCore

لدينا برنامج ثابت مُعد مسبقًا جاهز للوميض على الأجهزة المدعومة.

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

📱 عملاء MeshCore

البرنامج الثابت للمرافق (Companion)

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

• الويب: https://app.meshcore.nz
• أندرويد: 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

البرنامج الثابت للمكرر وخادم الغرفة

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

• https://config.meshcore.io

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

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

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

📜 الترخيص

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

المساهمة

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

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

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

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

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

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

pio test --environment native --verbose

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

هناك عدد من الميزات الكبيرة نسبيًا قيد التطوير، دون جداول زمنية محددة حتى الآن. بترتيب زمني تقريبي للغاية:

• راديو المرافق: إعادة تصميم واجهة المستخدم
• مكرر + خادم الغرفة: إضافة قوائم التحكم في الوصول (ACL) (مثل عقدة المستشعر)
• توحيد وضع الجسر للمكررات
• مكرر/جسر: توحيد رموز النقل للتقسيم/التصفية
• النواة + المكرر: اكتشاف الجوار صفر القفزات المحسن
• النواة: دعم المسار اليدوي ذهابًا وإيابًا
• المرافق + التطبيقات: دعم الشبكات الفرعية المتعددة (ووضع تكرار العميل خارج الشبكة)
• النواة + التطبيقات: دعم ضغط الرسائل LZW
• النواة: معدل الترميز الديناميكي (CR) للقفزات الضعيفة مقابل القوية
• النواة: إطار جديد لاستضافة عقد افتراضية متعددة على جهاز مادي واحد
• مواصفات بروتوكول V2: نقاش وتوافق حول بروتوكول الحزمة V2، بما في ذلك تجزئة المسار ومواصفات التشفير الجديدة، إلخ

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

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