هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة Arduino Uno R4 Minima و صفحة اللوحة.
لوحة Arduino Uno R4 Minima هي شريحة Renesas RA4M1 (معالج Cortex-M4 بتردد 48 MHz) في هيئة Uno. مكوّن نواة واحد (unor4 في crates/parts) يغلّف نموذج SoC للشريحة RA4M1 (crates/unor4) على نفس نواة ARMv7-M المستخدمة في Blue Pill و Black Pill (crates/cortexm-core). النواة مشتركة؛ أما الشريحة حولها فلا، ولا شيء يتعلق بالأطراف مشترك.
نوع الفهرس هو unor4. هذا المستند هو العقد، وهو يسود أي تعليق في الكود.
اقرأ القسم 7 أولًا إذا كنت ستنقل بناءً من هنا إلى شريحة حقيقية. هذا النموذج أصغر من RA4M1، وعدة عناوين فيه موسومة بـ"مُعتقدة، غير مُتحقَّق منها": القسم 7 يبيّن أيّها، وما هو غائب كليًا. لا شيء هنا يُخمَّن في صمت.
لماذا ليست هذه Blue Pill بأرقام مختلفة
شريحة RA عالم آخر غير STM32، والفروق هي التي يتعثر بها الكود:
- الطرف سجل واحد. سجل
PmnPFSهو كلمة 32 بت لكل طرف تحمل الاتجاه، ومزلاج الخرج، ومقاومة الرفع، والصرف المفتوح، ومفتاح التناظري، و"محيطي يملك هذا الطرف الآن"، وأيّ محيطي. لا يوجدMODER، ولاCRL/CRH، ولاPUPDRولاAFR. - ذلك السجل محمي من الكتابة. يجب أن تُصفَّر بتة
PWPR.B0WIوتُضبط بتةPWPR.PFSWEقبل أن تنفذ أي كتابة إلىPmnPFS. البرنامج الذي ينسى ذلك يجدdigitalWriteيعمل وpinModeلا يفعل شيئًا إطلاقًا. هذا النموذج يفرض ذلك ويَعُدّ ما ألقاه بعيدًا. - لا ساعة لأي محيطي حتى تقول ذلك. كل بتة في سجلات إيقاف الوحدات تُعاود الضبط إلى "موقوفة". وSCI وGPT وADC14 وUSB كلها غير متاحة (القراءات ترجع صفرًا) حتى تُكتب
MSTPCRB/MSTPCRD. - هناك مقاومة رفع ولا مقاومة خفض. الخيار
INPUT_PULLDOWNيعطي هنا طرفًا عائمًا عاديًا، ويقول ذلك. - منفذ
Serialهو USB، وليس UART. منفذ UART على D0 و D1 هوSerial1. على Uno الاثنان شيء واحد. - المحول بأربع عشرة بتة. الدالة
analogReadما زالت ترجع عشر بتات، لأن هذا ما يتوقعه كود Arduino؛ وanalogReadResolutionتطلب الباقي. - الفلاش عند العنوان صفر. لا اسم بديل، ولا طرف BOOT، وكلمة إعدادات عند
0x400تقرأها القطعة الحقيقية عند الخروج من إعادة الضبط. - LED اللوحة المدمج يعمل بالمستوى المرتفع، مثل Uno وعلى عكس Blue Pill.
1. أطراف اللوحة (بترتيب الفهرس)
فتحة مقابل فتحة، رأس Uno R3، وهذا ما يسمح لـ R4 بتركيب درع Uno. مقاس اللوحة 68.6 x 53.3 mm.
الصف العلوي، من اليسار إلى اليمين (14 فتحة): 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، A1، A2، A3، A4، A5.
31 طرفًا. الأسماء المكررة تحمل حرفًا لأن أسماء الأطراف في الفهرس فريدة.
الطرفان SCL وSDA بجانب AREF هما نفس قطعتي المعدن اللتين لـ A5 وA4: مسار واحد، وفتحتان، كما في Uno. تشغيل أي الطرفين يشغّلهما معًا.
طرف RA4M1 الذي يقع خلف كل فتحة:
| الفتحة | الوسادة | وأيضًا |
|---|---|---|
0 |
P301 | RXD2، استقبال Serial1 |
1 |
P302 | TXD2، إرسال Serial1 |
2 |
P104 | |
3 |
P105 | PWM |
4 |
P106 | |
5 |
P107 | PWM |
6 |
P111 | PWM |
7 |
P112 | |
8 |
P303 | |
9 |
P304 | PWM |
10 |
P103 | PWM، SS |
11 |
P411 | PWM، MOSI |
12 |
P410 | MISO |
13 |
P102 | SCK، LED_BUILTIN |
A0 |
P014 | AN009 |
A1 |
P000 | AN000 |
A2 |
P001 | AN001 |
A3 |
P002 | AN002 |
A4 |
P101 | AN021، SDA |
A5 |
P100 | AN022، SCL |
رقما القناة لـ A4 وA5 غير مُتحقَّق منهما (القسم 7). الأربعة الأخرى كذلك ليست.
كهربائيًا: كل طرف إدخال/إخراج يدفع بشكل push-pull عند 5 فولت عبر R_STRONG، أو يبقى في حالة مقاومة عالية (high-Z)، أو يُسحب للأعلى عبر مقاومة 35 كيلو أوم. لا توجد مقاومة سحب للأسفل داخلية. يقرأ المدخل مستوى عاليًا عند 2.5 فولت؛ والشبكة المتنازع عليها (Unknown) تُقرأ 0، والطرف العائم يقرأ ضجيجًا، كما في Uno (القسم 1 من docs/uno.md). 5V وIOREF تدفعان 5 فولت عبر R_SUPPLY، و3V3 يدفع 3.3 فولت، والأرضيات الثلاثة تدفع 0 فولت. يحمل RESET مقاومة سحب للأعلى بقيمة 10 كيلو أوم إلى 5 فولت، وسحبه تحت 2.5 فولت يُبقي النواة في حالة إعادة تعيين. أما VIN وAREF فهما مدخلان يقرأهما النموذج ولا يفعل بهما شيئًا.
الطرف 13 يحمل LED المدمج: حمل بقيمة 1 كيلو أوم إلى الأرض، يُضاف فقط عندما يكون الطرف مخرجًا، حتى يظل pinMode(13, INPUT_PULLUP) يعمل كما يُتوقع. مهبط LED على الأرض، لذا الطرف يُغذّي التيار لإضاءته.
2. خريطة الذاكرة
| ذاكرة فلاش الكود | 256 KB عند 0x0000_0000 |
| ذاكرة الإعدادات (option-setting memory) | 0x0000_0400، كلمتان، تُخزَّنان ولا تُفكّ شيفرتهما |
| SRAM | 32 KB عند 0x2000_0000 |
| قمة المكدس | 0x2000_8000 |
| PORT و PFS | 0x4004_0000، القسمان 3.1 و 3.2 |
| إيقاف الوحدة (module stop) | 0x4004_7000، القسم 3.7 |
| وحدة ADC14 رقم 0 | 0x4005_C000، القسم 3.5 (مُرجَّح) |
| SCI0..SCI9 | 0x4007_0000، بتباعد 0x20، القسم 3.4 |
| GPT0..GPT7 | 0x4007_8000، بتباعد 0x100، القسم 3.3 (مُرجَّح) |
| USBFS | 0x4009_0000، القسم 3.6 (مُرجَّح) |
The code flash really is at zero. There is no alias and no boot pin to choose one, so the vector table is at address 0 and VTOR's reset value is already right. A flash address that looks like a null pointer is the vector table, not a bug.
يجب أن يقع كل مقطع PT_LOAD داخل الذاكرة الوامضة أو SRAM؛ أي شيء آخر يُرفض مع بيان السبب، وتبقى الشريحة بلا برنامج. ذاكرة البيانات الوامضة (8 KB عند 0x4010_0000) وواجهتها البرمجية غير مُحاكاتَين.
ذاكرة الإعدادات (option-setting memory) عند 0x0000_0400 هي المكان الذي تقرأ منه شريحة RA4M1 حقيقية قيمة OFS0 بعد إعادة الضبط لتقرر ما إذا كانت أجهزة watchdog تبدأ من تلقاء نفسها. يضع firmware/unor4/crt0.S كلمة هناك ويتحقق link.ld من أنها تقع عند 0x400؛ هذا الطراز لا يحتوي على watchdog ولا يفكّ شيفرتي أي من الكلمتين. صورة بدونه تُقلع هنا ثم تعيد ضبط نفسها على المنضدة، ولهذا فهي ليست اختيارية.
النواة هنا Cortex-M4 بلا FPU. شريحة RA4M1 تحتوي على FPU بدقة مفردة؛ لكن cortexm-core ينفّذ الجزء الصحيح من ARMv7E-M فقط ولا ينفّذ VFP إطلاقًا، فسجل CPACR يُخزَّن ولا يمنح شيئًا، وكل ترميز VFP يطلق استثناء UNDEFINSTR. ترجم البرنامج الثابت باستخدام -mfloat-abi=soft -mfpu=none. العمليات الحسابية بالفاصلة العائمة في الكود تعمل وتُنفَّذ بتعليمات صحيحة؛ أما ملف تنفيذي مبني بـ hard-float في مكان آخر فيقع في خطأ عند أول تعليمة VFP بدلًا من أن يعيد رقمًا خاطئًا. أربعة بتات للأولوية، كما في القطعة الأصلية.
3. سجلات الطرفيات
المنفَّذ هو المجموعة الفرعية أدناه فقط. أي شيء آخر داخل كتلة مُوَجهة يُقرأ 0 ويُحتسب وصولًا شاردًا؛ وأي شيء خارج كل الكتل يُحتسب خطأ وصول. الوحدة التي ضُبط بت إيقافها (القسم 3.7) تُقرأ 0 وتُحتسب وصولًا شاردًا أيضًا، وهذا هو شكل «الساعة متوقفة» كما يبدو من الناقل.
3.1 PORT0..PORT5 (0x4004_0000، بتباعد 0x20)
| الإزاحة | سجل | نصفان |
|---|---|---|
0x00 |
PCNTR1 |
الـ16 بت المنخفضة في PDR، والـ16 بت المرتفعة في PODR |
0x04 |
PCNTR2 |
الـ16 بت المنخفضة في PIDR، والـ16 بت المرتفعة في EIDR (قراءة فقط) |
0x08 |
PCNTR3 |
الـ16 بت المنخفضة في POSR تضبط، والـ16 بت المرتفعة في PORR تمسح (كتابة فقط) |
0x0C |
PCNTR4 |
EOSR/EORR، مخزَّنان |
PCNTR3 is this part's BSRR, with the halves the other way around from an STM32's: the low half sets. A bit set in both halves of one write ends up clear. digitalWrite is one store to it and cannot race an interrupt handler touching another bit.
PIDR يقرأ الطرف نفسه لا اللاقط (latch): المخرج push-pull يقرأ ما يدفعه، والمدخل أو المخرج open-drain يقرأ آخر قيمة عيّنتها اللوحة من الشبكة.
المنافذ من 0 إلى 5 مُحاكاة، وهذا يغطي كل الأطراف التي تُخرجها لوحة Minima وكل مدخل تناظري في حزمة الـ64 طرفًا. الوسائد المعدنية (pads) مرقّمة بحسب port * 16 + pin.
3.2 PmnPFS (0x4004_0800، بتباعد 0x40 لكل منفذ، و4 بايتات لكل طرف) و PWPR (0x4004_0D03)
كلمة واحدة بحجم 32 بت لكل طرف عند 0x4004_0800 + 0x40*m + 4*n. الأسماء البايتية ونصف الكلمة التي يذكرها الدليل (PmnPFS_BY، PmnPFS_HA) هي اتحاد مع سجل الـ32 بت، لذا فهي في هذه القطعة ذات الترتيب البايتي الصغير بايتها المنخفض ونصف كلمتها المنخفض، ولهذا يمكن أن تكون pinMode كتابة بايت واحد.
| البت | الاسم | المعنى |
|---|---|---|
| 0 | PODR |
لاقط المخرج (output latch) |
| 1 | PIDR |
الجهد على الطرف، قراءة فقط |
| 2 | PDR |
1 = مخرج، 0 = مدخل |
| 4 | PCR |
مقاومة السحب الداخلية (pull-up) |
| 6 | NCODR |
مصرف مفتوح بقناة N (open drain) |
| 10..11 | DSCR |
قوة الدفع، مخزَّنة |
| 12..13 | EOFR |
حدث عند الحافة، مخزَّن |
| 14 | ISEL |
تمكين مدخل المقاطعة (IRQ)، مخزَّن (القسم 3.8) |
| 15 | ASEL |
تمكين المدخل التناظري |
| 16 | PMR |
1 = طرف طرفي (peripheral) يملك الطرف |
| 24..28 | PSEL |
أي طرف طرفي |
الطرف الذي ضُبط فيه ASEL يكون كهربائيًا عالي المقاومة (high-Z) مهما قالت بقية الكلمة، وهو النوع الوحيد الذي يجوز للمحوّل أخذ عينة منه. الطرف الذي ضُبط فيه PMR يتبع الوحدة الطرفية المُحاكاة التي يسمّيها PSEL ويتجاهل PODR؛ وقيمة PSEL غير المنفَّذة في هذا الطراز تترك اللوحة كما هي بدلًا من اختلاق جهد لها.
PSEL القيم التي يتصرف عليها هذا الطراز: 0b00011 GPT و 0b00100 SCI. كلاهما مُرجَّح وغير مُتحقَّق منه (القسم 7).
PWPR بايت واحد عند 0x4004_0D03. B0WI (bit 7) resets set and makes PFSWE (البتة 6) غير قابلة للكتابة؛ كتابة صفر فيها تمسحها، ثم كتابة PFSWE تسمح بكتابات PFS. الكتابة مع ضبط B0WI تترك PFSWE كما هي. أما الكتابة مع PmnPFS بينما PFSWE ممسوحة فلا تُنفَّذ، والنموذج يحسبها (protected_writes)، لأن هذا هو الفشل الصامت الذي تشتهر به هذه القطعة.
3.3 GPT0..GPT7 (0x4007_8000، بتباعد 0x100)
يعدّ GPT0 و GPT1 على 32 بتة؛ أما GPT2 إلى GPT7 فتعدّ على 16 بتة.
| الإزاحة | سجل |
|---|---|
0x00 |
GTWP |
0x04 |
GTSTR |
0x08 |
GTSTP |
0x0C |
GTCLR |
0x2C |
GTCR |
0x30 |
GTUDDTYC |
0x34 |
GTIOR |
0x38 |
GTINTAD |
0x3C |
GTST |
0x40 |
GTBER |
0x48 |
GTCNT |
0x4C |
GTCCRA |
0x50 |
GTCCRB |
0x54 |
GTCCRC |
0x58 |
GTCCRE |
0x5C |
GTCCRD |
0x60 |
GTCCRF |
0x64 |
GTPR |
0x68 |
GTPBR |
GTCR.CST (البتة 0) هي بتة التشغيل. GTCR.TPCS (البتات 24..26) هي المقسِّم، PCLKD / 4^TPCS، أي 1 و 4 و 16 و 64 و 256 و 1024؛ والقيمة المحجوزة تُعامل كـ 1024. GTCR.MD (البتات 16..18) تُخزَّن؛ ولا يُحاكى سوى العدّ التصاعدي الموجي المنشاري. تقبل GTSTR و GTSTP و GTCLR قناع بتات للقنوات لتشغيلها أو إيقافها أو تصفيرها. يُكتب GTPR و GTPBR معًا، لأن نقل المخزن المؤقت الذي كان سيقوم به هذا النموذج عند نهاية الدورة سيحمل القيمة نفسها.
العدّاد لا يُخزَّن أبدًا كرقم يتزايد: بل يُحسب من دورة المعالج بالصيغة (cycle - started) / divider mod (GTPR + 1)، فلا يمكن أن ينحرف عن الدائرة، وقراءة GTCNT في منتصف شريحة زمنية تعطي العدد عند تلك التعليمة.
The output is this model's own rule, and a simplification. GTIOR.OAE (bit 8) and GTIOR.OBE (bit 24) decide whether GTIOCnA and GTIOCnB are driven; the level is high while the count is below the channel's compare register and low otherwise. A compare of zero is permanently low and a compare above GTPR permanently high, which is what analogWrite(pin, 0) and analogWrite(pin, 255) need. The five-bit GTIOA and GTIOB level-select fields in GTIOR, which on silicon can produce an inverted output or a toggle, are stored and read back and not decoded. firmware/unor4/src/pwm.c writes the setting a real GPT would need anyway, so a build taken to a desk is configured and not merely enabled.
مخرج GPT لكل طرف PWM هو:
| طرف | الوسادة | مخرج |
|---|---|---|
3 |
P105 | GTIOC1B |
5 |
P107 | GTIOC2B |
6 |
P111 | GTIOC3A |
9 |
P304 | GTIOC5B |
10 |
P103 | GTIOC4B |
11 |
P411 | GTIOC6A |
هذا الجدول غير موثَّق (القسم 7). الأطراف الستة هي أطراف PWM الموثقة في Minima؛ أما أي قناة وأي مخرج يقابل كل طرف فهو اجتهاد هذا النموذج. النموذج وبيئة التشغيل متفقان، فالكود المبني هنا يعمل هنا.
تتجنب بيئة التشغيل استخدام GPT0 عمدًا.
3.4 SCI0..SCI9 (0x4007_0000، بتباعد 0x20)
سجلات من بايت واحد متتالية: العناوين المتجاورة هي سجلات مختلفة، فالوصول الأعرض لا يصل إلا إلى البايت عند العنوان المعطى.
| الإزاحة | سجل |
|---|---|
0x00 |
SMR |
0x01 |
BRR |
0x02 |
SCR |
0x03 |
TDR |
0x04 |
SSR |
0x05 |
RDR |
0x06 |
SCMR |
0x07 |
SEMR |
0x08 |
SNFR |
0x09..0x0B |
SIMR1..SIMR3 |
0x0C |
SISR |
0x0D |
SPMR |
SCR: TE (5) و RE (4) هما المفتاحان (لا يوجد مفتاح تشغيل عام)، إضافة إلى TIE (7) و RIE (6) و TEIE (2). SSR: TDRE (7) و RDRF (6) و ORER (5) و FER (4) و PER (3) و TEND (2). تُمسح أعلام الأخطاء و RDRF بكتابة صفر فيها، وإلا فهي للقراءة فقط، وRDRF لا يمكن أن تبقى ممسوحة ما دامت هناك بايتات في الانتظار.
البتة الواحدة تساوي 32 * 4^CKS * (BRR + 1) من دورات PCLKA، وفق الصيغة في الدليل N = PCLKA / (64 * 2^(2n-1) * B) - 1. SEMR.ABCS (البتة 5) تُنصّف القاسم، وSEMR.BGDM (البتة 4) تُنصّفه مرة أخرى؛ وكلتاهما مُطبَّقتان. كل ما تبقّى في SEMR، وفي SCMR وSNFR وSIMR* وSISR وSPMR، يُخزَّن ويُقرأ دون أي تأثير. طول الإطار يتبع SMR.CHR وSMR.PE وSMR.STOP.
البايتات تخرج بمعدل البت لا فورًا: TDR مع سجل الإزاحة، أي أن TDRE يعود إلى الضبط بمجرد بدء خروج بايت، و TEND عند انتهاء الأخير. استدعاء Serial1.println يستهلك وقتًا محاكى (86.8 ميكروثانية للبايت عند 115200)، تمامًا كما يحدث على المنضدة.
SCI2 هو القناة الوحيدة المتصلة بطرف هنا: TXD2 على D1 و RXD2 على D0. القنوات التسع الأخرى موجودة فقط ليكون رقم القناة هو الفهرس؛ بايتاتها تُحسب ولا تذهب إلى أي مكان.
طرف عليه PMR مضبوط و PSEL = SCI هو مرسل SCI2 يبقى مرتفعًا ما دام SCR.TE مضبوطًا، وهو ما يفعله خط TX الحقيقي بين الإطارات. البايتات نفسها تذهب إلى قناة المضيف، لا إلى السلك كموجة.
3.5 وحدة ADC14 رقم 0 (0x4005_C000)
العنوان الأساسي وكل إزاحة في هذا القسم غير موثَّقة (القسم 7).
| الإزاحة | سجل |
|---|---|
0x00 |
ADCSR (16 بتة) |
0x04، 0x06 |
ADANSA0، ADANSA1 |
0x08، 0x0A |
ADADS0، ADADS1 (مخزَّنان) |
0x0C |
ADADC (مخزَّن) |
0x0E |
ADCER |
0x10 |
ADSTRGR (مخزَّن) |
0x12 |
ADEXICR (مخزَّن) |
0x20 + 2n |
ADDRn، نتيجة واحدة لكل قناة |
0xE0 + n |
ADSSTRn، زمن أخذ العينة بحالات ADC، يُعاد ضبطه إلى 0x0B |
ADCSR.ADST (البتة 15) يبدأ مسحًا ويبقى مضبوطًا أثناء عمله؛ البرنامج الثابت يستعلم عنه، ومسحه يلغي المسح. ADCSR.ADCS (البتات 13..14): 0 لمسح مفرد، 2 لمسح متصل؛ المسح المتصل يعيد تسليح نفسه. ADCER.ADRFMT (البتة 15) ينقل النتيجة إلى أعلى البتات الست عشرة؛ والمحاذاة إلى اليمين هي الافتراضية.
يغطي المسح القنوات المختارة في ADANSA0/ADANSA1 ويستغرق زمن أخذ العينة لكل قناة زائد اثنتي عشرة حالة من التقريب المتتالي. PCLKC يساوي ICLK / 2، فحالة ADC واحدة تعادل دورتي معالج، والتحويل الافتراضي لقناة واحدة هو 23 حالة، أي أقل قليلًا من ميكروثانية، وهو وقت ينتظره البرنامج الثابت فعلًا.
ADDRn يحفظ البتات الأربع عشرة كلها. لا شيء في الشريحة يزيحها إلى عشر بتات؛ analogReadالدقة الافتراضية لـ Arduino من فعل بيئة التشغيل (القسم 6). المقياس الكامل هو خط 5 V.
مسحات المجموعات، وحساس الحرارة، والمرجع الداخلي، ومتوسط البيانات، والتشخيص الذاتي، ووضع الإطلاق المزدوج، وكل إطلاق عدا الإطلاق البرمجي غير مُحاكاة.
3.6 USBFS (0x4009_0000): أنبوب بايتات، ولا شيء غير ذلك
العنوان الأساسي وكل إزاحة في هذا القسم غير موثَّقة (القسم 7)، وكذلك، وهو الأهم، فكرة أن هذا USB أصلًا.
| الإزاحة | سجل |
|---|---|
0x00 |
SYSCFG |
0x04 |
SYSSTS0 (للقراءة فقط) |
0x08 |
DVSTCTR0 (مخزَّن) |
0x14 |
CFIFO |
0x20 |
CFIFOSEL |
0x22 |
CFIFOCTR |
0x30 |
INTENB0 (مخزَّن) |
0x40 |
INTSTS0 (مخزَّن) |
SYSCFG.USBE (البتة 0) تُشغِّل وحدة التحكم، وSYSCFG.DPRPU (البتة 4) تُوصِل مقاومة السحب لأعلى على D+ (وهذا هو معنى "التوصيل بالمنفذ")، وSYSCFG.SCKE (البتة 10) هي الساعة. حتى تُمسح بتة إيقاف الوحدة وتُضبط كل من USBE وDPRPU، لا يمرّ أي شيء عبر الأنبوب.
CFIFOSEL.CURPIPE (البتات 0..3) تختار أنبوبًا، وCFIFOSEL.ISEL (البتة 5) تحدّد الاتجاه: ضبطها للكتابة ومسحها للقراءة. CFIFO هي التي تنقل البايتات. CFIFOCTR.DTLN (البتات 0..8) تقرأ كم بايتًا موجودًا، وBVAL (البتة 15) تُسلّم مخزن الكتابة، وBCLR (البتة 14) تُلقيه. المخزن الذي يبلغ 64 بايتًا يخرج من تلقاء نفسه، لأنه لا يوجد مضيف يُنتظر.
لا شيء آخر من USB موجود هنا. لا مضيف، ولا ناقل، ولا إعادة تعيين، ولا حزمة SETUP، ولا وصف (descriptor)، ولا تعداد، ولا عنونة، ولا عدّاد إطارات، ولا SOF، ولا تخزين مؤقت مزدوج، ولا NAK، ولا STALL، ولا تهيئة أنابيب، ولا مقاطعة. الكود الذي يتعامل مع هذا بالطريقة التي يتعامل بها مشغّل CDC مع شريحة حقيقية سيعمل؛ أما الكود الذي ينتظر اكتمال التعداد، أو يفحص طلب وصف، فسينتظر إلى الأبد. لهذا فإن if (Serial) تكون صحيحة هنا بمجرد تشغيل begin()، وتكون خاطئة لبرهة على منضدة حقيقية.
هذا هو الموضع الذي يتعمد فيه النموذج ألا يكون الشريحة نفسها، وتظاهره بغير ذلك سيكون الكذبة الوحيدة المهمة.
3.7 إيقاف الوحدات (0x4004_7000)
| العنوان | سجل | ما يفكّ ترميزه هذا النموذج |
|---|---|---|
0x4004_7000 |
MSTPCRB |
SCIn عند البتة 31 - n، وUSBFS عند البتة 11 |
0x4004_7004 |
MSTPCRC |
مخزَّن |
0x4004_7008 |
MSTPCRD |
GPTn عند البتة 12 - n، وADC14 الوحدة 0 عند البتة 16 |
A set bit stops the module, and every one of them resets set. The numbering counts down, which is the thing that surprises people. A stopped module's registers read 0 and the access is counted as stray; the port block and these registers themselves are always reachable, because something has to be.
3.8 SysTick وNVIC وICU غير الموجود هنا
SysTick خاصة بنواة المعالج، مع SYST_CALIB = 480,000: الساعة المرجعية هي ICLK، لذا فالدورة التي مدتها 10 ms تعادل 480,000 عدّة. أربع بتات للأولوية. جدول المتجهات يتكوّن من ستة عشر مدخلًا للنظام ثم اثنين وثلاثين خانة في ICU.
على معالجات RA لا معنى ثابتًا لتلك الخانات الاثنتين والثلاثين: أي حدث من الأجهزة الطرفية يصل إلى المقاطعة IRQ n يُبرمَج في سجل ICU ذي الرمز IELSRn. روابط أحداث ICU غير مُمثَّلة في هذا الطراز، لذا لا شيء هنا يرفع مقاطعة طرفية، وIELSRn غير مُنفَّذ، وPmnPFS.ISEL يُخزَّن دون أي تأثير. SysTick، وهي استثناء نواة لا يحتاج إلى رابط، هي المقاطعة الوحيدة التي تنطلق. لهذا السبب لا يوجد attachInterrupt في بيئة التشغيل (القسم 6)، وقيل ذلك بوضوح بدلًا من التقريب: فـ ICU بأرقام أحداث مختلقة سيكون أسوأ من عدم وجوده أصلًا.
4. قناة المضيف
host_write يضع البايتات في كلٍّ من مخزن استقبال أنبوب USB وطابور استقبال SCI2؛ وhost_read يأخذ البايتات التي خرجت من أيٍّ منهما. لكل لوحة قناة مضيف واحدة، وقد يقرأ الكود Serial أو Serial1 أو كليهما.
ذلك هو Serial وSerial1 في الكود، والشاشة التسلسلية في الواجهة. البايتات بصيغة UTF-8 من منظور الواجهة، وغير شفافة من منظور الطراز.
المنفذان ليسا متطابقين في أمر ظاهر واحد: بايتات Serial1 تخرج بمعدل البت، بينما بايتات Serial تخرج في نهاية الشريحة الزمنية التي سُلِّمت فيها، ولذلك يمكن فعلًا أن يهبط سطر USB في وسط سطر UART في الشاشة. هذا هو سلوك اللوحة، وليس خطأ برمجيًا.
5. نموذج الزمن والقطعة
بكوبيكوثانية في u64، مثل النواة (kernel). المعالج يعمل عند 48 MHz، فالدورة الواحدة تساوي 20833.33 ps وليست عددًا صحيحًا، ولهذا لا يُجمَع الزمن تراكميًا قط: بل يُعاد حسابه من عدد الدورات كـ cycles * 1_000_000 / 48. الشريحة التي مدتها 10 us تساوي بالضبط 480 دورة وبالضبط 10,000,000 ps، فحدود الشرائح الزمنية لا تنحرف أبدًا.
يُربط عدّاد الدورات بزمن النواة في بداية كل شريحة زمنية، فلا يمكن لمؤقت أن ينحرف عن الدائرة مهما وقعت الشرائح، والنواة المتوقفة تلحق بالدورات التي نامت خلالها (بما فيها SysTick) دون تنفيذها.
A slice runs in two gears. Coarse is Cpu::run in chunks bounded by the next peripheral deadline; fine is one instruction at a time with the bus told the cycle each one starts at, which is what lets a pin change carry the cycle that caused it. A store to a port, GPT, SCI or USB register drops the slice into fine for the next 4,800 cycles.
probe قناع بتات: 1 يعني قيد التشغيل، 2 يعني نائمًا في WFI، 4 تعني أن LED المدمج على الطرف 13 مضاء، 8 تعني إرسالًا تسلسليًا في آخر 20 ms، و16 تعني استقبالًا تسلسليًا. القيمة 0 مع عدم وجود برنامج، أو عند الإمساك في حالة إعادة تعيين، أو بعد انهيار.
poke: القيمة 1 تُمسك RESET، والقيمة 0 تُطلقه.
الانهيار (تنفيذ BKPT، أو خطأ لا تستطيع النواة العودة منه) يوقف اللوحة ويضع سطرًا واحدًا على قناة المضيف يذكر PC وCFSR وHFSR:
firmware crashed at pc=0x00001000, BKPT #0 (CFSR 0x00000000, HFSR 0x00000000)
crt0.S يوجّه كل متجه لا يحتاجه إلى معالِج ينفّذ BKPT، بحيث يشير الخطأ إلى مكانه بدلًا من الدوران صامتًا.
6. زمن تشغيل البرنامج الثابت (firmware/unor4/)
بيئة تشغيل على شكل Arduino مكتوبة من الصفر: setup() وloop()، وpinMode وdigitalWrite وdigitalRead وshiftOut وanalogRead وanalogReadResolution وanalogWrite وmillis وmicros وdelay وdelayMicroseconds وmap وrandom وSerial وSerial1. لا يوجد Arduino core، ولا ArduinoCore-renesas، ولا FSP، ولا CMSIS، ولا libc، ولا أي شيء تحت GPL.
يُبنى باستخدام clang --target=thumbv7em-none-eabi -mcpu=cortex-m4 -mthumb -mfloat-abi=soft -mfpu=none -Os وld.lld مع firmware/unor4/link.ld، وبخيار --nmagic حتى لا يُحشى برنامج حجمه كيلوبايتان إلى صفحة بحجم 64 KB. BOARD=unor4 هي اللوحة الوحيدة التي يبنيها هذا البرنامج النصي.
- الأطراف. كل استدعاء لـ
pinModeيفتح قفلPWPR، ثم يكتب كلمةPmnPFSواحدة ويعيد قفلها. أماdigitalWriteفهي كتابة واحدة إلىPCNTR3. يُقبلINPUT_PULLDOWNويعطي طرف إدخال عاديًا، لأن القطعة لا تحتوي على مقاومة سحب لأسفل. - الوقت. SysTick عند 1 kHz: قيمة إعادة التحميل 47,999، وهو عدد صحيح من الدورات عند 48 MHz، لذا فإن
millisلا تنحرف.microsهي ذلك العدّاد زائد ما تبقى في عدّاد SysTick التنازلي نفسه، وبذلك يعطي مؤقّت واحد دقة بالميكروثانية على مدى 32 بت كاملًا وتبقى كل قنوات GPT حرة لـanalogWrite. أماdelayفينفّذWFIويتوقف؛ فالثانية الواحدة من الزمن المحاكى تكلّف نحو ألف تعليمة بدلًا من ثمانية وأربعين مليونًا. analogReadتُرجع عشرة بتات، من 0 إلى 1023، من محوّل بدقة أربعة عشر بتًا، لأن هذا ما يتوقعه كود Arduino.analogReadResolution(1..14)تغيّر قيمة الإزاحة، وهي موجودة فيsrc/analog.cوليست في الشريحة.analogWriteمن 0 إلى 255 عند 490.0 Hz (48 MHz / 16 / 6123) على الأطراف D3 وD5 وD6 وD9 وD10 وD11. القيمتان 0 و255 تُسقطان تمكين مخرج GPT وتقودان الطرف مباشرة، ولذلك فإنanalogWrite(pin, 0)مطفأ فعلًا؛ والطرف الذي ليس أحد الأطراف الستة يُقاد منخفضًا أو مرتفعًا عند نقطة المنتصف، كما تفعل أنوية Arduino.Serialهي أنبوبة USB ولا تصل إلى أي طرف في الرأس.Serial1هي SCI2 على الطرفين D0 وD1، بصيغة 8N1،BRR = PCLKA / (32 * baud) - 1مقرّبة. الاستقبال علىSerial1يتم بالاستقصاء، لأنه لا يوجد ICU لتسليم مقاطعة؛ وقائمة الانتظار في النموذج خلفRDRعميقة بما يكفي لأن الكتابة أثناء انشغال الكود لا تفقد حروفًا.- لا يوجد
attachInterrupt، للسبب الذي يذكره القسم 3.8. الكود يستقصي. - الفاصلة العائمة تعمل وهي فاصلة ناعمة (soft float).
Serial.print(float)يقرأ نمط بتات IEEE-754 ولا يحسب به أبدًا. Stringوالكومة وtone()هي ملك النواة المشتركة (firmware/lib): تعمل الكومة من_endإلى المكدس، وtone()هي PWM من GPT عند نسبة 50 بالمئة على الأطراف D3 وD5 وD6 وD9 وD10 وD11، مع بديل حاجز يُنفَّذ بالبتات لنغمة موقوتة على أي طرف آخر. لا I2C ولا SPI.
سلسلة program في الفهرس هي elf32 arm ra4m1.
أربعة أمثلة، ميزانية كل منها 16 KB: blink، وbutton (زر ضغط على D2)، وserial (المنفذان معًا، مع صدى للإدخال)، وanalog (مقبض على A0 يخفت LED على D9، ويطبع عشرة بتات وأربعة عشر).
يشغّل crates/unor4/tests/runtime.rs ملفات ELF هذه على النموذج. وُجدت حالتان من حالاته لتثبيت أرقام هذا المستند بدلًا من إعادة ذكرها: الساعة فعلًا 48 MHz عبر ثانيتين محاكاتين، وmillis تقع ضمن 20 ms من الحقيقة بعد ثلاث ثوانٍ.
7. ما تثق به هذه المواصفة، وما لا تثق به
ثلاث مجموعات. هذا القسم موجود لأن نموذج لوحة يخمّن عنوانًا بصمت أسوأ من نموذج يقول إنه لم يعرف.
Taken from the RA4M1 group user's manual and the Minima's own documentation. The core: a Cortex-M4 at 48 MHz with four priority bits. 256 KB of code flash at zero, 32 KB of SRAM at 0x2000_0000, 8 KB of data flash at 0x4010_0000. The option-setting memory at 0x0000_0400. PORT_BASE = 0x4004_0000 with a 0x20 stride, and PCNTR1..PCNTR4 at 0x00, 0x04, 0x08, 0x0C with the half-word meanings section 3.1 gives. PFS_BASE = 0x4004_0800 with a 0x40 stride and four bytes a pin, and the PmnPFS bit positions in section 3.2. PWPR at 0x4004_0D03 with B0WI at bit 7 and PFSWE at bit 6. MSTP_BASE = 0x4004_7000, that a set bit stops the module, and that the numbering counts down. SCI_BASE = 0x4007_0000 with a 0x20 stride, the byte-register layout in section 3.4, and the SCR/SSR/SMR bit positions and the bit-rate formula. That SCI2 is the Minima's Serial1 on D0 and D1, and that Serial is the on-die USB. The Uno R3 header and the RA4M1 pad behind each hole in section 1, less the two noted below. That A0 is AN009 and A1..A3 are AN000..AN002. That D3, D5, D6, D9, D10 and D11 are the PWM pins. That the board is 68.6 x 53.3 mm.
معتقدة، غير متحقَّق منها. ذُكرت هنا حتى يكون أمام من ينقل الصورة إلى سيليكون حقيقي قائمة قصيرة للتحقق، كلها في ملف رأس واحد، firmware/unor4/include/ra4m1.h:
GPT_BASE=0x4007_8000بخطوة 0x100، وكل إزاحة سجل داخل قناة GPT (القسم 3.3).- أي مخرج GPT يقابل كل طرف PWM: الجدول ذو الصفوف الستة في القسم 3.3. هذا أضعف ادعاء في المستند: الأطراف صحيحة أما القنوات فاعتقاد.
ADC_BASE=0x4005_C000وكل إزاحة داخل ADC14 (القسم 3.5).A4وA5علىAN021وAN022. القنوات التناظرية الأربع الأخرى ليست في هذه المجموعة.USB_BASE=0x4009_0000وكل إزاحة داخل USBFS (القسم 3.6).- ترميزا
PSELوهما0b00011لـ GPT و0b00100لـ SCI (القسم 3.2). - مواضع بتات
MSTPCRB/MSTPCRDبالضبط من أجل USBFS (11) وADC14 (16). أما بتا SCI وGPT فيتبعان قاعدة العد التنازلي، وهي ليست في هذه المجموعة.
حيث يختلف النموذج وهذا المستند عن السيليكون، يظل البرنامج الثابت المبني هنا متفقًا مع النموذج: فهو يعمل في المحاكي وكتاباته إلى السجلات في ملف رأس واحد يسهل تصحيحه.
مُنمذجة، لكن دون التزام بأرقام الدليل. سلوكيات لا عناوين، بالترتيب الذي يضبطه docs/esp32c6.md القسم 7، وتتبعه الآن كل عقود اللوحات هنا:
- الساعة 48 MHz وشجرة الساعة غير موجودة. بتات إيقاف الوحدات بوابات؛ وHOCO وMOCO والـ PLL و
SCKDIVCRغير منمذجة، فأيًّا كان ما يبرمجه الكود، تعمل النواة عند 48 MHz. يثبّتcrates/unor4/tests/runtime.rsذلك على البرنامج الثابت المرفق لا على هذه الجملة. - مخرج GPT مرتفع دون سجل المقارنة الخاص به ومنخفض فوقه (القسم 3.3). حقول اختيار المستوى الخماسية البتات في
GTIORتُخزَّن ولا تُفكَّك، فالمخرج المقلوب أو المتبدل لا يُستنسخ؛ أما دورةanalogWriteفتُستنسخ. - للشريحة سرعتان، وأول كتابة بعد فترة هدوء تكون مبكرة، حتى 10.7 us. كل شيء داخل الدفعة دقيق. والتفسير هو تفسير
docs/stm32f411.mdالقسم 7. - لا خطأ في ADC14. التحويل خط مستقيم مقابل مرجع 5 V، مأخوذ عند لحظة بدئه، دون عينة وحفظ، ودون مقاومة دخل، ودون لا-خطية، ودون ضجيج، ودون إزاحة. تشخيص
ADCERالذاتي ومتوسطADADCيُخزَّنان ولا يفعلان شيئًا. - الوسائد ثلاث حالات وعتبة واحدة. دفع وجذب عند 5 فولت، أو تصريف مفتوح، أو مقاومة عالية، أو مقاومة سحب داخلية بقيمة 35 kΩ، وتُقرأ القيمة بمقارنتها بنصف جهد التغذية، دون تخلُّف في العتبة، ودون إعداد لقوة الدفع، ودون زمن صعود، ودون حد للتيار. ويُخزَّن
DSCR. Serialأنبوب بايتات، والأنبوب لا يمتلئ أبدًا. البايتات التي تُسلَّم تخرج في نهاية الشريحة الزمنية وليس عند حد إطار USB،availableForWriteهي دائمًا 1، وif (Serial)هو قرار يتخذه هذا النموذج وليس مصافحة ينفّذها (القسم 3.6).- The board is an ideal supply:
5V,IOREFand3V3at rail impedance for ever, so nothing browns out. Start-up is a microsecond, where a real R4 spends its first moments in the bootloader. - لا يوجد زر للمستخدم، لأن اللوحة لا تملك واحدًا؛ الزر الوحيد يُبقي
RESETمنخفضًا ويصل عبرpoke.
غائبة عن قصد. كل واحدة من هذه تُركت خارجًا بدلًا من اختراعها، لأن تخطيطها أو سلوكها ليس شيئًا يستطيع هذا النموذج إعادة إنتاجه بأمانة:
- وحدة ICU ووصلات أحداثها. القسم 3.8. معها تختفي كل مقاطعات الوحدات الطرفية، و
attachInterrupt، وأطراف IRQ. - دائرة توليد الساعة: HOCO وMOCO وPLL و
SCKDIVCR. يُنمذج المكوّن وكأنه يعمل عند 48 MHz بالفعل، والبرنامج الذي يهيّئ شجرة الساعات يكتب في كتلة غير معيَّنة. - وحدة AGT. مؤقّت الطاقة المنخفضة في RA4M1، وهو الذي تستخدمه نواة Arduino في
millis. SysTick يكفي هنا وهو دقيق تمامًا. - مؤقّتات المراقبة (IWDT وWDT)، ولهذا السبب تُخزَّن ذاكرة إعدادات الخيارات دون فك ترميزها.
- I2C (IIC) وSPI وCAN وDTC ووحدة اللمس CTSU وRTC وDAC والمقارنات ومقوّيات العمليات OPAMP ووحدتا CRC وCAC، وواجهة برمجة ذاكرة البيانات.
- USB كبروتوكول. القسم 3.6 هو كل ما هناك.
- برمجة الذاكرة الفلاشية وذاكرة الإقلاع ROM.
لهذا السبب لا يعمل هنا ملف FSP من المورّد أو ملف نواة Arduino ثنائي، بينما يعمل البرنامج الثابت المبني وفقًا لهذا المستند.