نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج XIAO SAMD21 (كل المسجّلات).
ما هي
Seeed Studio XIAO SAMD21، بشريحة ATSAMD21G18A تعمل على نواة Cortex-M من تطويرنا الخاص بملفها المتوافق مع ARMv6-M، وهي النواة نفسها التي تستخدمها Raspberry Pi Pico، لكن بتردد 48 MHz بدلًا من 125. البرنامج الثابت ملف Thumb ELF يخاطب عناوين SAM D21 الحقيقية.
مقاس اللوحة 21 في 17.8 مم، وصفّاها المكوّنان من سبع پدّات يبعد كل منهما عن الآخر 0.6 إنش، فتجلس اللوحة على القناة الوسطى في لوحة التجارب تاركة صفًّا حرًا في كل جهة.
الأطراف
أربع عشرة پادّة مسنّنة الحواف، سبع في كل ضلع، مع منفذ USB-C في الأعلى.
العمود الأيسر: D0، D1، D2، D3، D4، D5، D6.
العمود الأيمن: 5V، GND، 3V3، D10، D9، D8، D7.
كل واحدة من بادّات الإدخال والإخراج الإحدى عشرة هي مدخل تناظري، وA0 إلى A10 هي البادّات نفسها التي عليها D0 إلى D10؛ والطباعة الحريرية تبيّن الاسمين. فـanalogRead(A3) وanalogRead(3) هما الطرف نفسه.
هذه لوحة بجهد 3.3 فولت وأطرافها لا تحتمل 5 فولت. طرف 3V3 يزوّد 3.3 فولت، وطرف 5V يزوّد 5 فولت من منفذ USB.
ثلاثة LED على اللوحة وليست على أي بادّة: LED المستخدم، وRX وTX. الثلاثة كلها تعمل بالمستوى المنخفض، لذا فإن digitalWrite(LED_BUILTIN, LOW) يضيء LED المستخدم. وLED_BUILTIN هو 13.
ثلاثة أشياء يفعلها تخطيط الأطراف معك
هذه أمور في العتاد وليس في النموذج، وكل واحدة تصطاد أحدهم:
D0لا يدعم PWM. إنه طرف DAC ولا يصل إلى أي مؤقّت على الإطلاق، لذاanalogWrite(0, x)يشغّله أو يطفئه عند منتصف الدورة. استخدم أي بادّة أخرى للـfade.D4لا يدعم المقاطعات الخارجية. إنه طرف NMI في الشريحة، لذاattachInterrupt(4, ...)لا يفعل شيئًا. كما أنD5وD7يتشاركان في خط مقاطعة واحد، فلا يمكن لأكثر من واحد منهما أن يحمل معالجًا في الوقت نفسه.- بعض بادّات PWM تتشارك في قيمة الدورة. فـ
D1وD4قناة مقارنة واحدة، وكذلكD9وD5، وD10وD2، وD8وD3. الكتابة على أحدهما تحرّك الاثنين.
Serial هي USB، أما Serial1 فلا
Serial هي منفذ USB الخاص بالشريحة نفسها، وهي ما تتصل به الشاشة التسلسلية، وليس لها معدّل باود خاص بها: فالرقم الذي تمرّره يصل إلى المضيف كطلب له حرية تجاهله.
لا يوجد تحتها أي ركيزة USB. يحاكي Mokxi وحدة التحكم بالجهاز كأنبوب بايتات عند مسجّلات النقاط الحقيقية ولا شيء فوق ذلك: لا تعداد، ولا descriptors، ولا حزم SETUP. على XIAO حقيقية تنتظر while (!Serial) {} حتى ينتبه المضيف إلى اللوحة؛ أما هنا فتعود فورًا. كما أن Keyboard وMouse، وهما النصف الآخر من سبب وجود لوحة بـUSB أصلي، غير متاحين.
Serial1 شيء آخر: USART حقيقي على D6 (إرسال) وD7 (استقبال)، ينقل إطارات 8N1 حقيقية بتة ببتّة. ضع سلك توصيل من D6 إلى D7 وسيسمع الكود صداه؛ واضبط الطرفين على معدّلي باود مختلفين وسيتشوّه النص، تمامًا كما يحدث على الطاولة.
What is modeled
المنافذ PORT وSysTick، وما يكفي من GCLK وPM وSYSCTRL ليكتمل إقلاعٌ على طريقة أردوينو، ووحدات SERCOM الست كمحولات USART، وTCC0-2 وTC3-7 بقدر PWM، ومحوّل ADC من نوع SAR على قنواته العشرين كلها، وEIC، وUSB كأنبوب بايتات.
هذه هي المجموعة التي تحتاجها الدوال pinMode وdigitalWrite وdigitalRead وanalogRead وanalogWrite وmillis وmicros وdelay وattachInterrupt وSerial وSerial1، على عناوينها الحقيقية.
ما لم يُحتَذَ به
شجرة الساعة (النواة ببساطة تعمل على 48 MHz منذ أول تعليمة)، وSPI وI2C على وحدات SERCOM (بدلًا من ذلك تعمل Wire وSPI برمجيًا على أطراف عادية، انظر أدناه)، والـDAC، والمقارنات التناظرية، ووحدة اللمس، وI2S، وDMA، ونظام الأحداث، ووحدة تحكم NVM، ووحدة المراقبة، وRTC، وكل ما في USB فوق أنبوب البايتات.
Blocks the chip has and the model does not are mapped and read zero rather than faulting, so a startup that pokes one does not crash the board.
The full list, and a plain account of which register offsets this model can state from the datasheet and which are its own reading, is in نموذج XIAO SAMD21. القسم 7 هو ما ينبغي قراءته قبل نقل بناء من هنا إلى شريحة حقيقية.
مكتبات Arduino الرسمية
درس تعليمي يتضمن Servo.h و Wire.h و SPI.h و EEPROM.h و LiquidCrystal_I2C.h و Adafruit_GFX.h مع Adafruit_SSD1306.h و DHT.h يُترجم هنا كما هو. كل منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مبني على مشغّلات القطع في الصندوق، وليس أي منها كود المكتبة الأصلية.
Wire.begin()يضع ناقل I2C علىD4(SDA) وD5(SCL).- تعمل المكتبة
EEPROM.h، لكن نموذج هذه اللوحة لا يحتوي EEPROM ولا فلاش قابلًا للكتابة، لذلك تُخزَّن البايتات في 4 KB من الذاكرة RAM: يمكن قراءتها مرة أخرى خلال التشغيل نفسه، لكنها تضيع عند إعادة الضبط. Adafruit_NeoPixel.hstops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.
يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.
الأمثلة
Blink وButton وSerial وAnalog.
في مواضع أخرى
- صفحة اللوحة: /boards/xiao-samd21
- وثيقة العقد: نموذج XIAO SAMD21
- اللوحة الأخرى على النواة نفسها: Raspberry Pi Pico
- مشروع البداية: XIAO SAMD21 serial