المرجع

عقد لوحة Arduino Leonardo (المرحلة 9)

‏ATmega32U4، الذي يتصل منفذ USB لديه بالشريحة: Serial هو نقطة نهاية CDC و‏Serial1 هو UART.

هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة Arduino Leonardo و صفحة اللوحة.

Leonardo هي لوحة Arduino التي يذهب منفذ USB فيها مباشرة إلى المتحكم الدقيق. مكوّن نواة واحد (leonardo في crates/parts) يغلّف نموذج نظام-on-chip من نوع ATmega32U4 (crates/atmega32u4) على نواة AVR نفسها المستخدمة في Uno و Mega (crates/avr-core). النواة مشتركة؛ أما الشريحة حولها فلا. هذا المستند هو العقد، وهو يعلو على أي تعليق في الكود.

نوع الدليل هو leonardo. وحيثما يقول قسم ما «كما في docs/uno.md»، فإن ذلك المستند هو العقد لذلك الجزء.

الحقيقة الوحيدة التي تجعل هذه اللوحة مختلفة عن كل لوحات AVR الأخرى هنا: Serial ليس منفذ UART. تمتلك ATmega32U4 جهاز USB كامل السرعة على الشريحة نفسها، والمنفذ الوحيد في اللوحة موصول به، والشاشة التسلسلية هي نقطة نهاية CDC يفتحها البرنامج الثابت للكود نفسه. أما Serial1 (منفذ USART الفعلي) فهو على الطرفين 0 و1 في الهيدر ولا يصل إلى شيء ما لم يُوصَل به شيء. القسم 3.6 صريح في مقدار ما هو محاكى من USB، والإجابة هي: أنبوب البايتات، ولا شيء فوقه.

1. أطراف اللوحة (بترتيب الفهرس)

منظر علوي، مقبس micro-USB ومقبس البرميل على الحافة اليسرى. أبعاد اللوحة 68.6 x 53.3 mm، وهيدرات الدروع مطابقة لهيدرات Uno، ثقبًا بثقب، بما في ذلك فجوة Uno البالغة 0.16 inch بين كتلتَي الهيدر الرقمي.

الصف العلوي، من اليسار إلى اليمين (18 ثقبًا): SCL، SDA، AREF، GND، 13، 12، 11، 10، 9، 8، 7، 6، 5، 4، 3، 2، 1، 0.

الصف السفلي، من اليسار إلى اليمين (13 ثقبًا): IOREF، RESET، 3V3، 5V، GNDb، GNDc، VIN، A0 إلى A5.

هيدر ICSP، كتلة 2x3 عند الحافة اليمنى، بترتيب أطرافه الخاص من 1 إلى 6 (6 ثقوب): MISO، 5Vb، SCK، MOSI، RESETb، GNDd. على اللوحة، الأطراف 1 و3 و5 في عمود واحد، و2 و4 و6 في العمود الآخر.

37 طرفًا. رأس ICSP هو المكان الوحيد الذي تُخرج منه Leonardo ناقل SPI: MISO وSCK وMOSI هي PB3 وPB1 وPB2، أي الأطراف 14 و15 و16 في النواة، ولا يصل أي ثقب آخر إلى تلك اللوحات. SPI.h (الذي ينفّذ الناقل برمجيًا) يضع SCK وMISO وMOSI على لوحات ICSP، أي 15 و14 و16، كما يفعل المتغيّر leonardo في نواة Arduino؛ SS هو 17، أي PB0، طرف مصباح RX، ولا ثقب له، لذا يستخدم الكود أي طرف حر لاختيار الشريحة. الأطراف 11 و12 و13 ليست SPI على هذه اللوحة. 5Vb وGNDd هما خطا 5 V والأرضي، وRESETb هو نفس المسار النحاسي الخاص بـ RESET: خفض أي من الثقبين يوقف الشريحة، ويتبعه الآخر عبر R_STRAP.

خريطة المنافذ، وهي الغاية التي يوجد من أجلها جدول أطراف هذه اللوحة:

pins منفذ
0، 1 PD2، PD3
2، 3 PD1, PD0
4 PD4
5 PC6
6 PD7
7 PE6
8 إلى 11 من PB4 إلى PB7
12 PD6
13 PC7
A0 إلى A3 من PF7 نزولًا إلى PF4
A4، A5 PF1، PF0
MISO وSCK وMOSI (14، 15، 16، ICSP) PB3، PB1، PB2

خمسة منافذ، من B إلى F. لا يوجد منفذ A ولا منفذ G في هذه القطعة. في الحزمة ذات الـ 44 طرفًا التي تستخدمها Leonardo، منفذ B ومنفذ D كاملان، ومنفذ C يُخرج PC6 و PC7 فقط، ومنفذ E يُخرج PE2 و PE6، ومنفذ F تنقصه PF2 و PF3. اللوحة التي لا تمتلكها الحزمة لا تقود شيئًا أبدًا وتقرأ 0.

كهربائيًا:

  • كل طرف GPIO إمّا أن يدفع بوضع push-pull عند 5 فولت عبر R_STRONG، أو يبقى في حالة high-Z، أو يسحب للأعلى عبر 35 k، تمامًا كما يحدد القسم 1 من docs/uno.md. يقرأ المدخل مستوى عاليًا عند 2.5 فولت؛ والشبكة المتنازع عليها (غير المعروفة) تُقرأ 0، والشبكة الطافية تُقرأ ضجيجًا، كما في Uno (docs/uno.md القسم 1).
  • SCL/SDA beside AREF are the same two pieces of metal as pins 3 and 2، وليس A5 و A4 كما في لوحة Uno، لأن I2C على هذه الشريحة يقع على المنفذ D. هذا هو الموضع الوحيد الذي لا يتطابق فيه مخطط الدرع المشترك مع الشريحة المشتركة، وهو ما يجب التحقق منه عند نقل كود من لوحة إلى أخرى. كل ثقب من الثقبين المتقابلين يحمل ما يخرجه الطرف نفسه إضافة إلى ما تفعله شبكة الجهة الأخرى، عبر R_STRAP.
  • 5V و IOREF يوفران 5 فولت عند R_SUPPLY؛ و 3V3 يوفر 3.3 فولت؛ و GND و GNDb و GNDc توفر 0 فولت. أما VIN فهو مدخل تتجاهله اللوحة: فهي تعمل دائمًا بالطاقة من USB.
  • RESET (و RESETb، وهما المسار نفسه) يحمل مقاومة سحب بقيمة 10 كيلوأوم إلى 5 فولت. سحبه إلى ما دون 2.5 فولت يُبقي المعالج في حالة إعادة تعيين؛ وتركه يعني إعادة تعيين خارجية، وهي ما يبلّغ عنه MCUSR.
  • AREF يُقرأ فقط ولا يُدفَع إليه أبدًا. عند اختيار مرجع داخلي يُترك الطرف وشأنه.
  • الطرف 13 يحمل LED اللوحة L عبر مقاومة 1 k إلى الأرضي.
  • A0 إلى A5 هي أطراف رقمية عادية إضافة إلى كونها مداخل تناظرية.

2. خريطة الذاكرة

الفلاش 32 كيلوبايت، 16 ألف كلمة تعليمات، PC بعرض 14 بت
SRAM 2560 بايت من 0x0100 إلى 0x0AFF، و RAMEND = 0x0AFF
EEPROM 1 كيلوبايت
I/O من 0x20 إلى 0x5F، تُوصل إليها بـ IN/OUT/SBI/CBI
مداخل ومخارج موسعة من 0x60 إلى 0xFF، لا تُوصل إليها إلا بـ LDS/STS وتعليمات التحميل بالمؤشرات

لا يوجد RAMPZ ولا EIND: فمساحة 32 كيلوبايت من الفلاش تتسع داخل Z، لذا يصل LPM إليها كلها ويكون عنوان الإرجاع بايتين. أي صورة خام أكبر من حجم الفلاش تُرفض بالاسم.

على لوحة حقيقية، تحمل أعلى 4 كيلوبايت من الفلاش محمّل الإقلاع الخاص بـ USB، وهذه هي الطريقة التي يعيد بها برمجة نفسه عبر المنفذ نفسه الذي يتواصل منه الكود. لا شيء هنا يُحمّل عبر محمّل إقلاع (فالصورة توضع مباشرة في الفلاش)، لذا فمساحة 32 كيلوبايت كلها متاحة، وملف firmware/leonardo/link.ld يقول ذلك.

3. الأجهزة الطرفية

كل عنوان أدناه هو عنوان في فضاء البيانات، بالطريقة التي تراها بها LDS/STS والمؤشرات من نوع volatile. أي سجل غير مذكور هنا تُقرأ قيمته عند إعادة التعيين ويُحتسب وصولًا شاردًا.

3.1 المنافذ

خمسة منافذ، ثلاثة سجلات لكل منها، PINx ثم DDRx ثم PORTx، كلها في نافذة الإدخال/الإخراج المنخفضة:

منفذ PINx
B 0x23
C 0x26
D 0x29
E 0x2C
F 0x2F

النطاق من 0x20 إلى 0x22 هو موضع المنفذ A لو وُجدت قطعة به منفذ كهذا، وهذه القطعة لا تمتلكه: هذه العناوين الثلاثة شاردة. البتة 4 PUD في MCUCR (0x55) تعطّل كل مقاومات السحب دفعة واحدة. كتابة الواحد في بتة من PINx تقلب البت المقابلة في PORTx.

3.2 المؤقت/العدّاد 0

ثماني بتات، قناتا مقارنة، وجدول مقاسم التردد المعتاد. TCCR0A عند 0x44، و TCCR0B عند 0x45، و TCNT0 عند 0x46، و OCR0A عند 0x47، و OCR0B عند 0x48، و TIMSK0 عند 0x6E، و TIFR0 عند 0x35، و GTCCR عند 0x43. كل أنماط الموجات كما تعطيها docs/uno.md قسم 3.2. OC0A هو PB7 (الطرف 11) و OC0B هو PD0 (الطرف 3).

3.3 المؤقتان/العدّادان 1 و 3

ست عشرة بتة، ستة عشر نمط موجات، والكتلة ذاتها ذات السجلات الأربعة عشر مرتين: TCCRnA عند الأساس، ثم +1 TCCRnB، و +2 TCCRnC، و +4 TCNTnL، و +5 TCNTnH، و +6 ICRnL، و +7 ICRnH، و +8..+13 من OCRnAL إلى OCRnCH. المؤقت 1 عند 0x80 والمؤقت 3 عند 0x90. TIMSK1 عند 0x6F، و TIMSK3 عند 0x71، و TIFR1 عند 0x36، و TIFR3 عند 0x38.

المؤقت 3 له قناة مقارنة واحدة. TCCR3A يحمل COM3A1:0 وبتات WGM3 ولا شيء غيرها، و OCR3B و OCR3C ليست سجلات، والعناوين من 0x9A إلى 0x9D شاردة. TIMSK3 يقبل TOIE3 و OCIE3A و ICIE3 فقط.

OC1A هو PB5 (الطرف 9)، و OC1B هو PB6 (الطرف 10)، و OC1C هو PB7 (الطرف 11، مشترك مع OC0A)، و OC3A هو PC6 (الطرف 5). التقاط المدخل: ICP1 هو PD4، و ICP3 هو PC7.

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

3.4 المؤقت/العدّاد 4، ذو البتات العشر

هذه هي الطرفية التي لا يمكن اعتبارها نسخة أعرض أو أضيق من شيء موجود في ATmega328P. عشر بتات خلف بايت عليا مشترك، وقيمة TOP في سجل لا في نمط، وثلاث قنوات مقارنة تُسمى A و B و D. لا توجد قناة C، لأن OCR4C هو TOP.

سجل العنوان
TCNT4 0xBE
TC4H 0xBF
TCCR4A 0xC0
TCCR4B 0xC1
TCCR4C 0xC2
TCCR4D 0xC3
TCCR4E 0xC4
OCR4A 0xCF
OCR4B 0xD0
OCR4C (TOP) 0xD1
OCR4D 0xD2
DT4 0xD4
TIMSK4 0x72
TIFR4 0x39

بتات TIFR4 و TIMSK4: TOV4/TOIE4 البتة 2، و OCF4B/OCIE4B البتة 5، و OCF4A/OCIE4A البتة 6، و OCF4D/OCIE4D البتة 7. CS43:0 في TCCR4B يوقف العدّاد عند 0 وإلا فقسمة على 2^(n-1)، حتى 16384. OCR4C يعود بعد إعادة التعيين إلى 0xFF، ولهذا تعمل دورة تشغيل بثماني بتات دون كتابة TOP. كل سجل ذي عشر بتات يمر عبر TC4H، وهو مزلاج مستقل عن TEMP الخاص بالمؤقتات ذات 16 بتة.

المنمذج: PWM السريع (WGM41:0 = 0) و PWM الصحيح طورًا وترددًا (WGM41:0 = 1)، والمخارج الثلاثة للمقارنة على OC4A (PC7، الطرف 13) و OC4B (PB6، الطرف 10) و OC4D (PD7، الطرف 6)، والأعلام الأربعة مع بتات تفعيلها. تحتاج القناة بتتها PWM4x إضافة إلى بتاتها COM4x؛ فـ COM4x وحده لا يفعل شيئًا.

Not modeled, and this is the list to read before trusting a waveform: the clock is CK, the 16 MHz system clock, which is what PLLFRQ.PINMUX selects at reset. The 48 or 64 MHz PCK path through the PLL is not there. PLLCSR (0x49) and PLLFRQ (0x52) are stored, and PLOCK reads back set once PLLE is set so firmware that waits for a lock does not spin. The complementary outputs (!OC4A, !OC4B, !OC4D), the dead-time generator in DT4, the output-enable bits in TCCR4E, the enhanced-resolution mode, the fault-protection unit and the two PWM6 modes are all absent. COM4x = 1 and COM4x = 2 both behave as non-inverting here, because the complementary output that tells them apart is what is missing.

3.5 المنفذ التسلسلي USART1

منفذ USART واحد، وهو Serial1. سبعة سجلات بدءًا من 0xC8: UCSR1A، +1 UCSR1B، +2 UCSR1C، +3 UCSR1D، +4 UBRR1L، +5 UBRR1H، +6 UDR1. مواضع البتات هي نفسها مواضع Uno (docs/uno.md القسم 3.4). يُخزَّن UCSR1D ويُقرأ بقيمة 0، ولا تتم محاكاة التحكم في تدفق البيانات عبر العتاد.

إنه موصول بأطرافه ولا شيء غيرها: RXD1 هو PD2 (الطرف 0) و TXD1 هو PD3 (الطرف 1). يُدفع الإطار عبر الوسادة بتة واحدة في كل مرة (بتة بداية منخفضة، ثماني بتات بيانات يبدأ أقلها أهمية، بتة توقف مرتفعة، كل واحدة منها 16 (UBRR + 1) دورة معالج، والنصف بـ U2X1)، لذا فإن سلكًا من الطرف 1 إلى الطرف 0 يحمل فعلًا حرفًا. الاستقبال يأخذ عينة من منتصف كل بتة، ولهذا يشوّش معدل باود غير مطابق النص هنا تمامًا كما يفعل على الطاولة.

TXEN1 يأخذ TXD1 أيًا كان ما يقوله DDRD، و RXEN1 يُبقي RXD1 مدخلًا: هذه قاعدة ورقة البيانات، وهي سبب أن Serial1.begin() لا يحتاج إلى pinMode.

3.6 جهاز USB: هيكل يحمل البايتات فقط

هذا هو الموضع الذي لا يكون فيه النموذج مطابقًا للشريحة عن قصد، وهو مهم بما يكفي ليُقال بوضوح.

مُحاكى عند العناوين الحقيقية: UHWCON 0xD7, USBCON 0xD8, USBSTA 0xD9, USBINT 0xDA, UDCON 0xE0, UDINT 0xE1, UDIEN 0xE2, UDADDR 0xE3, UDFNUML 0xE4, UDFNUMH 0xE5, UEINTX 0xE8, UENUM 0xE9, UERST 0xEA, UECONX 0xEB, UECFG0X 0xEC, UECFG1X 0xED, UESTA0X 0xEE, UESTA1X 0xEF, UEIENX 0xF0, UEDATX 0xF1, UEBCLX 0xF2, UEBCHX 0xF3, UEINT 0xF4. سبع نقاط نهاية، من 0 إلى 6.

ما يعمل كما ينبغي:

  • USBCON.USBE يشغّل وحدة التحكم؛ وتصفير UDCON.DETACH يوصلها. قبل هذين الإجراءين، كل سجل UEx يقرأ 0 وكل كتابة لا تذهب إلى أي مكان.
  • UENUM selects an endpoint. UECONX.EPEN enables it and UECFG0X.EPDIR gives it a direction: set is IN (device to host), clear is OUT.
  • UEINTX يُحسب ولا يُخزَّن. على نقطة نهاية IN مفعّلة يقرأ TXINI | FIFOCON، بالإضافة إلى RWAL ما دام بنك الـ64 بايت فيه متسع. وعلى نقطة نهاية OUT مفعّلة يقرأ RXOUTI | FIFOCON | RWAL تمامًا عندما تكون الشاشة التسلسلية قد أرسلت شيئًا لم يقرأه أحد، و0 فيما عدا ذلك.
  • Writing UEINTX follows the AVR USB convention: a bit is cleared by writing a zero to it. Clearing FIFOCON or TXINI on an IN endpoint hands the staged bank to the serial monitor. A bank that reaches 64 bytes goes out on its own.
  • UEDATX ينقل البايتات: الكتابة تُهيّئ بايتًا على نقطة النهاية IN المحددة، والقراءة تأخذ بايتًا من نقطة النهاية OUT المحددة. UEBCLX يعدّ ما هو مُهيّأ أو في الانتظار، ويتشبّع عند 255. UEINT فيه بتة لكل نقطة نهاية لديها ما تفعله.
  • USBSTA reads VBUS set and UESTA0X reads CFGOK set: the board is plugged in and an endpoint this model has is always allocated, because there is no FIFO memory to run out of.

ما هو غير موجود: المضيف، والناقل، وإعادة تعيين الناقل، وحزم SETUP، والموصِفات descriptors، والتعداد enumeration، والعنونة، وعدّاد الإطارات، وإشارة بداية الإطار كل 1 ms، وتعدد البنوك في نقاط النهاية، وNAK، وSTALL، والتخزين المؤقت المزدوج، ومقاطعتا USB كلتاهما. USB_GENERAL وUSB_ENDPOINT لا يُرفعان أبدًا، لذا فإن أي CDC يعمل على هذا النموذج يعتمد على الاستعلام المتكرر polling.

نتيجتان يمكن أن يلاحظهما الكود. while (!Serial) {} يعود فورًا هنا بينما ينتظر على الطاولة الحقيقية، لأنه لا يوجد مضيف ليعدّ الجهاز. والكود الذي يفحص نقلًا تحكميًا لا يجد ما يعمل به.

Keyboard.h وMouse.h وJoystick.h (في البرنامج الثابت/المكتبة، فوق mokxi_hid.h) تُترجم وتعمل هنا كالمعتاد. الكود الذي يتضمن إحداها يربط firmware/leonardo/src/usb_hid.c أيضًا، وهو عضو في المكتبة لا يُسحب إلا بمثل هذا الكود، فيجعل الجهاز جهازًا مركّبًا: واجهات CDC كما كان، بالإضافة إلى واجهة HID واحدة بنقطة نهاية مقاطعة IN رقم 4، وموصوفات التقرير report descriptor لكل مكتبة مدمجة مع بعضها، لكل منها معرّف التقرير الخاص به (الفأرة 1، لوحة المفاتيح 2، عصا التحكم 3). على لوحة حقيقية ذلك هو ما يُعدّه المضيف. هنا لا يوجد مضيف، لذا تطبع كل مكتبة ما كانت سترسله على Serial بدلًا من ذلك، سطر واحد بين قوسين لكل تغيير ([Keyboard] press Ctrl, [Joystick] buttons 0 3 | hat 90 | x 512 y 0). والكود الذي لا يتضمن أيا منها يبقى جهاز CDC العادي، ومخرجه هنا كما كان دائمًا.

المكتبات المكتوبة اعتمادًا على PluggableUSB في نواة AVR، وفي مقدمتها MIDIUSB، تجد PluggableUSB.h وUSBAPI.h وUSBCore.h وUSBDesc.h بجانب arduino.h (مكتوبة من مواصفة USB 2.0 تحت الأسماء التي تستخدمها النواة)، لذا تُبنى وتعمل دون أي تغيير. أما MIDIUSB نفسها فهي مدمجة (firmware/lib/MIDIUSB.h، مع MIDIUSB_Defs.h وpitchToNote.h) على Leonardo وMicro وPro Micro. يسلّم PluggableUSB().plug() للوحدة أرقام الواجهات والنقاط الطرفية بعد التي تخصصها النواة لمنفذ CDC (الواجهة 2، والنقطة الطرفية 4 للأولى)، لكن لا شيء يعرض الوحدة على المضيف، هنا أو على لوحة حقيقية: نقاطها الطرفية لا تُهيَّأ أبدًا، لذا يعيد USB_Send() القيمة -1 كما تفعل النواة قبل التعداد، ويعيد USB_Recv() القيمة -1 وتكون USB_Available() تساوي 0. يعمل كود متحكم MIDI، لكن نغماته لا تصل إلى أي مكان: أول استدعاء لـ sendMIDI() في MIDIUSB يقول ذلك مرة واحدة على الشاشة التسلسلية ([Mokxi] MIDIUSB: no USB host is simulated, so these MIDI messages go nowhere. ...)، ويستمر المخرج التسلسلي الخاص بالكود في العمل من حوله. لا تعرض أي لوحة في المحرر هذه الرسائل، لأن النقاط الطرفية للوحدة الموصولة لا تصل أبدًا إلى المحرك.

بيئة التشغيل نفسها ليست مقصورة على الجذر البسيط. firmware/leonardo/src/usb.c هو جهاز CDC ACM حقيقي (نقطة نهاية تحكم 0، ونقطة نهاية تنبيه 1، وbulk OUT رقم 2 وbulk IN رقم 3، بواصفات نواة Arduino ومعرّفيها VID وPID، مدفوع بالمقاطعات، مع لمسة 1200 baud إلى Caterina)، وهو موجود في كل صورة. عند إعادة التعيين يطلق بنك IN فارغًا على نقطة النهاية 3 ثم يقرأ FIFOCON مرة أخرى: السيليكون يبقي البنك حتى يقرأه مضيف، ولم يُعِد أي مضيف الناقل أصلًا، بينما هذا النموذج يحرّر البنك المُطلق فورًا. تلك القراءة الواحدة تحدد الوضع نهائيًا. هنا تدفع بيئة التشغيل البيانات كما هو موصوف أعلاه وتبقى حزمة USB خاملة؛ وعلى لوحة حقيقية تشغّل الحزمة. أي تغيير في النموذج يُبقي بنكًا مُطلقًا مشغولًا سينقل كل كود Leonardo إلى مسار العتاد، حيث لا يقول Serial شيئًا حتى يهيّئ مضيفٌ الجهاز، لذا فإن crates/atmega32u4/src/usb.rs فيه اختبار يثبّت هذا السلوك.

3.7 المحوّل ADC

عشرة بتات، وأربعة عشر قناة، ADCL 0x78, ADCH 0x79, ADCSRA 0x7A, ADCSRB 0x7B, ADMUX 0x7C, DIDR2 0x7D, DIDR0 0x7E, DIDR1 0x7F. المقسّم والبتّات ADSC وADIF وADIE وADATE في الوضع الحر وADLAR كلها تتصرف كما يعطيها القسم 3.3 من docs/uno.md؛ التحويل يستغرق 13 نبضة ساعة ADC، و25 نبضة لأول تحويل بعد ADEN.

أمران يختلفان عن ATmega328P وواحد عن ATmega2560:

  • محدد القناة ست بتات وبته العليا، MUX5، هي بتة 5 في ADCSRB, not bit 3, which is where an ATmega2560 puts it.
  • القنوات فوق سبعة ليست منفذًا ثانيًا. ADC8 إلى ADC13 هي PD4 وPD6 وPD7 وPB4 وPB5 وPB6، ولهذا فإن A6 إلى A11 على Arduino Leonardo هي أيضًا الأطراف الرقمية 4 و12 و6 و8 و9 و10. هذه اللوحة تُخرج A0 إلى A5 على رأس التوصيل التناظري؛ والبقية يُوصل إليها بأرقام أطرافها الرقمية.
  • لا توجد مرجعية 1.1 V. REFS1:0 هي 0 لـAREF، و1 لـAVCC، و3 للمرجعية الداخلية 2.56 V، و2 محجوزة. جهد النطاق 1.1 V ما يزال متاحًا كـقناة عند MUX5:0 = 0x1E.

القناة إلى الطرف: ADC0 PF0, ADC1 PF1, ADC4 PF4, ADC5 PF5, ADC6 PF6, ADC7 PF7, ADC8 PD4, ADC9 PD6, ADC10 PD7, ADC11 PB4, ADC12 PB5, ADC13 PB6. أما ADC2 وADC3 فموجودتان في المحدد mux وغير موصولتين في هذه الحزمة؛ اختيار إحداهما يقرأ 0. قنوات الفرق والتكبير وحساس الحرارة غير مُحاكاة وتقرأ 0.

3.8 المقاطعات الخارجية ومقاطعات تغيّر الأطراف

EICRA 0x69، EICRB 0x6A، EIMSK 0x3D، EIFR 0x3C، PCICR 0x68، PCIFR 0x3B، PCMSK0 0x6B.

خمس مقاطعات خارجية وثلاث فجوات: INT0 على الطرف PD0 (الطرف 3)، وINT1 على PD1 (الطرف 2)، وINT2 على PD2 (الطرف 0)، وINT3 على PD3 (الطرف 1)، وINT6 على PE6 (الطرف 7). أما INT4 وINT5 وINT7 فهي فتحات محجوزة بلا طرف خلفها، ولا يمكن لتفعيل أي منها أن يرفع أي إشارة أبدًا. بتات التحسّس هي EICRA للأرقام من 0 إلى 3 وEICRB للأرقام من 4 إلى 7، لكل منهما بتان: 0 مستوى منخفض، 1 أي حافة، 2 حافة هابطة، 3 حافة صاعدة. مقاطعة المستوى المنخفض تظل مرفوعة طالما الطرف منخفض ولا تضع أي راية.

مجموعة واحدة لتغيّر الأطراف، PCINT0، وهي المنفذ B بأكمله.

3.9 السكون وذاكرة EEPROM

SMCR 0x53 مع بت SE رقم 0، وكل أوضاع السكون تعمل كوضع الخمول: تتوقف ساعة المعالج، وتستمر الأجهزة الطرفية بالعمل، وأي مقاطعة مفعّلة توقظه. MCUSR 0x54 يُظهر PORF بعد إعادة تعيين بتشغيل الطاقة وEXTRF بعد إمساك طرف إعادة التعيين. WDTCSR هو عدّاد المراقبة، مثل Uno (docs/uno.md القسم 3.8، المتجه 12)، باستثناء أن نموذج الشريحة يمسح WDRF ويوقف عدّاد المراقبة بعد إعادة تعيين من عدّاد المراقبة قبل setup()، كما يفعل محمّل الإقلاع Caterina. أما CLKPR وPRR0 وPRR1 وOSCCAL وRCCTRL وSPMCSR وGPIOR0..2 فتُحفظ وتُقرأ مرة أخرى.

ذاكرة EEPROM سعتها 1 كيلوبايت عند EECR 0x3F، وEEDR 0x40، وEEARL 0x41، وEEARH 0x42، وعرض EEARH بتان. تكتمل القراءة فورًا؛ أما الكتابة فتستغرق 3.3 ms (26,368 دورة من مذبذب RC بسرعة 8 MHz؛ و1.8 ms في وضع المحو وحده أو الكتابة وحدها)، وخلالها يقرأ EEPE بالقيمة 1، ويرفع EERIE مقاطعة EE_READY كمستوى بمجرد انتهائها.

3.10 المتجهات

ثلاثة وأربعون متجهًا، بين كل اثنين كلمة، بدءًا من العنوان 0، مرقّمة بترتيب الأولوية. يحمل الجدول في crates/atmega32u4/src/vectors.rs وfirmware/leonardo/include/leonardo.h؛ والشكل المهم هنا أن الفتحات 5 و6 و8 و13 و14 و15 محجوزة في هذه القطعة، وأن متجهي USB يجلسان بين مجموعة تغيّر الأطراف وعدّاد المراقبة، وهو ترتيب لا تملكه أي شريحة AVR أخرى هنا.

ما يستخدمه وقت التشغيل: INT0..INT3 هي 1 إلى 4، وINT6 هو 7، وPCINT0 هو 9، وTIMER0_OVF هو 23، وUSART1_RX هو 25، وADC هو 29، ومتجهات المؤقت 4 الأربعة هي من 38 إلى 41.

4. قناة المضيف

host_write يضع البايتات في نقطة نهاية USB الصادرة (OUT) التي يقرأها البرنامج الثابت؛ وhost_read يأخذ البايتات التي أرسلها البرنامج الثابت على نقطة النهاية الواردة (IN). هذا هو Serial في الكود والشاشة التسلسلية في الواجهة. البايتات بصيغة UTF-8 بالنسبة للواجهة، وغير شفافة بالنسبة للنموذج.

Serial1 ليس على هذه القناة ولن يكون أبدًا: إنه طرفان على الترويسة.

5. نموذج الزمن والقطعة

كما في docs/uno.md القسم 5. بتردد 16 MHz، تستغرق الدورة 62.5 ns بالضبط، والشريحة الزمنية 10 us وتساوي 160 دورة بالضبط، وعدّاد الدورات مثبّت على وقت النواة في بداية كل شريحة. داخل الشريحة تُقدَّم النواة تعليمة واحدة في كل مرة، مع إخبار الناقلة بالدورة التي تبدأ عندها كل تعليمة، فيحمل تغيّر الطرف رقم الدورة التي سبّبته.

probe قناع بتّي: 1 يعني يعمل، 2 نائم، 4 مصباح L المدمج على الطرف 13، 8 إرسال USB خلال آخر 20 ms، 16 استقبال USB. القيمة 0 عند عدم وجود برنامج.

poke: القيمة 2 تمسك RESET، والقيمة 3 تطلقه.

6. البرنامج الثابت (firmware/leonardo/)

بيئة تشغيل على نمط Arduino مكتوبة من هذا المستند: setup() وloop()، pinMode، digitalWrite، digitalRead، analogRead، analogWrite، millis، micros، delay، delayMicroseconds، attachInterrupt، Serial وSerial1. بدون Arduino core، وبدون avr-libc، وبدون libc.

مبني بـ clang --target=avr -mmcu=atmega32u4، ومرتبط بواسطة ld.lld مع firmware/leonardo/link.ld. خمسة من ملفات بيئة التشغيل هي ملفات Uno نفسها، مُترجمة من جديد لهذه القطعة بدلًا من نسخها: تنسيق الأرقام، والمساعدات الرياضية، ودالة floor المستقلة ونصفها المكتوب بلغة التجميع، وPrint. سلسلة program في الفهرس هي elf32 avr atmega32u4.

أطراف PWM ومؤقتاتها:

طرف مخرج مؤقت التردد
3 OC0B 0، PWM سريع 976.5625 Hz
11 OC0A 0، PWM سريع 976.5625 Hz
13 OC4A 4، صحيح الطور والتردد، TOP = OCR4C 490.196 Hz
6 OC4D 4، صحيح الطور والتردد، TOP = OCR4C 490.196 Hz
9 OC1A 1، 8 بت صحيح الطور 490.196 Hz
10 OC1B 1، 8 بت صحيح الطور 490.196 Hz
5 OC3A 3، 8 بت صحيح الطور 490.196 Hz

Serial هو جهاز USB في src/usb.c وSerial1 هو USART1. يبدأ mokxi_init() جهاز USB قبل كل شيء، كما تفعل USBDevice.attach() في نواة Arduino، فتظهر اللوحة كمنفذ تسلسلي وتستقبل لمسة الـ 1200 baud سواء استدعى الكود Serial.begin() أو لا. انتظار PLL محدود (10 ms؛ فإذا لم يقفل PLL أبدًا يبقى USB متوقفًا)، والميلي ثانية التي تُقضى هناك تأتي قبل بدء المؤقت 0، فتؤخّر كل شيء معًا. على اللوحة، تُهمل كتابات Serial حتى يضبط المضيفُ الجهازَ ويفتح البرنامجُ المنفذ، وينتظر البايت 250 ms على الأكثر لمضيف لا يقرأ، وwhile (!Serial) ينتظر DTR، كما في نواة Arduino. يحمل الملفُّ معرّفات Leonardo الـ VID و PID (0x2341:0x8036) وسلاسل النصوص؛ ويعيد كاتب اللوحات كتابتها من أجل Micro (0x2341:0x8037) أو Pro Micro (0x1B4F:0x9206) أثناء كتابته للوحة. تكلّف حزمة وقت التشغيل نحو 2 كيلوبايت من ذاكرة flash ونحو عشرة بايتات من SRAM.

digitalPinToInterrupt: الطرف 3 هو 0، والطرف 2 هو 1، والطرف 0 هو 2، والطرف 1 هو 3، والطرف 7 هو 4. وأي طرف آخر يعطي ‎-1.

أربعة أمثلة: blink، وbutton (مفتاح على الطرف 7، وهو INT6)، وserial (يطبع على المنفذين معًا ليظهر الفرق بينهما على الشاشة)، وfade (يشغّل الطرف 13 بالمؤقت 4 والطرف 9 بالمؤقت 1، فيعمل نوعا عتاد PWM معًا في وقت واحد). خُصص لكل مثال 8 KB من مساحة الفلاش البالغة 32 KB.

7. ما هو غير مُحاكى

SPI، وTWI، والمقارن التناظري، وحساس الحرارة، وقسم محمّل الإقلاع وبتاته (fuses)، ومقسّم الساعة، وPLL والساعة السريعة التي تغذّي المؤقت 4، والمخرجات المتكاملة لـ PWM في المؤقت 4 ومولّد زمن الموات، وكل ما هو فوق أنبوب بايتات USB المذكور في القسم 3.6. تقرأ هذه السجلات قيم إعادة التعيين الخاصة بها وتُحسب كسجلات شاردة.

8. ما يكون هذا النموذج واثقًا منه، وما لا يكون واثقًا منه

مأخوذة من ورقة البيانات، ومُجرّبة ببرنامج ثابت حقيقي. كل عنوان وموضع بت وقيمة إعادة ضبط في القسم 3 مأخوذة من ورقة بيانات ATmega16U4/ATmega32U4، بترقيم فضاء البيانات، بما في ذلك نافذة المدخلات/المخرجات الموسعة من 0x60 إلى 0xFF التي تحدد أي السجلات يمكن لأمر IN/OUT الوصول إليها وأيها يحتاج إلى sts. المنافذ الخمسة، والمؤقتات 0 و1 و3 والمؤقت 4 ذو العشرة بتات مع OCR4C كقيمة علوية (TOP)، وUSART1، وقنوات ADC الأربع عشرة، وINT0 إلى INT3 وINT6، ومجموعة تغيّر الطرف الوحيدة، كلها مطابقة لما في ورقة البيانات. ملف crates/atmega32u4/tests/runtime.rs يشغّل ملفات ELF المرفقة blink وserial وfade عبر المنافذ وكلا عرضَي المؤقت وممر بايتات USB.

تمت نمذجتها، لكن دون التقيد بأرقام ورقة البيانات. سلوكيات لا عناوين:

  • متحكم جهاز USB مجرد هيكل ينقل البايتات، كما يقول القسم 3.6 بوضوح. لا يوجد تعداد (enumeration)، ولا تبادل للموصّفات (descriptors)، ولا ضبط لنقاط النهاية (endpoints)، ولا توقيت SOF، ولا تعليق أو استئناف، ولا إعادة تعيين بلمسة 1200 باود. Serial هو أنبوب بايتات إلى قناة المضيف يجيب على Serial وSerial.dtr() بالطريقة التي يجيب بها منفذ CDC متصل. إذن الشيء الوحيد الذي يجعل ليوناردو ليوناردو (أن الكود يمكن أن ينتظر إلى الأبد عند while (!Serial)) هو قرار يتخذه هذا النموذج وليس بروتوكولًا يشغّله.
  • والباقي هو قائمة أونو. ينطبق القسم الأوسط من القسم 7 في docs/uno.md دون تغيير: محول ADC بلا أخطاء، وساعة دقيقة بتردد 16 MHz، وثلاث حالات للوسادة (pad) وعتبة مع مقاومة سحب 35 kΩ، ومصدر تغذية مثالي لا يمكن أن ينخفض، وزمن إقلاع بميكروثانية واحدة، وشريحة زمنية مدتها 10 us.

غياب مقصود، كما يعدّد القسم 7: واجهة SPI، وواجهة TWI، والمقارن التناظري، وحساس الحرارة، وقسم محمّل الإقلاع (bootloader) وشروطه (fuses)، وقاسم الساعة (prescaler)، وحلقة PLL والساعة السريعة التي تغذّي المؤقت 4، والمخرجات المتكاملة للمؤقت 4 ومولّد زمن التحول (dead-time)، وكل ما هو فوق أنبوب بايتات USB. هذه السجلات تُقرأ بقيم إعادة الضبط وتُحسب كسجلات شاردة.