لماذا نتعب أنفسنا
لأن بعض الأمور لا تكون صحيحة إلا تعليمة واحدة في كل مرة. المقرر الذي يعلّم 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 عاديًا.
- المشروع مسطح البنية. أسماء الملفات لا تحمل مجلدات، لذا فإن مسار التضمين بعمق مجلد واحد.
Related
- محرر الكود والترجمة
- مصحح الأخطاء
- لوحة الخصائص
- لغة التجميع AVR في المتصفح: مشروع البداية للوميض سطرًا سطرًا، وعدّ الدورات، ومقاطعة مؤقت
- الترجمة في المتصفح: كيف
.Sis preprocessed, assembled and linked