نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج Arduino Leonardo (كل السجلات).
ما هي
شريحة ATmega32U4 في غلافها ذي 44 طرفًا، على نفس نواة AVR الموجودة في Uno، مع 32 KB من ذاكرة الفلاش، و2560 بايت من SRAM، و1 KB من EEPROM. تقع السجلات على عناوينها الحقيقية، لذا فالكود المبني هنا يعمل على اللوحة الموجودة على مكتبك. الصفحة المرجعية هي نموذج Arduino Leonardo.
يبلغ حجم اللوحة 68.6 في 53.3 مم (أبعاد Uno بدقة عُشر المليمتر)، ورؤوس الدروع (shields) تطابق Uno ثقبًا بثقب. ومثل Uno لا تدخل هذه اللوحة في لوحة التجارب: وصّلها بأسلاك توصيل من الرؤوس.
التسلسلي هو USB
هذه هي النقطة الأساسية التي يجب فهمها في Leonardo، وهي التي تُفاجئ القادمين من Uno.
في Uno تحوّل شريحة ثانية منفذ USB إلى UART، وSerial هو USART0 الخاص بالمتحكم الدقيق. أما في Leonardo فلا توجد شريحة ثانية: جهاز USB موجود على ATmega32U4 نفسه، وSerial هو نقطة نهاية CDC يفتحها البرنامج الثابت للكود نفسه. أما Serial1 فهو USART الحقيقي، ويخرج على الطرفين 0 و1 في الرأس.
إذن في المحرر:
- ما تطبعه إلى
Serialيظهر في الشاشة التسلسلية. - وما تطبعه إلى
Serial1يخرج من الطرف 1 على شكل بتات. وصّله بشيء ما (الطرف 0، أو راسم الإشارة، أو لوحة أخرى) وإلا فلن يصل إلى أي مكان.
برنامج التسلسلي المدمج يطبع إلى كليهما، لذا يظهر الفرق على الشاشة.
ينمذج Mokxi منفذ USB كـأنبوب بايتات عند سجلات نقطة النهاية الحقيقية: يكفي لمنفذ تسلسلي، ولا شيء فوق ذلك. لا يوجد تعداد (enumeration) ولا واصفات ولا مضيف، لذا فإن while (!Serial) {} يعود فورًا هنا بينما ينتظر على المكتب.
مكتبات Keyboard.h وMouse.h وJoystick.h تُبنى وتعمل. ولعدم وجود حاسوب في الطرف الآخر من الكابل، تُطبع كل ضغطة أو حركة أو تغيير زر إلى الشاشة التسلسلية كسطر بدلًا من ذلك ([Keyboard] press Ctrl). أما على اللوحة الموجودة على مكتبك فالبرنامج نفسه يصبح لوحة مفاتيح أو فأرة أو ذراع تحكم USB حقيقية.
البرنامج الذي يبنيه Mokxi يحمل جهاز USB تسلسليًا حقيقيًا للوحة الموجودة على مكتبك. عند إرساله إلى Leonardo أو Micro أو Pro Micro يظهر كمنفذ تسلسلي، وSerial يصل إلى الشاشة التسلسلية في Arduino IDE أو أي طرفية، وwhile (!Serial) ينتظر فتح المنفذ، ويمكن لزر الرفع إعادة تشغيله إلى محمّل الإقلاع (bootloader) بالطريقة نفسها التي يفعلها Arduino IDE.
Pins
عشرون طرفًا على رؤوس الدروع وثلاثة على رأس ICSP، مرقّمة بالطريقة التي ترقّمها بها الطباعة على اللوحة ونواة Arduino:
- من
0إلى13على طول الرأس الرقمي، مع LED الـLعلى الطرف 13. - من
A0إلىA5على طول الحافة السفلية. 14و15و16على رأس ICSP:MISOوSCKوMOSI(بالأسفل).A6إلىA11هي أسماء ثانية للأطراف الرقمية 4 و12 و6 و8 و9 و10، لأن ADC في هذه الشريحة يصل إلى المنفذين B وD إضافة إلى المنفذ F.
سبعة أطراف تدعم PWM عتاديًا مع analogWrite: وهي 3 و5 و6 و9 و10 و11 و13.
SDA وSCL هما الطرفان 2 و3، وليس A4 و A5 كما في Uno. الثقبان المجاوران لـ AREF هما نفس معدن الطرفين 3 و2. هذا هو المكان الوحيد الذي لا تتطابق فيه بصمة الدروع المشتركة مع الشريحة المشتركة، وهو أول ما يجب فحصه عند نقل كود من لوحة إلى أخرى.
SPI موجود على رأس ICSP فقط، وهي كتلة اللوحات 2x3 عند الحافة اليمنى، كما على اللوحة الحقيقية. لوحات MISO وSCK وMOSI فيه هي الأطراف 14 و15 و16، ولوحاته الثلاث الأخرى هي 5V ثانية وRESET وGND. الأطراف 11 و12 و13 ليست SPI في Leonardo، لذا فإن وحدة SPI موصّلة هناك كما في Uno لن تستجيب: انقل أسلاك الناقل الثلاثة إلى لوحات ICSP.
مؤقّت لا تملكه أي لوحة أخرى هنا
المؤقّت 4 في هذه الشريحة عرضه عشرة بتات، وقيمته العليا (TOP) سجلٌ وليست وضعًا، وقنوات المقارنة فيه هي A وB وD. لا توجد قناة C، لأن OCR4C هو TOP. يحرك هذا المؤقّت الطرفين 6 و13.
analogWrite hides all of that, so the sketch looks ordinary. The built-in
Fade program puts an LED on pin 13 and another on pin 9, which is an
ordinary 16-bit timer, so both kinds of PWM hardware are running at once: 976 Hz
on 13 and 490 Hz on 9.
Interrupts
خمسة أطراف فيها مقاطعة خارجية: 3 و2 و0 و1 و7. الطرف 7 هو الأكثر إثارة للاهتمام. إنه INT6، الوحيد الذي تُخرجه هذه اللوحة وليس من الأطراف الأربعة الأولى، وبرنامج Button المدمج يستخدمه.
مرّر رقم الطرف عبر digitalPinToInterrupt() ويتولى attachInterrupt() الباقي، كما على اللوحة الحقيقية.
مكتبات Arduino الرسمية
درس تعليمي يتضمن Servo.h و Wire.h و SPI.h و EEPROM.h و LiquidCrystal_I2C.h و Adafruit_GFX.h مع Adafruit_SSD1306.h و DHT.h يُترجم هنا كما هو. كل منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مبني على مشغّلات القطع في الصندوق، وليس أي منها كود المكتبة الأصلية.
Wire.begin()يضع ناقل I2C على2(SDA) و3(SCL).SPI.begin()يضع ناقل SPI على رأس ICSP:SCKهو 15، وMISOهو 14، وMOSIهو 16. أماSSفهو 17، طرف مصباحRX، ولا لوحة له، لذا أعطِ اختيار الشريحة (chip select) للوحدة أي طرف حر.- يستخدم
EEPROM.hذاكرة EEPROM الخاصة بالشريحة البالغة 1 KB، عبر سجلاتها الحقيقية. يحتفظ بما كتبته عبر الضغط على زر إعادة التشغيل في اللوحة، أما «تشغيل» جديد فيبدأ بها ممسوحة، كل بايت255، لأن «تشغيل» يعني لوحة جديدة. - مكتبة
Adafruit_NeoPixel.hتشغّل شريط WS2812. تُحسب توقيتات البت بلغة التجميع AVR، كما تفعل كل مكتبات NeoPixel على AVR، وعند 16 MHz يقع كل مستوى عالٍ داخل النافذة المحددة في ورقة البيانات. تُعطّل المقاطعات أثناء إرسال إطار، لذا يفقدmillis()نبضة عن كل ملّي ثانية يستغرقها إرسال شريط طويل، كما يحدث على المنضدة. تشغل الألوان ثلاثة بايتات لكل LED من أصل 2560 بايت من ذاكرة RAM الشريحة.
يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.
The firmware
أربعة برامج مدمجة: Blink وButton والتسلسلي وFade.
شيفرة مصدرية لكود مكتوب لـ Uno ستبنى عادةً لـ Leonardo. أما ملف ELF المترجم لـ Uno فلن يعمل عليها: شريحة مختلفة، وخريطة سجلات مختلفة، وجدول متجهات مختلف. ابنِه لـ Leonardo وسيعمل.
ما لم يُنمذج
طاقم USB فوق أنبوب البايتات: Keyboard, Mouse و Joystick يطبع تقاريرها إلى الشاشة التسلسلية بدلًا من الوصول إلى حاسوب. Serial هنا أنبوب بايتات بلا بروتوكول تحته: لا تعداد، لا واصفات، لا إعداد لنقطة النهاية، لا تعليق أو استئناف، ولا إعادة تشغيل بلمسة 1200 baud، لذا فإن الشيء الذي يجعل Leonardo لوحة مميزة (كود ينتظر while (!Serial)) هو قرار يتخذه هذا النموذج لا مصافحة ينفذها.
SPI وTWI/I2C، ومقارن الإشارات التناظرية، وحساس الحرارة، وPLL الذي كان يمكن أن يرفع تردد المؤقّت 4 فوق 16 MHz. الدروع ليست قطعًا مادية هنا؛ وصّل الدائرة نفسها على لوحة التجارب. لوحة Leonardo ETH غير منمذجة. أما لوحة Micro ولوحة Pro Micro فهما الشريحة نفسها بتصميمات أطراف أخرى، وتوجدان في صندوق القطع كلوحتين مستقلتين.
العناوين هي عناوين ورقة البيانات ولا يُخمَّن أي منها؛ التقريبات هي سلوكيات، والقسم 8 من نموذج Arduino Leonardo يفصّل كل واحدة منها. الثلاثة التي تظهر على المنضدة: ADC خالٍ من الخطأ (لا دائرة أخذ عيّنة وحفظ، لا لاخطية، لا ضوضاء، لا انزياح)، فيقرأ المقسّم الجهد العدد نفسه في كل مرة بينما تتذبذب القراءة في الحقيقة؛ بلورة 16 MHz دقيقة تمامًا بلا انحراف أو اهتزاز؛ وخط 5 V مصدر مثالي لا يمكن أن يهبط، فدائرة كانت ستُسقط لوحة حقيقية تعمل هنا بسلاسة.
Related
- صفحة اللوحة: /boards/leonardo
- وثيقة العقد: نموذج Arduino Leonardo
- الشريحة نفسها على لوحة تجارب: لوحة Arduino Micro ولوحة Pro Micro
- مشروع البداية: Leonardo fade