المحرر

كتابة لغة التجميع

لغة التجميع طريقة كاملة للبرمجة هنا: تبويب .S بجانب كودك، أو مشروع كامل بدون نواة Arduino تحته.

لماذا نتعب أنفسنا

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

طريقتان للدخول:

  • لغة التجميع بجانب الكود. أضف تبويب .S أو .s واستدعِه من C باستخدام extern "C". لا تزال نواة Arduino موجودة، لذا يظل Serial وmillis() وpinMode() يعمل.
  • لغة التجميع بدون نواة Arduino. اختر قالبًا بداية ضمن لغة التجميع (بدون Arduino) في قسم البرنامج الثابت من خصائص اللوحة. تصبح ملفات اللوحة ملف main.S واحدًا، ولا يُربط شيء سوى كودك الخاص وكود بدء التشغيل.

تبويبات .S و.s

اضغط + على شريط الملفات وسمِّ الملف. يخبرك الحوار بما هو مقبول: "اسم ملف جديد، مثل config.h أو helpers.cpp أو delay.S". أي ملف ينتهي بـ .S أو .s فهو لغة تجميع، ويُترجم ويُربط مع تبويبات .ino و.cpp للوحة نفسها، تمامًا كما يبني Arduino IDE ملف .S بجانب الكود.

التهجئتان ليستا الملف نفسه:

  • .Sبحرف S كبير، يمر أولًا عبر المعالج التمهيدي لـ C. #include <avr/io.h>, #define, #if و // التعليقات كلها تعمل، و __ASSEMBLER__ مضبوط. هذه هي التي تستخدمها.
  • .sبحرف s صغير، يُسلَّم للمجمِّع كما هو. لا تضمين، ولا وحدات ماكرو.

لا يبدأ تبويب .S أو .s الجديد فارغًا. يفتح مع دالة واحدة تعمل يمكن للكود استدعاؤها، بمجموعة تعليمات اللوحة نفسها: AVR على Uno وNano وMega وLeonardo وATtiny85، وARM Thumb على Pico ولوحات STM32 وUno R4 وmicro:bit وXIAO. التعليق فوقها يسرد اتفاقية الاستدعاء، فتكون القواعد أمامك أثناء الكتابة. احذفها أو ابنِ عليها.

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

الاستدعاء بين C ولغة التجميع

الدالة المكتوبة بلغة التجميع هي تسمية .global، وتصل إليها C عبر extern "C" حتى لا يتغير الاسم. يعمل الأمر في الاتجاهين: يمكن لغة التجميع استدعاء دالة C بالطريقة نفسها.

// sketch.ino
extern "C" uint8_t add_bytes(uint8_t a, uint8_t b);

void setup() {
  Serial.begin(9600);
  Serial.println(add_bytes(2, 40));   // 42
}

void loop() {}
; add.S
    .global add_bytes
add_bytes:
    add  r24, r22        ; a is in r24, b in r22
    ret                  ; the result goes back in r24

القواعد هي قواعد الشريحة نفسها، لا قواعد Mokxi، لذا فالدالة التي تتبعها تعمل أيضًا على لوحة حقيقية.

على لوحات AVR (يسميها المترجم GCC AVR calling convention):

  • تذهب الوسائط إلى r24، ثم r22، ثم r20، وتنازليًا بمقدار اثنين. الوسيطة المكونة من بايتين تأخذ زوجًا، البايت المنخفض أولًا: int في r25:r24.
  • تعود النتيجة في r24 لبايت واحد، وr25:r24 لبايتين، وr25:r22 لأربعة بايتات.
  • يجب أن يكون r1 صفرًا عند العودة. يفترضه المترجم في كل مكان، لذا فإن mul التي تغيّره تحتاج clr r1 بعدها.
  • السجلات من r2 إلى r17 وr28 وr29 ملك للمستدعي. ادفعها إذا استخدمتها، وأخرجها قبل ret. كل ما عدا ذلك لك أن تعبث به.

على لوحات ARM (معيار استدعاء إجراءات Arm القياسي):

  • تذهب الوسائط إلى r0 حتى r3، وتعود النتيجة في r0.
  • r4 حتى r11 تخص المستدعي: ادفعها ثم أخرجها.
  • عُد بـ bx lr، وعلّم التسمية بـ .thumb_func.

avr/io.h في ملف .S

على لوحة AVR، كتابة #include <avr/io.h> في ملف .S تعطيك أسماء السجلات والبتات، وتعمل تمامًا كما في avr-libc. وهذا مهم، لأن قاعدة واحدة تُوقع الجميع تقريبًا:

اسم السجل هو عنوان في الذاكرة، وليس عنوان إدخال/إخراج. فـ PORTB هو 0x25. عنوان الإدخال/الإخراج أقل بـ 32، لذا فإن in وout وsbi وcbi وsbic وsbis تحتاج _SFR_IO_ADDR(PORTB)، وهو 0x05:

    sbi  _SFR_IO_ADDR(DDRB), DDB5     ; PB5 is an output
    sts  TCCR1B, r16                  ; a high register, by its data address

إن كنت تفضّل كتابة الأسماء المجردة في كل مكان، ضع سطرًا واحدًا فوق التضمين فتصبح عناوين إدخال/إخراج بدلًا من ذلك، كما يفعل كود بدء التشغيل الخاص بـ avr-gcc نفسه:

#define __SFR_OFFSET 0
#include <avr/io.h>
    sbi  DDRB, DDB5

وبقية الترويسة تعمل أيضًا:

  • أسماء البتات. DDB5 وPINB5 وTXEN0 وWGM12 وOCIE1A وغيرها هي أرقام البتات، لذا فإن (1 << TXEN0) يُقرأ بالطريقة نفسها التي يقرأ بها ورق البيانات.
  • أسماء المتجهات. TIMER1_COMPA_vect هو __vector_11، لذا فإن .global TIMER1_COMPA_vect متبوعًا بالتسمية يجعل معالج مقاطعة تقفز إليه جدول المتجهات. وأنهِه بـ reti.
  • __zero_reg__ هو r1 و __tmp_reg__ هو r0، تحت تلك الأسماء.
  • السجلات بعد أول 64، مثل UCSR0B وTIMSK1، مُسندة إلى الذاكرة: اقرأها بـ lds واكتبها بـ sts.

لغة التجميع المضمّنة

بعض التعليمات داخل دالة C لا تحتاج إلى تبويب خاص بها. asm volatile مع القيود يعمل على لوحات AVR وARM:

uint8_t x = 5;
asm volatile ("lsl %0" : "+r" (x));   // x is 10

يحسب المحاكي الدورات، لذا فإن التأخير المكتوب يدويًا طوله فعلًا كما يقول ورق البيانات. حلقة من nop وdec وbrne مُوقَّتة بالمؤقّت 1 عند التردد الكامل، تعطي العدد نفسه تمامًا الذي يذكره ورق بيانات ATmega328P لتعليماته: تعليمة lds وتعليمة ldi و50 دورة من الحلقة تقيس 202 دورة، لا 201 ولا 203. هذا ما يجعل تعليم عدّ الدورات يستحق العناء هنا.

لغة التجميع بدون نواة Arduino

افتح لوحة الخصائص للوحة وابحث في قسم البرنامج الثابت. على Arduino Uno وNano وPro Mini بتردد 16 MHz وRaspberry Pi Pico وSTM32F411 Black Pill توجد مجموعة اسمها لغة التجميع (بدون Arduino) فيها أربعة قوالب بداية:

قالب البداية ماذا تفعل
الوميض بلغة التجميع يبدّل حالة LED اللوحة كل 250 ms عبر حلقة تأخير معدودة.
زر يضيء LED بلغة التجميع يتبع LED زرًا موصولًا بالأرض عبر مقاومة سحب.
تحية UART بلغة التجميع يطبع سطرًا على الشاشة التسلسلية مرتين في الثانية.
مقاطعة مؤقّت بلغة التجميع مقاطعة مؤقّت تبدّل حالة LED، وحلقة البرنامج الرئيسية لا تفعل شيئًا.

اختر أحدها فتصبح ملفات اللوحة ملف main.S واحدًا. إن كان لديك عملك الخاص على اللوحة، يُطلب تأكيدك أولًا. بعدها تحتفظ قائمة البرامج بقالب البداية الذي بدأت منه، وتذكر الملاحظة تحته أن زر «تشغيل» يجمع main.S بدون نواة Arduino، فتبقى اللوحة على لغة التجميع عند عودتك.

لا يوجد Arduino core في البناء: لا setup() ولا loop() ولا نبضة millis() ولا Serial. كل ما يتم ربطه هو هذا فقط:

  • على لوحة AVR، ملفك مع كود بدء التشغيل، وهو لـ avr-gcc main.S ما هو عليه gcrt1.o في avr-libc: جدول المتجهات حيث كل __vector_n عبارة عن reti ضعيف يمكنك تجاوزه، ثم تصفير r1، وضبط المكدس على RAMEND، ونسخ .data من الفلاش، وتصفير .bss، ثم call إلى main الخاصة بك. فأنت تكتب main وأي معالجات تريدها، بأسماء متجهات avr-libc. وإن عرّف ملفك قسم .vectors خاصًا به، فلن تحصل على أي كود بدء تشغيل ويصبح البرنامج كله لك.
  • على Pico وBlack Pill، لا شيء إلا ملفك. ملفك هو جدول المتجهات: .word _stack_top على Pico أو .word _estack على Black Pill، ثم .word Reset_Handler، ثم المعالجات التي تريدها، كل واحد منها .thumb_func.

ما تعدّه قوالب البداية، إن أردت قراءة السجلات معها:

  • وميض AVR يبدّل PB5 بكتابة 1 في PINB5، الذي يقرؤه ATmega328P على أنه «تبديل»، ويؤخّر بحلقة خارجية وحلقة داخلية: «250 ms عند 16 MHz هي 4,000,000 دورة: 40 ضرب 100,000»، والحلقة الداخلية أربع دورات لكل لفة.
  • زر AVR يقرأ PD2 مع تشغيل مقاومة السحب، فالضغط يُقرأ 0، ويستخدم sbic لتخطي سطر.
  • يضبط AVR UART المنفذ USART0 على سرعة 9600 baud بقيمة UBRR تساوي 103، ويُبقي النص في .progmem ويقرأه بايتًا بايتًا باستخدام lpm.
  • مؤقّت AVR يشغّل Timer 1 في وضع CTC عند التردد مقسومًا على 256 مع OCR1A بقيمة 31,249، أي كل 0.5 s، ويبدّل حالة LED في TIMER1_COMPA_vect.
  • يُخرج Pico كلًّا من IO_BANK0 وPADS_BANK0 (وUART0 في حالة UART) من RESETS، ويُشغّل GPIO25 عبر SIO على 0xD0000000، وينتظر عبر TIMERAWL، ويتواصل عبر UART0 على GPIO0 بسرعة 115200، ويستخدم مقاطعة الإنذار 0 في المؤقت TIMER لمُشغّل المؤقت.
  • يُشغّل Black Pill إشارات الساعة في RCC_AHB1ENR، ويُشغّل PC13 الذي يضيء عند انخفاضه، ويقرأ PA0 مع مقاومة السحب، ويطبع على USART1 عبر PA9 بسرعة 115200 بقيمة BRR تساوي 729، ويُشغّل SysTick بتردد 1 kHz.

اضغط «تشغيل» فتعمل اللوحة عليه. الشاشة التسلسلية وراسم الإشارة والمحلل المنطقي والقطع في مساحة العمل كلها تعمل كالمعتاد، لأن الشريحة المحاكاة لا تعرف ولا تهتم بأي لغة صنعت الصورة.

حين لا تتم التجميع

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

  • ldi r3, 5 يخبرك أن LDI يعمل على السجلات العليا فقط، من r16 إلى r31، وأن تستخدم mov لإنزال القيمة بعد ذلك إن احتجتها منخفضة.
  • lid r16, 5 يخبرك أن "lid" is not an AVR instruction، ويذكّرك بأن التسمية تنتهي بنقطتين وأن التوجيه يبدأ بنقطة.
  • التسمية المكتوبة بدون نقطتيها تُعاد إليك بالاسم مع إضافة النقطتين.
  • القفز الشرطي الذي لا يصل هدفه يضعه الرابط على سطره مع الحل: brne 1f، rjmp far، 1:.

أربعة منها فحوصات يقوم بها avr-as ولا يقوم بها مجمّع LLVM، لذا يقوم بها Mokxi نفسه، قبل تشغيل أي أداة. بدونها كان الخطأ سيتجمّع بصمت إلى البرنامج الخطأ:

  • ldi r16, 300 لا يتسع في بايت. حمّل النصفين بـ lo8() وhi8().
  • sbi PORTB, 5 يستخدم عنوان البيانات 0x25 بينما sbi يريد عنوان إدخال/إخراج. اكتب _SFR_IO_ADDR(PORTB).
  • add r16, 5 يُقرأ كـ add r16, r5، لأن ADD يأخذ سجلين. لا وجود لـ ADDI: اطرح السالب بـ subi r16, -5.
  • out PORTB, r16 بدون __SFR_OFFSET 0 تحذير لا خطأ، لأنه يتجمّع فعلًا: لكنه يكتب في سجل مختلف عن السجل المذكور.

يتم كشف in وout بعد عنوان الإدخال/الإخراج 63، وsbiw وadiw بعد 63، ورقم البِت بعد 7 بالطريقة نفسها، مع التعليمة البديلة المناسبة في كل حالة.

في لوحات Thumb تكون الأخطاء الشائعة: استخدام مسجّل عالٍ على Cortex-M0+، الذي لا يصل إلا إلى r0 حتى r7، وصيغة Thumb-2 بـ 32 بت على Cortex-M0+، الذي يحتوي على مجموعة 16 بت فقط، وقفزة خارج النطاق، وReset_Handler مفقود، وmain مفقود.

التنقل بين التعليمات

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

يحتوي تبويب Debug على قسم فك التجميع. عند التوقف يسرد التعليمات المحيطة بعدّاد البرنامج: العنوان، والبايتات، والتعليمة بصياغة llvm-objdump، وسطر المصدر الذي تبدأ عنده كل تعليمة، وهو زر ينقلك إليه. تُعلَّم التعليمة التي ستُنفَّذ. ينفّذ Step instruction تعليمة آلة واحدة بالضبط، بينما لا يزال Step over وStep into يتنقلان سطر مصدر كاملًا في كل مرة.

تُقرأ المسجّلات كما هي في المعالج نفسه. يُكتب sreg في AVR أيضًا كأعلامه ITHSVNZC، بنقطة لكل علم صفر، ويُكتب xpsr في ARM كـ N Z C V Q، لأن ثمانية بتات ليست عددًا.

الحدود

  • يتوفر لغة التجميع بدون Arduino core على Uno وNano وPro Mini وPico وSTM32F411 Black Pill. أما بقية اللوحات فلا تزال تقبل تبويبات .S و.s بجانب الكود.
  • عائلة ESP32 غير مشمولة. مجمّع Xtensa الخاص بـ Clang غير مكتمل للملفات المكتوبة يدويًا، لذلك تترجم تلك اللوحات C وC++ فقط.
  • لا يحتوي Pico W على مشاريع بداية. فـ LED الخاص به متصل بشريحة الشبكة اللاسلكية لا بطرف GPIO. استخدم Pico عاديًا.
  • المشروع مسطح البنية. أسماء الملفات لا تحمل مجلدات، لذا فإن مسار التضمين بعمق مجلد واحد.