SenseCAP M1 Raspberry Pi Shield: مخطط الأطراف وإعادة الاستخدام مع LoRaWAN

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 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.

مخطط الشركة المصنّعة 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 / SCL | GPIO2 / 3، GPIO3 / 5 | ناقل إدارة مشترك |
| إعادة ضبط SX1302 | GPIO17 / 11 | مرشح لإعادة ضبط المركّز |
| LED المستخدم | GPIO22 / 15 | توضيح M1 |
| SPI MOSI / MISO | GPIO10 / 19، GPIO9 / 21 | إشارات بيانات SPI |
| ساعة SPI | GPIO11 / 23 | إشارة ساعة SPI |
| اختيار SX1302 | GPIO8 / 24 | SPI0 CE0 |
| إعادة ضبط SX1262 | GPIO5 / 29 | مرشح لإعادة ضبط الراديو الإضافي |
| اختيار SX1262 | GPIO6 / 31 | GPIO6، منفصل عن SPI0 CE1 |
| SX1262 BUSY | GPIO18 / 12 | خرج حالة الراديو الإضافي |
| SX1262 IO1 / IO2 | GPIO23 / 16، GPIO24 / 18 | إشارات إضافية يجب التحقق منها قبل استخدامها |
لا تثبت ملاحظات GPS/UART المشطوبة وجود GPS في M1. اترك إعدادات GPS خارج إعدادك ما لم يتوفر GPS في جهازك. كما لا يحسم الرسم المنشور توصيل زر المستخدم أو التحكم بالمروحة. تحقيق Clockwork Bird في مخطط الأطراف

مرجع معلّم من المجتمع لا يغطي جميع مراجعات اللوحة، وليس مخطط 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

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

