المرجع

عقد لوحة STM32 "Blue Pill" F103 (المرحلة 9)

شريحة F103 على نواة Cortex-M3 لدينا، مع سجلات GPIO ‏CRL وCRH، ومؤقتات TIM1 إلى TIM4، ومنفذ USART1، ومحوّل ADC بدقة اثنتي عشرة بتة.

هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة STM32 Blue Pill و صفحة اللوحة.

المتحكم الدقيق الخامس ولوحة Cortex-M الثانية. مكوّن نواة واحد (bluepill في crates/parts) يغلّف نموذج SoC ‏STM32F103C8T6 (crates/stm32f103) مبنيًا على نواة ARMv7-M نفسها المستخدمة في Black Pill (crates/cortexm-core، المثبتة في proofs/cortexm/REPORT.md). البرنامج الثابت ملف ARM Thumb ELF عادي يتعامل مع الوحدات الطرفية أدناه عند عناوين STM32F103 الحقيقية، المأخوذة من RM0008 (الدليل المرجعي لـ STM32F101/102/103/105/107) وورقة بيانات STM32F103x8/xB، ولذا فإن برنامجًا مبنيًا لأجل Mokxi يعمل أيضًا على لوحة Blue Pill حقيقية.

نوع الفهرس هو bluepill (‏STM32F103C8T6، حزمة LQFP ذات 48 طرفًا، اللوحة التي يسمّيها الجميع Blue Pill). كل ما في docs/esp32c3.md عن سلوك قطعة لوحة (الشرائح، وقناة المضيف، وإعادة التعيين، وخط الانهيار) وكل ما في docs/uno.md عن كيفية وجود لوحة داخل دائرة ينطبق هنا ما لم يذكر هذا الملف خلاف ذلك.

لماذا ليست هي Black Pill بأرقام مختلفة

الملف docs/stm32f411.md هو النظير لهذا المستند، والإغراء هو قراءة أحدهما على أنه الآخر. لا تفعل. فالـF1 جيل مختلف من العائلة، والفروق هي بالضبط الفروق التي يستطيع برنامج رؤيتها:

‏F411‏ (Black Pill) ‏F103‏ (Blue Pill)
النواة ‏Cortex-M4 بلا FPU ‏Cortex-M3
الساعة 84 MHz ‏72 MHz
الفلاش / SRAM ‏512 KB / 128 KB ‏64 KB / 20 KB
ضبط الأطراف MODER وOTYPER وPUPDR وAFRL/AFRH حقل أربعة بتات واحد في CRL/CRH
اتجاه سحب الطرف كمدخل PUPDR بتّة ODR الخاصة بذلك الطرف
تصفير طرف النصف الأعلى من BSRR النصف الأعلى من BSRR، أو BRR
بوابة ساعة GPIO RCC_AHB1ENR RCC_APB2ENR
الوظيفة البديلة رقم لكل طرف في AFR ثابتة لكل وحدة طرفية، تُعاد تعيينها في AFIO_MAPR
اختيار منفذ EXTI SYSCFG_EXTICR AFIO_EXTICR
أساس RCC 0x4002_3800 0x4002_1000
المؤقتات ‏TIM2 وTIM5 بسعة 32 بتًا كل عدّاد هو 16-بت
ADC غير مُنمذج ADC1، تحويل واحد
أطراف التصحيح عند إعادة التعيين PA13، PA14، PA15، PB4 مثبّتة بمقاومة سحب الأطراف الخمسة نفسها، وتتحرر عبر SWJ_CFG

لا يوجد عنوان واحد مشترك. وحدتا الـ SoC هما شقيقتان، لا قالب ونسخة منه.

تشغيل البرامج الثنائية للمورّد (STM32Cube HAL، libopencm3، نواة STM32duino) ليس هدفًا. فهذه تحتاج إلى تهيئة شجرة الساعة من HSI، وزمن انتظار الذاكرة الوميضية والجلب المسبق، وDMA وUSB، وكلها غير مُنمذجة. أما ما هو هدف فهو أن كل سجل يلمسه برنامج bare-metal ليعمل وميض طرف، أو يطبع على UART، أو يقرأ زرًّا، أو يقرأ جهدًا، أو يشغّل مخرج PWM، يكون في عنوانه الحقيقي ببتّاته الحقيقية، بحيث يعمل الكود المصدري نفسه بعد ترجمته مقابل ترويسات CMSIS على السيليكون الفعلي.

1. أطراف اللوحة (بترتيب الفهرس)

The board is 2x20 pins on a 0.1 inch pitch, 53 x 23 mm, with the micro-USB socket at the top. Catalog order is the left header top to bottom, then the right header top to bottom.

الموصّل الأيسر: VBAT، PC13، PC14، PC15، PA0، PA1، PA2، PA3، PA4، PA5، PA6، PA7، PB0، PB1، PB10، PB11، NRST، 3V3، GND، 5V

الموصّل الأيمن: GNDb، GNDc، 3V3b، PB12، PB13، PB14، PB15، PA8، PA9، PA10، PA11، PA12، PA15، PB3، PB4، PB5، PB6، PB7، PB8، PB9

40 طرفًا: 32 طرف إدخال/إخراج، وثلاثة أطراف أرضية، واثنان 3.3 V، وواحد 5 V، وVBAT وNRST. تُطبع الأشكال المختصرة على الطباعة الحريرية (VB، C13، R، A0، B9، G، 3.3)؛ ويستخدم الفهرس أسماء المنافذ الكاملة لأن مرجع طرف netlist يجب أن يكون بلا التباس، ويضيف لاحقة إلى المكررات (GNDb، GNDc، 3V3b) لأن طرفين في قطعة واحدة لا يجوز أن يشتركا في الاسم.

ثلاثة أطراف من الشريحة ليست على موصل: PA13 وPA14 هما موصل SWD المنفصل ذو الأربعة أطراف على الحافة السفلية، وPB2 هو جمبر BOOT1 في الأعلى. وهي موجودة في نموذج الشريحة (ولا بد من ذلك، لأن منفذ التصحيح يثبّتها)، لكن لا يمكن لأي سلك الوصول إليها هنا، تمامًا كما على اللوحة.

كهربائيًا:

  • 3V3 و3V3b يوفّران 3.3 فولت عند R_SUPPLY؛ و5V يوفّر 5 فولت عند R_SUPPLY؛ وGND وGNDb وGNDc توفّر 0 فولت. اللوحة موصولة بالطاقة دائمًا (USB). وهي مصدر تغذية لبقية الدائرة. أما VBAT فهو مدخل تتجاهله اللوحة: فهي هنا تتغذى دائمًا من خط 3.3 فولت.
  • NRST مدخل بمقاومة سحب داخلية 40 كيلوأوم إلى 3.3 فولت (تذكر ورقة البيانات 30 إلى 50 كيلوأوم)؛ وإذا سُحب إلى ما دون 1.65 فولت يُبقي المعالج في حالة إعادة تعيين؛ وتحريره يعيد تشغيل البرنامج من متجه إعادة التعيين.
  • كل PAn وPBn وPCn هو GPIO ثنائي الاتجاه. إخراج (MODE != 00): push-pull عند 3.3 فولت أو 0 فولت عبر R_STRONG، أو open-drain (CNF = 01 أو 11) حيث تكون الحالة العالية high-Z دون أي مقاومة سحب إطلاقًا، لأن مخرج F1 لا يملك أيًّا منها. إدخال (MODE = 00): high-Z للحالة العائمة (CNF = 01) والتناظرية (CNF = 00)، أو سحب 40 كيلوأوم يكون اتجاهه بت ODR الخاص بذلك الطرف عندما CNF = 10. يقرأ الإدخال جهد الشبكة مقابل 1.65 فولت (نصف 3.3 فولت)؛ والقيمة Unknown تُقرأ 0، والمدخل العائم يقرأ ضجيجًا، كما في Uno (docs/uno.md القسم 1).
  • PC13 يحمل LED الأخضر المدمج، المصعد إلى 3.3 فولت عبر مقاومة 1 كيلوأوم، والمهبط إلى الطرف: يضيء الـ LED عندما يُسحب PC13 إلى المستوى المنخفض. وهو حِمل على الطرف، وتُظهره الواجهة من بت المجس (القسم 5). مقاومة 1 كيلوأوم بدلًا من 470 أوم في Black Pill، ولهذا يكون LED لوحة Blue Pill الأخفت بين الاثنتين. وتنطبق هنا أيضًا ملاحظة ورقة بيانات ST نفسها: PC13 وPC14 وPC15 في نطاق الطاقة الاحتياطية ولا تتحمل سوى 3 مللي أمبير غرقًا، فهي تُشغّل مؤشرًا لا أكثر.
  • لا يوجد زر للمستخدم. الزر الوحيد في Blue Pill هو RESET، ويُوصل إليه عبر poke (القسم 5). أي كود يحتاج زرًا عليه وضعه على لوحة التجارب، ولهذا تبدأ كثير من دروس Blue Pill بتوصيل زر.
  • PA9/PA10 هما USART1 TX/RX على اللوحة الفعلية وهنا أيضًا؛ وبايتات USART تذهب إلى قناة المضيف (القسم 4). وPA11/PA12 هما USB D-/D+ على اللوحة الفعلية، لكنهما هنا GPIO عادية.
  • PA15 وPB3 وPB4 موجودة على الموصّل، لكن منفذ تصحيح SWJ يحتجزها خارج إعادة التعيين: PA15 وPB4 بمقاومة سحب للأعلى، وPB3 عائمة. ويستعيدها البرنامج الثابت بكتابة SWJ_CFG في AFIO_MAPR (القسم 3.5). وهذه أكثر مفاجأة شيوعًا على هذه اللوحة، والنموذج يعيد إنتاجها بدل إخفائها.

2. خريطة الذاكرة (عناوين STM32F103C8 الحقيقية)

المنطقة العنوان الحجم ملاحظات
الفلاش 0x0800_0000 64 KB ذاكرة STM32F103C8 الوميضية؛ عمليات الكتابة مُهمَلة (لا توجد واجهة برمجة للذاكرة الوميضية)
اسم flash البديل 0x0000_0000 64 KB البايتات نفسها، لأن BOOT0 منخفض ومنطقة الإقلاع تعيّن flash الرئيسية إلى 0
SRAM 0x2000_0000 20 كيلوبايت
APB1 0x4000_0000 32 KB TIM2..TIM4، USART2، USART3، القسم 3
APB2 0x4001_0000 32 KB AFIO، EXTI، GPIOA..GPIOC، ADC1، TIM1، USART1، القسم 3
AHB 0x4002_0000 RCC عند 0x4002_1000، القسم 3
SCS 0xE000_E000 4 KB SysTick و NVIC و SCB، تُجاب داخل cortexm-core ولا تُرى على الناقل أبدًا

أي شيء آخر هو خطأ وصول: تأخذ النواة BusFault، والذي مع SHCSR بعد إعادة الضبط يتصاعد إلى HardFault. السجلات غير المخططة داخل كتلة طرفية مخططة تُقرأ 0 وتتجاهل الكتابات، مع عدّاد للتشخيص.

كثير من لوحات C8 تحمل فعلًا 128 كيلوبايت من الذاكرة الوميضية، لأن الشريحة هي CB وقد استُبعد نصفها غير المُختبَر. 64 كيلوبايت هو ما يعد به رقم القطعة، لذا 64 كيلوبايت هو ما يمنحه هذا النموذج وهو ما يمكن للبرنامج الثابت الاعتماد عليه؛ وينص سكربت الربط على ذلك.

ملف ELF للبرنامج الثابت: يأخذ loadProgram ملفًا تنفيذيًا ARM بصيغة ELF32 بالمحاذاة الصغيرة (e_machine بقيمة 40). يجب أن يقع كل مقطع PT_LOAD داخل flash (عبر أي من العرضين) أو داخل SRAM. إعادة الضبط هي المعمارية، لا قفزة إلى نقطة الدخول: MSP يأتي من الكلمة عند أساس جدول المتجهات وPC من الكلمة الثانية، مع مسح البت المنخفض، لذا فصورة البرنامج الثابت هي جدول متجهات حقيقي لا نقطة دخول مجردة. VTOR يُعاد ضبطه إلى 0، وهو اسم flash البديل. التحميل أثناء التشغيل يعيد ضبط اللوحة.

النواة هي Profile::V7M مع Cpu::set_priority_bits(4)؛ وعائلة STM32F1 تنفّذ البتات الأربع العليا من كل حقل أولوية بحجم 8 بتات، مثل F4، لذا يتصرف NVIC_IPR بالطريقة التي تتوقعها NVIC_SetPriority في CMSIS. Cortex-M3 هو ARMv7-M دون امتداد DSP الخاص بـ M4 ودون FPU، وهذا بالضبط ما ينفّذه cortexm-core ويرفض ما عداه: كل ترميز VFP وsaturating-SIMD يرفع UNDEFINSTR. لم تكن هناك ميزة اضطررنا لإيقافها لهذه القطعة؛ فإضافات M4 لم تكن موجودة أصلًا. ترجِم البرنامج الثابت بالخيارين -mcpu=cortex-m3 -mfloat-abi=soft.

3. سجلات الأجهزة الطرفية (مجموعة فرعية، إزاحات حقيقية، مواضع بتات حقيقية)

السجلات 32 بت ومحاذاة كلمة. الوصول بالبايت ونصف الكلمة يعمل ويصل إلى الكلمة الحاوية، وهذا ما يفعله جسر APB للسجلات المنمذجة هنا.

3.1 RCC (0x4002_1000)

شجرة الساعة تُنمذج من السجلات، مع تنازل واحد للصور التي يأتي بها Mokxi: إلى أن يلمس البرنامج الثابت إعدادات الساعة تعمل القطعة بساعة الإقلاع، SYSCLK = HCLK = 72 MHz (بلورة HSE مضروبة في تسعة)، وAPB1 عند النصف والADC عند PCLK2 / 6، لأن بيئة Arduino لا تضبط الPLL مطلقًا. أول كتابة إلى RCC_CR، أو كتابة RCC_CFGR تغيّر SW أو PLLSRC أو PLLXTPRE أو PLLMUL، تسلّم الساعة للسجلات: منذ ذلك الحين تكون SYSCLK هي HSI (8 MHz) أو HSE (8 MHz) أو PLL (HSI / 2، أو HSE منصّفة بـPLLXTPRE، مضروبة في PLLMUL + 2، بحد أقصى 16) كما يقول SWS، وHCLK هي SYSCLK / HPRE، وPCLK1 وPCLK2 هما HCLK / PPRE1 وPPRE2، وساعات المؤقتات هي PCLK (مقسّم 1) أو 2 × PCLK، وساعة ADC هي PCLK2 / ADCPRE. النواة وSysTick والمؤقتات ومعدلات baud في USART والADC وتحويل الدورات إلى زمن كلها تتبع ذلك، بما في ذلك عند تغيّر الساعة أثناء التشغيل. تُقرَّب HCLK إلى ميغاهرتز كاملة لتحويل الزمن. إعادة الضبط تعيد ساعة الإقلاع. زمن انتظار الفلاش ما زال يُخزَّن ويُتجاهَل.

الإزاحة الاسم السلوك
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. Reset 0x0000_0083
0x04 RCC_CFGR مخزَّن؛ SWS[3:2] يتبع SW[1:0] فورًا عندما يكون المصدر الذي يسمّيه SW مفعّلًا في RCC_CR، ويبقى ثابتًا خلاف ذلك. HPRE وPPRE1 وPPRE2 وPLLMUL وPLLSRC وPLLXTPRE وADCPRE تضبط الساعات كما سبق
0x08 RCC_CIR مخزَّنة وتُقرأ مرة أخرى
0x0C RCC_APB2RSTR كتابة 1 في بت طرفي تعيد ضبط سجلات ذلك الطرفي؛ والسجل نفسه يُقرأ 0
0x10 RCC_APB1RSTR الشيء نفسه لأجهزة APB1 الطرفية
0x14 RCC_AHBENR مخزَّن ويُقرأ؛ قيمة إعادة الضبط 0x0000_0014 (SRAMEN، FLITFEN)
0x18 RCC_APB2ENR البِت 0 هو AFIOEN، والبِت 2 هو IOPAEN، والبِت 3 هو IOPBEN، والبِت 4 هو IOPCEN، والبِت 5 هو IOPDEN، والبِت 6 هو IOPEEN، والبِت 9 هو ADC1EN، والبِت 10 هو ADC2EN، والبِت 11 هو TIM1EN، والبِت 12 هو SPI1EN، والبِت 14 هو USART1EN
0x1C RCC_APB1ENR بت 0 TIM2EN، 1 TIM3EN، 2 TIM4EN، 11 WWDGEN، 14 SPI2EN، 17 USART2EN، 18 USART3EN، 21 I2C1EN، 22 I2C2EN، 23 USBEN، 25 CANEN، 27 BKPEN، 28 PWREN
0x20 RCC_BDCR مخزَّن؛ LSERDY (1) يتبع LSEON (0)
0x24 RCC_CSR stored; LSIRDY (1) follows LSION (0); PINRSTF (26) set after an NRST reset, PORRSTF (27) after power-on, SFTRSTF (28) after AIRCR.SYSRESETREQ; a write with RMVF (24) clears the flags. There is no BORRSTF: this family has no brown-out reset flag, and bit 25 is reserved

بوابة GPIO تأتي من APB2ENR، وليس من سجل AHB. هذا السطر الواحد هو الفرق بين كود Blue Pill يعمل وآخر تختفي فيه كل كتابة على الأطراف، وهو أول موضع يفشل فيه من اعتاد على F4.

بت تمكين الساعة بوابة حقيقية: الطرفي الذي بت التمكين الخاص به صافٍ يُقرأ 0 ويتجاهل الكتابات، وعدّاد ضائع يسجّل الوصول. هذا هو أشهر خطأ STM32 في البرمجة المباشرة، وإخفاؤه سيجعله غير مرئي هنا.

3.2 ‏GPIOA وGPIOB وGPIOC (0x4001_0800، 0x4001_0C00، 0x4001_1000)

الإزاحة الاسم البتات
0x00 CRL 4 بتات لكل طرف، الأطراف 0..7: MODE في 0..1، وCNF في 2..3
0x04 CRH الشيء نفسه للأطراف 8..15
0x08 IDR قراءة فقط، البتات 0..15: مستويات الأطراف
0x0C ODR البِتات 0..15: مزلاج المخرج، واتجاه السحب لمدخل مسحوب
0x10 BSRR كتابة فقط: البتات 0..15 تضبط بت ODR المقابل، والبتات 16..31 تمسحه؛ المسح يتغلب على الضبط في الكتابة نفسها. يُقرأ 0
0x14 BRR write-only: bits 0..15 clear the matching ODR bit. The F4 has no such register
0x18 LCKR مخزَّن، يُقرأ ثانية؛ تسلسل القفل غير مُلزَم

MODE: ‏00 مدخل، 01 مخرج عند 10 MHz، 10 مخرج عند 2 MHz، 11 مخرج عند 50 MHz. معدلات المخرجات الثلاثة تُخزَّن وليس لها تأثير على توقيت الحواف هنا، وهو ما يُصرَّح به بدل إخفائه.

CNF while MODE is 00: 00 analog, 01 floating, 10 pulled (واتجاه السحب هو بت ODR لذلك الطرف، 1 للأعلى و0 للأسفل)، و11 محجوز.

CNF بينما MODE ليس 00: ‏00 دفع-جذب للأغراض العامة، 01 مصرف مفتوح للأغراض العامة، 10 دفع-جذب للوظيفة البديلة، 11 مصرف مفتوح للوظيفة البديلة.

قيمة إعادة الضبط لكل من CRL وCRH هي 0x4444_4444: كل طرف مدخل عائم. وODR يعود إلى 0 عند إعادة الضبط.

IDR يقرأ ما تقود هذه الشريحة على طرف تدفعه دفع-جذب، وما عيّنته اللوحة من الشبكة على أي طرف آخر، تمامًا كما يفعل PINx على Uno. لذا فإن مخرجًا بمصرف مفتوح يقرأ الطرف لا المزلاج، وهذا أساس عمل ناقل one-wire أصلًا.

منفذ تنقيح SWJ يحتفظ بخمسة أطراف بعد إعادة الضبط، مهما قال CRL/CRH (‏RM0008 9.3.5): PA13 (JTMS/SWDIO) مسحوب للأعلى، وPA14 (JTCK/SWCLK) مسحوب للأسفل، وPA15 (JTDI) مسحوب للأعلى، وPB3 (JTDO) عائم، وPB4 (NJTRST) مسحوب للأعلى. وAFIO_MAPR.SWJ_CFG يقرر أيها يبقى: 000 الخمسة كلها، 001 كلها عدا PB4، 010 فقط PA13/PA14 (‏SWD، وهو الخيار المعتاد)، 100 لا شيء. الطرف الذي يمسكه منفذ التنقيح يتجاهل كتلة GPIO كليًا.

3.3 ‏TIM1 وTIM2 وTIM3 وTIM4 (0x4001_2C00، 0x4000_0000، 0x4000_0400، 0x4000_0800)

كل عدّاد على هذه القطعة 16 بت. الأربعة كلها تعمل عند 72 MHz (القسم 5). ‏TIM1 هو المؤقت المتقدم؛ والثلاثة الأخرى للأغراض العامة.

الإزاحة الاسم البتات
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. اكتب 0 في بِت لمسحه، و1 يتركه (rc_w0، كما يقول الدليل)
0x14 EGR write-only: UG 0 reloads the prescaler, counter and repetition counter and sets UIF, CC1G 1..CC4G 4 set the capture/compare flags, TG 6 sets TIF
0x18 CCMR1 وضع المخرج: CC1S في 0..1، وOC1FE في 2، وOC1PE في 3، وOC1M في 4..6، وOC1CE في 7، والبِتات الثمانية نفسها للقناة 2
0x1C CCMR2 الشيء نفسه للقناتين 3 و4
0x20 CCER CC1E 0، CC1P 1، CC2E 4، CC2P 5، CC3E 8، CC3P 9، CC4E 12، CC4P 13
0x24 CNT 16 بتًا
0x28 PSC 16 بتًا؛ العدّاد ينبض عند 72 MHz / (PSC + 1)
0x2C ARR قيمة إعادة التحميل؛ الدورة تساوي ARR + 1 نبضة في العد التصاعدي
0x30 RCR TIM1 فقط، 8 بتات: حدث التحديث يقع كل RCR + 1 تجاوزًا. محجوز في الثلاثة الأخرى، والكتابة فيه هناك تُحسب كتابة شاردة
0x34 0x38 0x3C 0x40 CCR1 CCR2 CCR3 CCR4 16 بتًا
0x44 BDTR TIM1 فقط: فقط MOE (15) يُؤخذ به، وبدونه لا تصل القنوات إلى أي طرف. زمن الموت ومدخل break والمخرجات المكمّلة تُخزَّن ولا تُنمذج
0x48 0x4C DCR DMAR مخزَّنة وتُقرأ مرة أخرى

العدّ: التصاعدي (DIR = 0)، والتنازلي (DIR = 1)، والمتوسّط المحاذي (CMS != 0) كلها مُطبَّقة، كلٌّ مع حدث التحديث في موضعه حسب الدليل. ARPE يخزّن ARR مؤقتًا، وOCxPE يخزّن CCRx مؤقتًا حتى حدث التحديث، وهذا ما يجعل تغيير نسبة الملء سلسًا بلا تشويش.

Output compare modes (OCxM): 0 frozen, 1 active on match, 2 inactive on match, 3 toggle, 4 force inactive, 5 force active, 6 PWM mode 1 (active while CNT < CCRx up-counting), 7 PWM mode 2 (the inverse). CCxP inverts the output polarity. The pin only moves while CCxE is set (and, on TIM1, BDTR.MOE as well) and the pad's CNF says alternate function (section 3.2), and AFIO_MAPR has that channel on that pin (section 3.5).

التقاط المدخل غير مُطبَّق: CCxS != 0 يُخزَّن ويُحتسب شاردًا.

NVIC lines: TIM1 splits its flags across TIM1_UP = 25 (the update flag) and TIM1_CC = 27 (the four compare flags and the trigger); TIM2 = 28, TIM3 = 29, TIM4 = 30 each carry all of theirs. Each asserts while any of its SR flags is set with the matching DIER enable, held as a level. The handler clears the flag, as on silicon.

3.4 ‏USART1 (0x4001_3800)، وUSART2 (0x4000_4400)، وUSART3 (0x4000_4800)

الإزاحة الاسم البتات
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
0x04 DR الكتابة: إرسال؛ القراءة: البايت المستلَم ومسح RXNE
0x08 BRR DIV_Fraction في 0..3، وDIV_Mantissa في 4..15؛ baud = f_PCLK / (16 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. البِت 15 محجوز: لا يوجد OVER8 على هذه القطعة، وأخذ العينات يكون دائمًا بمعدل ستة عشر
0x10 CR2 مخزَّنة وتُقرأ مرة أخرى؛ STOP 12..13 مخزَّنة ويُفترض نمط 8N1 لضبط الإيقاع
0x14 CR3 مخزَّنة وتُقرأ مرة أخرى
0x18 GTPR مخزَّنة وتُقرأ مرة أخرى

f_PCLK هي 72 MHz لأجل USART1 (APB2) و36 MHz لأجل USART2 وUSART3 (APB1)، القسم 5. عند 72 MHz و115200 باود تكون USARTDIV بالضبط 39.0625، إذن BRR = 0x271 والمعدل دقيق تمامًا؛ وهذا أحد أسباب اختيار الجميع للرقم 72 MHz مع هذه القطعة.

USART1 هو قناة المضيف. الإرسال يتم عبر المخزن المؤقت الأحادي الخاص بالقطعة إضافة إلى سجل الإزاحة: الكتابة في DR مع ضبط TXE تُصفّر TXE، يأخذ سجل الإزاحة البايت ويعود TXE مضبوطًا فورًا، ثم يصل البايت إلى المضيف بعد زمن إطار واحد (10 أزمنة بت بالمعدل المضبوط)، وعندها يُضبط TC. الاستقبال: تنتظر بايتات المضيف في FIFO بحجم سجل الاستقبال الحقيقي (بايت واحد) إضافة إلى مخزن احتياطي لدى المضيف سعته 256 بايت حتى لا يضيع النص المكتوب؛ يبقى RXNE مضبوطًا طالما هناك بايت ينتظر؛ قراءة DR تُخرجه من الطابور، ووصول بايت إلى طابور ممتلئ يضبط ORE.

USART2 وUSART3 هما منفذا USART متطابقان بايتاتهما المرسلة لا تذهب إلى أي مكان (تُحتسب، بحيث يمكن لاختبار أن يراها) ومستقبِلاهما لا يجدان شيئًا ليقرآه أبدًا. موجودان كي يُترجم ويُشغَّل البرنامج الثابت المكتوب لأكثر من منفذ واحد.

خطوط NVIC: USART1 = 37، USART2 = 38، USART3 = 39. كل خط يبقى مفعّلًا طالما ظل الشرط RXNE & RXNEIE أو TXE & TXEIE أو TC & TCIE أو IDLE & IDLEIE قائمًا. هذه شروط وليست أعلامًا حَدِّيّة، لذا الدخول إلى المعالج لا يمسح شيئًا. معالج TXE الذي لم يبق لديه ما يرسله يجب أن يعطّل نفسه، تمامًا كما في الشريحة.

3.5 ‏AFIO (0x4001_0000) وEXTI (0x4001_0400)

الإزاحة الاسم البتات
AFIO 0x00 EVCR مخزَّنة وتُقرأ مرة أخرى
AFIO 0x04 MAPR إعادة التخطيط أدناه، إضافة إلى SWJ_CFG في 24..26
AFIO 0x08..0x14 EXTICR1..EXTICR4 4 بتات لكل خط: 0 = المنفذ A، 1 = المنفذ B، 2 = المنفذ C. الخط n يراقب الطرف n للمنفذ المختار
AFIO 0x1C MAPR2 مخزَّنة وتُقرأ مرة أخرى
EXTI 0x00 IMR قناع المقاطعات، بت واحد لكل خط من 0..15 (الخطوط 16..18 تُخزَّن ولا تُطلق أبدًا)
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 للمسح

لا يوجد AFRL/AFRH في هذه القطعة: أطراف أي طرفية ثابتة، وAFIO_MAPR ينقل بعضها جملة واحدة. التخطيطات المُحاكاة:

حقل MAPR القيمة القناة 1 / TX 2 3 4
TIM1_REMAP 6..7 00، 01 PA8 PA9 PA10 PA11
11 المنفذ E، غير مُحاكى
TIM2_REMAP 8..9 00 PA0 PA1 PA2 PA3
01 PA15 PB3 PA2 PA3
10 PA0 PA1 PB10 PB11
11 PA15 PB3 PB10 PB11
TIM3_REMAP 10..11 00 PA6 PA7 PB0 PB1
10 PB4 PB5 PB0 PB1
11 PC6 PC7 PC8 PC9
TIM4_REMAP 12 0 PB6 PB7 PB8 PB9
1 المنفذ D، غير مُحاكى
USART1_REMAP 2 0 / 1 PA9 / PB6 TX
USART2_REMAP 3 0 PA2 TX (القيمة 1 تعني المنفذ D، غير مُحاكى)
USART3_REMAP 4..5 00 / 01 PB10 / PC10 TX

إعادة تخطيط إلى منفذ غير موجود في هذا النموذج (D أو E) تترك الأطراف كما هي بدلًا من اختراعها. يمكن لطرف واحد أن يكون الوظيفة البديلة لطرفيتين (PA9 هو USART1 TX والقناة 2 في TIM1)، وهذا على السيليكون خطأ في الإعداد؛ يحسمه النموذج في مكان واحد، USART قبل المؤقت، بحيث يكون لكل طرف مالك واحد فقط ولا تستطيع أي طرفية أن تزيل أخرى من طرف خفيةً.

SWJ_CFG ‏(24..26) هو ما يحرّر أطراف التنقيح؛ انظر القسم 3.2.

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 ‏ADC1 (0x4001_2400)

A twelve-bit successive-approximation converter, clocked at PCLK2 / 6 = 12 MHz (section 5), which is the only divider that keeps a 72 MHz APB2 inside the part's 14 MHz limit. One ADC clock is six CPU cycles.

الإزاحة الاسم البتات
0x00 SR AWD 0، EOC 1، JEOC 2، JSTRT 3، STRT 4؛ اكتب 0 للمسح
0x04 CR1 EOCIE 5، SCAN 8؛ والباقي يُخزَّن
0x08 CR2 ADON 0، CONT 1، CAL 2، RSTCAL 3، ALIGN 11، EXTSEL 17..19، EXTTRIG 20، SWSTART 22
0x0C 0x10 SMPR1 SMPR2 3 بتات لكل قناة: 1.5، 7.5، 13.5، 28.5، 41.5، 55.5، 71.5، 239.5 ساعة ADC. SMPR2 يحمل القنوات 0..9
0x14..0x20 JOFR1..JOFR4 مخزَّنة وتُقرأ مرة أخرى
0x24 0x28 HTR LTR يُخزَّن ويُقرأ مرة أخرى؛ مراقب التنبيه التناظري غير مُحاكى
0x2C SQR1 L 20..23، طول المجموعة ناقص واحد، والتحويلات 13..16
0x30 0x34 SQR2 SQR3 خمس بتات لكل تحويل؛ SQR3[4:0] هو الأول
0x38 JSQR يُخزَّن ويُقرأ مرة أخرى؛ المجموعة المحقونة غير مُحاكاة
0x3C..0x48 JDR1..JDR4 تُقرأ 0
0x4C DR آخر تحويل عادي اكتمل؛ قراءته تمسح EOC

يستغرق التحويل sample time + 12.5 ساعة ADC، والنتيجة لا تُسلَّم مبكرًا: البرنامج الثابت ينتظر EOC فعلًا. عند زمن المعاينة الافتراضي 1.5 دورة يكون ذلك 14 ساعة ADC (84 دورة معالج، 1.17 us)؛ وعند 55.5 التي يستخدمها زمن التشغيل، 68 ساعة (408 دورات، 5.7 us).

بدء التحويل: كتابة ADON بينما هي بالفعل 1 تبدأ تحويلًا، وهذا هو أسلوب القطعة نفسها، وكذلك يفعل SWSTART مع ضبط EXTTRIG وEXTSEL = 111. يعيد CONT البدء في نهاية كل تحويل. يُقبل CAL وRSTCAL ويُقرآن صفرين على الفور (لا يوجد ما يُعاير)، ولا يبدأ أي منهما تحويلًا، لأن المحوّل أثناء المعايرة لا يحوّل. يضع ALIGN البتّات الاثنتي عشرة في DR[15:4].

يمشي SCAN على المجموعة العادية ويترك النتيجة الأخيرة في DR، وهذا بالضبط ما تفعله قطعة بلا DMA، وهو السبب في أن SCAN بلا DMA فخ.

القنوات: 0..7 هي PA0..PA7 و8..9 هي PB0..PB1. القنوات 10..15 تقع على أطراف المنفذ C التي لا تملكها قطعة بـ48 طرفًا. القناة 16 هي حساس الحرارة، مثبّتة عند قراءتها عند 25 C وهي 1.43 V (1775 وحدة عد)، والقناة 17 هي VREFINT مثبّتة عند 1.20 V (1489 وحدة عد). تحوّل قطعة اللوحة جهد الشبكة على كل طرف تناظري إلى عدد مقابل خط التغذية 3.3 V؛ والشبكة المتنازع عليها تُقرأ 0، والعائمة تتيه كما تفعل على Uno.

خط NVIC: ADC1_2 = 18، ويُرفع طالما أن EOC & EOCIE قائم. ADC2 غير مُنمذج.

3.7 SysTick وNVIC

كلاهما داخل cortexm-core عند العناوين المعمارية في System Control Space ولا يصلان أبدًا إلى الناقل (proofs/cortexm/REPORT.md القسم 5). قيمة SYST_CALIB هي 90,000 مع تصفير SKEW وNOREF: المرجع الخارجي هو HCLK/8 = 9 MHz، فنبضة 10 ms تساوي 90,000 منها بالضبط والحقل دقيق، خلافًا إلى Black Pill حيث لا تستقيم القيمة. مع تصفير CLKSOURCE لا يزال النموذج يعدّ دورات المعالج؛ فالمقسوم /8 غير مُنمذج ونذكر ذلك هنا بدل إخفائه.

يضم stm32f103.h أيضًا تسميات CMSIS، للكود المكتوب بترويسات ST: أسماء SysTick_CTRL_*_Msk و_Pos، وSysTick_LOAD_RELOAD_Msk وSysTick_VAL_CURRENT_Msk، وSystemCoreClock (72,000,000، متغيّر كما في CMSIS) وSystemCoreClockUpdate() فارغًا. يعمل millis() في بيئة التشغيل على SysTick، فالكود الذي يعيد برمجته يغيّر millis() وdelay()، كما يحدث تحت HAL في STM32duino.

3.8 ما لم يُنمذج

شجرة الساعة وزمن الوصول للفلاش، وDMA، وUSB، وCAN، وI2C، وSPI، وRTC وسجلات النسخ الاحتياطي، والمراقبات، وADC2، والمجموعة المحقونة للـADC والمراقب التناظري، ومدخل كسر TIM1 ومخرجاته المتكاملة، والتقاط المدخل، وأنماط الطاقة المنخفضة في متحكم الطاقة، وبايتات الخيارات، وبرمجة الفلاش. سجلاتها غير مُسقَطة على خريطة العناوين (خطأ وصول) إلا حيث تُذكر كتلة أعلاه، حيث يقرأ الإزاحة غير المنفذة 0، ويتجاهل الكتابات، ويحتسب كتابة شاردة. يوقف WFI وWFE النواة؛ وSLEEPDEEP يُخزَّن ويسلك سلوك النوم العادي.

4. قناة المضيف

host = "utf-8 bytes on USART1". يعيد readHost بايتات إرسال USART1 كلما انتهى خروجها على السلك؛ ويدفع writeHost بايتات إلى طابور استقبال USART1 (الفيض يُسقط ويضبط ORE، كما على الشريحة). تعرض الشاشة التسلسلية البايتات كنص، بفك ترميز UTF-8 ومعاملة \n كنهاية سطر (وتجاهل \r).

5. نموذج الزمن والقطعة

72 MHz، دورة واحدة لكل 1/72 us. تأتي أعداد الدورات من النواة (Cpu::run يعيد الدورات؛ عدّاد دورات النواة هو الساعة). الدورة ليست عددًا صحيحًا من البيكوثانية، فالزمن يُشتق كـ ps = cycles * 1_000_000 / 72، بالضبط، ولا يُراكم أبدًا، بل يُحسب من جديد من عدد الدورات، فلا يمكن أن ينحرف. شريحة 10 us تساوي بالضبط 720 cycles، و720 دورة تساوي بالضبط 10,000,000 ps، فحدود الشرائح دقيقة.

الساعات عند الإقلاع (يشرح القسم 3.1 كيف تغيّرها البرامج الثابتة؛ كل رقم هنا يتبع HCLK بعدها):

النطاق التردد
SYSCLK, HCLK, CPU ‏72 MHz
ساعة الملحقات الطرفية في APB1 (USART2، USART3) 36 MHz
ساعة مؤقتات APB1‏ (TIM2..TIM4) ‏72 MHz
APB2 (USART1، TIM1، مدخل مقسّم ADC) ‏72 MHz
ADC 12 MHz

داخل الشريحة تتقدم النواة خطوة بخطوة بحيث تحمل كل كتابة إلى جهاز محيطي دورة CPU التي حدثت عندها: فيصبح تغيير طرف drive_after عند تلك الإزاحة من بداية الشريحة، فكتابتان إلى BSRR بينهما أربع دورات هما فعلًا على مسافة 55 ns على الشبكة. يُتقدَّم في المؤقتات تحليليًا. يُحسب الحدث التالي لكل مؤقت (مطابقة مقارنة، أو تحديث، أو فيض) من عدّه ومقسّمه وARR ووضعه، وتُشغَّل النواة حتى تلك الدورة، ويُطبَّق الحدث، ويستمر التشغيل، فتقع حافة PWM على الدورة بالضبط لا في نهاية الشريحة. ترى قراءات IDR مستويات الأطراف كما كانت عند بداية الشريحة مضافًا إليها أي تغيير أحدثه البرنامج نفسه داخل الشريحة.

WFI (وWFE مع تصفير سجل الأحداث) يوقف النواة: تتوقف القطعة عن التقطيع وتجدول إيقاظة واحدة عند الأقرب من بين إعادة تحميل SysTick، والحدث التالي لمؤقت يمكنه رفع مقاطعة مفعّلة، وحدث USART التالي، ونهاية تحويل ADC؛ أي تغيير على طرف أو بايت من المضيف يوقظها فورًا. هذه هي قصة الخمول كاملة. يقيس proofs/cortexm/REPORT.md سرعة النواة عند نحو الزمن الحقيقي في Chromium ويقول بوضوح أنه لا يوجد هامش، فالكود الذي يدور بانتظار delay() لن يحافظ على الزمن الحقيقي. لذلك يقف delay() في بيئة التشغيل على WFI ويوقظه SysTick، فتكلّف اللوحة الخاملة النواة حفنة أحداث في كل ثانية محاكاة بدل 72 مليون دورة.

المجس: البتة 0 = قيد التشغيل (1 أثناء التنفيذ، 0 أثناء إعادة التعيين أو التوقف)، البتة 1 = نائمة (موقوفة على WFI/WFE)، البتة 2 = LED اللوحة (PC13 بمستوى منخفض)، البتة 3 = نشاط إرسال خلال آخر 20 ms، البتة 4 = نشاط استقبال خلال آخر 20 ms. إذن probe هو قناع بتات صغير، يساوي 0 عند عدم وجود برنامج.

النقر: 0 = تحرير RESET، 1 = تثبيت RESET. لا يوجد زر ثانٍ على هذه اللوحة للنقر عليه.

معالجة الانهيار كما في القسم 5 من docs/esp32c3.md: تُبلغ النواة عن Trap، فتتوقف القطعة وتطبع سطرًا واحدًا على قناة المضيف، مثل firmware crashed at pc=0x08000412, BKPT #0 (CFSR 0x00000000, HFSR 0x40000000). القفل (lockup)، والتعليمة غير المعرفة، وBKPT، وجدول متجهات غير معيَّن، كلها تصل كأفخاخ. ثم تتوقف القطعة عن طلب إيقاظات.

6. بيئة تشغيل البرنامج الثابت (firmware/bluepill/)

بيئة تشغيل C و++C قائمة بذاتها للـSTM32F103 مبنية بـ clang 18‏ (--target=thumbv7m-none-eabi -mcpu=cortex-m3 -mfloat-abi=soft -Os) وlld، بلا newlib ولا CMSIS ولا HAL ولا أي شيء GPL:

  • crt0.S: the 16 system vectors plus the 60 IRQ vectors at the head of flash, reset entry (copy .data from its load address in flash, clear .bss, run the C++ static constructors, call main; the core has already loaded MSP from vector 0), and a default handler that executes BKPT so a stray interrupt becomes one line on the serial monitor rather than a silent spin.
  • link.ld: فلاش عند 0x0800_0000 بسعة 64 KB، وSRAM عند 0x2000_0000 بسعة 20 KB، والمكدس من أعلى SRAM، مع تأكيد أن البيانات الساكنة تترك له 2 KB.
  • stm32f103.h: كل سجل في القسم 3 كmacro متطاير بالاسم الحقيقي من ST‏ (GPIOC->ODR، RCC->APB2ENR، TIM3->CCR1، USART1->DR، ADC1->SQR3)، مع ثوابت البتات وأرقام IRQ.
  • arduino.h: نفس واجهة الكود البرمجي الموجودة في بيئتي Uno وBlack Pill، ولكن على أطراف هذه القطعة: pinMode، digitalWrite، digitalRead، analogRead، analogWrite، delay، delayMicroseconds، millis، micros، Serial، attachInterrupt، shiftOut، map، random. أرقام الأطراف هي أسماء المنافذ: PA0 وPB9 وPC13 هي ثوابت، وLED_BUILTIN هو PC13. هناك pinMode إضافي واحد هو INPUT_ANALOG، لأن محوّل F1 لا يمكنه أخذ عيّنة إلا من طرف يشير CNF الخاص به إلى ذلك.

millis() تأتي من SysTick بتردد 1 kHz (إعادة تحميل 71,999). micros() تأتي من TIM2 بتردد 1 MHz (PSC = 71، ARR = 0xFFFF) ممتدة إلى 32 بت في البرمجيات: كل عدّاد على هذه القطعة ذو ست عشرة بت، لذا يفيض TIM2 كل 65.536 ms ويحمل مقاطعة التحديث النصف الأعلى. تقرأ micros() الجزأين مع حماية من فيض يقع بينهما، وتضيف فيضًا لم يُنفَّذ معالجه بعد، وهذا هو معنى وضع noInterrupts() حول استدعاء micros(). خمس عشرة مقاطعة في الثانية لا تُذكر أمام ألف مقاطعة من SysTick. delay() تُبقي النواة في وضع WFI حتى يبلغ عدّاد SysTick الموعد النهائي؛ أما delayMicroseconds() فتنتظر بنشاط عبر micros().

يعيد analogRead(pin) بتات المحوّل الـاثني عشر نفسها، 0 عند 0 V و4095 عند 3.3 V، وليس البتات العشرة التي تعيدها Arduino: محوّل ADC في هذه القطعة ذو اثني عشر بتًا فعلًا، وتقريبها لأسفل لتشبه AVR يعني التخلّي عن بتَين دون أي فائدة. الاستدعاء الأول يُشغّل ADC1، ويضبط ADCPRE على /6، ويشغّل تسلسل المعايرة وإعادة الضبط. الأطراف العشرة هي PA0..PA7 وPB0 وPB1؛ وأي طرف آخر يعيد 0.

analogWrite(pin, 0..255) تُخرج PWM بتردد 1 kHz كما تفعل STM32duino (PWM_FREQUENCY بقيمة 1000: PSC = 1، أي نبضة كل 36 MHz، و ARR = 35,999، أي 72 MHz / 2 / 36,000)، مع CCRx = 36,000 x value / 255، وهو تحجيم setCaptureCompare في النواة، على عشرة أطراف:

مؤقت القناة 1 القناة 2 القناة 3 القناة 4
TIM3 PA6 PA7 PB0 PB1
TIM4 PB6 PB7 PB8 PB9
TIM1 PA8 لا شيء لا شيء PA11

PA0..PA3 are not PWM pins here, unlike on the Black Pill: TIM2 is the microsecond counter and it needs a whole timer to itself. TIM1's channels 2 and 3 are PA9 and PA10, which are Serial, so they are left out too. TIM1 needs BDTR.MOE, which the runtime sets when it starts that timer.

0 و255 ليسا PWM: يفصلان مخرج المقارنة ويجعلان الطرف منخفضًا أو مرتفعًا، لذا فإن analogWrite(pin, 0) إطفاء فعلي. أما digitalWrite على طرف PWM فيستعيد الطرف، كما تفعل نواة Arduino.

Serial هو USART1 على PA9/PA10، بوضع 8N1، والاستقبال بمقاطعات إلى حلقة من 64 بايت، والإرسال عبر حلقة من 64 بايت تُفرَّغ بمقاطعة TXE، كما تفعل HardwareSerial في STM32duino (SERIAL_TX_BUFFER_SIZE بقيمة 64): أمر طباعة يتّسع في الحلقة يعود فورًا وتخرج البايتات بمعدل البود، والأطول ينتظر فراغًا، و availableForWrite() هو الفراغ المتبقّي (63 عند الحلقة الفارغة). attachInterrupt(pin, fn, mode) يستخدم AFIO و EXTI: معالج واحد لكل خط، وأنماط CHANGE و RISING و FALLING.

أمثلة تحت firmware/bluepill/examples/<name>/sketch.ino، تُبنى إلى web/public/firmware/bluepill/<name>.elf مع web/public/firmware/bluepill/index.json بالشكل نفسه كما في فهرس Uno، وكل مُدخل يحمل "program": "elf32 arm stm32f103":

  • blink: وميض على PC13 بتردد 1 Hz، فعّال بالمستوى المنخفض، مع delay(500) متوقّفًا على WFI.
  • button: زر ضغط على PB0 مع INPUT_PULLUP يضيء PC13.
  • serial: يطبع millis() و analogRead(PA0) مرة كل ثانية، ويعيد إرسال ما يستقبله.
  • fade: analogWrite على PA6 لتنفيس LED عبر TIM3، مع تتبّع PC13 له.

تختار الواجهة قائمة البرامج الثابتة وفق سلسلة program في فهرس القطعة (docs/sim-api.md القسم 3): "elf32 arm stm32f411" يقرأ /firmware/stm32/index.json و "elf32 arm stm32f103" يقرأ /firmware/bluepill/index.json.

7. ما تثق به هذه المواصفة، وما لا تثق به

ثلاث مجموعات، بالتصنيف نفسه الذي يستخدمه القسم 7 من docs/esp32c6.md. وهي موجودة لأن نموذج لوحة يخمّن عنوانًا بصمت هو أسوأ من نموذج يقول إنه لم يعرف.

مأخوذة من الدليل المرجعي، ومُجرَّبة ببرنامج ثابت حقيقي. كل عنوان أساس وإزاحة سجل وموضع بت في القسمين 2 و3 مأخوذ من الدليل المرجعي للSTM32F1 (RM0008) وورقة بيانات STM32F103C8: RCC عند 0x4002_1000، وGPIOA/B/C عند 0x4001_0800/0C00/1000 مع أنصاف بايتات الضبط الرباعية الخاصة بـF1‏ CRL/CRH، وTIM1 إلى TIM4، وUSART1 إلى USART3، وAFIO عند 0x4001_0000، وEXTI عند 0x4001_0400، وADC1 عند 0x4001_2400، مع 20 KB من SRAM و64 KB من ذاكرة flash. يحمّل crates/stm32f103/tests/firmware.rs ملفات ELF حقيقية ويشغّل GPIO والمؤقّتات وUSART1 وADC1 وSysTick وEXTI من خلالها. أما ترتيب رؤوس الأطراف الأربعين للوحة Blue Pill، وLED الخاص بها على PC13 الموصول مصعده إلى خط التغذية، وحقيقة أن PA15 وPB3 وPB4 تظهر كأطراف JTAG، فهي أمور خاصة باللوحة نفسها.

مُحاكاة السلوك دون التقيد بأرقام الدليل المرجعي. السلوكيات لا العناوين:

  • ساعة الإقلاع هي 72 MHz. لوحة Blue Pill حقيقية لا تضبط PLL تعمل عند 8 MHz من HSI، أما هنا فبرنامج لا يلمس سجلات الساعة يعمل عند 72 MHz، وهو ما تفترضه بيئة Mokxi التشغيلية لـ Arduino. وبمجرد أن يكتب البرنامج سجلات الساعة تُتابَع PLL والمذبذبات والمقسّمات (القسم 3.1)، أما زمن انتظار الذاكرة الومّيضة فلا.
  • للشريحة غَلّتان، وأول تخزين بعد فترة هدوء يأتي مبكراً، بمقدار يصل إلى 7.1 us. كل ما يقع داخل الدفعة دقيق. والمنطق هو نفسه المذكور في docs/stm32f411.md القسم 7.
  • لا خطأ في ADC1. التحويل خط مستقيم مقابل VREF+ = 3.3 V، مُعاين في اللحظة التي بدأ فيها، دون دائرة عيّن وإمساك، ودون مقاومة دخل، ودون لا-خطية، ودون ضجيج، ودون الانزياح الذي يحتاج محوّل F103 حقيقي معايرةً له (بت CAL في ADC_CR2 يُقبل ولا يفعل شيئًا هنا).
  • الوسائد ثلاث حالات وعتبة واحدة. دفع-جذب عند 3.3 V، أو مصب مفتوح، أو مقاومة عالية، أو شدّ داخلي بقيمة 40 kΩ (تعطي ورقة البيانات مدى 30 kΩ إلى 50 kΩ)، ويُقرأ الطرف مقابل نصف التغذية، دون تخلّف، ودون إعداد للسرعة، ودون زمن صعود، ودون حدّ للتيار.
  • اللوحة مصدر تغذية مثالي: 3V3 و 5V بممانعة الخط دائماً، فلا شيء يهبط جهده، ولا وجود للمنظّم (الذي في نسخ Blue Pill المستنسخة يكون غالباً قطعة خاطئة وسبب موت اللوحة). الإقلاع يستغرق ميكروثانية، دون أطراف إقلاع ودون بايتات الخيارات.
  • لا يوجد زر للمستخدم، لأن اللوحة لا تملك واحداً؛ الزر الوحيد يُبقي NRST منخفضاً ويصل عبر poke.

مُستبعَد عمداً، كما يعدّد القسم 3.8: شجرة الساعة وزمن انتظار الذاكرة الومّيضة، و DMA، و USB (لذا يصل Serial إلى الشاشة عبر قناة المضيف ويبقى PA11/PA12 أطراف GPIO عادية)، و CAN، و I2C، و SPI، و RTC وسجلات النسخ الاحتياطي، ومراقبات التنفيذ، ودخل الإيقاف والمخرجات المتمّمة لـ TIM1، و ADC2، ومجموعة التحويل المحقون ومراقب الإشارة التناظرية في ADC، وبرمجة الذاكرة الومّيضة.

8. الرفع إلى لوحة حقيقية

«الرفع إلى اللوحة» يكتب الكود إلى لوحة Blue Pill حقيقية عبر محمّل الإقلاع في ذاكرة النظام الخاصة بـ F103 على USART1، كما يصفه مستند AN3155 من ST (web/src/hardware/stm32-serial.ts، والبطاقة في stm32-upload-dialog.ts).

  • البناء. بناء العتاد هو بيئة تشغيل المحاكي زائد firmware/bluepill/hardware/clocks.c مع -DMOKXI_HARDWARE (hardwareBundle في web/src/compile/bundles.ts). تخرج الشريحة الحقيقية من إعادة الضبط على HSI بتردد 8 MHz؛ ويبدأ mokxi_hw_init() المذبذب البلوري 8 MHz، ويضبط حالتي انتظار للفلاش وذاكرة الجلب المسبق، وAPB1 /2، وAPB2 /1، وADC /6، ويشغّل SYSCLK من PLL عند 72 MHz. وهذا بالضبط ما تفترضه قيم F_CPU و F_APB1 و F_APB2 و F_TIM في stm32f103.h. بدون بلورة يبقى على HSI. عنوان الربط هو نفسه (0x08000000)، لذا فنص الربط مشترك. ملفات ELF الخاصة بالمحاكي مثبتة في hardware-build.test.ts.
  • التوصيلات. محوّل تسلسلي USB بجهد 3.3 V: الطرف TX إلى A10، والطرف RX إلى A9، وGND إلى G. ارفع BOOT0 إلى 1، ثم اضغط RESET، فيبدأ محمّل ROM. بعد الرفع، أعِد BOOT0 إلى 0.
  • البروتوكول. 115200 baud، و8E1. مزامنة 0x7F، ثم Get، ثم Get ID‏ (0x410 على F103C8)، ثم Erase‏ (0x43) أو Extended Erase‏ (0x44) حسب إصدار المحمّل، ثم Write Memory في كتل من 256 بايت، ثم Read Memory للتحقق من كل كتلة، ثم Go إلى 0x08000000. رد NACK عند المسح يعني أن حماية القراءة مفعّلة، وتشرح البطاقة كيفية إلغائها.
  • لم يُجرَّب بعد على لوحة حقيقية. أداة الرفع مُختبَرة ضد محمّل وهمي (testing/fake-stm32.ts) فقط.