هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة Seeed XIAO SAMD21 و صفحة اللوحة.
XIAO SAMD21 هي أصغر لوحة هنا وثالث لوحة بنواة Cortex-M0+. مكوّن نواة واحد (xiao في crates/parts) يغلّف طراز معالج ATSAMD21G18A (crates/atsamd21) على النواة نفسها المستخدمة في Raspberry Pi Pico (crates/cortexm-core، Profile::V6M). النواة مشتركة؛ الشريحة حولها ليست كذلك. هذا المستند هو العقد، وهو يَفوق أي تعليق في الشيفرة.
النوع في الفهرس هو xiao.
اقرأ القسم 7 أولًا إن كنت ستأخذ بناءً من هنا إلى سيليكون حقيقي. كل عنوان أساس في هذا الطراز يمكن لهذا المستند ذكره من SAM D21 Family Datasheet، وكذلك معظم إزاحات السجلات، لكن إزاحات كتلة TC وجدول توزيع الملحقات هي قراءة هذا الطراز وليست اقتباسًا لصفحة، والقسم 7 يسمّي كل واحدة منها. لا شيء هنا تخمين صامت.
1. أطراف اللوحة (بترتيب الفهرس)
منظر علوي، مقبس USB-C في الأعلى، ومعالج ATSAMD21G18A تحت الطباعة الحريرية في المنتصف. اللوحة مقاسها 21 × 17.8 مم، وصفّا وساداتها السبعة المسننة يبعدان 15.24 مم (0.6 بوصة بالضبط)، لذا تمتد على جانبي القناة الوسطى في لوحة التجارب.
العمود الأيسر، من الأعلى إلى الأسفل (7 وسادات): D0، D1، D2، D3، D4، D5، D6.
العمود الأيمن، من الأعلى إلى الأسفل (7 وسادات): 5V، GND، 3V3، D10، D9، D8، D7.
14 وسادة. إحدى عشرة منها للإدخال/الإخراج وثلاث للطاقة. كل واحدة من الإحدى عشرة هي أيضًا مدخل تناظري، وA0 إلى A10 هي الوسادات نفسها كـ D0 إلى D10؛ الطباعة الحريرية تعرض كليهما.
الوسادة خلف كل طرف، وما يمكن أن تكونه أيضًا:
| طرف | الوسادة | AIN |
EXTINT |
PWM (الوظيفة E) | أخرى |
|---|---|---|---|---|---|
D0 / A0 |
PA02 | 0 | 2 | لا شيء | مخرج المحول الرقمي التناظري |
D1 / A1 |
PA04 | 4 | 4 | TCC0 CC0 |
|
D2 / A2 |
PA10 | 18 | 10 | TCC1 CC0 |
|
D3 / A3 |
PA11 | 19 | 11 | TCC1 CC1 |
|
D4 / A4 |
PA08 | 16 | NMI | TCC0 CC0 |
SDA |
D5 / A5 |
PA09 | 17 | 9 | TCC0 CC1 |
SCL |
D6 / A6 |
PB08 | 2 | 8 | TC4 CC0 |
Serial1 TX |
D7 / A7 |
PB09 | 3 | 9 | TC4 CC1 |
Serial1 RX |
D8 / A8 |
PA07 | 7 | 7 | TCC1 CC1 |
SCK |
D9 / A9 |
PA05 | 5 | 5 | TCC0 CC1 |
MISO |
D10 / A10 |
PA06 | 6 | 6 | TCC1 CC0 |
MOSI |
ثلاثة أمور في هذا الجدول تستحق القراءة مرتين، وكلها تتعلق بالعتاد لا بالنموذج:
D0لا يدعم PWM. الطرف PA02 هو طرف الـ DAC ولا يعطي أي خرج موجة على الإطلاق.analogWrite(0, x)هنا يقود الطرف تشغيله أو إطفاءه عند منتصف المدى بدل التظاهر بالتلاشي.- الطرف
D4لا يملك مقاطعة خارجية عادية. الطرف PA08 هو طرف الـ NMI في الشريحة.attachInterrupt(4, ...)لا يفعل شيئًا، هنا وعلى الطاولة. - الطرفان
D5وD7يتشاركانEXTINT9، لذا لا يمكن إلا لأحدهما أن يحمل مقاطعة في الوقت نفسه؛ والثانيattachInterruptيسحب الخط من الأول. ولأن TCC1 وTCC2 يملكان سجلّي مقارنة لكل منهما، تتشارك بعض الأطراف في دورة عمل: كتابةanalogWriteعلى أحدD1/D4,D9/D5,D10/D2أوD8/D3تحرّك الاثنين معًا.
ثلاثة مصابيح LED موجودة على اللوحة ولا توجد على أي طرف: LED المستخدم على PA17، وLED الاستقبال RX على PA18، وLED الإرسال TX على PA19. الثلاثة كلها نشطة بمستوى منخفض، لذا فإن digitalWrite(LED_BUILTIN, LOW) يضيء مصباح المستخدم. تُرى عبر مجس والعرض المرئي، ولا شيء غير ذلك. يرقّمها وقت التشغيل 13 و12 و11 ويعرّف LED_BUILTIN على أنه 13.
كهربائيًا. كل طرف إدخال/إخراج يقود بطريقة push-pull عند 3.3 V عبر R_STRONG، أو يبقى في حالة high-Z، أو يسحب إلى الأعلى أو الأسفل عبر 40 k. يقرأ المدخل مستوى مرتفعًا عند 1.65 V؛ والشبكة المتنازع عليها (غير المعروفة) تُقرأ 0، والشبكة الطافية تقرأ ضجيجًا، كما هو الحال في Uno (docs/uno.md القسم 1). الطرف 3V3 يقدّم 3.3 V عبر R_SUPPLY، والطرف 5V يقدّم 5 V، والطرف GND يقدّم 0 V، دائمًا، لأن اللوحة موصولة بـ USB. لا يوجد طرف reset على الرأس: طرفا الـ reset موجودان على الوجه السفلي من لوحة XIAO حقيقية، وهنا الـ reset عبارة عن نقرة (القسم 5).
2. خريطة الذاكرة
| الفلاش | 256 KB عند 0x0000_0000 |
| SRAM | 32 KB من 0x2000_0000 إلى 0x2000_7FFF |
| قمة المكدس | 0x2000_8000 |
| PM | 0x4000_0400، القسم 3.2 |
| SYSCTRL | 0x4000_0800، القسم 3.2 |
| GCLK | 0x4000_0C00، القسم 3.2 |
| EIC | 0x4000_1800، القسم 3.6 |
| PORT | 0x4100_4400، القسم 3.1 |
| USB | 0x4100_5000، القسم 3.7 |
| SERCOM0..5 | 0x4200_0800، بتباعد 0x400، القسم 3.3 |
| TCC0..2 | 0x4200_2000، بتباعد 0x400، القسم 3.4 |
| TC3..TC7 | 0x4200_2C00، بتباعد 0x400، القسم 3.4 |
| ADC | 0x4200_4000، القسم 3.5 |
كل مقطع PT_LOAD يجب أن يقع داخل الذاكرة الوميضية أو الـ SRAM؛ وأي شيء آخر يُرفض مع ذكر العنوان المخالف في الرسالة، وتبقى الشريحة بلا برنامج.
The vector table goes at zero and nothing goes before it. A real XIAO ships with the UF2 bootloader in the first 8 KB and the application linked at 0x2000; an image built here therefore runs in Mokxi and under a debugger, and needs relinking at 0x2000 to go in over that bootloader. That is a one-line change to ORIGIN in firmware/xiao/link.ld, not a code change.
الكتل التي يملكها ورق البيانات ولا يملكها هذا النموذج (PAC0-2، DSU، NVMCTRL، DMAC، MTB، WDT، RTC، EVSYS، AC، DAC، PTC، I2S) هي مربوطة وغير فعّالة: قراءة أي منها تعطي 0 وتُحسب وصولًا شاردًا، بدل التسبب في خطأ. برنامج إقلاع يعبث بحالات انتظار متحكم NVM لا ينبغي أن يوقف اللوحة. وأي شيء خارج كل الكتل هو خطأ وصول، وهو على ARMv6-M خطأ HardFault، وتبلغ عنه اللوحة كانهيار على قناة المضيف.
3. سجلات الطرفيات
الجزء المدرج أدناه فقط هو المنفَّذ. سجل SAM D21 عرضه ثمانية أو ستة عشر أو اثنان وثلاثون بتًا، والناقل يخدم كلًا منها بعرضه الخاص: الوصول الأضيق من سجله هو قراءة-تعديل-كتابة كما كانت مصفوفة الناقل ستفعل، والأوسع يُجاب من السجل الذي يبدأ فيه. لذا يعمل البرنامج الثابت المكتوب وفق أنواع ورق البيانات نفسها دون تغيير.
3.1 PORT (0x4100_4400)
مجموعتان، PA وPB، بتباعد 0x80. الأطراف مرقّمة من 0 إلى 63 في هذا النموذج: من 0 إلى 31 هي PA00..PA31 ومن 32 إلى 63 هي PB00..PB31.
| الإزاحة | سجل |
|---|---|
0x00 |
DIR |
0x04 |
DIRCLR |
0x08 |
DIRSET |
0x0C |
DIRTGL |
0x10 |
OUT |
0x14 |
OUTCLR |
0x18 |
OUTSET |
0x1C |
OUTTGL |
0x20 |
IN |
0x24 |
CTRL (مخزَّن، يُقرأ مرة أخرى) |
0x28 |
WRCONFIG |
0x30 + n |
PMUXn، بايت واحد لكل زوج من الأطراف |
0x40 + n |
PINCFGn، بايت واحد لكل طرف |
في PINCFG البت 0 هو PMUXEN، والبت 1 هو INEN، والبت 2 هو PULLEN، والبت 6 هو DRVSTR (مخزَّن، ومُهمَل كهربائيًا).
سجل OUT يؤدي وظيفتين، وهو الفخ الحقيقي الوحيد في هذه القطعة. مع DIR set it is the driven level; with DIR clear it is the اتجاه السحب. لذا INPUT_PULLUP هو DIRCLR، ثم OUTSET، ثم PINCFG.PULLEN، و PULLEN دون OUT يعطي سحبًا إلى الأعلىأدناه. اثنان من ثلاثة فقط تجعل الطرف يقوم بالشيء الخطأ بصمت.
يكتب WRCONFIG إعدادات PINCFG وPMUX لستة عشر طرفًا في عملية تخزين واحدة: PINMASK في البتات 0..15، وPMUXEN في 16، وINEN في 17، وPULLEN في 18، وDRVSTR في 22، وPMUX في 24..27، وWRPMUX في 28، وWRPINCFG في 30، وHWSEL في 31 (وهو ما يزيح القناع إلى الأطراف 16..31).
عند ضبط PMUXEN، يختار PMUX إحدى وظائف الوحدات الطرفية الثماني A..H ويخرج الوسد من يد الـ PORT. يعمل النموذج على ما يملكه (SERCOM في وضع USART ومخرجات الموجة لـ TC/TCC، جدول القسم 1)، ويعامل كل اختيار آخر كوحدة طرفية لا يمتلكها، لا تطلب شيئًا وتترك الوسد بحالة عالية المقاومة بدلًا من اختراع مستوى. تبقى مقاومة السحب الخاصة بالوسد كما هي، وبهذا يحافظ طرف استقبال SERCOM على مقاومة السحب لأعلى الخاصة به.
يقرأ IN القيمة 0 على طرف لم يُضبط INEN فيه، وهذا ما يفعله العتاد الحقيقي. والوسد الذي تقود هذه الشريحة مخرجه يُقرأ منه ما تقوده.
3.2 وحدات PM وGCLK وSYSCTRL: شجرة الساعات غير مُنمذجة
يعمل النواة عند 48 MHz بدءًا من أول تعليمة. لا توجد شجرة ساعات هنا: لا DFLL، ولا مذبذبات، ولا مقسّمات، ولا مولّدات تولّد شيئًا فعلًا. هذه الكتل الثلاث موجودة فقط كي يعمل كود بدء تشغيل مكتوب وفق السجلات الحقيقية حتى نهايته بدلًا من أن يعلّق على بت جاهزية.
- SYSCTRL (
0x4000_0800) هو ظل لاثنين وثلاثين كلمة، مع استثناءين.PCLKSR(0x0C) يُقرأ وكل بتات الجاهزية والقفل مضبوطة (XOSCRDY،XOSC32KRDY،OSC32KRDY،OSC8MRDY،DFLLRDY،DFLLLCKF،DFLLLCKC،DFLLRCS،BOD33RDY،DPLLLCKF،DPLLLCKT) وكل بتات الفشل صفرية.DFLLSYNCيُقرأ 0. لذاwhile (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {}يمر مباشرة دون تعليق. - GCLK (
0x4000_0C00):CTRLعند0x00(SWRSTالبت 0)، وSTATUSعند0x01(SYNCBUSYالبت 7، لا يُضبط أبدًا)، وCLKCTRLعند0x02، وGENCTRLعند0x04، وGENDIVعند0x08. الثلاثة الأخيرة تُعنون بالمعرّف ID في القيمة المكتوبة، كما في القطعة الحقيقية، وتُجيب القراءة عن آخر معرّف كُتب. لا شيء معتمد عليها في التشغيل. - PM (
0x4000_0400):AHBMASKعند0x14، وAPBAMASKعند0x18، وAPBBMASKعند0x1C، وAPBCMASKعند0x20، كلها مخزنة وتُقرأ بقيم إعادة التعيين، وRCAUSEعند0x38، وهو للقراءة فقط هنا ويحمل بت تشغيل الطاقة أو بت إعادة التعيين الخارجية أو بت إعادة تعيين النظام حسب آخر إعادة تعيين للقطعة. لا شيء معتمد على أقنعة الساعات: الوحدة الطرفية تعمل سواء شغّل البرنامج الثابت ساعتها أم لا. بيئة التشغيل تشغّلها على أي حال، لأن القطعة الحقيقية تحتاج ذلك.
الوقت نفسه يأتي من SysTick، الموجود في cortexm-core عند عنوانه المعماري. تعيد بيئة التشغيل تحميله كل 48 000 دورة (بالضبط ملي ثانية عند 48 MHz)، وSYST_CALIB يُبلغ عن ذلك كعُشر عشرة ملي ثانية بالضبط.
3.3 SERCOM كـ USART (0x4200_0800 + 0x400 n)
ستة SERCOM، كل منها مُنمذج في وضع USART بساعة داخلية (CTRLA.MODE = 1)، غير متزامن 8N1، وفي لا وضع آخر. لم تُنمذج SPI ولا I2C؛ وSERCOM موضوع في أحد هذين الوضعين لا يفعل شيئًا.
| الإزاحة | سجل |
|---|---|
0x00 |
CTRLA |
0x04 |
CTRLB |
0x08 |
DBGCTRL (مخزن) |
0x0C |
BAUD |
0x0E |
RXPL (مخزن) |
0x14 |
INTENCLR |
0x16 |
INTENSET |
0x18 |
INTFLAG |
0x1A |
STATUS (مخزن؛ لا يُرفع خطأ أبدًا) |
0x1C |
SYNCBUSY (دائمًا 0) |
0x28 |
DATA |
CTRLA البت 0 SWRST، البت 1 ENABLE، البتات 2..4 MODE، البتات 16..17 TXPO (القيمة 0 تقود PAD[0]، وأي قيمة أخرى تقود PAD[2])، البتات 20..21 RXPO (الوسد الذي يستمع إليه المستقبل)، البت 30 DORD. CTRLB البت 16 TXEN، البت 17 RXEN. INTFLAG البت 0 DRE، البت 1 TXC (مقفول، اكتب 1 للمسح)، البت 2 RXC.
BAUD هو المولّد الحسابي غير المتزامن: BAUD = 65536 (1 - 16 f / f_ref)، فزمن البت الواحد هو 16 x 65536 / (65536 - BAUD) من ساعات المرجع. يُفترض أن المرجع هو ساعة النواة 48 MHz، لعدم وجود شجرة ساعات يمكن سؤالها (القسم 3.2). قيمة BAUD تساوي 0 (ما يتركه برنامج لم يستدعِ begin()) فتعود إلى 115200. لا يوجد وضع كسري.
مرسل مفعّل وضُبط فيه TXEN يملك وسده ويمرر بتات حقيقية عبره: بت بداية منخفض، وثمانية بتات بيانات بدءًا من الأقل أهمية، وبت توقف مرتفع، كل منها بطول زمن بت واحد، وكل حافة موسومة بدورة العتاد التي كانت ستحركها فيها. مستقبل ضُبط فيه RXEN يبدأ إطارًا عند الحافة الهابطة ويأخذ عينة كل بت بيانات في منتصف زمن البت. لذا يحمل سلك واصل من D6 إلى D7 حرفًا، ومعدل باود غير متطابق يشوّه النص هنا كما يشوّهه على الطاولة الحقيقية.
على هذه اللوحة، Serial1 هو SERCOM4 مع TXPO بقيمة 0 وRXPO بقيمة 1، أي PAD[0] على PB08 وPAD[1] على PB09 (D6 وD7)، كلاهما على الوظيفة الطرفية C.
3.4 TCC0-2 وTC3-7، في حدود PWM
ثلاثة TCC وخمسة TC. العداد هنا لا يُزاد أبدًا خطوة بخطوة: بل دالة مغلقة الصيغة لدورة المعالج، وكذلك زمن حافته التالية، وهذا ما يسمح لنواة متوقفة في WFI ألا تكلّف شيئًا خلال delay() كامل بينما يستمر PWM بالعمل.
PRESCALER هو البتات 8..10 من CTRLA في النوعين، وهو لا تمثل قيمه قوى للاثنين حتى النهاية: القيم من 0 إلى 4 هي DIV1 وDIV2 وDIV4 وDIV8 وDIV16، ثم 5 هي DIV64، و6 هي DIV256، و7 هي DIV1024. تلك القفزة فخ حقيقي، والخطأ فيها يجعل PWM أبطأ أربع مرات.
TCC (0x4200_2000 + 0x400 n):
| الإزاحة | سجل |
|---|---|
0x00 |
CTRLA: البت 0 SWRST، البت 1 ENABLE، البتات 8..10 PRESCALER |
0x04/0x05 |
CTRLBCLR/CTRLBSET (مخزن) |
0x08 |
SYNCBUSY (دائمًا 0) |
0x24/0x28 |
INTENCLR/INTENSET |
0x2C |
INTFLAG: البت 0 OVF |
0x30 |
STATUS (دائمًا 0) |
0x34 |
COUNT |
0x3C |
WAVE: البتات 0..2 WAVEGEN، والقيمة 2 هي PWM العادي |
0x40 |
PER، الدورة |
0x44 + 4c |
CC0..CC3، نسب التشغيل |
0x68/0x6C/0x70 + 4c |
WAVEB/PERB/CCBn، وهي تسري فورًا هنا |
يملك TCC0 أربع قنوات مقارنة؛ بينما يملك TCC1 وTCC2 قناتين، لذا يكرر WO[2] وWO[3] فيهما WO[0] وWO[1]. هذا سبب اقتران جدول القسم 1 لبعض الأطراف.
TC (0x4200_2C00 + 0x400 n، لـ TC3 إلى TC7):
| الإزاحة | سجل |
|---|---|
0x00 |
CTRLA: البت 0 SWRST، البت 1 ENABLE، البتات 2..3 MODE (القيمة 0 COUNT16، و1 COUNT8، و2 COUNT32)، البتات 5..6 WAVEGEN، البتات 8..10 PRESCALER |
0x02 |
READREQ (مقبول، لا يفعل شيئًا: العداد محدث دائمًا) |
0x04/0x05 |
CTRLBCLR/CTRLBSET (مخزن) |
0x0C/0x0D |
INTENCLR/INTENSET |
0x0E |
INTFLAG: البت 0 OVF |
0x0F |
STATUS (دائمًا 0) |
0x10 |
COUNT، بالعرض الذي يحدده MODE |
0x14 |
PER، في COUNT8 فقط |
0x18 + c |
CC0، CC1، يفصل بينهما بايت في COUNT8، واثنان في COUNT16، وأربعة في COUNT32 |
في وضع PWM العادي (WAVEGEN = 2) تكون قمة TC هي PER في وضع COUNT8 وعرض العدّاد الكامل فيما عدا ذلك؛ أما في مطابقة PWM (WAVEGEN = 3) فـ CC0 هو الدورة وCC1 هو نسبة الإشغال. مخرج الموجة مرتفع من بداية الدورة حتى حدوث المطابقة ومنخفض بعدها، لذا فإن المطابقة عند 0 تعطي مستوى منخفضًا ثابتًا، والمطابقة فوق القمة تعطي مستوى مرتفعًا ثابتًا، دون أي حافة على الإطلاق. هذا هو الشكل الذي يريده analogWrite وهو الشكل الوحيد الذي ينتجه هذا النموذج.
يصل علم تجاوز السعة إلى NVIC عندما تكون خانة INTENSET الخاصة به مضبوطة. الالتقاط، ونظام الأحداث، والوضع الأحادي، والمنحدر، والترقية، وإدراج زمن السكون، وتوليد الأنماط، ومداخل الأعطال، كلها غير موجودة.
3.5 محول ADC (0x4200_4000)
تحويلات مفردة يتم تفعيلها برمجيًا، وهذا هو المسار الوحيد الذي يسلكه analogRead.
| الإزاحة | سجل | |
|---|---|---|
0x00 |
CTRLA |
الخانة 0 SWRST، الخانة 1 ENABLE |
0x01 |
REFCTRL |
مخزَّنة وتُقرأ مرة أخرى |
0x02 |
AVGCTRL |
مخزَّنة وتُقرأ مرة أخرى |
0x03 |
SAMPCTRL |
مخزَّنة وتُقرأ مرة أخرى |
0x04 |
CTRLB |
الخانتان 4..5 RESSEL: 0 اثنتا عشرة خانة، 2 عشر خانات، 3 ثماني خانات |
0x06 |
WINCTRL |
مخزَّنة وتُقرأ مرة أخرى |
0x08 |
SWTRIG |
الخانة 0 FLUSH، الخانة 1 START |
0x0C |
INPUTCTRL |
الخانات 0..4 MUXPOS؛ MUXNEG وGAIN مخزّنة |
0x10 |
EVCTRL |
مخزَّن |
0x12/0x13 |
INTENCLR/INTENSET |
|
0x14 |
INTFLAG |
الخانة 0 RESRDY، الخانة 1 OVERRUN |
0x15 |
STATUS |
دائمًا 0 |
0x16 |
RESULT |
قراءته تمسح RESRDY |
0x18..0x22 |
WINLT، WINUT، GAINCORR، OFFSETCORR، CALIB، DBGCTRL |
مخزَّنة وتُقرأ مرة أخرى |
تحويل واحد: وجّه MUXPOS إلى القناة، واكتب SWTRIG.START، وانتظر RESRDY، ثم اقرأ RESULT. يستغرق ذلك 6 ميكروثوانٍ ثابتة من وقت المحاكاة، والبرنامج الثابت ينتظرها فعلًا. الناتج هو round(4095 x Vin / 3.3) من جهد الوسادة في لحظة بدء التحويل، منزاحًا إلى الأسفل إذا كان RESSEL أقل من اثنتي عشرة خانة. القناة التي لا يثبّت طرفها شيء تقرأ 0.
المرجع والتكبير لا يفعلان شيئًا هنا. يُخزَّن REFCTRL.REFSEL وINPUTCTRL.GAIN ويُقرآن، لكن النموذج يقيس دائمًا بالنسبة إلى خط التغذية 3.3 فولت، وهو ما تنتهي إليه إعدادات أنوية Arduino نفسها، INTVCC1 مع تكبير DIV2، على هذه اللوحة. الكود الذي يبدّل إلى المرجع الداخلي 1.0 فولت يحصل هنا على نفس الأرقام التي كان سيحصل عليها عند INTVCC1، وهذا المستند يصرّح بذلك بدلًا من اختراع معامل تحجيم. المتوسطات، ومراقب النافذة، والتصحيحات، ووضع التشغيل الحر، والوضع التفاضلي، ونظام الأحداث، كلها غير موجودة.
القنوات 0..19 موجودة. جدول القسم 1 يربطها بالوسائد.
3.6 متحكم EIC (0x4000_1800)
ستة عشر خط EXTINT، وهي ما بُني عليه attachInterrupt. تصل الوسادة إلى المتحكم بأخذ الوظيفة الطرفية A، والخط الذي تهبط عليه تحدده الوسادة نفسها (القسم 1).
| الإزاحة | سجل |
|---|---|
0x00 |
CTRL: الخانة 0 SWRST، الخانة 1 ENABLE |
0x01 |
STATUS: الخانة 7 SYNCBUSY، دائمًا 0 |
0x02/0x03 |
NMICTRL/NMIFLAG (مخزّن؛ إنذار NMI نفسه لا يُطلَق) |
0x04 |
EVCTRL (مخزّن) |
0x08/0x0C |
INTENCLR/INTENSET |
0x10 |
INTFLAG |
0x14 |
WAKEUP (مخزّن) |
0x18/0x1C |
CONFIG0/CONFIG1: أربع خانات SENSE وخانة FILTEN واحدة لكل خط |
SENSE: 0 لا شيء، 1 صاعدة، 2 هابطة، 3 كلاهما، 4 مستوى مرتفع، 5 مستوى منخفض. تُثبَّت الحافة في INTFLAG ويُكتب عليها لمسحها. المستوى يُبقي INTFLAG مضبوطًا ما دام الطرف على ذلك المستوى، لذا فإن المعالج الذي لا يزيل الشرط يعمل من جديد، تمامًا كما يحدث على القطعة الحقيقية. FILTEN مخزّن ولا يرشّح شيئًا.
الخطوط الستة عشر تشترك في متجه NVIC واحد؛ وقت التشغيل يقرأ INTFLAG ويستدعي المعالجات المرفقة أيًّا كانت.
3.7 جهاز USB (0x4100_5000): كعب يحمل البايتات
على XIAO يذهب المنفذ الوحيد على اللوحة إلى منفذ USB الخاص بشريحة SAM D21 نفسها، والشاشة التسلسلية على مكتبك تتحدث مع واجهة CDC ACM يُعَدّدها البرنامج الثابت للكود. هذه هي الحقيقة التي تجعل اللوحة ما هي عليه، وهي أيضًا الحقيقة التي تجعلها صعبة: لا وجود لـ Serial حتى يجيب البرنامج الثابت على عشرات عمليات النقل التحكم.
ما هو موجود هنا أنبوب يحمل أسماء السجلات، ومسار النقل هو المسار الحقيقي للقطعة.
| الإزاحة | سجل |
|---|---|
0x00 |
CTRLA: الخانة 0 SWRST، الخانة 1 ENABLE، الخانة 7 MODE |
0x02 |
SYNCBUSY (دائمًا 0) |
0x03 |
QOSCTRL (مخزّن) |
0x08 |
CTRLB: الخانة 0 DETACH، مضبوطة عند إعادة التعيين |
0x0A |
DADD (مخزّن) |
0x0C/0x0D/0x10 |
STATUS، FSMSTATUS، FNUM: جميعها تقرأ 0؛ لا يوجد ناقل ليكون له حالة |
0x14/0x18/0x1C |
INTENCLR/INTENSET/INTFLAG (مخزّنة؛ لا يُرفع شيء أبدًا) |
0x20 |
EPINTSMRY |
0x24 |
DESCADD |
0x28 |
PADCAL (مخزّن) |
0x100 + 0x20 n |
النقطة الطرفية n: EPCFG +0، EPSTATUSCLR +4، EPSTATUSSET +5، EPSTATUS +6، EPINTFLAG +7، EPINTENCLR +8، EPINTENSET +9 |
جدول الوصف عند DESCADD هو الحقيقي: مصرفان لكل نقطة طرفية، ستة عشر بايت لكل مصرف، ADDR عند +0 وPCKSIZE عند +4 مع BYTE_COUNT في الخانات 0..13 وSIZE في الخانات 28..30.
- IN. يملأ البرنامج الثابت مخزنًا مؤقتًا، ويكتب الطول في
PCKSIZEللمصرف 1 ويضبطEPSTATUS.BK1RDY. يقرأ النموذج تلك البايتات من SRAM، ويسلّمها إلى الشاشة التسلسلية، ويمسحBK1RDYويرفعEPINTFLAG.TRCPT1. - OUT. يمسح البرنامج الثابت
EPSTATUS.BK0RDYللإشارة إلى أن البنك 0 فارغ. تنسخ المحاكاة ما كتبته الشاشة التسلسلية إلىADDRالخاص بالبنك 0، وتكتب الطول فيPCKSIZEالخاص به، ثم تضبطBK0RDYوترفعEPINTFLAG.TRCPT0.
لا شيء آخر عن USB هنا. لا يوجد مضيف ولا ناقل ولا إعادة تعيين ولا حزمة SETUP ولا وصف ولا تعداد ولا عنونة ولا عدّاد إطارات ولا إطار بداية كل 1 ms ولا NAK ولا STALL ولا LPM. INTFLAG لا يُرفع أبدًا، ومقاطعة USB لا تصل أبدًا إلى NVIC، لذا تقوم بيئة التشغيل بالاستقصاء. الكود الذي يشغّل هذا بالطريقة التي تشغّل بها نواة Arduino السيليكون الحقيقي سيظل يعمل (فهو يستقصي بتات جاهزية البنوك، وهي تعمل)، لكن الكود الذي ينتظر التعداد سينتظر إلى الأبد، لذا while (!Serial) {} يعود فورًا هنا بينما ينتظر على الطاولة. لوحة المفاتيح والفأرة، وهما النصف الآخر من الغرض من لوحة USB أصيلة، غير متاحتين إطلاقًا.
لا يوجد معدل باود على هذه القناة، وهذا ليس اختصارًا: منفذ CDC ACM لا يملك معدل باود خاصًا به. Serial.begin(115200) يمرر رقمًا كان سيصل إلى المضيف كطلب ترميز سطر، والمضيف حر في تجاهله.
3.8 المقاطعات
يقع NVIC في النواة على عنوانه المعماري، مع بتّي أولوية. جدول المتجهات هو جدول SAM D21: 0 PM، و1 SYSCTRL، و2 WDT، و3 RTC، و4 EIC، و5 NVMCTRL، و6 DMAC، و7 USB، و8 EVSYS، و9..14 SERCOM0..5، و15..17 TCC0..2، و18..22 TC3..TC7، و23 ADC، و24 AC، و25 DAC، و26 PTC، و27 I2S.
الخطوط التي يرفعها هذا النموذج فعليًا: EIC، وSERCOM0..5، وADC، وTCC0..2 وTC3..TC7. خط USB لا يُرفع (القسم 3.7)، وكذلك لا يُرفع خط أي شيء آخر.
4. قناة المضيف
host_write يضع البايتات في طابور استقبال USB؛ وhost_read يأخذ البايتات التي خرجت منه. هذا هو Serial في الكود والشاشة التسلسلية في الواجهة. البايتات هي UTF-8 من وجهة نظر الواجهة، وغير شفافة بالنسبة للنموذج.
Serial1 ليس قناة المضيف. فهو يذهب إلى D6 وD7 ولا شيء غيرهما، لذا ما يطبعه الكود هناك يصل إلى الشاشة التسلسلية فقط إذا أعاده شيء ما على لوحة التجارب.
5. نموذج الزمن والقطعة
بيكوثانية في u64، مثل النواة. تعمل النواة عند 48 MHz، فالدورة الواحدة هي 20833.33 ps، وليست عددًا صحيحًا، ولهذا السبب لا يُجمع الوقت أبدًا: بل يُعاد حسابه دائمًا من عدد الدورات كـ cycles x 1_000_000 / 48. الشريحة مدتها 10 us هي بالضبط 480 دورة وبالضبط 10,000,000 ps، لذا لا تنحرف حدود الشرائح أبدًا. عدّاد الدورات مربوط بزمن النواة عند بداية كل شريحة، فلا يمكن للمؤقّت أن ينحرف عن الدائرة مهما وقعت الشرائح، والنواة المتوقفة تلحق بالدورات التي نامت خلالها، بما في ذلك SysTick، وهو ما يعدّه millis().
تعمل الشريحة على سرعتين، كما تفعل نماذج STM32: دفعات خشنة محدودة بموعد الطرفية التالي، وتعليمة واحدة في كل مرة لمدة 100 us بعد أي كتابة تقع على مسجّل PORT أو SERCOM أو مؤقّت أو USB. فالبرنامج الذي يلمس طرفًا يعمل بالسرعة الدقيقة، والبرنامج الذي يحسب يعمل بالسرعة الخشنة.
probe هو قناع بتّي: 1 قيد التشغيل، و2 متوقف في WFI، و4 LED المستخدم مضاء، و8 LED الاستقبال، و16 LED الإرسال، و32 إرسال تسلسلي خلال آخر 20 ms، و64 استقبال تسلسلي؛ و0 بلا برنامج. بتات LED الثلاثة صحيحة الاتجاه بالفعل: الفتحات نشطة بمستوى منخفض وقد قلبتها القطعة.
poke: 1 يُبقي إعادة التعيين، و0 يُطلقها.
6. بيئة تشغيل البرنامج الثابت (firmware/xiao/)
بيئة تشغيل على طراز Arduino كُتبت لهذه اللوحة: setup() وloop()، وpinMode، وdigitalWrite، وdigitalRead، وshiftOut، وanalogRead (مع analogReadResolution)، وanalogWrite، وmillis، وmicros، وmicros64، وdelay، وdelayMicroseconds، وattachInterrupt، وdetachInterrupt، وinterrupts، وnoInterrupts، وSerial وSerial1. لا Atmel Software Framework، ولا نواة Arduino، ولا CMSIS، ولا newlib، ولا libgcc، ولا compiler-rt.
delay() يوقف النواة: فهو ينفّذ WFI ومقاطعة SysTick التالية توقظها. النواة المتوقفة لا تنهي أي تعليمات، والنواة تقفز مباشرة إلى وقت الاستيقاظ، لذا يقضي blink ثانيته من الزمن المحاكى على ألف مقاطعة بدلًا من ثمانية وأربعين مليون دورة. أما التأخير داخل noInterrupts() فينتظر بالدوران بدلًا من ذلك، لأن نواة متوقفة مع ضبط PRIMASK لن تشغّل أبدًا المعالج الذي يقدّم الساعة.
analogWrite هو ثماني بتات عند 732.42 Hz (256 عدًّا، وPER بقيمة 255، من ساعة 48 MHz مقسومة على 256: أي 48 MHz / 256 / 256، وهي تردد Arduino Zero) على الفتحات العشر التي تصل إلى مؤقّت. القيمتان 0 و255 ليستا PWM: فهما تعيدان الفتحة إلى PORT وتقودانها منخفضة أو مرتفعة، لذا analogWrite(pin, 0) إطفاء حقيقي.
بُني باستخدام clang --target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb، مع الربط مقابل firmware/xiao/link.ld بواسطة ld.lld. خمسة من ملفات بيئة التشغيل هي ملفات Raspberry Pi Pico، جرت ترجمتها من جديد لهذه اللوحة بدلًا من نسخها: تنسيق الأرقام، ومساعدات الرياضيات، ودالة floor المستقلة، وPrint. كلتا القطعتين Cortex-M0+ ولا شيء في أي من تلك الملفات يعتمد على مكان وجود طرفية. أما ملفات هذه اللوحة نفسها فهي ترويسة المسجّلات، وجدول الأطراف، وكود الإقلاع، ونص الرابط، وصنفا المنفذ التسلسلي، ودرايفرات GPIO والتناظري والوقت وSERCOM وUSB والمقاطعات. أما مساعدات القسمة والضرب والإزاحة في AEABI داخل crt0.S فهي ملفات Pico تعليمة بتعليمة، لأن عقود مسجّلاتها تخص الـ ABI لا الشريحة.
سلسلة program في الفهرس هي elf32 arm samd21. وتختلف عن elf32 arm rp2040 الخاصة بـ Pico لأن ملف ELF يختلف فعلًا: مجموعة التعليمات نفسها، وخريطة ذاكرة مختلفة، وصورة مربوطة لأحدهما لن تعمل على الآخر.
أربعة أمثلة: blink (LED المستخدم وآخر على D10)، وbutton (مفتاح على D2، على EXTINT10)، وserial (كلا المنفذين، مع سلك ربط من D6 إلى D7) وanalog (مقاومة متغيرة على A10 وتلاشٍ تدريجي على D9). ميزانية المثال 32 KB، والسقف الحقيقي الذي يفرضه نص الرابط هو 32 KB من SRAM.
7. ما تثق به هذه المواصفة، وما لا تثق به
ثلاث مجموعات. هذا القسم موجود لأن نموذج لوحة يخمّن عنوانًا بصمت أسوأ من نموذج يقول إنه لم يعرف.
مأخوذ من ورقة البيانات. خريطة الذاكرة في القسم 2: ذاكرة flash بحجم 256 KB عند العنوان صفر، وذاكرة SRAM بحجم 32 KB عند 0x2000_0000، والعناوين الأساسية لـ PM وSYSCTRL وGCLK وEIC وPORT وUSB والـ SERCOMs الستة وTCC0-2 وTC3-7 والـ ADC، مع الخطوات 0x400 بين المتناظرات. تخطيط سجلات PORT وخطوة المجموعة 0x80 الخاصة به، بما في ذلك قاعدة اختيار OUT للسحب ومواضع حقول WRCONFIG. تخطيط USART في SERCOM وصيغة حساب سرعة البث. تخطيط TCC. تخطيط ADC. تخطيط EIC وحقول SENSE ذات الأربع بتات. سجلات جهاز USB، وخطوة نقطة النهاية 0x20 ومصرف الواصف ذي الستة عشر بايت مع ADDR وPCKSIZE. ترميز PRESCALER، بما في ذلك القفزة من DIV16 إلى DIV64. أرقام متجهات المقاطعات في القسم 3.8. بتان لمن الأولوية في NVIC.
مُصدَّق، لا مُتحقَّق منه. أمران، والبرنامج المُعدّ للسيليكون الحقيقي ينبغي أن يتحقق من كليهما:
- إزاحات سجلات كتلة TC في القسم 3.4:
CTRLA0x00,READREQ0x02,CTRLBCLR/CTRLBSET0x04/0x05,CTRLC0x06,DBGCTRL0x08,EVCTRL0x0A,INTENCLR/INTENSET0x0C/0x0D,INTFLAG0x0E,STATUS0x0F,COUNT0x10,PER0x14,CC0x18. أما إزاحات TCC فيستطيع هذا النموذج تقريرها؛ وإزاحات TC هي أفضل قراءة لديه لكتلة يتغيّر تخطيطها معMODE، وهي الأرقام التي يُبنى عليهاfirmware/xiao/include/samd21.h، لذا فإن البرنامج الثابت المُبنى هنا يوافق النموذج سواء وافق السيليكون أم لا. - جدول تعدّد إرسال الأجهزة الطرفية في القسم 1: أي عمود
PMUXعلى كل لوح يحمل أي لوح SERCOM، وأي خطEXTINTوأي مخرج موجة. الأرقام خلف كل طرف XIAO هي أرقام اللوحة وهي ما يعتمد عليه البرنامج الثابت؛ وأي قناة مؤقّت يستطيع اللوح الوصول إليها هي ما يعتمد عليه كود PWM، والخطأ هناك يظهر كطرف لا تتلاشى إضاءته تدريجيًا لا كرقم خاطئ.crates/atsamd21/src/mux.rsهو الجدول كله في مكان واحد.
معرّفات عملاء الساعة العامة في samd21.h (GCLK_ID_EIC وغيرها) في المجموعة نفسها. لا شيء هنا مشروط عليها (القسم 3.2)، فالخطأ في أحدها غير مرئي في Mokxi لكنه يوقف جهازًا طرفيًا تمامًا على منضدة حقيقية.
غائبة عمدًا. ترك كل منها بدل اختلاقه:
- شجرة الساعة. لا DFLL ولا مذبذبات ولا PLL ولا مولّدات. القسم 3.2 يوضّح ما يقوم مقامها.
- SPI و I2C على وحدات SERCOM. القسم 3.3 هو وضع USART لا غير، لذا لا يتوفر
WireوSPI. - الـ DAC وهو الغرض الحقيقي من PA02، والمقارنات التماثلية، وPTC وI2S.
- DMAC و EVSYS. لا DMA ولا روابط أحداث بين الأجهزة الطرفية، وهي ما كانت سجلات
EVCTRLللمؤقّتات ستستخدمها. - NVMCTRL وبرمجة الفلاش، ومشاهد العطب (watchdog)، وRTC وDSU. مُسندة وخاملة (القسم 2).
- كل ما هو USB فوق أنبوب بايتات، ويشرحه القسم 3.7 بالتفصيل، ومعه Keyboard وMouse.
- The UF2 bootloader. An image here starts at zero; a real XIAO's starts at 0x2000 (section 2).
لهذا لا تعمل ملفات Arduino core الثنائية الرسمية هنا، بينما يعمل البرنامج الثابت المُبنى لهذا المستند.