اللوحات

WCH CH32V003

شريحة RISC-V بتردد 48 MHz مع 16 KB من الذاكرة الوميضية و2 KB من RAM، على لوحة توسعة بعشرين طرفًا. يشغّل Mokxi عليها Blink والشاشة التسلسلية وADC.

نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة.

ما هي

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.

  • صفحة اللوحة: /boards/ch32v003
  • جارة بمعمارية RISC-V وبمساحة أكبر بكثير: اللوحة ESP32-C3
  • الخطة والعقد لنموذج الشريحة: docs/plans/ch32v003.md