MeshTNC

MeshTNC

MeshTNC هي أداة لنقل بيانات LoRa من وإلى أجهزة الراديو الاستهلاكية.

• الكود المصدري - github.com/datapartyjs/MeshTNC
• الإصدارات - github.com/datapartyjs/MeshTNC/releases
• الدعم - ko-fi/dataparty

الميزات

• واجهة سطر أوامر تسلسلية بسيطة مدمجة في البرنامج الثابت
• إرسال بيانات أولية (hex) عبر LoRa باستخدام واجهة سطر الأوامر التسلسلية
• تسجيل حزم LoRa إلى المنفذ التسلسلي (hex)
• التنصت على حزم BLE
• وضع KISS-TNC

التجميع

باستخدام إضافة PlatformIO لـ Visual Studio Code

• قم بتثبيت PlatformIO في Visual Studio Code.
• استنساخ وفتح مستودع MeshTNC في Visual Studio Code.
• اطّلع على التطبيقات النموذجية التي يمكنك تعديلها وتشغيلها:
  • Simple Repeater

باستخدام سطر الأوامر

• قم بتثبيت PlatformIO Core CLI
• استنساخ وفتح مستودع MeshTNC في المحيط الذي تفضله
• ابحث عن اسم البيئة من ملف 'platform.ini' في مجلد 'variants' الخاص بجهازك
  • أو ابحث عن الجهاز في مخرجات الأمر pio project config | grep '^env:'
• قم ببناء البرنامج الثابت الخاص بالجهاز export FIRMWARE_VERSION="localbuild" ; ./build firmware <اسم-البيئة-للجهاز>
• ابحث عن صورة البرنامج الثابت في مجلد 'out'

الوميض

قم بتنزيل إصدارات البرنامج الثابت المجمعة مسبقًا - github.com/datapartyjs/MeshTNC/releases

لم نقم بعد ببناء أداة وميض. يمكنك وميض الإصدارات باستخدام أداة وميض meshcore، أو أدوات الوميض المقدمة من الشركة المصنعة، أو باستخدام تعليمات المطورين للوميض باستخدام VS Code.

• وميض باستخدام أداة الوميض الخاصة بمنصتك من الشركة المصنعة
• استخدم أداة وميض meshcore - http://flasher.meshcore.co.uk/

التوافق مع الأجهزة

تم تصميم MeshTNC للأجهزة التي يدعمها MeshCore، لذا تحقق من قائمة الدعم الخاصة بهم في MeshCore Flasher. نحن ندعم معظم نفس الأجهزة، انظر variants.

واجهة سطر الأوامر التسلسلية

يبدأ البرنامج الثابت لـ MeshTNC في البداية في وضع تسلسلي مقروء للبشر. يمكنك الاتصال بوحدة التحكم التسلسلية باستخدام تطبيق طرفي تسلسلي. قد تحتاج إلى ضبط معدل الباود، والذي يكون افتراضيًا 115200. الأمر التالي يستخدم minicom للاتصال بالمنفذ التسلسلي، يرجى استبدال /dev/ttyACM0 بعقدة الجهاز المناسبة لمنفذك التسلسلي:

minicom -b 115200 -D /dev/ttyACM0

قد يكون من المفيد في أنظمة Linux تشغيل الأمر التالي لتعيين الباود الافتراضي عند التفاعل مع المنفذ التسلسلي:

stty -F /dev/ttyACM0 115200

بمجرد الاتصال، يحتوي جهاز MeshTNC على واجهة سطر أوامر بسيطة. تشبه إلى حد كبير واجهة MeshCore مع بعض الإضافات البارزة.

إضافات واجهة سطر الأوامر

• txraw <hex...> - إرسال حزمة
• get syncword <word> - قراءة إعداد كلمة المزامنة
• set kiss port <port> - تعيين منفذ جهاز KISS
• set radio <freq>,<bw>,<sf>,<coding-rate>,<syncword> - تكوين الراديو
• serial mode kiss - التبديل إلى وضع KISS
• rxlog on - تمكين تسجيل حزم LoRa
  • تنسيق الإخراج: [timestamp],[type=RXLOG],[rssi],[snr],[hex...]\n
• rxlog off - تعطيل تسجيل حزم LoRa
• rxlog ble on - تمكين تسجيل حزم BLE
  • تنسيق الإخراج: [timestamp],[type=RXBLE],[rssi],[snr],[MAC - 6 octets][hex...]\n
• rxlog ble off - تعطيل تسجيل حزم BLE
• get ble - تفريغ إعدادات BLE

الأوامر الحالية

• reboot
• clock sync
• start ota
• clock
• time
• tempradio
• clear stats
• get af
• get agc.reset.interval
• get name
• get lat
• get lon
• get radio
• get rxdelay

وضع KISS

يتيح وضع KISS تشغيل راديو LoRa كمودم KISS، مما يجعله متوافقًا مع الكثير من برامج الراديو الموجودة مسبقًا، بما في ذلك برامج APRS ونواة Linux.

تمكين وضع KISS

• افتح وحدة تحكم تسلسلية واتصل بجهاز MeshTNC
• serial mode kiss

الخروج من وضع KISS

• للخروج من وضع KISS والعودة إلى وضع واجهة سطر الأوامر، يمكنك إرسال تسلسل خروج KISS كما يلي: echo -ne '\xC0\xFF\xC0' > /dev/ttyUSBx
  • لكي يعمل هذا، تأكد من ضبط إعدادات المنفذ التسلسلي ومعدل الباود بشكل صحيح باستخدام stty

APRS عبر LoRa

يمكنك استخدام أدوات APRS المفضلة لديك مع MeshTNC. ببساطة اختر ترددًا، ضع الراديو في وضع KISS واتصل بأدوات APRS كجهاز KISS TNC.

• minicom -D /dev/ttyACM0
  • set radio 918.25,500.0,7,5,0x16
  • serial mode kiss

برامج APRS

يجب أن يعمل MeshTNC مع العديد من عملاء APRS، وقد اختبرناه على ما يلي:

• xastir
• APRSisce32

AX.25 عبر LoRA

هناك ثروة من المعرفة والأمثلة متاحة هنا: https://linux-ax25.in-berlin.de/wiki/AX.25

هناك العديد من الأشياء المثيرة للاهتمام التي يمكن القيام بها مباشرة عبر AX.25 دون استخدام IP، لكن المثال التالي سيوضح كيفية تعيين عنوان IP لواجهة AX.25. يمكن القيام بذلك على جهازين مختلفين باستخدام MeshTNCs، ويجب أن تكون قادرًا على عمل ping بينهما عبر الهواء، طالما أن إعدادات الراديو على كلا الجهازين متطابقة، وعناوين IP المعينة على كل نظام في نفس الشبكة الفرعية ومختلفة عن بعضها البعض، وتختلف معرفات النداء (أو على الأقل SSID) على كل نظام. سيعمل توجيه IP أيضًا إذا تم تكوينه بشكل صحيح!

بداية سريعة لـ AX.25

• قم بتوصيل MeshTNC بنظام Linux.
• عيّن إعدادات الراديو المناسبة على واجهة سطر الأوامر لـ MeshTNC
• ادخل وضع KISS على واجهة سطر الأوامر لـ MeshTNC
  • بعد الدخول إلى وضع KISS، يرجى الخروج من برنامج الطرفية لتحرير المنفذ التسلسلي.
• على نظام Linux المتصل، قم بتحرير ملف /etc/ax25/axports:
  • أضف السطر التالي:
    • 0 AL1CE-1 115200 220 2 AX25 test
    • استبدل AL1CE-1 بمعرف النداء و SSID الخاصين بك
• قم بتوصيل MeshTNC بمنفذ AX.25 باستخدام: kissattach /dev/ttyACM0 0
  • بعد تشغيل هذا الأمر، تحقق من الواجهة التي تم إنشاؤها: sudo dmesg | grep mkiss
    • [88447.885556] mkiss: ax0: crc mode is auto.
• يمكنك تعيين عنوان IP عن طريق تشغيل: ip addr add 10.10.10.10/24 dev ax0

إيثرنت عبر LoRa

قم بتشغيل ما يلي على جهازين أو أكثر، كل منها متصل بجهاز MeshTNC، لإنشاء شبكة إيثرنت عبر LoRa.

• قم بتثبيت tncattach
  • git clone https://github.com/markqvist/tncattach.git
  • cd tncattach
  • make
  • sudo make install
• minicom -D /dev/ttyACM0
  • set radio 916.75,500.0,5,5,0x16
  • serial mode kiss

على الجهاز الأول

• sudo tncattach --mtu=230 -e -noipv6 --ipv4=10.10.10.10/24 /dev/ttyACM0 115200

على الجهاز الثاني

• sudo tncattach --mtu=230 -e -noipv6 --ipv4=10.10.10.11/24 /dev/ttyACM0 115200