المرجع

عقد لوحة Arduino Uno R4 Minima (المرحلة 9)

The RA4M1 on our Cortex-M4 core: the PFS port block, GPT PWM, SCI2 as Serial1 and a fourteen-bit ADC.

هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة 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, IOREF and 3V3 at 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 ثنائي، بينما يعمل البرنامج الثابت المبني وفقًا لهذا المستند.