هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة STM32F411 Black Pill و صفحة اللوحة.
ثالث متحكم دقيق، وأول لوحة Cortex-M. مكوّن نواة واحد (stm32f411 في crates/parts) يغلّف نموذج SoC من نوع STM32F411CEU6 (crates/stm32f411) مبنيًا على نواة ARMv7-M (crates/cortexm-core، المُثبتة في proofs/cortexm/REPORT.md). البرنامج الثابت هو ملف ARM Thumb ELF عادي يتخاطب مع الأجهزة الطرفية أدناه على عناوين STM32F411 الحقيقية، المأخوذة من RM0383 (الدليل المرجعي لـ STM32F411xC/E) وDS10314 (ورقة البيانات)، بحيث يعمل البرنامج المبني لـ Mokxi أيضًا على WeAct Black Pill حقيقي.
النوع في الفهرس هو stm32f411 (WeAct MiniF4 "Black Pill" v3.x, STM32F411CEU6). لوحة ثانية، nucleof411re (وهي Nucleo-F411RE من ST، بنفس رقاقة STM32F411RET6)، هي نموذج SoC نفسه بإعدادات لوحة خاصة بها: ساعتها، وواجهة USART المضيفة، وأطرافها، وبناء زمن التشغيل الخاص بها. القسم 8 هو تلك اللوحة؛ وكل ما هنا يصح على الاثنين ما لم يُذكر غير ذلك. ثلاثة جهات تبني بناءً على هذا الملف: نموذج SoC والقطعة (Rust)، وزمن تشغيل البرنامج الثابت والأمثلة (C/C++, clang)، وصورة اللوحة (TypeScript). غيّره فقط بتحرير هذا الملف أولًا. كل ما في docs/esp32c3.md عن سلوك قطعة لوحة (الشرائح، القناة المضيفة، إعادة التعيين، سطر الانهيار) وكل ما في docs/uno.md عن كيفية وضع لوحة في دائرة ينطبق هنا ما لم يقل هذا الملف غير ذلك.
تشغيل الملفات الثنائية الرسمية (STM32Cube HAL وlibopencm3 ونواة STM32duino) ليس هدفًا في المرحلة 4. فهي تحتاج إلى إحضار شجرة الساعة من HSI، وزمن انتظار الفلاش والجلب المسبق، وDMA وUSB، ولا شيء منها مُنمذج. الهدف هو أن يكون كل سجل يلمسه برنامج bare-metal لإيماض طرف، أو الطباعة على UART، أو قراءة زر، أو تشغيل مخرج PWM، عند عنوانه الحقيقي ببتّاته الحقيقية، بحيث يعمل المصدر نفسه المترجم مقابل ترويسات CMSIS على السيليكون.
1. أطراف اللوحة (بترتيب الفهرس)
اللوحة ذات 2x20 طرفًا على مسافة 0.1 إنش إضافة إلى ترويسة SWD من 4 أطراف على الحافة السفلية، وUSB-C في الأعلى، بالترتيب المتبع في مخطط الأطراف الخاص بـ WeAct للوحات STM32F4x1 v2.0+. ترتيب الفهرس هو الترويسة اليسرى من الأعلى إلى الأسفل، ثم اليمنى من الأعلى إلى الأسفل، ثم ترويسة SWD من اليسار إلى اليمين.
الترويسة اليسرى: PB12, PB13, PB14, PB15, PA8, PA9, PA10, PA11, PA12, PA15, PB3, PB4, PB5, PB6, PB7, PB8, PB9, 5V, GND, 3V3
الترويسة اليمنى: 5Vb, GNDc, 3V3b, PB10, PB2, PB1, PB0, PA7, PA6, PA5, PA4, PA3, PA2, PA1, PA0, NRST, PC15, PC14, PC13, VBAT
ترويسة SWD: 3V3c, PA13 (SWDIO), PA14 (SWCLK), GNDb
44 طرفًا. PB11 غائب: فالـ STM32F411CEU6 قطعة من 48 طرفًا ولا تُخرجه، لذا فإن PB0..PB15 "كما هو مجهّز": خمسة عشر طرفًا لا ستة عشر. خطوط التغذية تظهر أكثر من مرة (ثلاثة 3.3 V، واثنان 5 V، وثلاثة أرضيات) وتحمل حرفًا لأن أسماء الأطراف في الفهرس فريدة. أطراف SWD لا تُدخل في لوحة التجارب التي تجلس فيها اللوحة (plug: false في web/src/parts/stm32f411.ts).
Until late October 2026 the drawing had the board end for end (VBAT at the
USB end) with the SWD header folded into the VBAT row as PA13, PA14 and
GNDb, and no second 5 V or 3.3 V pins. A diagram saved then is read with the
part's header setting at early and keeps that drawing
(web/src/parts/header-layout.ts); the model does not read the setting.
The silkscreen prints the short forms (VB, C13, R, A0, B9, G); the
catalog uses the full port names because a netlist pin reference has to be
unambiguous.
كهربائيًا:
3V3يوفّر 3.3 V عندR_SUPPLY؛ و5Vيوفّر 5 V عندR_SUPPLY؛ وGNDوGNDbيوفران 0 V. اللوحة مُغذّاة دائمًا (USB-C). وهي مصدر تغذية لبقية الدائرة.VBATمدخل تتجاهله اللوحة: فهي هنا تُغذّى دائمًا من خط 3.3 V.NRSTمدخل بمقاومة سحب داخلية 40 k نحو 3.3 V (يقول RM0383 إنها بين 30 k و50 k)؛ عند دفعه تحت 1.65 V يُبقي المعالج في حالة إعادة تعيين؛ وعند تحريره يُعيد تشغيل البرنامج من متجه إعادة التعيين.- كل
PAnوPBnوPCn(وعلى NucleoPD2) هو GPIO ثنائي الاتجاه. في وضع الخرج (MODER= 01 أو 10): push-pull عند 3.3 V أو 0 V عبرR_STRONG، أو open-drain (بتOTYPERمضبوط) حيث تكون الحالة العالية high-Z. في وضع الدخل أو التمثيلي (MODER= 00 أو 11): high-Z، مع مقاومة سحب لأعلى بقيمة 40 k نحو 3.3 V عندماPUPDR= 01، أو مقاومة سحب لأسفل بقيمة 40 k عندماPUPDR= 10. يقرأ الدخل جهد الشبكة مقارنة بـ 1.65 V (نصف 3.3 V)؛ الحالة غير المعروفة تُقرأ 0، والطرف العائم يقرأ تشويشًا، كما في Uno (docs/uno.mdالقسم 1). PC13يحمل LED الأزرق المدمج على اللوحة، المصعد إلى 3.3 V عبر مقاومة 470 R، والمهبط إلى الطرف: يضيء LED عندما يُسحبPC13منخفضًا. وهو عبء على الطرف، وتُظهره الصورة المرئية عبر بت مجس (القسم 5).PA0يحمل أيضًا زرKEY، الذي يوصلPA0بالأرضي طوال الضغط عليه. لا توجد مقاومة سحب خارجية: البرنامج الثابت يستخدم الداخلية. يُصل إلى الزر عبرpoke(القسم 5)، لا عبر طرف.PA9/PA10هما USART1 TX/RX على اللوحة الحقيقية وهنا أيضًا؛ بايتات USART تذهب إلى قناة المضيف (القسم 4)، ويبقى الطرفان GPIO على الشبكة، لذا فإن راسم الإشارة عليهما يُظهر ما يفعله كتلة GPIO.PA11/PA12هما USB D-/D+ على اللوحة الحقيقية، و GPIO عاديًا هنا.PA13/PA14يخرجان من إعادة الضبط في وضع الوظيفة البديلة لـ SWD، تمامًا كما تفعل القطعة، ما يعني أنهما high-Z حتى يعيد البرنامج الثابت برمجةMODER.
2. خريطة الذاكرة (عناوين STM32F411CE الحقيقية)
| المنطقة | العنوان | الحجم | ملاحظات |
|---|---|---|---|
| الفلاش | 0x0800_0000 |
512 KB | ذاكرة flash في STM32F411CE؛ تُتجاهل الكتابات (لا توجد واجهة لبرمجة flash) |
| اسم flash البديل | 0x0000_0000 |
512 KB | البايتات نفسها، لأن BOOT0 منخفض ومنطقة الإقلاع تعيّن flash الرئيسية إلى 0 |
| SRAM | 0x2000_0000 |
128 KB | |
| APB1 | 0x4000_0000 |
32 KB | TIM2..TIM5 و USART2، القسم 3 |
| APB2 | 0x4001_0000 |
32 KB | TIM1 و USART1 و ADC1 و SYSCFG و EXTI و TIM10، القسم 3 |
| AHB1 | 0x4002_0000 |
64 KB | GPIOA..GPIOD و RCC، القسم 3 |
| SCS | 0xE000_E000 |
4 KB | SysTick و NVIC و SCB، تُجاب داخل cortexm-core ولا تُرى على الناقل أبدًا |
أي شيء آخر هو خطأ وصول: تأخذ النواة BusFault، والذي مع SHCSR بعد إعادة الضبط يتصاعد إلى HardFault. السجلات غير المخططة داخل كتلة طرفية مخططة تُقرأ 0 وتتجاهل الكتابات، مع عدّاد للتشخيص.
ملف ELF للبرنامج الثابت: يأخذ loadProgram ملفًا تنفيذيًا ARM بصيغة ELF32 بالمحاذاة الصغيرة (e_machine بقيمة 40). يجب أن يقع كل مقطع PT_LOAD داخل flash (عبر أي من العرضين) أو داخل SRAM. إعادة الضبط هي المعمارية، لا قفزة إلى نقطة الدخول: MSP يأتي من الكلمة عند أساس جدول المتجهات وPC من الكلمة الثانية، مع مسح البت المنخفض، لذا فصورة البرنامج الثابت هي جدول متجهات حقيقي لا نقطة دخول مجردة. VTOR يُعاد ضبطه إلى 0، وهو اسم flash البديل. التحميل أثناء التشغيل يعيد ضبط اللوحة.
النواة هي Profile::V7M مع Cpu::set_priority_bits(4)؛ عائلة STM32F4 تنفّذ البتات الأربعة العليا من كل حقل أولوية بحجم 8 بتات، لذا يتصرف NVIC_IPR كما تتوقع NVIC_SetPriority في CMSIS. لا توجد FPU: CPACR يُخزَّن ولا يُتصرَّف به، وكل تعليمة VFP أو DSP ترفع UNDEFINSTR. ترجَم البرنامج الثابت بـ -mfloat-abi=soft.
3. سجلات الأجهزة الطرفية (مجموعة فرعية، إزاحات حقيقية، مواضع بتات حقيقية)
السجلات بحجم 32 بتًا ومحاذاة كلمة. الوصول بالبايت والنصف كلمة يعمل ويصيب الكلمة المحتوية، وهذا ما تفعله جسور AHB/APB للسجلات المنمذجة هنا.
3.1 RCC (0x4002_3800)
شجرة الساعة منمذجة من السجلات، مع تنازل واحد لصور Mokxi المرفقة: إلى أن يلمس البرنامج الثابت إعداد الساعة تعمل القطعة عند ساعة الإقلاع للوحة (SYSCLK = HCLK = 84 MHz على Black Pill، و100 MHz على Nucleo، و APB1 بالنصف)، لأن بيئة Arduino لا تبرمج PLL أبدًا. أول كتابة إلى RCC_CR أو RCC_PLLCFGR، أو كتابة RCC_CFGR تغيّر SW، تسلّم الساعة للسجلات: من حينها يكون SYSCLK هو HSI (بسرعة 16 MHz)، أو HSE (كريستال 25 MHz على Black Pill، و8 MHz من ST-LINK على Nucleo) أو PLL (src / PLLM * PLLN / PLLP) كما يقول SWS، و HCLK هو SYSCLK / HPRE، و PCLK1 و PCLK2 هما HCLK / PPRE1 و PPRE2، وساعات المؤقتات هي PCLK (مقسّم 1) أو 2 × PCLK، أو مع DCKCFGR.TIMPRE تكون HCLK حتى قسمة على 4. النواة و SysTick والمؤقتات ومعدلات baud لـ USART وساعة ADC وتحويل الدورات إلى الوقت، كلها تتبع ذلك، بما في ذلك عندما تتغير الساعة أثناء التشغيل. تُقرَّب HCLK إلى ميغاهرتزات كاملة لتحويل الوقت. إعادة الضبط تعيد ساعة الإقلاع. زمن انتظار flash ما يزال يُخزَّن ويُتجاهل.
| الإزاحة | الاسم | السلوك |
|---|---|---|
0x00 |
RCC_CR |
stored; HSIRDY (1), HSERDY (17) and PLLRDY (25) read back set whenever their ON bit is set, so a spin on "ready" terminates immediately (oscillators and the PLL start at once) |
0x04 |
RCC_PLLCFGR |
مخزَّن، يُقرأ ثانية؛ قيمة إعادة الضبط 0x2400_3010 |
0x08 |
RCC_CFGR |
مخزَّن؛ SWS[3:2] يتبع SW[1:0] فورًا عندما يكون المصدر الذي يسميه SW مشغّلًا في RCC_CR، ويبقى ثابتًا خلاف ذلك. HPRE وPPRE1 وPPRE2 تضبط ساعات الناقل كما سبق |
0x0C |
RCC_CIR |
مخزَّنة وتُقرأ مرة أخرى |
0x10 0x20 0x24 |
RCC_AHB1RSTR RCC_APB1RSTR RCC_APB2RSTR |
كتابة 1 في بت طرفي تعيد ضبط سجلات ذلك الطرفي؛ والسجل نفسه يُقرأ 0 |
0x30 |
RCC_AHB1ENR |
البت 0 GPIOAEN، و1 GPIOBEN، و2 GPIOCEN، و3 GPIODEN، و4 GPIOEEN، و7 GPIOHEN، و12 CRCEN، و21 DMA1EN، و22 DMA2EN |
0x34 |
RCC_AHB2ENR |
مخزَّنة وتُقرأ مرة أخرى |
0x40 |
RCC_APB1ENR |
البت 0 TIM2EN، و1 TIM3EN، و2 TIM4EN، و3 TIM5EN، و11 WWDGEN، و14 SPI2EN، و15 SPI3EN، و17 USART2EN، و21 I2C1EN، و22 I2C2EN، و23 I2C3EN، و28 PWREN |
0x44 |
RCC_APB2ENR |
البت 0 TIM1EN، و4 USART1EN، و5 USART6EN، و8 ADC1EN، و11 SDIOEN، و12 SPI1EN، و13 SPI4EN، و14 SYSCFGEN، و16 TIM9EN، و17 TIM10EN، و18 TIM11EN |
0x50 0x54 0x60 0x64 |
سجلات LPENR الأربعة |
مخزَّنة وتُقرأ مرة أخرى |
0x70 |
RCC_BDCR |
مخزَّن؛ LSERDY (1) يتبع LSEON (0) |
0x74 |
RCC_CSR |
مخزَّن؛ LSIRDY (1) يتبع LSION (0)؛ PINRSTF (26) مضبوط بعد إعادة ضبط NRST، وPORRSTF (27) وBORRSTF (25) بعد التشغيل؛ الكتابة مع RMVF (24) تمسح الأعلام |
بت تمكين الساعة بوابة حقيقية: الطرفي الذي بت التمكين الخاص به صافٍ يُقرأ 0 ويتجاهل الكتابات، وعدّاد ضائع يسجّل الوصول. هذا هو أشهر خطأ STM32 في البرمجة المباشرة، وإخفاؤه سيجعله غير مرئي هنا.
3.2 GPIOA و GPIOB و GPIOC و GPIOD (0x4002_0000، 0x4002_0400، 0x4002_0800، 0x4002_0C00)
Port D is on the die in both packages; the 48-pin F411CE bonds out none of it
and the 64-pin F411RE only PD2. Its reset values are all zero. The clock
enable is RCC_AHB1ENR bit 3, GPIODEN.
| الإزاحة | الاسم | البتات |
|---|---|---|
0x00 |
MODER |
2 bits per pin: 00 input, 01 output, 10 alternate function, 11 analog |
0x04 |
OTYPER |
1 bit per pin: 0 push-pull, 1 open-drain |
0x08 |
OSPEEDR |
2 bits per pin; stored, read back, no effect on edge timing |
0x0C |
PUPDR |
2 bits per pin: 00 none, 01 pull-up, 10 pull-down |
0x10 |
IDR |
قراءة فقط، البتات 0..15: مستويات الأطراف |
0x14 |
ODR |
البتات 0..15: مزلاج الخرج |
0x18 |
BSRR |
كتابة فقط: البتات 0..15 تضبط بت ODR المقابل، والبتات 16..31 تمسحه؛ المسح يتغلب على الضبط في الكتابة نفسها. يُقرأ 0 |
0x1C |
LCKR |
مخزَّن، يُقرأ ثانية؛ تسلسل القفل غير مُلزَم |
0x20 0x24 |
AFRL AFRH |
4 بتات لكل طرف، الأطراف 0..7 و 8..15 |
قيم إعادة الضبط هي قيم القطعة نفسها، وهذا مهم لأنها ما يترك أطراف SWD دون تغيير: GPIOA_MODER = 0xA800_0000، GPIOA_OSPEEDR = 0x0C00_0000، GPIOA_PUPDR = 0x6400_0000؛ GPIOB_MODER = 0x0000_0280، GPIOB_OSPEEDR = 0x0000_00C0، GPIOB_PUPDR = 0x0000_0100؛ وكل ما تبقى 0.
IDR يعيد قراءة ما تقوده هذه الشريحة على طرف تقوده هي، وما عيّنته اللوحة من الشبكة على طرف لا تقوده، تمامًا كما يفعل PINx على الـ Uno.
الوظيفة البديلة: عندما تكون MODER = 10 يقود الطرفَ المحيطيُّ الذي تختاره AFRL/AFRH لهذا الطرف، من المجموعة الفرعية في القسمين 3.3 و3.4. اختيار وظيفة بديلة لا يطبّقها هذا النموذج يترك الطرف في حالة عالية المقاومة ويُحتسب شاردًا. التطابقات المُطبَّقة (DS10314 جدول 9):
| AF | pins |
|---|---|
AF1 TIM2 |
PA0 CH1، PA1 CH2، PA2 CH3، PA3 CH4، PA5 CH1، PA15 CH1، PB3 CH2، PB10 CH3 |
AF1 TIM1 |
PA8 CH1، PA9 CH2، PA10 CH3، PA11 CH4؛ التكميلية PA7، PB13 CH1N، PB0، PB14 CH2N، PB1، PB15 CH3N |
AF2 TIM3 |
PA6 CH1، PA7 CH2، PB0 CH3، PB1 CH4، PB4 CH1، PB5 CH2، PC6 CH1، PC7 CH2، PC8 CH3، PC9 CH4 |
AF3 TIM10 |
PB8 CH1 |
AF2 TIM4 |
PB6 CH1، PB7 CH2، PB8 CH3، PB9 CH4 |
AF2 TIM5 |
PA0 CH1، PA1 CH2، PA2 CH3، PA3 CH4 |
AF7 USART1 |
PA9 TX، PA10 RX، PB6 TX، PB7 RX |
AF7 USART2 |
PA2 TX، PA3 RX |
3.3 المؤقتات TIM2 وTIM3 وTIM4 وTIM5 (0x4000_0000، 0x4000_0400، 0x4000_0800، 0x4000_0C00)
يملك TIM2 وTIM5 سجلات CNT وARR وCCRx بعرض 32 بتًا؛ أما TIM3 وTIM4 فبعرض 16 بتًا. الأربعة كلها تعمل بساعة 84 MHz (القسم 5).
| الإزاحة | الاسم | البتات |
|---|---|---|
0x00 |
CR1 |
CEN 0، UDIS 1، URS 2، OPM 3، DIR 4، CMS 5..6، ARPE 7، CKD 8..9 |
0x04 |
CR2 |
مخزَّنة وتُقرأ مرة أخرى |
0x08 |
SMCR |
مخزَّنة وتُقرأ مرة أخرى؛ وضعا التابع والإطلاق غير مُطبَّقين |
0x0C |
DIER |
UIE 0، CC1IE 1، CC2IE 2، CC3IE 3، CC4IE 4، TIE 6؛ ومفاتيح DMA مخزَّنة |
0x10 |
SR |
UIF 0، CC1IF 1..CC4IF 4، TIF 6، CC1OF 9..CC4OF 12. اكتب 0 في البت لمسحه، و1 يتركه (rc_w0، كما يقول الدليل) |
0x14 |
EGR |
كتابة فقط: UG 0 يعيد تحميل المقياس القبلي والعداد ويضبط UIF، CC1G 1..CC4G 4 تضبط أعلام الالتقاط والمقارنة، TG 6 يضبط TIF |
0x18 |
CCMR1 |
وضع الإخراج: CC1S 0..1، OC1FE 2، OC1PE 3، OC1M 4..6، OC1CE 7، CC2S 8..9، OC2FE 10، OC2PE 11، OC2M 12..14، OC2CE 15 |
0x1C |
CCMR2 |
الشيء نفسه للقناتين 3 و4 |
0x20 |
CCER |
CC1E 0، CC1P 1، CC2E 4، CC2P 5، CC3E 8، CC3P 9، CC4E 12، CC4P 13 |
0x24 |
CNT |
|
0x28 |
PSC |
16 بتًا؛ العداد يتقدم بتردد 84 MHz / (PSC + 1) |
0x2C |
ARR |
قيمة إعادة التحميل؛ الدورة تساوي ARR + 1 نبضة في العد التصاعدي |
0x34 0x38 0x3C 0x40 |
CCR1 CCR2 CCR3 CCR4 |
|
0x48 0x4C |
DCR DMAR |
مخزَّنة وتُقرأ مرة أخرى |
0x50 |
TIM2_OR / TIM5_OR |
مخزَّنة وتُقرأ مرة أخرى |
العدّ: التصاعدي (DIR = 0)، والتنازلي (DIR = 1)، والمتوسّط المحاذي (CMS != 0) كلها مُطبَّقة، كلٌّ مع حدث التحديث في موضعه حسب الدليل. ARPE يخزّن ARR مؤقتًا، وOCxPE يخزّن CCRx مؤقتًا حتى حدث التحديث، وهذا ما يجعل تغيير نسبة الملء سلسًا بلا تشويش.
أنماط مقارنة الإخراج (OCxM): 0 مجمّد، 1 نشط عند التطابق، 2 خامل عند التطابق، 3 تبديل، 4 فرض الخمول، 5 فرض النشاط، 6 نمط PWM 1 (نشط طالما CNT < CCRx في العد التصاعدي)، 7 نمط PWM 2 (العكس). CCxP يقلب قطبية الإخراج. الطرف لا يتحرك إلا أثناء ضبط CCxE و كون الطرف في وضع الوظيفة البديلة مع اختيار ذلك المؤقت (القسم 3.2).
التقاط المدخل غير مُطبَّق: CCxS != 0 يُخزَّن ويُحتسب شاردًا.
خطوط NVIC: TIM2 = 28 و TIM3 = 29 و TIM4 = 30 و TIM5 = 50. يُرفع كل خط طالما أن أي بت من بتات SR الخاص به مضبوط مع تمكين المطابق في DIER، ويبقى كمستوى ثابت. يمسح معالج المقاطعة البت، تمامًا كما في الشريحة الحقيقية.
3.3a المؤقتان TIM1 (0x4001_0000) وTIM10 (0x4001_4400)
TIM1 is the advanced-control timer: the registers of section 3.3, 16 bits wide,
plus RCR (0x30, stored; the repetition counter is not acted on) and BDTR
(0x44). BDTR.MOE (bit 15) gates every TIM1 output: with it clear none of
them drives a pin. CCER adds CCxNE (bit 4n+2) and CCxNP (bit 4n+3)
for channels 1 to 3: the complementary output alone is the channel's reference
level with CCxNP as its polarity, and with CCxE on as well it is the
reference's complement (RM0383 table 56 with no dead time; dead time and the
break input are stored and not modeled). Clock enable RCC_APB2ENR bit 0.
TIM10 مؤقت بعرض 16 بتًا له قناة واحدة، مُطبَّق بسجلات القسم 3.3؛ ما ينقصه على السيليكون يُقرأ كما خُزِّن. تفعيل الساعة RCC_APB2ENR البت 17.
كلاهما يعدّ بساعة مؤقتات APB2، وهي HCLK على اللوحتين. خطوط NVIC: TIM1_UP_TIM10 = 25 (تحديث TIM1، أو أي مقاطعة من TIM10)، TIM1_TRG_COM_TIM11 = 26 (إطلاق TIM1)، TIM1_CC = 27 (أعلام مقارنة TIM1).
3.4 المنفذان USART1 (0x4001_1000) وUSART2 (0x4000_4400)
| الإزاحة | الاسم | البتات |
|---|---|---|
0x00 |
SR |
PE 0، FE 1، NE 2، ORE 3، IDLE 4، RXNE 5، TC 6، TXE 7، LBD 8، CTS 9. تُمسح بتُ RXNE و TC و LBD/CTS بالكتابة 0؛ كما تُمسح بتا TC و ORE أيضًا عند تسلسل قراءة SR ثم قراءة DR، كما يذكر الدليل الفني |
0x04 |
DR |
الكتابة: إرسال؛ القراءة: البايت المستلَم ومسح RXNE |
0x08 |
BRR |
DIV_Fraction 0..3، DIV_Mantissa 4..15؛ السرعة = f_PCLK / (8 x (2 - OVER8) x USARTDIV) |
0x0C |
CR1 |
SBK 0، RWU 1، RE 2، TE 3، IDLEIE 4، RXNEIE 5، TCIE 6، TXEIE 7، PEIE 8، PS 9، PCE 10، WAKE 11، M 12، UE 13، OVER8 15 |
0x10 |
CR2 |
مخزَّنة وتُقرأ مرة أخرى؛ STOP 12..13 مخزَّنة ويُفترض نمط 8N1 لضبط الإيقاع |
0x14 |
CR3 |
مخزَّنة وتُقرأ مرة أخرى |
0x18 |
GTPR |
مخزَّنة وتُقرأ مرة أخرى |
f_PCLK هي HCLK للمنفذ USART1 (APB2) وHCLK / 2 للمنفذ USART2 (APB1)، القسم 5: 84 و42 MHz على الـ Black Pill، و100 و50 MHz على الـ Nucleo.
USART1 هو قناة الاتصال بالمضيف على الـ Black Pill؛ أما على الـ Nucleo فهو USART2، الذي توصّله تلك اللوحة بمنفذ COM الافتراضي للـ ST-LINK، وUSART1 هو المنفذ الذي لا تذهب بايتاته إلى أي مكان. الإرسال يتم عبر مخزن القطعة المؤقت الوحيد وسجل الإزاحة: الكتابة في DR مع ضبط TXE تمسح TXE، يأخذ سجل الإزاحة البايت ويعود TXE مضبوطًا فورًا، ويصل البايت إلى المضيف بعد زمن إطار واحد (10 أزمنة بت بالسرعة المضبوطة)، عند ضبط TC. الاستلام: تنتظر بايتات المضيف في FIFO بحجم سجل الاستلام الحقيقي (بايت واحد) مضافًا إليه مخزن احتياطي بجهة المضيف سعته 256 بايت حتى لا يضيع النص المكتوب؛ RXNE يبقى مضبوطًا طالما ينتظر بايت؛ وقراءة DR تُخرجه من الطابور، ووصول بايت بينما RXNE مضبوط مسبقًا يضبط ORE.
منفذ USART الآخر هو منفذ ثانٍ مطابق له، لكن البايتات المرسلة منه لا تذهب إلى أي مكان (يتم عدّها، بحيث يمكن لاختبار ما رؤيتها)، ومستقبله لا يجد شيئًا يقرأه أبدًا. وهو موجود حتى يتمكن برنامج ثابت كُتب لمنفذين من الربط والتشغيل.
خطوط NVIC: USART1 = 37، USART2 = 38. يظل كل خط مفعّلًا طالما أن RXNE & RXNEIE أو TXE & TXEIE أو TC & TCIE أو IDLE & IDLEIE قائمًا. هذه حالات وليست أعلامًا حافّية، لذا فإن دخول المعالج لا يمسح شيئًا. يجب على معالج TXE الذي لم يتبقّ لديه ما يرسله أن يعطّل نفسه، تمامًا كما على الشريحة.
3.5 SYSCFG (0x4001_3800) و EXTI (0x4001_3C00)
| الإزاحة | الاسم | البتات |
|---|---|---|
SYSCFG 0x00 |
MEMRMP |
يُخزَّن ويُقرأ مرة أخرى؛ إعادة تعيين الإقلاع مثبّتة على ذاكرة flash الرئيسية |
SYSCFG 0x04 |
PMC |
مخزَّنة وتُقرأ مرة أخرى |
SYSCFG 0x08..0x14 |
EXTICR1..EXTICR4 |
4 بتات لكل خط: 0 = المنفذ A، 1 = المنفذ B، 2 = المنفذ C، 3 = المنفذ D. يراقب الخط n الطرف n من المنفذ المحدد |
SYSCFG 0x20 |
CMPCR |
يقرأ 0 |
EXTI 0x00 |
IMR |
قناع المقاطعات، بت واحد لكل خط من 0..15 (الخطوط من 16..22 تُخزَّن ولا تُطلق أبدًا) |
EXTI 0x04 |
EMR |
قناع الأحداث؛ يُخزَّن، والخط المقنّع يوقظ النواة من WFE |
EXTI 0x08 |
RTSR |
تحديد الإطلاق الصاعد |
EXTI 0x0C |
FTSR |
تحديد الإطلاق الهابط |
EXTI 0x10 |
SWIER |
writing 1 sets the matching PR bit |
EXTI 0x14 |
PR |
قائم (pending)؛ اكتب 1 للمسح |
NVIC lines: EXTI0 = 6, EXTI1 = 7, EXTI2 = 8, EXTI3 = 9, EXTI4 = 10, EXTI9_5 =
23, EXTI15_10 = 40. A line asserts its NVIC input while its PR bit is set and
its IMR bit is set; the handler clears PR, as on silicon.
3.6 نظام SysTick ووحدة NVIC
Both are inside cortexm-core at the architectural addresses in the System
Control Space and never reach the bus (proofs/cortexm/REPORT.md section 5).
SYST_CALIB is programmed to 10500 with SKEW and NOREF clear: the board's
external reference is HCLK/8 = 10.5 MHz, so a 10 ms tick is 105,000 of them,
which does not fit 24 bits: the part's own answer, and the reason CMSIS
SysTick_Config uses the processor clock. With CLKSOURCE clear the model
still counts processor cycles; the /8 divider is not modeled and is called out
here rather than hidden.
يحتوي stm32f411.h أيضًا على تسميات CMSIS، للكود المكتوب وفق ترويسات ST: أسماء SysTick_CTRL_*_Msk و_Pos، وSysTick_LOAD_RELOAD_Msk وSysTick_VAL_CURRENT_Msk، وSystemCoreClock (84,000,000، وهو متغير كما في CMSIS) ودالة SystemCoreClockUpdate() فارغة. تعمل دالة millis() في بيئة التشغيل على SysTick، لذا فإن أي كود يعيد برمجته يغيّر millis() وdelay().
3.6a ADC1 (0x4001_2000، والسجلات المشتركة عند 0x4001_2300)
مجموعة عادية واحدة، تبدأ بـ SWSTART (البت 30 في CR2) أثناء تعيين ADON، في وضع المرة الواحدة أو الوضع المتواصل، حيث يمشي SCAN عبر التسلسل ويترك آخر نتيجة في DR، وهذا ما تفعله القطعة التي لا تحتوي على DMA. لا يوجد بدء بـ «اكتب ADON مرتين» في هذه العائلة. SR: يُعيَّن EOC (1) عند انتهاء التحويل ويُمسح عند قراءة DR؛ يُعيَّن STRT (4) عند بدء تحويل؛ وكلاهما rc_w0. يختار CR1.RES (البتان 24..25) دقة 12 أو 10 أو 8 أو 6 بتات؛ وCR2.ALIGN يحاذي إلى اليسار؛ وCR1.EOCIE يرفع خط NVIC رقم 18 (ADC). يقسم ADC_CCR.ADCPRE (البتان 16..17) إشارة PCLK2 على 2 أو 4 أو 6 أو 8 لساعة ADC، ويستغرق التحويل زمن أخذ العيّنة من SMPRx للقناة (3 أو 15 أو 28 أو 56 أو 84 أو 112 أو 144 أو 480 من دورات ساعة ADC) زائد دورة ساعة واحدة لكل بت (RM0383 11.5): لذا EOC لا يأتي مبكرًا ولا متأخرًا.
Channels 0..7 are PA0..PA7, 8 and 9 PB0 and PB1, 10..15 PC0..PC5
(DS10314 table 8). The board hands each one the voltage on its net as a
twelve-bit count against 3.3 V; a floating pin reads noise. Channel 17
(VREFINT, 1.21 V, count 1502) and 18 (the temperature sensor at 25 C, 0.76 V,
count 943) read their nominal values while ADC_CCR.TSVREFE (bit 23) is set,
and 0 otherwise. Not modeled: the injected group, the analog watchdog,
external triggers, DMA and the overrun flag. Clock enable RCC_APB2ENR bit 8.
3.7 ما هو غير مُنمذج
شجرة الساعات وزمن الانتظار في الذاكرة الوميضية، وDMA، وUSB، وI2C، وSPI، وSDIO، وRTC، والمراقبان، وTIM9 وTIM11، ووحدة CRC، وأنماط الاستهلاك المنخفض في متحكم الطاقة، وبايتات الخيارات، وبرمجة الذاكرة الوميضية. سجلاتها غير معنونة (خطأ وصول) إلا حيث يُذكر كتلة أعلاه، حيث يقرأ الإزاحة غير المطبَّقة 0 ويتجاهل الكتابات ويحسب كتابة شاردة. توقف WFI وWFE النواة؛ ويُخزَّن SLEEPDEEP ويتصرف كنوم عادي.
4. قناة المضيف
host = "utf-8 bytes on USART1" ("utf-8 bytes on USART2" على Nucleo). يعيد readHost بايتات TX لمنفذ USART المضيف فور خروجها على السلك؛ ويدفع writeHost بايتات إلى طابور الاستقبال (التجاوز يُسقط ويُفعّل ORE، كما في الشريحة). تعرض الشاشة التسلسلية البايتات كنص، مع فك ترميز UTF-8 واعتبار \n نهاية سطر (ويُتجاهل \r).
5. نموذج الزمن والقطعة
84 MHz على Black Pill، دورة واحدة لكل 1/84 us (100 MHz على Nucleo، دورة واحدة لكل 10 ns بالضبط، وشريحة من 1000 دورة؛ وبقية هذا القسم تعطي أرقام Black Pill). تأتي عدّات الدورات من النواة (Cpu::run يعيد الدورات؛ وعداد دورات النواة هو الساعة). الدورة ليست عددًا صحيحًا من البيكوثانية، لذا يُشتق الزمن كـ ps = cycles * 1_000_000 / 84، بدقة تامة، دون تراكم أبدًا، ويُعاد حسابه دائمًا من عدّة الدورات، فلا يمكن أن ينحرف أبدًا. شريحة 10 us تساوي بالضبط 840 دورة، و840 دورة تساوي بالضبط 10,000,000 ps، فحدود الشرائح دقيقة.
الساعات عند الإقلاع (يشرح القسم 3.1 كيف تغيّرها البرامج الثابتة؛ كل رقم هنا يتبع HCLK بعدها):
| النطاق | Black Pill | Nucleo |
|---|---|---|
| SYSCLK, HCLK, CPU | 84 MHz | 100 MHz |
| ساعة طرفيات APB1 (USART2) | 42 MHz | 50 MHz |
| ساعة مؤقتات APB1 (TIM2..TIM5) | 84 MHz | 100 MHz |
| APB2 (USART1، ADC1) ومؤقتاته (TIM1، TIM10) | 84 MHz | 100 MHz |
داخل الشريحة تُخطى النواة بحيث تحمل كل كتابة إلى طرفية دورة CPU التي حدثت عندها: فيصبح تغيير طرف ما drive_after عند تلك الإزاحة من بداية الشريحة، فكتابتان إلى BSRR متباعدتان أربع دورات هما فعلًا على بعد 48 ns على الشبكة. تُقدَّم المؤقتات تحليليًا. يُحسب الحدث التالي لكل مؤقت (مطابقة مقارنة، أو تحديث، أو تجاوز) من عدّته ومعامل تقسيمه وARR ووضعه، وتُشغَّل النواة حتى تلك الدورة، ثم يُطبَّق الحدث ويستمر التشغيل، فتقع حافة PWM على الدورة الدقيقة لا في نهاية الشريحة. ترى قراءات IDR مستويات الأطراف كما كانت عند بداية الشريحة زائد أي تغيير أحدثه البرنامج نفسه في الشريحة.
WFI (and WFE with the event register clear) parks the core: the part stops
slicing and schedules one wake at the earliest of the SysTick reload, the next
timer event that can raise an enabled interrupt, and the next USART event; a pin
change or a host byte wakes it immediately. This is the whole idle story.
proofs/cortexm/REPORT.md measures the core at 1.02x of a real STM32F411 in
Chromium and says plainly that there is no headroom, so a sketch that busy-waits
through a delay() will not hold real time. delay() in the runtime therefore
parks on WFI and is woken by SysTick, and an idle board costs the kernel a
handful of events a simulated second instead of 84 million cycles.
المجس: البتة 0 = قيد التشغيل (1 أثناء التنفيذ، 0 أثناء إعادة التعيين أو التوقف)، البتة 1 = نائمة (موقوفة على WFI/WFE)، البتة 2 = LED اللوحة (PC13 بمستوى منخفض)، البتة 3 = نشاط إرسال خلال آخر 20 ms، البتة 4 = نشاط استقبال خلال آخر 20 ms. إذن probe هو قناع بتات صغير، يساوي 0 عند عدم وجود برنامج.
الأمر Poke: 0 = تحرير KEY، 1 = الضغط على KEY (يوصل PA0 بالأرضي أثناء الضغط)، 2 = إبقاء NRST مضغوطًا، 3 = تحرير NRST.
معالجة الانهيار كما في القسم 5 من docs/esp32c3.md: تبلغ النواة عن Trap، ثم تتوقف القطعة وتطبع سطرًا واحدًا على قناة المضيف، مثل firmware crashed at pc=0x08000412, HardFault (CFSR 0x00000100). الانغلاق، والتعليمة غير المعرفة، وBKPT، وجدول المتجهات غير المعروض، كلها تصل كأشراك. بعد ذلك تتوقف القطعة عن طلب الاستيقاظ.
6. بيئة تشغيل البرنامج الثابت (firmware/stm32/)
بيئة تشغيل C و ++C مستقلة للـ STM32F411 مبنية بـ clang 18 (--target=thumbv7em-none-eabi -mfloat-abi=soft -mcpu=cortex-m4 -Os) وlld، من دون newlib، من دون CMSIS، من دون HAL، ومن دون أي شيء GPL:
crt0.S: the 16 system vectors plus the 85 IRQ vectors at the head of flash,_start(setMSP, which the core has already done from vector 0; copy.datafrom its load address in flash, clear.bss, run the C++ static constructors, callmain), and a default handler that stops.link.ld: الفلاش عند0x0800_0000بحجم 512 KB، وSRAM عند0x2000_0000بحجم 128 KB، والمكدس من أعلى SRAM، مع تأكيد أن البيانات الساكنة تترك له مساحة كافية.stm32f411.h: كل سجل من القسم 3 ك macro متطاير بالاسم الحقيقي من ST (GPIOC->ODR،RCC->AHB1ENR،TIM3->CCR1،USART1->DR)، إضافة إلى ثوابت البتات وأرقام المقاطعات.arduino.h: نفس واجهة الكود البرمجي الموجودة في بيئة Uno، ولكن على أطراف هذه القطعة:pinMode،digitalWrite،digitalRead،analogWrite،delay،delayMicroseconds،millis،micros،Serial،attachInterrupt،shiftOut،map،random. أرقام الأطراف هي أسماء المنافذ:PA0وPB9وPC13هي ثوابت، وLED_BUILTINهوPC13.
millis() تأتي من SysTick بتردد 1 kHz (إعادة تحميل 83,999). micros() تأتي من TIM2، وهي عدّاد حر 32 بت بتردد 1 MHz (PSC = 83، ARR = 0xFFFFFFFF)، لذا فلها دقة 1 us ويلتف كل 71.6 دقيقة. delay() تُبقي النواة على WFI حتى يبلغ عدّاد SysTick الموعد النهائي؛ أما delayMicroseconds() فتنتظر بشكل مشغول على TIM2.
analogWrite(pin, 0..255) يُخرج PWM عند 1 kHz، كما يفعل STM32duino (PWM_FREQUENCY 1000: PSC = 1، أي نبضة 42 MHz، وARR = 41,999، أي 84 MHz / 2 / 42,000)، مع CCRx = 42,000 x value / 255، وهو تحجيم setCaptureCompare في النواة، على اثني عشر طرفًا:
| مؤقت | القناة 1 | القناة 2 | القناة 3 | القناة 4 |
|---|---|---|---|---|
| TIM5 | PA0 |
PA1 |
PA2 |
PA3 |
| TIM3 | PA6 |
PA7 |
PB0 |
PB1 |
| TIM4 | PB6 |
PB7 |
PB8 |
PB9 |
0 و255 ليسا PWM: يفصلان مخرج المقارنة ويجعلان الطرف منخفضًا أو مرتفعًا، لذا فإن analogWrite(pin, 0) إطفاء فعلي. أما digitalWrite على طرف PWM فيستعيد الطرف، كما تفعل نواة Arduino.
analogRead(pin) تُجري التحويل على ADC1 (القسم 3.6a) كما تفعل STM32duino: الطرف في وضع تناظري، ADCPRE تساوي PCLK2 / 4، و15 دورة أخذ عينات، ثم SWSTART وانتظار EOC، والنتيجة في عشرة بتات افتراضيًا (ADC_RESOLUTION بقيمة 10). analogReadResolution(bits) تختار أقرب دقة للمحوّل (6 أو 8 أو 10 أو 12) وتُحوّلها إلى عدد البتات المطلوب عبر mapResolution الخاصة بالنواة. أي رقم أقل من عدد المداخل التناظرية للوحة يُعدّ مدخلًا تناظريًا (analogRead(0) تعادل A0)، كما في STM32duino؛ وعلى Black Pill تكون A0 حتى A9 هي PA0 حتى PA7 وPB0 وPB1.
Serial هو USART1 على PA9/PA10، بوضع 8N1، والاستقبال بالمقاطعات إلى حلقة من 64 بايت، والإرسال عبر حلقة من 64 بايت تُفرَّغ بمقاطعة TXE، كما يفعل HardwareSerial في STM32duino (SERIAL_TX_BUFFER_SIZE بقيمة 64): أمر print يتسع للحلقة يعود فورًا وتخرج البايتات بسرعة البث، والأطول ينتظر توفر مساحة، وavailableForWrite() هو المساحة المتبقية (63 عندما تكون فارغة). وattachInterrupt(pin, fn, mode) يستخدم SYSCFG وEXTI: معالج واحد لكل خط، مع CHANGE وRISING وFALLING.
أمثلة تحت firmware/stm32/examples/<name>/sketch.ino، تُبنى إلى web/public/firmware/stm32/<name>.elf مع web/public/firmware/stm32/index.json بالشكل نفسه كما في فهرس Uno، ويحمل كل عنصر "program": "elf32 arm stm32f411":
blink: وميض علىPC13بتردد 1 Hz، فعّال بالمستوى المنخفض، معdelay(500)متوقّفًا علىWFI.button: زرKEYعلىPA0معINPUT_PULLUPيضيءPC13.serial: يطبعmillis()مرة كل ثانية ويعيد إرسال ما يستقبله.fade:analogWriteعلىPA0لتنفّس LED، مع تبعيةPC13له.
تختار الواجهة قائمة البرامج الثابتة حسب نص program في فهرس القطعة (docs/sim-api.md القسم 3): "elf32 riscv32imc" يقرأ /firmware/index.json، و"elf32 avr atmega328p" يقرأ /firmware/uno/index.json، و"elf32 arm stm32f411" يقرأ /firmware/stm32/index.json، و"elf32 arm stm32f411 nucleo" يقرأ /firmware/nucleof411re/index.json.
7. ما تثق به هذه المواصفة، وما لا تثق به
ثلاث مجموعات، بالتصنيف نفسه الذي يستخدمه القسم 7 من docs/esp32c6.md. وهي موجودة لأن نموذج لوحة يخمّن عنوانًا بصمت هو أسوأ من نموذج يقول إنه لم يعرف.
مأخوذة من الدليل المرجعي، ومُجرَّبة ببرنامج ثابت حقيقي. كل عنوان أساسي وإزاحة سجل وموضع بت في القسمين 2 و3 مأخوذ من الدليل المرجعي لـ STM32F4 (RM0383) وورقة بيانات STM32F411CE: RCC عند 0x4002_3800، وGPIOA/B/C عند 0x4002_0000/0400/0800، وTIM2 إلى TIM5 عند 0x4000_0000/0400/0800/0C00، وUSART1 عند 0x4001_1000 وUSART2 عند 0x4000_4400، وSYSCFG عند 0x4001_3800 وEXTI عند 0x4001_3C00، وSysTick وNVIC عند عناوين ARM الخاصة بهما، و128 KB من SRAM عند 0x2000_0000 و512 KB من الفلاش عند 0x0800_0000؛ وGPIOD عند 0x4002_0C00، وTIM1 عند 0x4001_0000، وADC1 عند 0x4001_2000 وTIM10 عند 0x4001_4400 مع حقول بتات الـ ADC وتوقيتاته من الفصل 11 من RM0383. الملفان crates/stm32f411/tests/firmware.rs وtests/nucleo.rs يحمّلان ملفات ELF حقيقية ويشغّلان عبرهما GPIO والمؤقتات وUSART الاثنين وADC وSysTick وEXTI. أما ترتيب أطراف لوحة WeAct Black Pill وLED الخاصة بـ PC13 فهو من اللوحة نفسها.
مُحاكاة السلوك دون التقيد بأرقام الدليل المرجعي. السلوكيات لا العناوين:
- ساعة الإقلاع هي السرعة الكاملة للوحة (84 MHz، أو 100 على الـ Nucleo). لوحة حقيقية لا تضبط الـ PLL أبدًا تعمل عند 16 MHz من الـ HSI؛ هنا يعمل برنامج لا يلمس سجلات الساعة أبدًا بساعة اللوحة، وهذا ما تفترضه بيئة تشغيل Mokxi للـ Arduino. وبمجرد أن يكتب البرنامج في سجلات الساعة تُتبع الـ PLL والمذبذبات والمقسّمات (القسم 3.1)؛ أما تأخير الفلاش فلا.
- الشريحة الزمنية لها غُرّان، وأول كتابة بعد فترة هدوء تأتي مبكرة. يعمل المعالج على دفعات خشنة حتى تقع كتابة على سجل GPIO أو مؤقت أو USART، وعندها يعمل تعليمة بتعليمة لفترة. كل ما داخل الدفعة دقيق؛ لكن أول كتابة في الدفعة تُحتسب زمنيًا عند رأس الدفعة التي وقعت فيها، أي بحد أقصى 6.1 us مبكرة.
- الأطراف لها ثلاث حالات وعتبة واحدة. دفع-جذب عند 3.3 V، أو تصريف مفتوح، أو مقاومة عالية، أو مقاومة سحب داخلية 40 kΩ (ورقة البيانات تعطي من 30 kΩ إلى 50 kΩ)، وتُقرأ النتيجة مقابل نصف جهد التغذية، بلا تخمير ولا إعداد للسرعة ولا زمن ارتفاع ولا حد للتيار. الـ LED الموجودة على اللوحة هي LED خلف مقاومة 470 Ω على
PC13، والأنود نحو الجهد، فيضيئها المستوى المنخفض. - The board is an ideal supply: 3V3 and 5V at rail impedance for ever, so nothing
browns out and the regulator is not there.
VBATis a pin and no more. Startup is a microsecond, with no option bytes and no boot pins.
غائبة عمدًا، كما يسردها القسم 3.7: شجرة الساعة وتأخير الفلاش، وDMA، وUSB (لذا منفذ USB في اللوحة لا يحمل شيئًا؛ Serial يصل إلى الشاشة عبر قناة المضيف، ويبقى PA11/PA12 أطراف GPIO عادية)، وI2C وSPI وI2S وSDIO والـ RTC وكلاب المراقبة وTIM9 وTIM11 وCRC والـ FPU وسجلاته، وبرمجة الفلاش. غياب الـ FPU يكلّف وقتًا لا نتائج: بيئة التشغيل مبنية لواجهة soft-float، فيُحسب العدد العشري برمجيًا ويخرج بالقيمة نفسها، لكن بدورات أكثر مما يأخذ FPU الشريحة.
8. لوحة Nucleo-F411RE (nucleof411re)
لوحة NUCLEO-F411RE من ST (MB1136، UM1724): شريحة STM32F411RET6، وهي الشريحة نفسها في علبة 64 طرفًا، على لوحة مع ST-LINK. القطعة هي المحوّل نفسه الخاص بـ Black Pill (crates/parts/src/parts/stm32f411.rs) مع إعداد اللوحة stm32f411::NUCLEO_F411RE؛ وبيئة التشغيل هي firmware/stm32/ مبنية بالخيار -DMOKXI_BOARD_NUCLEO_F411RE (firmware/nucleof411re/build.sh). في الفهرس program = "elf32 arm stm32f411 nucleo"، وهو يقرأ /firmware/nucleof411re/index.json؛ وhost = "utf-8 bytes on USART2".
الساعة. 100 MHz، وهي الساعة التي يبرمجها إعداد NUCLEO_F411RE في STM32duino (تجاوز HSE من 8 MHz القادمة من ST-LINK، وPLLM 4، وPLLN 100، وPLLP 2؛ وAPB1 / 2، وAPB2 / 1)، فالدورة تساوي 10 ns بالضبط والشريحة الزمنية 10 us تساوي 1000 دورة. تكلفة الدورة الواحدة على المضيف هي نفسها كما على Black Pill، وهناك 19 % دورات أكثر في الثانية، لذا فالكود الذي ينتظر في حلقة مشغولة يحتاج 19 % أكثر من الجهاز للحفاظ على الزمن الحقيقي؛ أما الذي ينام في delay() فلا يكلّف شيئًا في الحالتين.
الأطراف (بترتيب الفهرس): رؤوس Arduino CN6 IOREF، NRST، 3V3، 5V، GND، GNDb، VIN؛ وCN8 A0..A5؛ وCN5 D15، D14، AVDD، GNDc، D13..D8؛ وCN9 D7..D2؛ ثم الأطراف التي لا يُخرجها إلا رأسا الـ morpho، CN7 PC10، PC11، PC12، PD2، VDD، E5V، BOOT0، GNDd، PA13، PA14، PA15، PB7، PC13، VBAT، PC2، PC3، وCN10 PC9، PC8، PC6، PC5، U5V، GNDe، PA12، PA11، PB12، PB2، PB1، PB15، PB14، PB13، AGND، PC4، PA2، PA3 (63 طرفًا). الطرف الموجود على رأس Arduino ورأس morpho معًا هو طرف واحد، باسمه في Arduino:
| Arduino | D2 |
D3 |
D4 |
D5 |
D6 |
D7 |
D8 |
D9 |
D10 |
D11 |
D12 |
D13 |
D14 |
D15 |
A0 |
A1 |
A2 |
A3 |
A4 |
A5 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| الوسادة | PA10 |
PB3 |
PB5 |
PB4 |
PB10 |
PA8 |
PA9 |
PC7 |
PB6 |
PA7 |
PA6 |
PA5 |
PB9 |
PB8 |
PA0 |
PA1 |
PA4 |
PB0 |
PC1 |
PC0 |
أُهملت لأن اللوحة كما تُشحن لا توصلها (UM1724 6.8، 6.12): D0/D1 (SB62/SB63 مفتوحان؛ PA3/PA2 يذهبان إلى ST-LINK وموجودان على رأس الـ morpho)، وPC14/PC15 (بلورة LSE) وPH0/PH1 (خرج MCO من ST-LINK). VIN وE5V وBOOT0 مداخل تتجاهلها اللوحة؛ وIOREF وVDD وAVDD وVBAT (مربوطة بـ VDD على هذه اللوحة) هي 3.3 V؛ وU5V هي 5 V.
على اللوحة. LD2، الخضراء، من PA5 عبر مقاومة 510 أوم إلى الأرضي: تضيء أثناء قيادة الطرف بمستوى عالٍ، وفقط أثناء كونه مخرجًا (البِت 2 من المجس). B1، زر USER الأزرق، يصل PC13 بالأرضي (أمر poke بالقيمة 1 يضغطه، وبالقيمة 0 يتركه)، وR30، مقاومة 4.7 كيلوأوم من PC13 إلى 3.3 فولت، موصولة بالطرف دائمًا، لذا يقرأ المدخل مستوى عالٍ عند ترك الزر. B2 هو NRST (poke بالقيمة 2 أو 3). بِتات المجس تخص لوحة Black Pill؛ أما البِتان 3 و4 فهما لاتصال COM الخاص بـLD1 على ST-LINK.
بيئة التشغيل. ترقيم NUCLEO_F411RE في STM32duino: 0..15 هي D0..D15، و16..51 بترتيب morpho الخاص بالمتغيّر variant، وPIN_A0..PIN_A15 = 192..207 هي مداخلها التناظرية، وكل اسم منفذ معرّف كأحد تلك الأرقام (PA5 هو PIN_A15، وهو الطرف الرقمي 13)، لذا فإن 13 وD13 وPA5 وLED_BUILTIN كلها طرف واحد. USER_BTN هو PC13. Serial هو USART2 على PA2/PA3 (SERIAL_UART_INSTANCE يساوي 2)، ويسمى أيضًا Serial2؛ ولا يوجد Serial1. يستخدم analogWrite أول مؤقت يذكره PinMap_TIM الخاص بالمتغيّر لكل طرف، عند 1 kHz (PSC يساوي 1، وARR يساوي 49,999): TIM2 على PA0..PA3، PA5، PA15، PB3، PB10؛ TIM3 على PA6، PB4، PB5، PC6..PC9؛ TIM4 على PB6..PB9؛ TIM1 على PA8..PA11 وكقنوات CH1N..CH3N: PA7، PB0، PB1، PB13..PB15. إذًا يعمل micros() هنا على TIM5، وtone() على TIM10، وهو TIMER_TONE الخاص بالمتغيّر. يعود Wire افتراضيًا إلى D14/D15، وSPI إلى D13، D12، D11، D10. أمثلة في firmware/nucleof411re/examples/: blink، button، serial، fade (D9) وanalog (A0).