اللوحات

لوحة ESP32-S3-DevKitC-1

ESP32-S3 بمعالج Xtensa LX7 بتردد 240 MHz: لوحة DevKitC-1 الرسمية من Espressif، مع LED RGB على RMT، ومنفذي USB، وLEDC PWM، ومحوّل تناظري إلى رقمي بدقة اثنتي عشرة بتة.

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

ما هي

ESP32-S3-DevKitC-1 هي لوحة Espressif للشرائح ESP32-S3، وتعمل هنا على نواة Xtensa من تصميمنا. البرنامج الثابت ملف Xtensa ELF يتعامل مع عناوين ESP32-S3 الحقيقية، وقد جرت مطابقة كل عنوان تقريبًا مع الدليل المرجعي التقني من Espressif.

أبعاد اللوحة 62.7 في 25.4 مم، وصفّا أطرافها الـ 22 يبعدان عن بعضهما 0.9 بوصة، فتقعد اللوحة على القناة الوسطى في لوحة التجارب تاركة صفًّا من الثقوب حرًّا على كل جانب، مثل ESP32 DevKit الكلاسيكي.

الأطراف

اثنان وعشرون طرفًا على كل حافة طويلة، والمقبسان micro-USB في الأسفل، والوحدة وهوائيها في الأعلى. تكتب الطباعة الحرارية على اللوحة رقم كل GPIO.

J1، العمود الأيسر، من الأعلى إلى الأسفل: 3V3، 3V3، RST، 4، 5، 6، 7، 15، 16، 17، 18، 8، 3، 46، 9، 10، 11، 12، 13، 14، 5V، G.

J3، العمود الأيمن، من الأعلى إلى الأسفل: G، TX، RX، 1، 2، 42، 41، 40، 39، 38، 37، 36، 35، 0، 45، 48، 47، 21، 20، 19، G، G.

TX وRX هما GPIO 43 و44، على UART0. وRST هو طرف تفعيل الشريحة. و5V هو خط USB الكهربائي. هذه لوحة بجهد 3.3 فولت وأطرافها لا تتحمل 5 فولت.

أمور يفعلها تخطيط الأطراف بك

  • الأطراف GPIO 35 و36 و37 مخصصة للذاكرة PSRAM في اللوحات ذات PSRAM الثمانية (مثل N8R8 التي يشتريها معظم الناس). وهي موجودة على الرأس، وفي تلك اللوحات لا يجوز استخدامها. لا تتوفر PSRAM في Mokxi، لذا تعمل هنا، وهو ما قد لا يحدث على منضدة حقيقية.
  • الطرفان GPIO 19 و20 هما D- وD+ لمنفذ USB. إذا أرسلت إشارة عبرهما توقف مقبس «USB» عن العمل على لوحة حقيقية. هنا يستمر منفذ USB التسلسلي في العمل، وهو أرحم من الشريحة الفعلية.
  • الأطراف GPIO 0 و3 و45 و46 هي أطراف strapping، لذا فإن ما يوصّل بها عند التشغيل له أهمية. والطرف GPIO 0 هو أيضًا زر BOOT.
  • بعض الأطراف تبدأ التشغيل ومدخلها معطَّل. الأطراف GPIO 4 إلى 8 و15 و16 و19 إلى 21 تقرأ القيمة 0 إلى أن يشغّل pinMode منطقة المدخل، وهي حالة الشريحة عند إعادة الضبط. pinMode يفعل ذلك دائمًا، فلا يلاحظ الكود شيئًا.

The RGB LED

لا تحتوي اللوحة على LED عادي. بل تحتوي على LED RGB قابل للعنونة، وهو مكوّن من نوع WS2812، على GPIO 48 في اللوحات الأولى وعلى GPIO 38 في الإصدار v1.1، وهو ما يذكره Espressif كالفرق الوحيد بين المراجعتين. خاصية المراجعة في اللوحة تحدد أيهما يظهر على لوحة التجارب الخاصة بك.

LED_BUILTIN على هذه اللوحة ليس رقم GPIO: كما في نواة Arduino، فهو مجموع عدد أطراف GPIO وطرف الـ LED، وdigitalWrite(LED_BUILTIN, HIGH) يرسل إلى الـ LED إطارًا يضيئه بالأبيض بربع السطوع. وللحصول على لون، استخدم rgbLedWrite(RGB_BUILTIN, red, green, blue). كلاهما يخرج عبر الطرف المحيطي RMT في الشريحة، 24 بتًا يبدأ بالأخضر، وكل بت ضمن توقيتات دليل بيانات WS2812B، فتضيء الـ LED على اللوحة بأي لون يحمله الإطار.

الأمثلة مبنية على GPIO 48، كما في تعريف اللوحة في نواة Arduino. على لوحة v1.1 تقع الـ LED على GPIO 38، فيتركها الكود نفسه مطفأة، وهو ما سيحدث على منضدة حقيقية. الطرف موجود أيضًا على الرأس، لذا فإن شريط ws2812 موصولًا بالطرف 48 يرى الإطارات نفسها.

analogRead: عشر قنوات، و2.9 V هي الحد الأعلى

القنوات العشر لمحوّل ADC1 هي GPIO من 1 إلى 10: القناة n هي الطرف GPIO n + 1. بدقة اثني عشر بتًا. عند التوهين الافتراضي 12 dB ينتهي مدى القياس في دليل البيانات عند 2.9 V، ويقرأ Mokxi القيمة 4095 من هذه النقطة فصاعدًا، لذا فإن مقياس جهد (potentiometer) موصولًا عبر خط 3.3 V يقرأ 4095 في الثُمن الأعلى من مداه. يطبع مثال knob الرقم الخام حتى لا يبقى هذا غامضًا.

ذلك الخط المستقيم حتى 2.9 V هو تقريب: تحتفظ شريحة S3 حقيقية بهامش صغير فوق المدى وتنحني عند الطرفين، ويصحَّح ذلك من معايرة محفوظة في الشريحة. لم يُنمذَج ADC2.

analogWrite هو LEDC، ولا يكلّف النواة شيئًا

analogWrite(pin, 0..255) يربط إحدى قنوات LEDC الثماني بالطرف: ثمانية بتات عند 1 kHz، على أي طرف GPIO، عبر مصفوفة GPIO. وledcAttach(pin, frequency, bits) وledcWrite(pin, duty) متاحان عندما تكون الترددات مهمة. على S3، لا تسري إعدادات LEDC إلا عند كتابة بت تحديث، ووقت التشغيل يكتبه؛ فالـ LED المتلاشية لا تكلف النواة شيئًا.

Serial، والمقبسان USB

تحتوي لوحة DevKitC-1 حقيقية على مقبسي micro-USB. يمر «UART» عبر جسر من USB إلى UART ليصل إلى UART0: هذا هو Serial، كما في نواة Arduino مع إيقاف خيار USB CDC عند التشغيل، وهو الإعداد الافتراضي لهذه اللوحة. أما «USB» فهو متحكم USB Serial/JTAG الخاص بالشريحة: هذا هو USBSerial، الذي يرسل حزمة من 64 بايتًا في المرة، في نهاية كل سطر.

الشاشة التسلسلية هنا تستمع إلى الاثنين معًا، فأيهما طبع يظهر في المكان نفسه، وما تكتبه يذهب إلى كليهما.

نواة واحدة، لا نواتان

تحتوي شريحة S3 حقيقية على نواتين من نوع Xtensa LX7، وكود Arduino هنا يعمل على نواة واحدة. الكود المبني حول setup() وloop() لا يلاحظ ذلك. أي شيء يبدأ مهمة على النواة 1 لن يعمل.

البرنامج الثابت الذي بنيته بنفسك مختلف: يعمل MicroPython ونسخة مبنية من ESP-IDF على نموذج للشريحة كاملة، حيث تعمل النواتان فعلًا (انظر أدناه).

What is modeled

نواة Xtensa LX7، التي هي بالنسبة لكل ما ينتجه المترجم من C مجموعة تعليمات LX6 الخاصة بـ ESP32 الكلاسيكي: نفس ABI بنوافذ السجلات، وقد جرت مطابقة مخرجات مترجم S3 بايتات ببايت مع مخرجات مترجم ESP32. وحولها: 416 KB من SRAM تُرى عبر الناقلين، ومصفوفة GPIO وIO MUX مع حالات السحب الافتراضية من الدليل على كل طرف، وUART0، ومنفذ USB Serial/JTAG التسلسلي، وSYSTIMER خلف millis() وmicros()، وADC1، وLEDC، وقنوات الإرسال الأربع لـ RMT، وبوابات الساعة، ومن مصفوفة المقاطعات بقدر ما تحتاجه أربعة مصادر.

WiFi, simulated

لا يوجد راديو. ما هو موجود هو شبكة محاكاة، وهي نفسها التي لدى ESP32 الكلاسيكي وESP32-C3، خلف كتلة من تصميم Mokxi لا من تصميم الشريحة، عند عنوان تتركه S3 غير مُعرَّف. WiFi.h, HTTPClient.h و WebServer.h تعمل كما يتوقع أي درس تعليمي: تنضم اللوحة إلى نقطة وصول اسمها وكلمة مرورها خاصيتان من خصائص اللوحة، وتجلب صفحة من عنوان متخيَّل تحت .mokxi، أو تقدّم واحدة إلى لوحة الويب. لا يوجد 802.11 ولا TCP ولا TLS و لا إنترنت حقيقي. الاستثناء الوحيد هو مفتاح إنترنت حقيقي في لوحة السحابة، الذي يرسل طلبات الأسماء الأخرى عبر بوابة Mokxi. أما البلوتوث LE فمحاكى بالطريقة نفسها، مع هاتف في لوحة البلوتوث بالمحرر (البلوتوث، محاكى).

WiFi, simulated هو كيفية استخدامها؛ وشبكة WiFi محاكاة هو العقد.

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

أي جهاز راديو: يتم محاكاة WiFi وBluetooth LE، من دون راديو حقيقي تحتهما. النواة الثانية. وحدة FPU وتعليمات المتجهات في S3: كلتاهما تسبب خطأً بدلًا من إرجاع رقم خاطئ، وبيئة التشغيل تستخدم الفاصلة العائمة البرمجية. ‏SRAM0، وذاكرة التخزين المؤقت، وflash، وPSRAM. ‏RTC، ومعالجات ULP المساعدة، والنوم العميق. ‏ADC2، وحساس اللمس، وحساس درجة الحرارة. مؤقتات مجموعات المؤقتات (كوابحها مُحاكاة لأجل كابح المهام). ‏UART1 وUART2، ومتحكمات I2C وSPI، وI2S، وواجهة الكاميرا، وTWAI، وUSB OTG. Wire وSPI في بيئة التشغيل برمجيات على أطراف عادية، كما على كل لوحة هنا: SDA على 8، وSCL على 9، وSPI من 10 إلى 13.

لن تعمل هنا ملفات ESP-IDF و Arduino-core الثنائية من البائع: فبيئة التشغيل من صنعنا.

ترجمة الكود الخاص بك

عدّل الكود واضغط «تشغيل»: تتم الترجمة في التبويب باستخدام clang من Espressif لمعمارية Xtensa، وهي نفس سلسلة الأدوات المستخدمة في ESP32 الكلاسيكي وESP8266 (clang-v3، نحو 80 MB، تُنزَّل مرة واحدة). لا يتم رفع أي شيء. المثال الذي لم يُمَسّ يشغّل برنامجه الجاهز مسبقًا، المبني بـ GCC من Espressif للـ S3؛ لا يُربط أي شيء من GCC به.

حساب الفاصلة العائمة يعمل: لا يحتوي هذا الطراز على FPU، لذا يقوم البناء بجمع float و double برمجيًا، تمامًا كاللوحات التي لا تحتوي على FPU إطلاقًا. تجد الشرح الكامل في الترجمة في المتصفح.

الأمثلة

Blink، وRainbow، وButton، وSerial، وUSB serial، وFade، وKnob، والأمثلة الأربعة الخاصة بـ WiFi: WiFi: الانضمام إلى الشبكة، وWiFi: جلب حالة الطقس، ومختبر API: جلب JSON، وWiFi: مصباح على صفحة ويب.

برنامج ثابت بنيتَه بنفسك

يُبنى كود Arduino هنا، ويعمل على نواة واحدة. والبرنامج المبني في مكان آخر، باستخدام ESP-IDF أو بلغة Rust (esp-hal, esp-idf-hal)، يعمل أيضًا، على نموذج للشريحة كاملة مع كلتا النواتين: ارفع .bin أو .elf في لوحة البرنامج الثابت، وتقلع اللوحة به كما يحدث بعد idf.py flash. الواي فاي والبلوتوث هما الفجوة، لأن مشغّلاتهما مكتبات مغلقة من Espressif: أي برنامج ثابت يشغّل أحدهما يتوقف مع سطر يقول ذلك. الخطوات والقائمة الكاملة موجودة في تشغيل برنامج ثابت جاهز.

MicroPython وCircuitPython

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

Pick CircuitPython (code.py) instead and Run boots the official CircuitPython 10.3.1 firmware for this board, with its CIRCUITPY drive and its REPL on the S3's own USB port. WiFi is not simulated under CircuitPython here. See ‏CircuitPython على الـ Pico، وهو يغطي هذه اللوحة أيضًا.

في مواضع أخرى