نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة.
ما هي
CH32V003 هو أرخص متحكم دقيق من WCH: نواة QingKe V2A تنفّذ RV32EC (أساس RISC-V بستة عشر مسجلًا وتعليمات مضغوطة وبلا ضرب أو قسمة)، تعمل بتردد يصل إلى 48 MHz عبر مذبذب داخلي 24 MHz ومضاعف PLL. القطعة هنا هي CH32V003F4P6، بحزمة TSSOP-20، على لوحة توسعة تُخرج أطرافها إلى صفين من الثقوب بتباعد 0.1 inch ويبعدان 0.6 inch عن بعضهما، فتجلس مركّبة على قناة لوحة التجارب. لا يوجد بها LED للمستخدم ولا أزرار. VDD مصدر 3.3 V و GND أرضي، دائمًا.
الأطراف وأرقامها
The twenty pins are named as the openwch Arduino core names them: PA1,
PA2, PC0 to PC7 and PD0 to PD7, plus VDD and GND. A sketch writes
pinMode(PD2, OUTPUT). A bare number is the port times 8 plus the bit, with A
at 0, C at 8 and D at 16, so PD2 is 18.
| Pin | الاسم | أيضًا |
|---|---|---|
| 1 | PD4 |
A7 |
| 2 | PD5 |
A5، USART1 TX |
| 3 | PD6 |
A6، USART1 RX |
| 4 | PD7 |
طرف GPIO عادي هنا (انظر أدناه) |
| 5 | PA1 |
A1 |
| 6 | PA2 |
A0 |
| 7 | GND |
أرضي |
| 8 | VDD |
مصدر 3.3 V |
| 9 | PC0 |
|
| 10 | PC1 |
I2C SDA على الشريحة الحقيقية |
| 11 | PC2 |
I2C SCL على الشريحة الحقيقية |
| 12 | PC3 |
|
| 13 | PC4 |
A2 |
| 14 | PC5 |
SPI SCK على الشريحة الحقيقية |
| 15 | PC6 |
SPI MOSI على الشريحة الحقيقية |
| 16 | PC7 |
SPI MISO على الشريحة الحقيقية |
| 17 | PD0 |
|
| 18 | PD1 |
SWIO، طرف البرمجة |
| 19 | PD2 |
A3 |
| 20 | PD3 |
A4 |
على لوحة التوصيل، الصف الأيسر هو الأطراف من 1 إلى 10 من الأعلى، والصف الأيمن هو الأطراف من 20 نزولاً إلى 11، كما تُرقَّم الحزمة عادةً.
A0 إلى A7 هي قنوات ADC1 من 0 إلى 7. تعيد analogRead() عشر بتات، من 0 إلى 1023، مقارنةً بـ VDD.
الساعة، والمنافذ التي تكون مطفأة
البرنامج هو الذي يضبط الساعة. بعد إعادة الضبط تعمل الشريحة على مذبذب 24 MHz مقسوماً على ثلاثة، أي 8 MHz؛ وبيئة تشغيل Mokxi تشغّل الـ PLL وتعمل عند 48 MHz قبل setup()، كما تفعل نواة Arduino، وتستغرق كل تعليمة 1/48 من الميكروثانية. البرنامج الذي يترك الساعة كما هي يعمل أبطأ ست مرات، كما يحدث على المنضدة.
A port ignores writes until its clock is enabled in RCC_APB2PCENR, and reads
as 0 until then. That is the chip's rule, and the first thing that bites a
program that writes the registers directly. pinMode() enables the clock for
you.
التسلسلي
Serial هو USART1، حيث TX على PD5 وRX على PD6، موصول بالشاشة التسلسلية. يعمل بالاستطلاع. لا يوجد مخزن مؤقت للاستلام ولا مقاطعة بعد، ويحتفظ الـ USART ببايت واحد فقط، لذا فإن أي بايت ثانٍ يصل قبل قراءة الأول يضيع، كما يحدث على الشريحة الحقيقية مع تعطيل المقاطعة. مثال Serial يتحقق من Serial.available() طوال الوقت ولا ينتظر أبداً داخل delay().
What is modeled
النواة كـ RV32EC بتعليمة واحدة لكل نبضة ساعة، وشجرة الساعة (HSI وPLL ومقسّم AHB)، ومنافذ GPIO للأطراف A وC وD بأساليب push-pull وopen drain والمقاومة السحب للأعلى والسحب للأسفل والتماثلي، مع تحكم الساعة أعلاه، وUSART1 على الأطراف الافتراضية، وADC1 كتحويل تناظري إلى رقمي بعشرة بتات يُطلَق برمجيًا، وSysTick خلف millis() وmicros() وdelay(). عناوين السجلات وإزاحاتها هي عناصر الدليل المرجعي؛ أما القائمة في docs/plans/ch32v003.md فتذكر القليلة التي تخمَّن بدل أن تُتحقق.
ما لم يُنمذج
- المقاطعات. الـ PFIC غير مُحاكى، لذا لا تنطلق مقاطعات SysTick و EXTI و USART ولا توجد
attachInterrupt(). البرنامج يعمل بالاستطلاع. - PWM، لذا لا توجد
analogWrite()ولاtone()، وكذلك I2C و SPI، فلا توجدWireولاSPI. هذه ستأتي في الإصدار التالي. - إعادة تعيين أطراف USART و AFIO، وبايتات الخيارات، وبرمجة الفلاش، والمشاهد المستقل، والاستيقاظ التلقائي.
- تعليمات XW المضغوطة من WCH، والفخ الذي تقع فيه النواة الحقيقية مع السجلات x16 فما فوق. البرنامج المبني بمترجم WCH نفسه والذي يستخدم XW يقع في الفخ هنا.
PD7كطرف إعادة الضبط. على الشريحة من المصنع يمكن أن يكون PD7 هو NRST حسب بايتات خياراته؛ هنا هو طرف GPIO عادي.StringوStreamوالمكتبات: 16 KB من الفلاش و 2 KB من الذاكرة لا تتسع لها، لذا لا ينطبق فهرس مكتبات Arduino على هذه اللوحة.
Common mistakes
الكتابة في سجل منفذ قبل تفعيل ساعته. لا يحدث شيء، على الشريحة الحقيقية وهنا أيضاً.
توقّع أن تنام delay(). إنها انتظار مشغول على SysTick، لذا تحاكي المحاكاة كل تعليمة منها.
توصيل LED باللوحة وتوقّع LED_BUILTIN. لوحة التوصيل لا تحتوي على واحدة؛ وصّل LED ومقاومة من طرف إلى GND.
مشاريع البداية
Blink يُومض LED على PD2 عبر مقاومة 330 أوم. Button يشغّله أثناء الضغط على زرّ على PC4. التسلسلي يطبع عدّادًا كل ثانية ويعيد ما تكتبه. مقبض يقرأ مقياس جهد على PC4 عبر الـ ADC.
Related
- صفحة اللوحة: /boards/ch32v003
- جارة بمعمارية RISC-V وبمساحة أكبر بكثير: اللوحة ESP32-C3
- الخطة والعقد لنموذج الشريحة:
docs/plans/ch32v003.md