هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة 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.datafrom its load address in flash, clear.bss, run the C++ static constructors, callmain; the core has already loadedMSPfrom vector 0), and a default handler that executesBKPTso 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) فقط.