اللوحات

لوحة STM32F411 Black Pill

معالج Cortex-M4 بتردد 84 MHz مع GPIO ومؤقتات وADC وUSART1 وSysTick.

نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج STM32F411 (كل المسجلات).

ما هي

The WeAct MiniF4 "Black Pill", an STM32F411CEU6 running on our own Cortex-M core in its ARMv7-M profile with Thumb-2. The registers come from the manufacturer's reference manual and datasheet at their real addresses, so the same source cross-compiled against the vendor headers would work on silicon.

التردد ثابت: 84 MHz للمعالج والناقل والمؤقتات، و42 MHz على ناقل الملحقات الأبطأ. الشريحة نفسها على لوحة Nucleo من ST تعمل عند 100 MHz: لوحة Nucleo-F411RE.

الأطراف

Two twenty-pin headers on a 0.1 inch pitch and a four-pin SWD header across the bottom edge, in the order of WeAct's own pinout diagram, with USB-C at the top.

الرأس الأيسر، من الأعلى إلى الأسفل: PB12، PB13، PB14، PB15، PA8 إلى PA12، PA15، PB3 إلى PB9، ثم 5V وG و3V3.

الرأس الأيمن، من الأعلى إلى الأسفل: 5V، G، 3V3، PB10، PB2، PB1، PB0، PA7 نزولًا إلى PA0، R (NRST)، PC15، PC14، PC13، وVB (VBAT) في الطرف الأبعد عن مقبس USB.

رأس SWD، من اليسار إلى اليمين: 3V3، DIO (PA13)، SCK (PA14)، G. اللوحة المثبتة في لوحة تجارب لا توصل هذه الأطراف، لأن الرأس الحقيقي يتجه إلى الأعلى أو غير مركّب؛ وصّل إليها مباشرة.

للقضبان الإضافية أسماؤها الخاصة في المخطط، لأن كل اسم طرف فريد: أسماء الصف الأيمن هي 5Vb وGNDc و3V3b، وأسماء رأس SWD هي 3V3c وGNDb. كلها نفس القضبان.

A project saved before Mokxi drew the real order (late October 2026) has this board end for end, with VBAT beside the USB socket and PA13, PA14 and a ground folded into the left row. It opens that way, with its header setting on early, so a board in a breadboard keeps every pin in the hole it was in. Set header to board for the real order: wires to pins follow them, but a board sitting in a breadboard then reaches different holes.

PB11 غير موجود، لأن الشريحة ذات 48 طرفًا لا تُخرجه. لذا فإن المنفذ B خمسة عشر طرفًا، لا ستة عشر.

الطرف هنا اسمه منفذ ورقم، لا رقم على اللوحة: PA5 وليس 5. هذا يربك القادمين من Arduino، ومسار التعلّم يبدأ بهذه النقطة.

الـ LED معكوس التوصيل

PC13 يحمل LED أزرق على اللوحة موجبه موصول بـ 3.3 فولت عبر مقاومة 470 أوم وسالبه على الطرف. يضيء عندما يُسحب PC13 إلى المستوى المنخفض. لهذا السبب يُسمّى الدرس الأول للوحة "الـ LED الذي يضيء عندما يكون الطرف منخفضًا".

What is modeled

GPIO وTIM1 إلى TIM5 وTIM10 في وضعَي العد وPWM، وADC1 وUSART1 وSysTick، إضافة إلى ما يكفي من RCC للرد على قراءات المسجلات التي يجريها البرنامج عند الإقلاع.

analogRead يقرأ أطراف ADC العشرة، PA0 إلى PA7 وPB0 وPB1 (A0 إلى A9)، بعشر بتات افتراضيًا كما في STM32duino (من 0 إلى 1023 عبر 0 إلى 3.3 فولت)؛ وanalogReadResolution(12) يعطي البتات الاثنتي عشرة الكاملة للمحوّل.

كل ملحق في STM32 الحقيقية يبدأ وساعته مغلقة، وهذا صحيح هنا أيضًا: تمكين الساعة قبل لمس أي ملحق جزء من التمرين نفسه، وليس إجراءً شكليًا يتخطاه هذا النموذج.

ما لم يُحتَذَ به

شجرة الساعات وزمن تأخر الفلاش، وDMA وUSB وI2C وSPI وSDIO وRTC وكلاب الحراسة وTIM9 وTIM11 ووحدة CRC وأوضاع الطاقة المنخفضة وoption bytes وبرمجة الفلاش. مسجلاتها غير معرّفة في الذاكرة، لذا لمس أي منها يسبب خطأ ناقل (bus fault). وحدة FPU غير محاكاة أيضًا: الأعداد العشرية تُحسب برمجيًا، فتأتي بالنتائج نفسها لكن تستغرق دورات أكثر مما تستغرقه على الشريحة.

عدم محاكاة شجرة الساعات يعمل في الاتجاه الآخر أيضًا. النواة تعمل عند 84 MHz مهما ضُبط فيه RCC، لذا فالكود الذي ينسى تشغيل PLL يضبط الوقت هنا بشكل صحيح لكنه يعمل أبطأ بخمس مرات على لوحة حقيقية. طرفا 3V3 و5V مصدران مثاليان لا يهبط جهدهما.

التقاط المدخلات غير محاكى. WFI وWFE يوقفان النواة؛ والنوم العميق يسلك سلوك النوم العادي.

حِزم المصنّع (Cube HAL وlibopencm3 ونواة STM32duino) خارج نطاق العمل للسبب نفسه الذي عليه Pico SDK: فهي تُقلع عتادًا غير موجود هنا.

جداول المسجلات موجودة في نموذج STM32F411.

التسلسلي

USART1 يحمل الشاشة التسلسلية. التفاصيل الكاملة، بما فيها ما يحدث عند امتلاء طابور الاستقبال، موجودة في وثيقة العقد.

مكتبات Arduino الرسمية

درس تعليمي يتضمن Servo.h و Wire.h و SPI.h و EEPROM.h و LiquidCrystal_I2C.h و Adafruit_GFX.h مع Adafruit_SSD1306.h و DHT.h يُترجم هنا كما هو. كل منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مبني على مشغّلات القطع في الصندوق، وليس أي منها كود المكتبة الأصلية.

  • Wire.begin() يضع ناقل I2C على PB7 (SDA) وPB6 (SCL).
  • تعمل المكتبة EEPROM.h، لكن نموذج هذه اللوحة لا يحتوي EEPROM ولا فلاش قابلًا للكتابة، لذلك تُخزَّن البايتات في 4 KB من الذاكرة RAM: يمكن قراءتها مرة أخرى خلال التشغيل نفسه، لكنها تضيع عند إعادة الضبط.
  • Adafruit_NeoPixel.h stops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.

يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.

الأمثلة

Blink وButton وSerial وFade وChaser.

لغة التجميع

توفر لوحة البرنامج الثابت أيضًا لغة التجميع (بدون Arduino): وميض LED، وزر يضيء LED، ورسالة UART للتحية، ومقاطعة مؤقت بلغة التجميع ARM Thumb-2 لمعالج Cortex-M4. ملفات اللوحة تصبح واحدة main.S، ولا يُربط سوى ذلك الملف، فيحمل جدول المتجهات الخاص به: .word _estack، ثم Reset_Handler، ثم معالجات المقاطعات. المشاريع الافتتاحية تُشغّل الساعات في RCC_AHB1ENR، وتُشغّل PC13، وتقرأ PA0، وتطبع على USART1 عبر PA9 بمعدل 115200، وتُشغّل SysTick عند 1 kHz من نواة 84 MHz. إن .S بجانب كود عادي يعمل أيضًا. انظر كتابة لغة التجميع.

في مواضع أخرى