تعلّم

إوماض LED على ESP32-C3

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
ESP32-C3: وميضمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
برنامج الإوماض المدمج في اللوحة، مع LED ومقاومة 220 أوم على GPIO 8.

اللوحة التي يحاكيها هذا المثال هي لوحة ESP32-C3-DevKitM-1 حقيقية، وليست بديلًا عامًّا: شريحة RISC-V أحادية النواة بتردد 160 MHz، بترقيم GPIO خاص بها لا يطابق أسماء الأطراف المطبوعة على لوحة Arduino إطلاقًا. لا يوجد هنا طرف مطبوع عليه "13"؛ فـ LED المدمج يقع على GPIO 8، لذلك LED_BUILTIN على هذه اللوحة يعني 8، وهو نفس الطرف الذي توصّل الدائرة أعلاه به LED خارجيًّا ومقاومة.

اضغط «تشغيل» فترى LED الخاص باللوحة وLED على لوحة التجارب يومضان معًا، مرة كل ثانية، بفضل برنامج ثابت يُترجم فعلًا لهذه الشريحة ويعمل فعلًا على نواة RISC-V المحاكاة، وليس مجرد حركة جاهزة.

نزّل خطة الدرس (PDF)

أي لوحة يحاكي هذا المثال

قل اللوحة بدقة، لأن هناك أكثر من لوحة ESP32-C3 وهي غير قابلة للتبديل: هذه هي DevKitM-1، لوحة التطوير الرسمية من Espressif، وليست لوحات "SuperMini" الأصغر من طرف ثالث التي تتشارك الشريحة نفسها لكن بترتيب أطراف وتخطيط مختلفين. إذا كانت لديك لوحة SuperMini، يبقى GPIO 8 هو الطرف الصحيح الذي تبحث عنه في الكود، لكن لا تتوقع أن تتطابق مواضع الأطراف الفعلية في هذا الرسم مع الأسماء المطبوعة على لوحة مختلفة.

الشريحة تحت كلتا اللوحتين هي ESP32-C3 نفسها: نواة RISC-V واحدة، وGPIO، وUART، وSYSTIMER على خريطة ذاكرة حقيقية وموثقة. البرنامج الثابت للملحقات التي يحاكيها هذا المحاكي يمكن نقله إلى لوحة DevKitM-1 فعلية، حيث يبقى بحاجة إلى اختبار. ما يختلف بين اللوحات التي تتشارك الشريحة نفسها هو أي الأطراف مُخرَج إلى الرأس وبأي ترتيب.

توصيل LED عند 3.3 فولت، لا 5

هذا هو الرقم الوحيد الذي يتغير فعلًا بين Arduino Uno وESP32-C3: أطراف GPIO في C3 تعمل عند 3.3 فولت، لا 5. أجرِ نفس حساب المقاومة مع هذا الجهد بدلًا من ذاك، (3.3 V ناقص نحو 2 V) مقسومًا على 220 أوم، فيخرج التيار أقرب إلى 6 mA، مقابل نحو 13.6 mA على Uno عند قيمة المقاومة نفسها. سيعمل LED نفسه هنا بإضاءة أخفت بشكل ملحوظ، ومن الجيد تخفيض المقاومة قليلًا إلى نحو 150 أوم مثلًا للعودة إلى سطوع مشابه، بدلًا من افتراض أن قيم Uno تنتقل كما هي.

ما الذي يختلف تحت النداءات الثلاثة نفسها

digitalWrite() وpinMode() وdelay() تُقرأ بالطريقة نفسها على كل لوحة يحاكيها Mokxi، وهذا مقصود: نواة Arduino تخفي الشريحة تحتها. ما يتغير هنا هو كل ما دون ذلك الخط. فـ C3 نواة RISC-V واحدة بعرض 32 بت تعمل عند 160 MHz مقابل نواة AVR بعرض 8 بت على Uno تعمل عند 16 MHz، وdelay() هنا يُحسب وقته من SYSTIMER، وهو ملحق لا يوجد في ATmega328P، بدلًا من مؤقت عام استُخدم لهذا الغرض. لا شيء من ذلك يغيّر ما يفعله الكود أعلاه؛ بل يغيّر مقدار الهامش المتبقي لكل ما يميل مشروع قائم على C3 إلى فعله في الوقت نفسه، مثل قراءة حساس عبر I2C أو تشغيل شاشة صغيرة، وهذا جزء كبير من سبب كون هذه الشريحة خيارًا شائعًا حين يكبر المشروع عن مجرد LED يومض.

الكود

الكود له الشكل نفسه ككود Uno، لأن digitalWrite() وpinMode() وdelay() هي النداءات نفسها بأسلوب Arduino على كل لوحة يحاكيها Mokxi؛ فقط رقم الطرف والتعليق الذي يصفه يتغيران.

firmware/examples/blink، نسخة بناء ESP32-C3 (البرنامج الفعلي الذي يعمل أعلاه)
void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(500);
  digitalWrite(LED_BUILTIN, LOW);
  delay(500);
}

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

أخطاء شائعة

الخطآن الخاصان بهذه اللوحة، فضلًا عن خطأ عكس LED وخطأ المقاومة المفقودة اللذين ينطبقان في كل مكان: قراءة الرقم المطبوع على اللوحة وكأنه رقم GPIO، وهو غالبًا ليس كذلك على لوحة تطوير أطرافها مُخرَجة إلى رأس مطبوع بأسماء الشريحة نفسها؛ وافتراض أن أي GPIO متاح لأي استخدام. عدد قليل من أطراف C3 هو أطراف strapping، تُقرأ مرة واحدة عند الإقلاع لاختيار أمور مثل وضع الإقلاع، وقد يمنع دفعها إلى مستوى منخفض بقطعة خارجية لحظة التشغيل اللوحة من البدء كما تتوقع. GPIO 8 لا يلعب هذا الدور، وهذا سبب إضافي لكونه الطرف الذي يستخدمه LED المدمج وهذا المثال معًا.

خطأ ثالث يستحق التسمية لأنه سهل الوقوع فيه مرة واحدة ولا يتكرر: افتراض أن analogWrite() يتصرف هنا تمامًا كما يتصرف على Uno. هو يؤدي الوظيفة نفسها على كلتيهما، لكن ليس بالطريقة نفسها: نداء Uno يصل إلى أحد ستة أطراف موصولة بمخرج مقارنة مؤقت، أما نداء C3 فيصل إلى أي طرف على الإطلاق، لأن قنوات LEDC تُوجَّه عبر مصفوفة GPIO بدلًا من لحامها بجهة ثابتة. صفحة تلاشي PWM تغطي ما يتغير فعلًا بين اللوحتين، ومن الجيد قراءتها قبل افتراض أن كود تلاشٍ سينتقل دون تعديل.

ورابع، سهل إغفاله لأن الخطأ فيه لا يكلف شيئًا هنا: نسيان أن GPIO 8 يعمل أيضًا كالطرف الموصول به LED المدمج على اللوحة. توصيل LED خارجي إلى الطرف نفسه أمر جائز، وهو بالضبط ما تفعله الدائرة أعلاه، لكنه يعني أن LED اللوحة وLED لوحة التجارب سيعرضان الحالة نفسها دائمًا؛ وتوصيل LED ثانٍ مستقل يتطلب GPIO ثانيًا غير مستخدم.

تغذية اللوحة وLED معًا

تتغذى DevKitM-1 في هذا المحاكي عبر منفذ USB الخاص بها، تمامًا كاللوحة الحقيقية، فلا يحتاج شيء في دائرة LED إلى تغذية الشريحة نفسها. ما يستهلكه LED والمقاومة يأتي من طرف GPIO، عند 3.3 V، لا من مسار تغذية منفصل، وحساب التيار أعلاه يأخذ ذلك في الحسبان بالفعل. على اللوحة الحقيقية يهم هذا أكثر قليلًا مما يهم هنا: لطرف GPIO حد أقصى حقيقي لتيار المصدر، ومقاومة صغيرة جدًا هي الفرق بين LED محدود التيار بأمان وطرف يُطلب منه أكثر مما يحتمل.

افتح هذه الدائرة في المحرر. ESP32-C3: وميض، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

الأسئلة

هل هذا هو البرنامج نفسه كمثال وميض Arduino Uno؟

الشكل نفسه والنداءات الثلاثة نفسها، لكن بناء منفصل: ملف ELF هنا يستهدف نواة RISC-V على خريطة ذاكرة ESP32-C3 الحقيقية، لا ATmega328P التي تستهدفها أمثلة Uno، وGPIO 8 يحل محل الطرف 13.

هل تعمل WiFi في هذا المحاكي؟

تعمل WiFi عبر شبكة محاكاة مع نداءات Arduino الخاصة بـ WiFi. لا يوجد راديو ولا 802.11، وبعد تسجيل الدخول يمكنك تشغيل الإنترنت الحقيقي. البلوتوث محاكى بالطريقة نفسها، مع هاتف في لوحة البلوتوث في المحرر.

على أي أطراف يمكنني إضاءة LED بأمان؟

معظم أطراف GPIO المُخرَجة تعمل جيدًا لمؤثر digitalWrite بسيط لـ LED؛ صفحة اللوحة تسرد أيها أطراف strapping يستحق تجنّبها لأي شيء يُشغَّل لحظة التشغيل.

هل محاكي ESP32-C3 مجاني الاستخدام؟

نعم، دون حاجة إلى حساب لفتحه وتجربته، تمامًا ككل لوحة يحاكيها Mokxi.

هل يمكن للبرنامج الثابت المبني هنا العمل على لوحة ESP32-C3-DevKitM-1 حقيقية؟

بالنسبة للملحقات التي يحاكيها هذا المحاكي، ملف ELF مبني هنا يستهدف إزاحات السجلات الحقيقية لـ GPIO وUART والكود المعتمد على المؤقتات كهذا المثال. اختبره على اللوحة الفعلية قبل الاعتماد عليه.

هل أحتاج إلى معرفة لغة التجميع RISC-V لاستخدام هذه اللوحة؟

لا. كل مثال هنا مكتوب بلغة C++ بأسلوب Arduino نفسه كأمثلة Uno؛ نواة RISC-V تحتها هي ما ينفّذ البرنامج المترجم فعلًا، لكن لا شيء في كتابة كود لهذه اللوحة يتطلب معرفة ذلك.

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

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