تعلّم

أومض LED على Blue Pill بكتابة السجلات بنفسك

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Blue Pill: وميض عبر السجلاتمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
الطرف PC13 يقاد يدويًا عبر RCC و CRH و BSRR، مع طباعة قيم السجلات أولًا.

تخفي pinMode و digitalWrite ثلاث كتابات في السجلات. على STM32 تستحق هذه الكتابات الثلاث أن تتعلمها، لأنك يوم تنتقل من نواة Arduino إلى HAL من المزوّد أو إلى البرمجة المباشرة للعتاد، ستجدها هي ما تفعله كل دالة GPIO، وأشهر خطأ STM32 على الإطلاق يكمن في أولها.

الدائرة أعلاه عبارة عن STM32F103 Blue Pill مع LED ومقاومة 1 k من 3.3 V إلى PC13، وهو الطرف نفسه المتصل بـ LED اللوحة الخضراء. يرمش الكود بهذا الطرف بدون pinMode أو digitalWrite، وقبل البدء يطبع ثلاث قيم من السجلات. اضغط «تشغيل» فتقرأ الشاشة التسلسلية:

الأسطر الثلاثة هي "CRH مع ساعة المنفذ C مطفأة: 0x0"، ثم "CRH بعد IOPCEN، قيمة إعادة الضبط: 0x44444444"، ثم "CRH مع PC13 كمخرج: 0x44244444". بعد ذلك ترمش كلتا LED مرة كل ثانية.

الخطوة 1: شغّل ساعة المنفذ

كل جهاز طرفي على STM32 يبدأ وساعته مطفأة لتوفير الطاقة، والجهاز الطرفي بلا ساعة لا يفعل شيئًا. ساعة المنفذ GPIO C هي البتة 4 من RCC->APB2ENR، واسمها IOPCEN. حتى تُضبط، تقرأ سجلات المنفذ أصفارًا وتتجاهل الكتابات.

يثبت الكود ذلك. يكتب قيمة إلى GPIOC->CRH قبل تمكين الساعة ويقرأ 0x0: لم تذهب الكتابة إلى أي مكان. وبعد RCC->APB2ENR |= RCC_APB2ENR_IOPCEN يقرأ السجل نفسه 0x44444444، وهي قيمة إعادة الضبط. على العتاد الحقيقي، نسيان هذا السطر ينتج برنامجًا يترجم ويعمل ولا يفعل شيئًا على الإطلاق، دون أي خطأ في أي مكان. ويحاكي Mokxi هذه البوابة بالطريقة نفسها عمدًا.

الخطوة 2: اضبط الطرف في CRH

يصف F103 كل طرف بأربع بتات: اثنتان لـ MODE (مدخل، أو مخرج بسرعة 10 أو 2 أو 50 MHz) واثنتان لـ CNF (دفع وجذب، أو صرف مفتوح، أو وظيفة بديلة). الأطراف من 0 إلى 7 في CRL ومن 8 إلى 15 في CRH. الطرف PC13 هو النيبل السادس من CRH، البتات من 20 إلى 23.

قيمة إعادة الضبط 0x4 في كل نيبل تعني CNF 01 و MODE 00: مدخل عائم. يمسح الكود نيبل PC13 ويكتب 0x2، أي MODE 10 (مخرج، 2 MHz) و CNF 00 (دفع وجذب)، ولهذا يقرأ السطر الثالث 0x44244444: نيبل واحد تغيّر والبقية كما هي. عائلات STM32 الأحدث مثل F4 تستخدم تخطيطًا مختلفًا (MODER و OTYPER و OSPEEDR)، وهو أول ما ينكسر عند نقل كود F1 إلى F4.

firmware/bluepill/examples/registers (مختصر من البرنامج الذي يعمل أعلاه)
const uint32_t PIN = 13;
const uint32_t CRH_SHIFT = (PIN - 8) * 4;      // bits 20..23
const uint32_t OUT_2MHZ_PUSH_PULL = 0x2;       // CNF 00, MODE 10

void setup() {
  RCC->APB2ENR |= RCC_APB2ENR_IOPCEN;          // 1. clock on
  uint32_t crh = GPIOC->CRH;
  crh &= ~(0xFUL << CRH_SHIFT);
  crh |= OUT_2MHZ_PUSH_PULL << CRH_SHIFT;
  GPIOC->CRH = crh;                            // 2. PC13 an output
}

void loop() {
  GPIOC->BSRR = 1UL << (PIN + 16);             // 3. reset: low, LED on
  delay(500);
  GPIOC->BSRR = 1UL << PIN;                    //    set: high, LED off
  delay(500);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

الخطوة 3: BSRR، ولماذا ليس ODR

You could change the pin by reading ODR, the output register, flipping bit 13 and writing it back. BSRR is better. Writing a 1 to one of its low 16 bits sets that pin; writing a 1 to one of its high 16 bits resets it; zeros change nothing. It is a single write with no read first, so if an interrupt changes another pin on port C between your read and your write, BSRR cannot undo that change, and a read-modify-write of ODR can.

LED على PC13 موصّلة من 3.3 V إلى الطرف، لذا يسحب الطرف تيارها وتضيء LED عندما يكون الطرف منخفضًا. هذا هو عكس الطرف 13 في Uno، وهو السبب في أن الكود يعيد ضبط الطرف لتشغيل LED.

لماذا المقاومة 1 k، وأين يقع HAL

الأطراف PC13 و PC14 و PC15 خاصة في F103. فهي تحصل على طاقتها عبر مفتاح طاقة نطاق النسخ الاحتياطي، وورقة بيانات ST تحدّها بسحب نحو 3 mA كحد أقصى، وبسرعة لا تتجاوز 2 MHz، وتقول إنه لا يجوز استخدامها كمصدر تيار، مثلًا لتشغيل LED من الطرف إلى الأرضي. LED في Blue Pill موصّلة بالاتجاه المعاكس، من 3.3 V إلى داخل الطرف، عبر مقاومة 1 k: أي أن (3.3 - 2) / 1000 تساوي نحو 1.3 mA. مقاومة 220 ohm هنا كانت ستطلب نحو 6 mA، لذا تستخدم هذه الدائرة 1 k للبقاء داخل الحد. للحصول على LED أشد إشراقًا على لوحة حقيقية، اختر طرفًا عاديًا مثل PA5 مع مقاومة 330 ohm.

مكتبة HAL من ST تنفّذ الخطوات الثلاث نفسها بدوال مسماة: ‎__HAL_RCC_GPIOC_CLK_ENABLE()‎، و ‎HAL_GPIO_Init()‎ مع GPIO_InitTypeDef، و ‎HAL_GPIO_WritePin()‎ أو ‎HAL_GPIO_TogglePin()‎ التي تكتب في BSRR خلف الكواليس. Mokxi لا يشغّل ملفات HAL الثنائية، لأنها تبدأ بضبط شجرة الساعة وزمن انتظار الذاكرة الوميضية، وهما غير مُحاكيَين؛ Blue Pill هنا تعمل بسرعة ثابتة قدرها 72 MHz. السجلات أعلاه هي بالضبط ما تنتهي تلك الاستدعاءات في HAL إلى كتابته.

تنبيه من العالم الحقيقي: كثير من اللوحات التي تُباع باعتبارها Blue Pill تحمل نسخة مقلّدة من STM32F103 بدلًا من شريحة ST. عادةً ما تشغّل كود GPIO البسيط مثل هذا بشكل جيد، لكنها قد تختلف في حجم الذاكرة الوميضية وفي دعم مصحح الأخطاء، لذا تحقق من الكتابة على الشريحة إذا تصرفت اللوحة بشكل غريب.

افتح هذه الدائرة في المحرر. Blue Pill: وميض عبر السجلات، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم شغّلها مرة أخرى.

الأسئلة

لماذا لا يفعل كود STM32 GPIO الخاص بي شيئًا؟

السبب الأكثر شيوعًا بفارق كبير هو ترك ساعة المنفذ مطفأة في RCC. في عائلة F1 توجد ساعات GPIO في ‎RCC->APB2ENR‎، وفي F4 توجد في ‎RCC->AHB1ENR‎. عندما تكون الساعة مطفأة، تُتجاهل عمليات الكتابة وتعيد عمليات القراءة صفرًا.

هل LED في Blue Pill تعمل بالمستوى المنخفض؟

نعم. فهي موصّلة من 3.3 V عبر مقاومة إلى PC13، لذا تضيء عندما يُسحب PC13 إلى المستوى المنخفض.

ما الفرق بين BSRR و BRR؟

BSRR تستطيع رفع الأطراف (النصف السفلي) وخفضها (النصف العلوي) في عملية كتابة واحدة. أما BRR فلا تستطيع إلا خفضها. وكلتاهما تترك كل طرف لم تذكره دون تغيير.

هل يمكنني استخدام دوال Arduino والسجلات في الكود نفسه؟

نعم. ما زال هذا الكود يستخدم Serial و delay() من بيئة التشغيل. فقط احرص على ألا يلمس كل منهما ضبط الطرف نفسه، وإلا فالفائز هو آخر من يكتب في CRH.

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.