الدرس 01

وميض PteronautOS

قم ببناء وتثبيت البرنامج الثابت المحكم باستخدام مستقبل CYCLONE ELRS 2.4GHz 7CH PWM RX كمثال.

يدعم PteronautOS لوحات مستقبل أخرى أيضًا. إن اشتراك ESP8285 لا يجعل توصيلاتها متطابقة: قد تختلف منافذ GPIO المكشوفة وتعيين القنوات ووصلات البرمجة ومراجعات PCB. تنطبق الطاقة وتوصيل CH2/CH3 أدناه على مثال CYCLONE هذا؛ تحقق من تخطيط أطراف لوحتك وتكوين العتاد المدعوم قبل توصيل مستقبل آخر.

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

01 · بناء البرنامج الثابت

أولاً قم ببناء WebUI — الواجهة التي تُدمج في برنامج المستقبِل الثابت. تتطلب هذه الخطوة Node.js 20 أو أحدث و npm. يحدد العلم I18N_LOCALES اللغات التي تُجمَّع؛ المثال أدناه يدمج لغة هذا الدرس بالإضافة إلى الإنجليزية. احذف العلم لتضمين اللغات الإحدى عشرة كلها.

cd src/html && nvm use 20 && I18N_LOCALES=ar,en npm run build:pteronautos

استنسخ المستودع، وثبّت PlatformIO، ثم نفّذ الأمر التالي من جذر المستودع. مشروع PlatformIO موجود في src؛ يبني هذا الأمر بيئة مستقبل ESP8285 المخصصة المستخدمة في هذا المثال.

cd ../.. && pio run -d src -e PteronautOS_ESP8285_2400_RX

02 · توصيل المستقبل

بالنسبة لمستقبل CYCLONE هذا، استخدم خرج الطاقة 5V لمحوّل FTDI لتغذية المستقبل، وليس خرج 3.3V. تقع وصلات UART على أطراف إشارة القناتين 2 و 3 — لا حاجة لتحديد منصات UART منفصلة.

محوّل FTDI	اتصال المستقبل
GND	GND (−)
5 فولت / VCC	التغذية (+)
TX	إشارة CH3 — RX المستقبل (GPIO3)
RX	إشارة CH2 — TX المستقبل (GPIO1)

يشير إعداد 5V إلى طاقة المستقبل. راجع توثيق المحوّل: يجب أن يستخدم TX/RX منطق 3.3V متوافقًا مع ESP8285 حتى عندما يكون خرج التغذية 5V. لا توصل مصدر طاقة ثانٍ في الوقت نفسه.

03 · الدخول إلى محمّل الإقلاع

اضغط مع الاستمرار على BOOT (GPIO0)، وافصل كابل USB الخاص بـ FTDI ثم أعد توصيله، وأبقِ BOOT مضغوطًا لنحو ثانية ثم حرّره. لا يقوم سكربت الوميض بإعادة تعيين تلقائية، لذا ادخل إلى محمّل الإقلاع يدويًا قبل تشغيله.

04 · كتابة الصورة

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

يُدمج العلم --lang أدناه لغة هذا الدليل مباشرة. احذفه للاختيار تفاعليًا — كل اللغات أو مجموعة مختارة أو تخطي إعادة البناء.

./scripts/flash.sh --lang ar

يبحث الاختيار التلقائي للمنفذ عن أجهزة macOS /dev/cu.*. إذا كانت عدة أجهزة تسلسلية متصلة، أو كنت تستخدم نظام تشغيل مختلفًا، فاختر منفذ محوّل المستقبل صراحةً. استبدل المثال أدناه بمسار جهازك الفعلي.

./scripts/flash.sh --lang ar --port /dev/cu.usbserial-XXXX

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

./scripts/flash.sh --port /dev/cu.usbserial-XXXX --check

05 · التحقق من التثبيت

أعد تشغيل المستقبل دون الضغط على BOOT. تأكد من توفر نقطة وصول WiFi وواجهة WebUI (SSID: Pteronaut OS ، كلمة المرور: flynatural )، ثم حمّل الإعدادات وتحقق من اسم الهدف قبل إعادة توصيل السيرفو.

تابع مع صفحة العتاد للاطلاع على خرائط الأطراف وملاحظات التوصيل الخاصة بالمراجعة.