Table of Contents

تصلح لوحة SenseCAP M1 كعتاد لبوابة LoRaWAN، لكن أسلاكها تحتاج إلى تدقيق أكبر مما يقدمه دليل عام للوحات Raspberry Pi HAT. يوسّع هذا الدليل تحقيق Clockwork Bird المنشور عام 2023 بوثائق الشركة المصنّعة وفحص برنامج تشغيل upstream وإرشادات GPIO الحالية. ستحدّد العتاد، وتفصل بين الحقائق المؤكدة وأدلة مخطط الأطراف غير المكتملة، وتنشئ سجل إعداد قابلًا للتكرار.

النطاق: هذا دليل عتاد مبني على الوثائق. لم تُختبر الأوامر وخرائط اللوحة على جهاز M1 فعلي لهذا المقال.

أهم النقاط

  • حدّد اللوحتين: لكل من حامل M1 والمركّز القابل للإزالة طراز ومراجعة مستقلان.
  • راجع نصوص إعادة الضبط: تتعارض القيم الافتراضية لـ CoreCell مع إشارات في مخطط أطراف M1 المنشور.
  • افحص واجهات النظام: تجيب ملفات أجهزة SPI وترقيم GPIO وإصدارات أدوات GPIO عن أسئلة مختلفة.
  • حافظ على تهيئة عنصر الأمان: قراءة معلومات الجهاز تختلف عن تكوينه أو إنشاء المفاتيح.
  • تحقق من المسار كاملًا: اكتشاف المركّز لا يثبت وصول بيانات المستشعر.

قبل البدء

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

العنصرالغرض
لوحة M1 والمركّزقراءة مراجعة الحامل والملصق الكامل للوحدة
Raspberry Pi 4البدء بالمضيف المستخدم في تصميم M1 الأصلي
بطاقة microSD احتياطيةتجهيز نظام تشغيل منفصل مع الحفاظ على التثبيت الأصلي
مزود الطاقة والهوائي المناسبانالمطابقة مع التجميع ونطاق RF الخاص بالوحدة
SSH أو وحدة تحكم محليةتسجيل التشخيصات وتحرير الإعدادات
مستشعر وخادم LoRaWANالتحقق من وصول بيانات التطبيق فعليًا بعد تشغيل العتاد
مقياس وخبرة بالعتادحسم التوصيلات غير الموثقة قبل تشغيلها

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

حدّد الطبقات الثلاث

جهاز M1 الكامل وحامل اللوحة والمركّز مكونات مختلفة. توثّق Seeed نقطة الاتصال الكاملة على أنها Raspberry Pi 4 مع مركّز WM1302/SX1302 أو WM1303/SX1303. لا يثبت اسم منتج «SenseCAP M1 shield» أيًّا من هذين الجزأين يأتي مع الحامل. نظرة عامة على M1 من Seeed Studio

يوصل الحامل الطاقة والإشارات الطرفية بين Pi والوحدة. ويتولى المركّز استقبال الإشارات الراديوية وإرسالها. ويعمل مُرحّل الحزم على المضيف لتبادل الحزم الراديوية المستلمة وعمليات الإرسال الهابطة المجدولة مع خادم. نظرة عامة على SX1302 HAL من Semtech

على سبيل المثال، يرسل مستشعر حرارة رفّية وصلة صاعدة عبر الراديو. يستقبلها المركّز، ثم يمررها المضيف، وتعالجها خدمات الشبكة والتطبيق. يثبت إقلاع Linux جزء المضيف فقط من هذه السلسلة.

تُظهر صورة Clockwork Bird حامل M1 v1.1 مع وحدة تحمل بوضوح الملصق WM1302-SPI-EU868. استخدم الصورة لتحديد مواضع الملصقات على جهازك. الأرقام التسلسلية تحدد المعدات المصوّرة، لا قيم إعداد بوابة أخرى.

حامل M1 أخضر يضم وحدة WM1302 SPI EU868 تحمل ملصقًا، بجانب USB-C والزر ومقبس المروحة وكابل الهوائي

عتاد M1 v1.1 صوّره Clockwork Bird، واستُخدم أيضًا لغلاف هذا المقال · Clockwork Bird, 2023-05-03

توصيلات الطاقة والراديو

تعامل مع موصل USB-C في M1 كمدخل للطاقة. تحدد الشركة المصنّعة طاقة DC بجهد 5 V وتيار 3 A للبوابة كاملة، وتعرّف USB-C بواجهة مزود الطاقة. وصفه بمنفذ شحن يوحي بوظيفة بطارية لا تظهر في المواصفات. مواصفات SenseCAP M1

يفصل مخطط الكتل لدى الشركة المصنّعة مصدر 5 V عن خط 3.3 V المنظّم للوحدة. يهم هذا التمييز عند استكشاف الأعطال: قد يعمل Pi بينما لا تصل الطاقة إلى المركّز. لا تحقن 5 V في طرف إشارة، ولا تفترض أن مدخلي الطاقة معزولان عن بعضهما.

تحتاج نسختا SPI وUSB من الوحدة إلى توصيلين مختلفين بالمضيف. تصف وثائق WM1302 من Seeed اتصال SPI مباشرًا لطراز SPI وجسر USB من نوع STM32L4 لطراز USB. يصف شكل mini-PCIe هيئة الوحدة، بينما الواجهات الكهربائية الموثقة هي SPI أو USB. لا يكفي تطابق الشكل مع مقبس حاسوب محمول لإثبات التوافق. وثائق WM1302 من Seeed

قبل توصيل التجميع بالطاقة، ثبّت الوحدة والطاقة مفصولة ووصل هوائيًا مناسبًا. طابق عتاد RF والهوائي وخطة النطاق الإقليمية المقصودة. لا يغيّر اسم ملف إعداد مكونات RF، ولا يثبت مقبس طاقة M1 دعم نسخة مركّز USB.

مخطط كتل يربط Raspberry Pi 4 بلوحة M1 عبر الطاقة وSPI وGPIO وI2C

مخطط الشركة المصنّعة SenseCAP المعاد نشره في مقال Clockwork Bird الأصلي، ويعرض تصميم WM1302 · Seeed Studio / SenseCAP, via Clockwork Bird

اقرأ مخطط الأطراف بعناية

سجّل أرقام GPIO بنظام BCM وأرقام الأطراف الفعلية في عمودين منفصلين. فمثلًا، يقع BCM GPIO17 على الطرف الفعلي 11 في موصل Pi. ويضيف موصل حافة الوحدة نظام ترقيم ثالثًا، لذلك رقم طرف إعادة الضبط فيه ليس رقم GPIO في Raspberry Pi.

ينقل الجدول التالي التوصيلات الواردة في صورة الرأس المعلّمة من Clockwork Bird. إنه مرجع مجتمعي، لا مخطط كامل صادر عن الشركة المصنّعة ولا قياس لكل مراجعات M1. كما يستخدم الرسم تسميات SX1262، بينما يستخدم نص إعادة الضبط العام لدى Semtech أسماء SX1261.

الإشارة في الرسمBCM / الطرف الفعليالتفسير
I2C SDA / SCLGPIO2 / 3، GPIO3 / 5ناقل إدارة مشترك
إعادة ضبط SX1302GPIO17 / 11مرشح لإعادة ضبط المركّز
LED المستخدمGPIO22 / 15توضيح M1
SPI MOSI / MISOGPIO10 / 19، GPIO9 / 21إشارات بيانات SPI
ساعة SPIGPIO11 / 23إشارة ساعة SPI
اختيار SX1302GPIO8 / 24SPI0 CE0
إعادة ضبط SX1262GPIO5 / 29مرشح لإعادة ضبط الراديو الإضافي
اختيار SX1262GPIO6 / 31GPIO6، منفصل عن SPI0 CE1
SX1262 BUSYGPIO18 / 12خرج حالة الراديو الإضافي
SX1262 IO1 / IO2GPIO23 / 16، GPIO24 / 18إشارات إضافية يجب التحقق منها قبل استخدامها

لا تثبت ملاحظات GPS/UART المشطوبة وجود GPS في M1. اترك إعدادات GPS خارج إعدادك ما لم يتوفر GPS في جهازك. كما لا يحسم الرسم المنشور توصيل زر المستخدم أو التحكم بالمروحة. تحقيق Clockwork Bird في مخطط الأطراف

رسم معلّم لموصل Raspberry Pi يعرض LED في M1 وإعادة ضبط المركّز وإشارات SPI وتوصيلات GPS المشطوبة

مرجع معلّم من المجتمع لا يغطي جميع مراجعات اللوحة، وليس مخطط M1 كاملًا · Clockwork Bird, 2023-05-03

عالج تعارضات نصوص إعادة الضبط

يختار نص إعادة الضبط مخارج كهربائية، لا تفضيلات برمجية فحسب. يستهدف reset_lgw.sh من Semtech تصميم CoreCell المرجعي. تشمل قيمه الافتراضية GPIO23 لإعادة ضبط المركّز، وGPIO18 لتمكين الطاقة، وGPIO22 لإعادة الضبط الإضافي، وGPIO13 لإعادة ضبط AD5338R. مصدر نص إعادة الضبط من Semtech

تغيّر تعليمات الإعداد القديمة لدى Seeed تعييني إعادة الضبط إلى GPIO17 وGPIO5، لكنها تُبقي المدخلات الأخرى الخاصة بالتصميم المرجعي. قارن هذه القيم بصورة M1 المعلّمة قبل اتباع المثال. تعليمات إعداد WM1302 من Seeed

التعيينالدليل المتعارضالقرار المطلوب
GPIO22 كإعادة ضبط إضافيةتسمّيه صورة M1 LED المستخدمأزل هذا الافتراض قبل تمكين LED
GPIO18 كتمكين للطاقةتسمّيه صورة M1 إشارة BUSY إضافيةتحقق من الشبكة واتجاه الإشارة قبل قيادتها
GPIO13 لإعادة ضبط DACيسمّي النص العام تصميمًا مرجعيًا مختلفًاتحقّق من وجود الدائرة
جهاز SPI إضافيتختار صورة M1 GPIO6 بدلًا من CE1تحقق من توصيل اختيار الشريحة ودعم برنامج التشغيل

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

افصل كل مصادر الطاقة، ثم تتبّع التوصيلات التي يمكن الوصول إليها بين الرأس وموصل الوحدة. سجّل مراجعة اللوحة والطرفين. تثبت نتيجة الاستمرارية وجود اتصال، بينما توضح وثائق المكوّن اتجاه الإشارة وحدودها الكهربائية.

استخدم مخطط الوحدة أدناه لتجنب الخلط بين أطراف موصل الحافة وأطراف رأس Pi. تصف تسميات الراديو الإضافي مرجع الوحدة المنشور، ولا تثبت تطابق الشرائح أو الميزات المدعومة في كل مراجعة. مخطط أطراف وحدة WM1302 من Seeed

مخطط Seeed يبيّن جانبي موصل حافة WM1302 مع الطاقة وSPI وI2C وإشارات الراديو الإضافية

يختلف ترقيم موصل حافة الوحدة عن ترقيم رأس Raspberry Pi · Seeed Studio, WM1302-doc

جهّز Raspberry Pi OS

سجّل بيئة المضيف على التثبيت الاحتياطي:

cat /etc/os-release
uname -r
tr -d '\0' < /proc/device-tree/model

يشكل إصدار النظام والنواة وطراز Pi نقطة بداية قابلة للتكرار. سجّلها قبل مقارنة نتائجك بدليل أقدم.

ثبّت أدوات الفحص والبناء:

sudo apt update
sudo apt install git build-essential i2c-tools gpiod
sudo raspi-config

فعّل SPI وI2C في Interface Options ثم أعد التشغيل. يستخدم SPI لمسار المركّز، ويدعم I2C أجهزة الإدارة المذكورة لاحقًا. لا تستورد تغييرات منفذ GPS التسلسلي غير المرتبطة من دليل HAT آخر.

افحص الواجهات المكشوفة:

ls -l /dev/spidev* /dev/i2c-*
i2cdetect -l
gpiodetect
gpioinfo
gpioset --version

تسرد هذه الأوامر ملفات الأجهزة والمحولات ووحدات تحكم GPIO والخطوط وإصدار أداة GPIO المثبتة. يعرض i2cdetect -l المحولات دون فحص عناوين الأجهزة. يثبت وجود /dev/spidev0.0 إتاحة واجهة SPI، لا اتصالها بمركّز يعمل. دليل i2c-tools ، إرشادات GPIO من Raspberry Pi

راعِ إصدارات GPIO

لا تنسخ أرقام GPIO العامة من جهاز آخر. تستخدم النصوص القديمة /sys/class/gpio، وهي واجهة يعدّها توثيق النواة مهجورة. ينبغي للتكاملات الجديدة في مساحة المستخدم أن تستخدم واجهة جهاز أحرف GPIO مع وحدة التحكم وإزاحة الخط الصحيحين. توثيق Linux GPIO

افحص أيضًا gpioset --help قبل تعديل نص. تختلف الصياغة وسلوك العمليات بين الإصدارين 1 و2. تحتفظ الأداة الحالية بالخطوط المطلوبة افتراضيًا، لكن العقد القابل للنقل لا يضمن حالتها بعد انتهاء العملية. توثيق gpioset في libgpiod

توثّق Raspberry Pi سلوك استمرار حالة المخارج في نواتها، وتعرض خيارات لتغييره. سجّل إعداد النواة الفعلي بدل افتراض أن كل أنظمة Linux تتصرف بالطريقة نفسها. لا يحل تحديث الترقيم أو الأداة مشكلة خريطة كهربائية غير صحيحة. دليل استخدام GPIO من Raspberry Pi

اختبر LED المستخدم

بعد التحقق من اتصال GPIO22 بالـ LED وإزالة مستخدمي GPIO المتعارضين، حرّر إعداد الإقلاع:

sudoedit /boot/firmware/config.txt

تثبت إصدارات Raspberry Pi OS الحديثة إعداد الإقلاع في /boot/firmware/config.txt. تستخدم الصور القديمة /boot/config.txt، وهو المسار الوارد في مقال 2023. أنشئ نسخة احتياطية من الملف النشط قبل تحريره. توثيق config.txt من Raspberry Pi

أضف طبقة LED تحت قسم ينطبق على Pi لديك، مثل [all]:

dtoverlay=gpio-led,gpio=22,label=lorawan,trigger=heartbeat

تستخدم قيمة gpio أرقام BCM. وتسمي label جهاز LED في Linux، بينما يعيّن trigger=heartbeat مشغل نبضات النواة. يذكر Clockwork Bird هذا التعيين في M1، وتوثق مرجعية طبقات Raspberry Pi هذه القيم. ملاحظة LED الأصلية ، مرجع طبقة gpio-led

بعد إعادة التشغيل، افحص LED المسجل:

ls -l /sys/class/leds/
cat /sys/class/leds/lorawan/trigger

النتيجة المتوقعة مدخل LED باسم lorawan مع اختيار heartbeat بين قوسين مربعين. يثبت وميض LED عمل مسار GPIO وبرنامج التشغيل، لكنه لا يثبت التسجيل في LoRaWAN أو استقبال الراديو أو حالة Helium.

افحص أجهزة I2C

عنوان I2C دليل، لا هوية جهاز. لاحظ Clockwork Bird استجابات عند 0x60 و0x39، ثم قرأ معلومات ATECC608 عبر مكتبة التشفير. بقي تحديد مستشعر الحرارة في المقال الأصلي افتراضيًا.

ابدأ بقائمة المحولات من القسم السابق. ترسل عمليات الفحص الواسعة في i2cdetect معاملات استطلاع، ولا تراقب الحركة بشكل سلبي، ويحذر الدليل upstream من احتمال تعطيل الأجهزة. تجنب الفحص الروتيني لبوابة تعمل أو لأجهزة متصلة مجهولة. سلوك الاستطلاع في i2c-tools

الملاحظةالاستنتاج المدعومالسؤال غير المحسوم
استجابة عند 0x60استجاب شيء ما للاستطلاعهل هو عنصر الأمان المتوقع؟
استجابة عند 0x39استجاب شيء ما للاستطلاعأي مكوّن ومراجعة استجابا؟
UU في الفحصيملك برنامج تشغيل العنوان، فتُرك الاستطلاعأي برنامج تشغيل يملكه؟
لا توجد استجابةلم يتلق الاستطلاع تأكيدًاهل السبب الطاقة أو الناقل أو الملكية أو بروتوكول الجهاز؟

عزّز احتمال مستشعر الحرارة

STTS751 مرشح للعنوان 0x39 تدعمه المصادر. يربط ملف رأس برنامج تشغيل الحرارة لدى Semtech العنوان 0x39 صراحةً بـ STTS751-0DP3F. يعزز ذلك الفرضية الأصلية دون تحديد جميع اللوحات المزودة بهذا العنوان. ملف رأس برنامج STTS751 من Semtech

بعد تحديد مكوّن متوافق والتأكد من عدم استخدام عملية أخرى له، اقرأ سجلات تعريفه بهذه الأوامر:

sudo i2cget 1 0x39 0xfd b
sudo i2cget 1 0x39 0xfe b

هنا تختار 1 الناقل الذي جرى التحقق منه، ويختار 0x39 الجهاز، ويطلب b قراءة بيانات بايت عبر SMBus. في STTS751-0، معرّف المنتج الموثق عند 0xFD هو 0x00، ومعرّف الشركة المصنّعة عند 0xFE هو 0x53. تحدد هذه المعاملات عناوين السجلات ولا تكتب قيم إعداد. ورقة بيانات STTS751، خريطة السجلات وسجلات التعريف

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

افحص عنصر الأمان

ATECC608 مكوّن مصادقة مستقل. تعامل مع الإعداد والرقم التسلسلي والمفتاح العام ومواد المفتاح المحمية كمفاهيم منفصلة. لا تكشف قراءة المفتاح العام المفتاح الخاص المقابل.

توفر CryptoAuthLib من Microchip واجهة الجهاز. ويضم مستودع cryptoauthtools أمثلة مبنية على المكتبة. جهّز المكتبة الأصلية وارتباطات Python للنظام المستهدف وفق تعليمات المشروعين قبل تشغيل مثال. لا يثبت تثبيت حزمة Python غير مرتبطة أو نسخ نص منفرد عمل خلفية I2C. CryptoAuthLib من Microchip ، cryptoauthtools من Microchip

من مجلد cryptoauthtools/python/examples مجهز، نفّذ أمر الفحص الوارد في المقال الأصلي:

sudo python3 info.py -i i2c

يحدد الوسيط -i i2c الواجهة. مع بيئة افتراضية، استخدم مفسر Python الخاص بها صراحةً وتأكد من عثوره على المكتبة الأصلية المطابقة. في كثير من التثبيتات يختار sudo python3 مفسر النظام، ما يفسر بعض أخطاء استيراد الوحدات.

يقرأ info.py الذي جرى فحصه معلومات المراجعة والرقم التسلسلي والإعداد وحالة القفل. عند قفل منطقة البيانات، يحاول جلب المفتاح العام من الفتحة 0. ولا ينفذ تسلسل تهيئة المثال. لا يثبت فشل قراءة المفتاح العام من الفتحة 0 وحده تعطل الجهاز. مصدر info.py من Microchip

المخرج أو العمليةالمعنى
قفل الإعدادقيود الإعداد سارية
قفل منطقة البياناتفسّر الوصول وفق سياسات الفتحات المهيأة
عرض المفتاح العامجلب معلومات عامة، لا تصدير مفتاح خاص
تشغيل config.pyمثال تهيئة يتضمن كتابة الإعداد والقفل وإنشاء المفاتيح

لا تشغّل config.py لإصلاح خطأ فحص. يتضمن مصدره كتابات للإعداد واستدعاءات لقفل المناطق وإنشاء المفاتيح. كما يهم مسار إنشاء المفتاح الافتراضي على جهاز مهيأ بالفعل. مصدر config.py من Microchip

توضح ملفات التهيئة الموثقة من Microchip أن قفل منطقة البيانات لا يعني أن لكل الفتحات أذونات وصول متطابقة. ولا تثبت هذه الملفات إعداد M1 الدقيق. احتفظ بالإعداد الموجود وراجع وثائق الجزء المطابق قبل التخطيط لإعادة استخدام تتضمن مفاتيح. سياسات الذاكرة والوصول للفتحات من Microchip

عالج الأسئلة المفتوحة عن المروحة والزر

لا يحدد مقبس مروحة بثلاثة أطراف جهدها أو قطبيتها أو طريقة التحكم بها. صوّر ترقيم الأطراف واقرأ ملصق المروحة. تحقّق من توصيل الطاقة والتحكم قبل توصيل بديل أو اختيار طبقة GPIO.

وبالمثل، لا يحدد التحقيق الأصلي GPIO الخاص بالزر. ابحث عن برنامج تشغيل أو إعداد مرتبط بمراجعة اللوحة، ثم تحقق من الاتصال والطاقة مفصولة. لا تعيّن كل GPIO يبدو غير مستخدم كمخرج للعثور على الزر.

الطرفيةالأدلة المطلوب جمعهاشرط القبول
طاقة المروحةتصنيف المروحة وأرضي الموصل ومصدرهيطابق مصدر الطاقة المقاس مواصفات المروحة
التحكم بالمروحةبرنامج تشغيل/إعداد أو دائرة تحكم متتبعةسلوك محدد عند بدء التشغيل وارتفاع الحرارة
زر المستخدمأسلاك نقاط التلامس وخريطة GPIO وقطبية الدخلتنتج ضغطة واحدة مقصودة الحدث المتوقع

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

اختر حزمة برامج البوابة

افصل دعم اللوحة عن بروتوكول الخادم. لا يصلح خادم LoRaWAN متوافق تسلسل إعادة ضبط خاطئًا أو معايرة RF غير صحيحة. اختر أولًا برنامجًا يدعم المركّز وأسلاك الحامل ونظام التشغيل والإعداد الإقليمي.

مسار البرنامجالدور المفيدما يجب فحصه قبل النشر
Semtech SX1302 HALتشغيل أولي وأدوات تشخيص على مستوى المصدرنص إعادة ضبط اللوحة وإعداد الوحدة
LoRa Basics Stationاتصال مصادق عليه بين البوابة والخادمتكامل اللوحة وبيانات اعتماد الخادم
ChirpStack Concentratordخدمة مخصصة للمركّزالطراز المدعوم والمعايرة وخريطة GPIO

تدرج ChirpStack طراز SPI باسم seeed_wm1302. يثبت ذلك دعم الوحدة، لا وجود صورة M1 كاملة أو دعم كل مراجعات M1. لا تعامل تعليمات تثبيت SenseCAP M2 المنفصلة كتعليمات برامج ثابتة لـ M1. دعم العتاد في ChirpStack ، هدف تثبيت Seeed في ChirpStack

توصي وثائق The Things Stack باستخدام LoRa Basics Station بدل مُرحّل Semtech UDP القديم. يوفر Station بروتوكول TLS والمصادقة بالرموز إلى جانب ميزات الإعداد المركزي. تفيد أمثلة UDP لفهم ترحيل الحزم، لكن إعداد عنوان الخادم فيها لا يوفر هذه الحمايات. إرشادات UDP لـ The Things Stack ، وثائق LoRa Basics Station

جهّز أدوات upstream

ابنِ الأدوات على Pi المستهدف في مجلد عمل جديد:

git clone https://github.com/Lora-net/sx1302_hal.git
cd sx1302_hal
git rev-parse HEAD
make

احفظ مع مخرجات البناء معرّف الالتزام. يثبت اكتمال البناء التوافق مع المترجم، لكن الراديو يحتاج أيضًا إلى تنفيذ إعادة ضبط موثوق وإعداد صحيح. توضح وثائق Semtech وظيفة HAL وأدواته المساعدة. وثائق بناء وأدوات SX1302 HAL

راجع ملف إعادة الضبط قبل تشغيل أدوات الوصول إلى العتاد:

sed -n '1,180p' tools/reset_lgw.sh

لا تنسخ هذا الملف إلى مجلد التشغيل دون تغيير. توثّق Semtech الاستخدام التلقائي لنص إعادة الضبط بواسطة برامج الوصول إلى العتاد، بما فيها أدوات التعرف. يجب أن يغطي فحصك كل طرف مُعيّن واتجاه الإشارة وواجهة GPIO وحالة بدء التشغيل والإغلاق.

بعد التحقق من اللوحة، اتبع تعليمات الحزمة المختارة لقراءة EUI للمركّز وتسجيل البوابة. حافظ على معايرة الوحدة وإعدادات RF عند إضافة إعداد الخادم. في إعداد Semtech UDP، يمثل gateway_ID الـ EUI، بينما يمثل Gateway ID في وحدة تحكم The Things Stack معرّف التسجيل المقروء للبشر. إعداد البوابة في The Things Stack

أثبت وصول بيانات المستشعر

استخدم أدلة على مراحل لتحديد أول طبقة تتعطل. تثبت حالة البوابة على أنها متصلة وجود اتصال بالخادم. ويحتاج اختبار القبول أيضًا إلى مستشعر معروف وخطة تردد مطابقة وحمولة تطبيق مفكوكة الترميز.

التسلسل التالي خطة اختبار مقترحة، لا نتائج مقاسة على M1:

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

لمستشعر OTAA، تحقق أيضًا من تبادل التفعيل والوصلة الصاعدة اللاحقة. تعني OTAA التفعيل عبر الهواء، وهي عملية الانضمام التي تنشئ جلسة. لا يثبت استقبال طلب الانضمام نجاح الانضمام أو مسار الإرسال الهابط. وثائق التفعيل لدى The Things Stack

تشخيص عملي: تتصل البوابة بالخادم وتعرض EUI، لكن المستشعر لا يظهر. أعط الأولوية لإعداد إرسال المستشعر وقنوات الاستقبال المختارة ومسار الهوائي وسجلات الراديو. لن تعالج إعادة برمجة ATECC608 نقص الأدلة في هذا السيناريو.

تشخيص ثانٍ: تظهر حزمة المستشعر محليًا لكنها لا تصل إلى التطبيق. طابق وقت الحزمة مع أحداث البوابة والخادم، ثم افحص التوجيه وتسجيل الجهاز وفك الترميز. لا تكفي حزمة RF في سجل لإلقاء اللوم على مفكك الحمولة قبل قبول الخادم للحدث.

استكشاف الأخطاء حسب العَرَض

العَرَضافحص أولًاالإجراء التالي
لا يوجد ملف جهاز SPIإعداد الإقلاع النشط وخيارات الواجهةفعّل الواجهة المقصودة وأعد التشغيل
يوجد SPI والراديو لا يعملالطاقة والتثبيت وتسلسل إعادة الضبط واختيار الشريحةتحقق من المسار الكهربائي قبل تغيير الخادم
خطأ تصدير GPIOافتراضات sysfs القديمة والنواة المثبتةاستخدم تنفيذًا مراجعًا لواجهة GPIO
GPIO مستخدمالعملية الظاهرة في gpioinfoعالج الملكية قبل إعادة المحاولة
تعطل LED بعد الإعدادتطبيق الطبقة وتعارضات GPIO22افحص أجهزة LED المسجلة ونص إعادة الضبط
غياب جهاز I2Cرقم الناقل والطاقة والملكية الحاليةاستقصِ دون تكرار الفحوص الواسعة
فشل استيراد مكتبة التشفيرالمفسر والارتباطات ومسار المكتبة الأصليةأصلح بيئة البرنامج
فشل قراءة المفتاح العامسياسة الفتحة والقراءات الناجحة السابقةراجع الإعداد دون إجراء التهيئة
المروحة لا تعملمصدر الطاقة المؤكد وتنفيذ التبريدأعد التبريد قبل الاختبارات المستمرة
وصول وصلات صاعدة وفشل الانضماممسار الهبوط والإعدادات الإقليمية/إعدادات الجهازتتبّع رد الانضمام ونوافذ الاستقبال

تعامل مع كل تصحيح كتجربة واحدة. احفظ الإعداد السابق، وغيّر متغيرًا واحدًا، وكرر الفحص نفسه، وسجّل ظهور الدليل المتوقع من عدمه.

أنشئ سجل العتاد

استخدم هذا القالب لتحويل التحقيق إلى محضر تسليم قابل للتكرار:

مراجعة الحامل والصور:
طراز المركّز والواجهة ونطاق RF:
طراز المضيف / النظام / النواة / إصدار أداة GPIO:
مصدر الطاقة / الهوائي / ترتيب التبريد:
خريطة الأطراف المؤكدة والأدلة:
الشبكات غير المحسومة والميزات المستبعدة:
مستودع البرنامج والالتزام:
تنفيذ إعادة الضبط ومالك GPIO:
EUI البوابة / الخادم / خطة التردد:
تفعيل المستشعر ودليل الوصلة الصاعدة المفكوكة:
نتيجة الاسترداد بعد إعادة التشغيل:
موقع البطاقة الأصلية وإجراء التراجع:

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

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

الخطوات التالية

ابدأ بإكمال سجل العتاد وحسم اختلافات نص إعادة الضبط. ثم شغّل مستشعرًا معروفًا واحدًا واحفظ الأدلة حتى فك ترميز التطبيق قبل إضافة مزيد من الأجهزة.

سجل القبول: احفظ مراجعة اللوحة وملصق الوحدة ونطاق الراديو وقياس الطاقة وجهاز SPI النشط وأسماء خطوط GPIO وتسلسل إعادة الضبط وسجل المركّز واتصال الخادم ودليل وصلة صاعدة واحدة مفكوكة. علّم كل قيمة بأنها ملاحظة أو موثقة أو افتراض لم يُحسم. لا تعتبر بدء العملية دليلًا على أداء RF أو وصول بيانات التطبيق.

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

المصادر واعتمادات الصور

مراجعة البحث في 12 سبتمبر 2026. تشير روابط المستندات والمستودعات غير المؤرخة إلى الإصدارات التي روجعت لهذا المقال. تحتفظ الأشكال المحلية بتسمياتها وبيانات نسبها الأصلية.

الناشرالمصدر والتاريخ
Clockwork BirdSenseCAP M1 Raspberry Pi Shield ، 2023-05-03. صورة اللوحة ورأس معلّم ومخطط كتل الشركة المصنّعة المعاد نشره
Seeed Studio / SenseCAPنظرة عامة على M1 ومواصفاته ، دون تاريخ. نسبة مخطط الكتل الأصلي
Seeed Studioوثائق WM1302 ومخطط أطراف الوحدة ، مستودع
SemtechSX1302/SX1303 HAL ، ويتضمن مصدر نص إعادة الضبط وبرنامج تشغيل الحرارة المرتبطين
Raspberry Piإعداد الإقلاع ، دليل GPIO ، و مرجع الطبقات
Linux / libgpiodواجهة GPIO sysfs المهجورة و دليل gpioset ، والأخير مؤرخ في أغسطس 2026
i2c-toolsدليل i2cdetect ، مصدر v4.3
STMicroelectronicsورقة بيانات STTS751 ، المراجعة 7
MicrochipCryptoAuthLib ، cryptoauthtools ، و وثائق سياسة الوصول إلى الفتحات
ChirpStackدعم عتاد Concentratord و هدف تثبيت Seeed
The Things Industriesمُرحّل UDP ، LoRa Basics Station ، و تفعيل الأجهزة
Meshtasticوثائق MeshtasticD ، دون تاريخ