اللوحات

لوحة ESP32-C3

نواة RISC-V بتردد 160 MHz على خريطة الذاكرة الحقيقية، بلا راديو ومع شبكة محاكاة بدلًا منه.

نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج ESP32-C3 (كل السجلات).

ما هي

لوحة ESP32-C3-DevKitM-1: شريحة RISC-V بسعة 32 بت تعمل على نواة RV32IMC الخاصة بنا، التي تجتاز مجموعة اختبارات riscv-tests داخل المتصفح. يستخدم النموذج خريطة الذاكرة الحقيقية لـ ESP32-C3 والإزاحات الحقيقية للسجلات في كل ما ينفّذه، لذا فالبرامج الثابتة المبنية هنا تعمل على لوحة DevKitM-1 حقيقية.

يعمل المعالج في شرائح زمنية مدتها 10 ميكروثانية عند تردد 160 MHz، بتعليمة واحدة في كل دورة، وأي تغيّر في طرف داخل شريحة زمنية يوضع عند التعليمة التي سبّبته بالضبط.

الأطراف

رأسان من 15 طرفًا لكل منهما، بالترتيب نفسه الموجود على اللوحة الحقيقية.

الرأس الأيسر، من الأعلى إلى الأسفل: GND، 3V3، 3V3b، 2، 3، RST، GNDb، 0، 1، 10، 4، 5، 6، 7، 8.

الرأس الأيمن: 5V، 5Vb، GNDc، GNDd، 9، 18، 19، 20، 21، ثم ستة أطراف موسومة NC، مرسومة فقط ليكتمل الرأس ولا تُقرأ أبدًا.

الأطراف GPIO من 0 إلى 10، إضافة إلى 18 و19 و20 و21 قابلة للاستخدام. هذه لوحة بجهد 3.3 فولت: المخرج يعطي 3.3 V أو 0 V، وعتبة المدخل 1.65 V، ومقاومة الرفع الداخلية ومقاومة الخفض الداخلية كلتاهما نحو 45 k.

للطرف RST مقاومة رفع بقيمة 10 k؛ سحبه تحت 1.65 V يُبقي الشريحة في حالة إعادة تعيين.

يحمل الطرف GPIO 8 الـ LED المدمج في اللوحة، ولهذا فإن LED_BUILTIN يساوي 8. هنا يُرسم كـ LED عادي. أما على لوحة ESP32-C3-DevKitM-1 حقيقية فهو LED RGB قابل للعنونة (قطعة من نوع WS2812 بمتحكم خاص بها)، يتجاهل الطرف الذي يُضبط عاليًا أو منخفضًا فقط: مثال Blink المرفوع من Mokxi لا يضيء شيئًا على اللوحة الحقيقية. تتغلب نواة Espressif لـ Arduino على ذلك بإعطاء LED_BUILTIN رقمًا خاصًا به وتحويل digitalWrite() عليه إلى لون يُرسل إلى الـ LED، فيضيء مثال Blink من Arduino IDE فعلًا، بلون أبيض خافت. لرؤية وميض من بناء Mokxi على اللوحة الحقيقية، وصّل LED ومقاومة بطرف آخر.

الأطراف التناظرية

الأطراف GPIO من 0 إلى GPIO 4 هي قنوات ADC1 من 0 إلى 4، واستدعاء analogRead() على أحدها تحويل حقيقي لجهد الطرف: اثنا عشر بتًا، من 0 إلى 4095، مقارنة بمدى كامل يحدده التوهين. الافتراضي هو 11 dB، أي تقريبًا كامل خط 3.3 V، لذا فمقياس جهد أو عصا تحكم عبر التغذية يغطي المدى كله؛ ودالة analogSetPinAttenuation() تقبل ADC_0db (1.1 V) أو ADC_2_5db (1.5 V) أو ADC_6db (2.2 V) أو ADC_11db، ودالة analogReadResolution() تزيح النتيجة إن أردت استرجاع عشرة بتات مثل Uno.

One read costs about five microseconds of simulated time, which is what the converter takes. A pin with nothing on it reads 0 rather than noise. Any other pin reads 0 too: there are five analog inputs and no more.

PWM

تعمل الدالة analogWrite(pin, 0..255) على أي طرف GPIO. يأتي المخرج من LEDC، متحكم PWM الخاص بالـ LED في الشريحة، ويصل إلى الطرف عبر مصفوفة GPIO، لذا لا توجد مجموعة أطراف ~ ثابتة كما هو الحال في Uno.

الافتراضي هو ثمانية بتات عند 1 kHz. عندما تكون للتردد أهمية (محرك السيرفو يريد خمسين إطارًا في الثانية وعرض نبضة، لا نسبة واجب)، استخدم الصيغة الخاصة بـ ESP32:

ledcAttach(4, 50, 14);        // fifty frames a second, 16384 counts each
ledcWrite(4, 1229);           // 1.5 ms of a 20 ms frame: the middle

توجد ست قنوات وأربعة مؤقتات. القنوات التي تطلب التردد والدقة نفسيهما تتشارك مؤقتًا واحدًا، فستة أطراف تخفت معًا تستهلك واحدًا من الأربعة؛ اطلب زوجًا خامسًا مختلفًا تعيد ledcAttach القيمة false بدلًا من إعادة ضبط مؤقت يعتمد عليه طرف آخر. ودالتا pinMode() وdigitalWrite() تستعيدان الطرف من LEDC.

نسبة واجب 0 تعني مستوى منخفضًا ثابتًا، ونسبة 255 مستوى عاليًا ثابتًا، من العتاد مباشرة دون أي حواف، وهذا يعني أيضًا أن المحاكي لا يجد ما يوقظ اللوحة من أجله، فاللوحة التي تخفت LED بينما هي متوقفة في wfi تكلّفها استيقاظين في المللي ثانية لا غير.

التسلسلي

على اللوحة الحقيقية، الطرفان 20 و21 هما UART0 والطرفان 18 و19 هما USB. هنا هي أطراف GPIO عادية، وتمضي بايتات UART0 إلى الشاشة التسلسلية بدلًا من ذلك. انظر «تشغيل» والشاشة التسلسلية.

What is modeled

أطراف GPIO وIO_MUX وUART0 وSYSTIMER ومسار القياس الواحد لـ ADC1 ومجموعة السرعة المنخفضة لـ LEDC، بعناوينها الحقيقية وبتاتها الحقيقية، إضافة إلى مقاطعة الجهاز الخارجية لأطراف GPIO وUART.

توقف الدالة delay() النواة عند منبّه SYSTIMER بدلًا من الدوران في حلقة، لذا فالكود الخامل يكلّف المحاكي بضع مئات من التعليمات في كل ثانية محاكاة بدلًا من مئة وستين مليونًا.

بعض عناوين السجلات لم يتم التحقق منها

اثنان من الكتل أعلاه يحملان عنوانين لا يستطيع هذا النموذج ضمانهما. العناوين الأساسية وإزاحات GPIO وIO_MUX وUART0 وSYSTIMER هي من الدليل المرجعي التقني. أما داخل SAR ADC، فكل إزاحة سجل قياس واحد عدا أول اثنتين فهي اختيار هذا النموذج لا اقتباس من صفحة في الدليل؛ والشيء نفسه ينطبق على سجلات المقاطعة الأربعة لـ LEDC وسجلي الإعداد العام والتاريخ، وأرقام إشارات مصفوفة GPIO الستة التي تصل قنوات LEDC عبرها إلى طرف. البرامج الثابتة المبنية هنا تتوافق مع النموذج سواء توافقت مع السيليكون أم لا، ومن ينوي نقل صورة إلى لوحة DevKitM-1 حقيقية عليه أن يفحص أولًا القائمة القصيرة تلك من #define في firmware/include/esp32c3.h. القسم 7 من نموذج ESP32-C3 يصنّف كل عنوان إلى: مأخوذ من الدليل، أو مُصدَّق به دون تحقق، أو غائب.

WiFi, simulated

لا يوجد راديو. لن يوجد أبدًا: فـ MAC للمعيار 802.11 ليس شيئًا يستطيع هذا النموذج محاكاته بأمانة. أما Bluetooth LE فيُحاكى بالطريقة نفسها التي يُحاكى بها الشبكة، عبر هاتف في لوحة Bluetooth في المحرر (البلوتوث، محاكى).

ما يوجد بدلًا من ذلك هو شبكة محاكاة. كتلة هي من Mokxi لا من الشريحة (صندوق بريد عند 0x6FFF_E000، حيث لا شيء مُعيَّن في C3 حقيقية إطلاقًا) تحمل WiFi.h وHTTPClient.h وWebServer.h، لذا فالكود الذي يعطيك إياه أي درس تعليمي يعمل هنا: تنضم اللوحة إلى نقطة وصول اسمها وكلمة مرورها خاصيتان من خصائص اللوحة، وتمشي الدالة WiFi.status() في الحالات نفسها خلال ثانية إلى ثلاث ثوانٍ، ويعطيها DHCP العنوان 192.168.4.2، ويمكن للكود جلب صفحة أو تقديمها.

ما يقف خلف ذلك هو برمجية، ولا شيء مخفي في هذا الأمر. لا يوجد 802.11، ولا قناة، ولا بحث عن الشبكات، ولا WPA2، ولا TCP، ولا TLS و لا إنترنت حقيقي: أربعة أسماء اخترعناها تحت .mokxi تُحلّ ولا غيرها، ولا شيء يفعله الكود يستطيع الوصول إلى الشبكة التي يعمل عليها متصفحك. WiFiClientSecure يترجم ثم يفشل، قائلًا إن TLS غير مُحاكى. لوحتا Web و Cloud على طول أسفل المحرر تُفتحان بهذه الجملة ولا تُمرّرها بعيدًا.

الاستثناء الوحيد هو إنترنت حقيقي، مفتاح في لوحة Cloud لأي شخص سجّل دخوله (المزيد منه مع Pro) يكون مغلقًا في كل مرة تُحمَّل فيها الصفحة. عند تشغيله، يخرج طلب اسم خارج .mokxi, https:// مشمولًا، يخرج عبر بوابة Mokxi وتعود الإجابة إلى الكود. انظر إنترنت حقيقي.

WiFi، محاكى هو كيفية استخدامه؛ وWiFi المحاكى هو العقد، حدًّا بعد حد.

المراقب والمكدس

As on the board, ESP-IDF's task watchdog runs from before setup() with a 5 s timeout: a sketch that neither calls delay() nor returns from loop() for that long prints the "Task watchdog got triggered" lines and reboots, and esp_reset_reason() says ESP_RST_TASK_WDT (6) afterwards. disableCore0WDT() turns that off, and esp_task_wdt_add(NULL) watches the sketch's own resets. A stack that runs out (recursion that never ends) stops with a "stack overflow" crash line at the top of the heap, before it writes over the program.

ما لم يُحتَذَ به

الغائب: SPI وI2C كأجهزة طرفية، ومؤقتات مجموعات المؤقتات (كلب المراقبة الخاص بها موجود، لمهمة كلب المراقبة)، وRMT، ومنفذ USB Serial/JTAG، ومصفوفة المقاطعات الكاملة، وكل ما يخص ESP-IDF. من محوّل ADC التناظري لا يُنمذَج إلا مسار اللقطة الواحدة لـ ADC1، وليس ADC2 (الذي تشاركه الراديو على الشريحة الحقيقية)، ولا جدول أنماط DMA، ولا المتحكم الرقمي، ولا المرشحات ومراقبات العتبة، ولا منحني المعايرة في eFuses، لذا فالقراءة هنا خط مستقيم اسمي وليست انحناءة طفيفة كقطعة حقيقية، بلا ضجيج ولا خطيّة مضطربة إطلاقًا. يمكن استعلام علامة اكتمال ADC لكنها لا تصل إلى متحكم المقاطعات. الملفات الثنائية من المورّد خارج النطاق؛ ما يعمل هو برنامج ثابت مبني على بيئة تشغيلنا الخاصة، وهو ما يبنيه لك المحرر.

التعليمة الواحدة دورة واحدة عند 160 MHz، بلا ذاكرة تخزين مؤقت ولا دورات انتظار للفلاش ولا توقفات في خط الأنابيب، لذا فالبرنامج هنا يعمل بانتظام أكبر مما يعمل به على الشريحة الحقيقية. طرفا 3V3 و5V مصدران مثاليان لا يمكن أن يهبط جهدهما، فلا يحدث في Mokxi انقطاع بسبب نقص التغذية أبدًا.

سجلاً بسجل، نموذج ESP32-C3 يضم كل ذلك.

مكتبات Arduino الرسمية

درس تعليمي يضم Servo.h وWire.h وSPI.h وEEPROM.h وLiquidCrystal_I2C.h وAdafruit_GFX.h مع Adafruit_SSD1306.h وAdafruit_NeoPixel.h وESP32Servo.h وDHT.h يُترجم هنا كما هو. كل واحد منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مكتوب فوق مشغّلات القطع في الصندوق، ولا شيء منه كود المكتبة الأصلية.

  • Wire.begin() يضع ناقل I2C على GPIO 8 (SDA) وGPIO 9 (SCL)، وهو اختيار Arduino core لهذه اللوحة؛ وWire.begin(sda, scl) ينقله.
  • تعمل المكتبة EEPROM.h، لكن نموذج هذه اللوحة لا يحتوي EEPROM ولا فلاش قابلًا للكتابة، لذلك تُخزَّن البايتات في 4 KB من الذاكرة RAM: يمكن قراءتها مرة أخرى خلال التشغيل نفسه، لكنها تضيع عند إعادة الضبط.

يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.

الأمثلة

Blink وButton وSerial وFade وPWM fade وServo sweep وCounter وInterrupt وWiFi: join the network وWiFi: fetch the weather وWiFi: a lamp on a web page وThumb stick وRainbow strip وPlasma panel وOLED text and shapes وOLED dice وOLED pong وPong console وBinary clock وElectronic dice وKnight Rider وMorse sender وSimon وStacker وTalker.

تلاشي PWM ومسح السيرفو هما الدرسان اللذان يستخدمان LEDC. الأول هو نفس LED المتنفس كما في درس التلاشي، لكن يصنعه العتاد بدلًا من صناعته يدويًا، وهذا هو الفرق بين نواة تبقى مستيقظة لكل ميكروثانية من شكل الموجة وأخرى تنام بين الخطوات؛ والثاني يحرك محرك SG90 عبر قناة بتردد 50 Hz، حيث ما يقرأه محرك السيرفو هو عرض النبضة وليس دورة التشغيل.

عصا تحكم وOLED pong هما الوحيدان اللذان يقرآن ADC. عرض العصا التجريبي يطبع المحورين ويضيء LED في الجهة التي تدفع العصا نحوها، بوضوح أو خفوت حسب مدى الدفع؛ وOLED pong هو لعبة العصا الخاصة بالـ Uno على هذه اللوحة، حيث يتبع المضرب مقاوم الجهد Y للعصا على GPIO 0 وتُعرض النتيجة بخط 5x7 الذي لا مساحة للـ Uno له.

كُتب عرضا الشريط واللوحة لهذه اللوحة. مشغّل WS2812 نفسه يعمل أيضًا على لوحات AVR وبقية عائلة ESP32 وPico وUno R4.

Stacker هو المعروض في الصفحة الرئيسية. مصفوفتان 8x8 من MAX7219 تقف إحداهما فوق الأخرى، فيتشكل ملعب بعرض ثمانية بكسلات وارتفاع ستة عشر، وزر أركيد قياس 30 mm على GPIO 3 يُسقط الكتلة المنزلقة. وهما موصولتان تسلسليًا بالطريقة التي صُممت الشريحة لها: البيانات على GPIO 7 تصل إلى الوحدة العلوية فقط، وDOUT يغذّي DIN للوحدة السفلية، وإشارة الساعة على GPIO 5 واختيار الشريحة الوحيد على GPIO 6 يصلان إليهما معًا. يرسل الكود حزمتين بين حافتي CS واحدة، حزمة الوحدة السفلية أولًا، لأن الحزمة المرسلة أولًا تُدفع إلى أبعد نقطة في السلسلة. تعمل المصفوفتان من طرف 5V في اللوحة وليس 3V3، لأن MAX7219 يريد أربعة فولت أو أكثر. إن لم يضغط أحد الزر لأربع ثوانٍ لعب الكود بنفسه، وضغطة واحدة تعيد اللعبة.

MicroPython

اختر MicroPython (main.py) في لوحة البرنامج الثابت للوحة، وزر «تشغيل» يشغّل برنامج MicroPython الرسمي v1.29.0 لـ ESP32-C3 مع main.py، على نموذج للشريحة كاملة يُقلع من ROM خاص بـ Espressif نفسها. machine.Pin, PWM, ADC, I2C, SPI, UART(1) و neopixel العمل، و network.WLAN ينضم إلى الشبكة المحاكاة. انظر MicroPython على ESP32.

في مواضع أخرى