كيف يعمل
Multi-file C: headers, macros and builds follows C من الصفر. تسلسلة من ستة دروس تعمل على منضدة الكود: Arduino Uno عليه مصباح أحمر على الطرف 13، وأصفر على 12، وأخضر على 11، وزر على الطرف 2. ينتقل المشروع إلى ESP32-C3.
يفتح كل درس كودًا يعمل في ملف واحد. تشغّله، وتقرأ الشاشة التسلسلية، ثم تنمّيه: تضيف الملف الثاني والثالث بنفسك من شريط التبويبات (fuel.cpp، rover.h، telemetry.cpp، config.h)، وتقرأ عمليات التحقق ما تطبعه اللوحة بعد أن تُبنى ملفاتك وتُربط. بعض الخطوات تطلب منك أن تعطّل البناء عمدًا أولًا، لتقابل كل خطأ ربط وأنت تعرف تمامًا ما الذي سبّبه.
الدروس
- ملفات كثيرة، برنامج واحد: المعالجة الأولية، وترجمة كل ملف على حدة، ثم الربط. الإعلانات مقابل التعريفات، وملف ثانٍ، وخطأ
undefined symbolالذي يظهر عندما يختلف ملفان. - الترويسات والحمايات: مركبة مقسّمة إلى
rover.hوrover.cpp، وما يلصقه#includeفعلًا، وترويسة تُقرأ مرتين والحماية التي تمنع ذلك، ولماذا يحتاج جسم الدالة في الترويسة إلىinline. - الماكرو وفخاخها: مربعٍ ينسى أقواسه، ودالة أقصى تقرأ الحساس مرتين، و
#وdo { } while (0)، ومتى تقوم الدالة بالمهمة أفضل. - الترجمة الشرطية:
#ifو#ifdef، وأسطر التنقيح التي لا تكلف شيئًا عند إيقافها، وبوابة إصدار، والشريحة التي يُبنى لها الكود، وقيمة افتراضية يستطيع المشروع تجاوزها. - extern وstatic: الربط ومدة الحياة. متغير عام يصل إليه ملف آخر عبر
extern، وstaticعلى مستوى الملف تحفظ اسمًا خاصًا، ومتغير static محلي يتذكّر. - أعلام البناء: كود يقرأ إعدادات البناء الخاصة به (
-std،-mmcu،-Os،-fno-exceptions)، وملف رأس للإعدادات بدلاً من أعلام-D، مع تخلّص الرابط من الكود الذي لا يستدعيه شيء، وكل ذلك مقيس في سجل البناء.
المشروع: شيفرة واحدة للوحتين
منارة تُبنى دون تغيير للـ Uno والـ ESP32-C3. الملف نفسه يطبع int is 2 bytes على واحدة وint is 4 bytes على الأخرى، ونفس الجمع يعطي 0 على الـ Uno و65536 على الـ C3. تجعل الجمع قابلًا للنقل عبر uint16_t، وتنقل كل اختلاف بين اللوحات إلى board.h محميّ، ثم تجعله لك: لوحة ثالثة، أو علم ميزة، أو ترويسة تنقيح.
ما الذي تفعله اللوحات بشكل مختلف
- مترجم الـ Uno يعرّف
__AVR__ومترجم الـ C3 يعرّف__riscv. تختبر الدورة هذه الأسماء، لأن المترجم يضبطها في كل بناء؛ أما أسماء بناء Arduino نفسه، مثلARDUINO_AVR_UNO، فتأتي فوقها. - حجم int هو 2 بايت على الـ Uno و4 على الـ C3، والمؤشر كذلك، وحجم double لا يتجاوز 4 بايت على الـ Uno.
- على الـ Uno تُنسخ النصوص إلى RAM عند الإقلاع، لذا يكلّف النصُّ ذاكرةَ RAM إضافة إلى الفلاش. سجل البناء يُظهر الاثنين.
- زر «تشغيل» في Mokxi، مثل Arduino IDE، يستخدم مجموعة ثابتة واحدة من أعلام المترجم (
-Os، وC++17، وبلا استثناءات). تضع المشاريع خياراتها في ترويسة إعداد تُضمّ أولًا، وهذا يعمل بالطريقة نفسها مع أي أداة بناء.
بعد هذا المسار
C++ الحديث للمتحكمات الدقيقة يستبدل كثيرًا من هذه الماكرو بـ constexpr وenum class والقوالب، والمؤشرات والذاكرة في لغة C يتعمّق في ما يضعه الرابط في RAM وأين يضعه.