اللوحات

ESP32 DevKit V1

ESP32 الكلاسيكي: معالج Xtensa LX6 بتردد 240 MHz على لوحة DOIT ذات الثلاثين طرفًا، مع متحكم PWM من نوع LEDC ومحوّل ADC باثني عشر بت وستة أطراف تعمل كمداخل فقط.

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

ما هي

لوحة DOIT ESP32 DevKit V1، وحدة ESP32-WROOM-32 على حامل ذي ثلاثين طرفًا، تعمل على نواة Xtensa الخاصة بنا، وهي أول لوحة هنا طقم تعليماتها ليس RISC-V ولا AVR ولا Arm. البرنامج الثابت ملف ELF لمعمارية Xtensa يتخاطب مع عناوين ESP32 الحقيقية.

أبعاد اللوحة 51.5 في 28.3 mm وصفّا أطرافها الخمسة عشر يبعد كل منهما 0.9 بوصة، لذا تجلس فوق القناة الوسطى في لوحة التجارب تاركة صفًا من الفتحات حرًّا على كل جانب.

This is the thirty-pin DOIT board, not the 38-pin Espressif DevKitC. The DevKitC is a full inch between rows, leaves no row free at all, and brings out more pins. If your board has 38 pins, use ESP32-DevKitC V4، وهي لوحة مستقلة بذاتها في صندوق القطع.

الأطراف

خمسة عشر طرفًا على كل حافة طويلة، ومنفذ micro-USB في الأسفل، والوحدة وهوائيها المدمج في PCB في الأعلى.

العمود الأيسر، من الأعلى إلى الأسفل: EN، VP، VN، D34، D35، D32، D33، D25، D26، D27، D14، D12، GND، D13، VIN.

العمود الأيمن، من الأعلى إلى الأسفل: D23، D22، TX0، RX0، D21، D19، D18، D5، TX2، RX2، D4، D0، D2، D15، 3V3.

Dn هو GPIO n. VP هو GPIO 36 وVN هو GPIO 39، وسُمّيا على الطباعة وفق وظيفتهما لا رقميهما. EN هو تمكين الشريحة، وهو إعادة التشغيل في هذه اللوحة. VIN هو خط 5 V القادم من USB.

هذه لوحة 3.3 فولت وأطرافها لا تتحمّل 5 V.

ثلاثة أشياء يفعلها تخطيط الأطراف معك

هذه أمور في العتاد وليس في النموذج، وكل واحدة تصطاد أحدهم:

  • لا يمكن لـ GPIO 34 إلى 39 أن تكون مخارج. أبدًا. هذه الأطراف الستة فيها مخزن إدخال مؤقت ولا شيء غيره: لا مشغّل إخراج ولا مقاومة شد أو خفض داخلية. pinMode(34, OUTPUT) يكتب في السجل لكن البتة لا تثبت، ويبقى الطرف بممانعة عالية. أربعة منها على هذا الرأس: D34، D35، VP وVN. يرفض Mokxi الكتابة كما تفعل الشريحة، ويعدّها، ويضع علامة كهرمانية صغيرة على اللوحة بدلًا من أن يتركك تعتقد أن طرفًا يُشغّل شيئًا ما. إن احتجت مقاومة شد على أحدها فلا بد أن تكون مقاومة خارجية.
  • GPIO 6 إلى 11 غير موجودة على رأس التوصيل أصلًا، لأنها ذاكرة SPI flash التي يعمل البرنامج منها. على اللوحات التي تُخرجها فعلًا، تمرير إشارة على أحدها يوقف عمل الشريحة.
  • GPIO 0 و2 و5 و12 و15 أطراف إقلاع (strapping). فهي تحدد كيف تقلع الشريحة، لذا فما يتصل بها عند التشغيل مهم. GPIO 2 هي أيضًا LED الأزرق، لذا حالتها قبل تشغيل pinMode تختلف من لوحة إلى أخرى.

LED والزر

LED_BUILTIN هو GPIO 2، أي LED أزرق عادي موصّل بالطريقة المعتادة: قيمة HIGH تُشغّله. أمّا BOOT فهو GPIO 0، يعمل بمستوى منخفض، وهو موجود في الرأس باسم D0 أيضًا، فيمكنك التوصيل إليه؛ والنقر عليه على اللوحة يربط الطرف بالأرضي.

analogRead: ثماني قنوات، وخط 3.3 V لا يقع عند القيمة 4095

القنوات الثماني لـ ADC1 ليست GPIO 0 إلى 7. بل هي بالترتيب GPIO 36 و37 و38 و39 و32 و33 و34 و35، والطرفان GPIO 37 و38 غير مُخرَجين على WROOM-32، لذا ما يمكنك الوصول إليه فعليًا هو VP، VN، D32، D33، D34 وD35.

اثنا عشر بتًا، وعند التوهين الافتراضي 11 dB تتبع القراءة منحنى ESP32 حقيقية بدلًا من خط مستقيم: 0 لأول 80 mV تقريبًا، وشبه خطية في الوسط، و4095 بدءًا من نحو 3.1 V. لذلك فإن مقاومة متغيرة موصولة بخط 3.3 V الخاص بهذه اللوحة تصل إلى 4095 قليلًا قبل نهاية مداها، وتقرأ نحو 1890 لا 2048 في المنتصف. هذا هو السلوك الحقيقي، ومثال knob يطبع الرقم الخام حتى لا يبقى الأمر غامضًا. أما analogReadMilliVolts() فيعكس أثر المنحنى ويقرأ القيمة بالفولتات.

ADC2 غير مُحاكى. على ESP32 حقيقية تتقاسم ADC2 مع راديو WiFi فتتوقف عن العمل عند بدء WiFi، ولهذا لا يستخدمها أحد؛ هنا هي غائبة ببساطة، فالقنوات الثماني أعلاه هي كل ما هناك.

التحويل الخطي المستقيم هنا تقريب لمحوّل حقيقي ينحني عند الطرفين ويُصحَّح من منحنى معايرة محفوظ في الشريحة. توقّع أن يكون النموذج ألطف قليلًا من السيليكون قرب 0 V وقرب أعلى المدى.

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

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

لأن LEDC عتاد حقيقي، فإن تلاشي LED هنا لا يكلّف النواة شيئًا إطلاقًا: يمكن أن يبقى الكود في delay() وتبقى الحواف تصل في موعدها. أما اللوحة الأكثر إثارة للاهتمام في المقارنة فهي ESP8266 NodeMCU: لا تمتلك عتاد PWM، فنواتها تقوم بالعمل. وكلتا اللوحتين صادقتان في ذلك.

التسلسلي

Serial هو UART0، وهو المنفذ الذي يتصل به جسر USB في لوحة DevKit، وهو موصول بالشاشة التسلسلية. تخرج البايتات بمعدل الباود الذي تضبطه، لذا فإن كودًا يطبع أسرع مما يستطيع 115200 باود نقله قد ينتظر هنا تمامًا كما يفعل على المكتب.

Serial1 وSerial2 هما UART1 وUART2، منفذان حقيقيان على أي أطراف تختارها، يرسلان الإطارات ويستقبلانها بتًا بتًا عبر السلك، لذا يمكن لوحدة GPS أو وحدة HC-05 أو وحدة PZEM-004T أو مرسل RS-485 أو حتى لوحة ثانية على تلك الأطراف أن تسمعهما:

Serial2.begin(9600, SERIAL_8N1, 16, 17); // RX, TX: the pins marked RX2 and TX2

ما يفعلونه هو ما تفعله نواة arduino-esp32 3.x:

  • بلا أطراف، يستخدم Serial1.begin(9600) الطرفين GPIO 26 (RX) و27 (TX)، ويستخدم Serial2.begin(9600) الطرفين GPIO 4 و25. كانت النواة 2.x تستخدم 16 و17 لـ Serial2، ولهذا تترك الدروس القديمة الأطراف دون تعيين؛ ينبّهك Mokxi إلى ذلك مرة في الشاشة التسلسلية إن فعلها الكود. وsetPins(rx, tx) ينقلهما، قبل begin() أو بعده.
  • الإطار يمكن أن يكون أيًّا من SERIAL_5N1 إلى SERIAL_8O2، وخيار invert في begin() يقلب الخطين معًا.
  • تصل البايتات المستلمة إلى الكود على شكل دفعات، كما في مشغّل ESP-IDF: ينقل الـ UART محتوى FIFO الخاص به إلى مخزن حلقي بحجم 256 بايت (setRxBufferSize() قبل begin()) بمجرد وصول 120 بايت (setRxFIFOFull()) أو عند سكون الخط لمدة زمن حرف واحد (setRxTimeout()). available() يعدّ محتوى المخزن الحلقي، لذا فإن البايت الذي ما يزال في الـ FIFO ليس متاحًا بعد. الكود الذي يقرأ ببطء شديد يفقد بايتات كما يحدث على المنضدة الحقيقية.
  • onReceive() يُستدعى بعد كل دفعة، بين loop()وبينما ينتظر الكود في delay()، وليس من مهمة FreeRTOS.
  • write() ينتظر بينما يكون FIFO بسعة 128 بايت ممتلئًا، و flush() حتى يخرج آخر بت توقف. setTxBufferSize() مستخدم، لكن لا يوجد مخزن حلقي للإرسال، لذا write() ما يزال ينتظر الـ FIFO.

التحكم في التدفق عبر العتاد، ووضع RS-485، و IrDA و autobaud غير مُحاكاة. يحتاج طرف الإرسال TX إلى مشغّل إخراج، لذا لا يمكن لأطراف GPIO 34 إلى 39 أن تكون سوى RX. SoftwareSerial.h ما يزال يعمل على أي طرفين كذلك.

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

تحتوي ESP32 الحقيقية على نواتين Xtensa LX6، بينما يعمل كود Arduino هنا على نواة واحدة: لا وحدة APP CPU، ولا مقاطعات بين النواتين، ولا FreeRTOS يوزّع المهام بينهما. الكود المبني حول setup() و loop() لا يلحظ ذلك أبدًا. أي شيء يبدأ مهمة على النواة 1 لن يعمل.

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

What is modeled

المعالج Xtensa LX6 بواجهة ABI النافذية (الواجهة الوحيدة التي يُصدرها المترجم)، مع نافذة السجلات، ومعالجَي تجاوز النافذة وتحت التدفق، ومقاطعات المستوى 1. وحوله: مصفوفة GPIO و IO_MUX، و UART0، والمؤقت 0 من مجموعة المؤقتات 0 خلف millis() و micros()، و ADC1 بوضع القراءة الواحدة عبر كتلة SENS، ومجموعة السرعة العالية في LEDC، وما يلزم مصفوفة مقاطعات DPORT من مصدرين اثنين.

هذه هي الدوال التي تحتاجها pinMode وdigitalWrite وdigitalRead وanalogRead وanalogWrite وledcAttach وledcWrite وmillis وmicros وdelay وattachInterrupt وSerial، في عناوينها الحقيقية.

WiFi, simulated

لا يوجد راديو. ولن يكون هناك أبدًا: فطبقة MAC الخاصة بمعيار 802.11 ليست شيئًا يمكن لهذا النموذج أن يعيد إنتاجه بأمانة.

ما يوجد بدلًا من ذلك هو شبكة محاكاة. كتلة هي من Mokxi نفسه وليست من الشريحة (صندوق بريد عند 0x3FEF_E000، حيث لا توجد في ESP32 الحقيقية أي ذاكرة معينة على الإطلاق) تحمل 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 وتعود الإجابة إلى الكود. انظر إنترنت حقيقي.

يقع العنوان في الفجوة التي تتركها ناقلة بيانات الشريحة بين نافذتي الذاكرة الخارجية ونافذة الملحقات، بحيث تُحدث الصورة التي تستخدمه خطأً على السيليكون الحقيقي بدلًا من قراءة سجل ملحق آخر. Bluetooth محاكى عبر الكتلة نفسها، Classic و LE، مع هاتف في لوحة Bluetooth في المحرر وبدون راديو (البلوتوث، محاكى).

تأتي مع هذه اللوحة ثلاثة أمثلة: WiFi: الانضمام إلى الشبكة و WiFi: جلب حالة الطقس و WiFi: مصباح على صفحة ويب.

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

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

راديو من أي نوع. لا يوجد في النموذج راديو 802.11 أو بلوتوث ولا ادّعاء بوجوده؛ فالـ WiFi والبلوتوث أعلاه محاكيان ويقولان ذلك. النواة الثانية. وحدة FPU: كل تعليمة فاصلة عائمة تُحدث خطأً هنا بدلًا من إرجاع رقم خاطئ، وبيئة التشغيل تعتمد الفاصلة العائمة البرمجية، لذا يعمل float ولا تعمل الملفات الثنائية للبائع المبنية بفاصلة عائمة عتادية. الذاكرة المؤقتة والفلاش وPSRAM: يعمل الكود من الذاكرة الداخلية. الـ RTC ومعالج ULP المساعد والسبات العميق. ADC2 وحساس اللمس وحساس هول. المتحكمان I2C وSPI، وI2S وRMT. Wire وSPI في بيئة التشغيل برمجيات على أطراف عادية، كما على كل لوحة هنا: يضع Wire.begin() الطرف SDA على 21 وSCL على 22، ويستخدم SPI الأطراف 18 (SCK) و19 (MISO) و23 (MOSI) و5 (SS). يقود Adafruit_NeoPixel.h شريط WS2812 بقياس توقيت كل بت عبر عدّاد دورات النواة، بما أن RMT الذي تستخدمه ESP32 الحقيقية غير موجود هنا. مجموعات المؤقتات بعد المؤقت الأول من مجموعة المؤقتات 0 وكلب الحراسة الخاص بها (الذي يشغّل كلب حراسة المهام، كما يفعل ESP-IDF).

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

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

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

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

The full list of what the model implements, and a plain account of which register addresses came out of the technical reference manual and which are this model's belief, is in نموذج ESP32 DevKit. القسم 6 هو ما ينبغي قراءته قبل نقل بناء من هنا إلى شريحة حقيقية.

مكتبات Arduino القياسية التي تترجمها اللوحات الأخرى (Servo.h وWire.h وEEPROM.h وAdafruit_SSD1306.h والبقية) موجودة على مسار التضمين هنا أيضًا. تم التحقق من Wire.h وAdafruit_NeoPixel.h وKeypad.h على هذه اللوحة، بفحص I2C على 21 و22، وشريط مضاء، ولوحة مفاتيح 4x4؛ أما البقية فلم تُفحص هنا بعد.

MicroPython

يمكن للوحة تشغيل Python بدلًا من كود. اختر MicroPython (main.py) في لوحة البرنامج الثابت و يجعل «تشغيل» اللوحة تُقلع ببرنامج MicroPython v1.29.0 الرسمي للـ ESP32 و تشغّل ملف main.py. يعمل ذلك على نموذج للشريحة كاملة، انطلاقًا من ذاكرة ROM المقنّعة من Espressif، لذا فإن الحدود أعلاه هي حدود بيئة تشغيل Arduino وليست حدود MicroPython: machine.I2C, machine.SPI، و RMT خلف neopixel و network.WLAN موجودة من أجله. انظر MicroPython على ESP32.

الأمثلة

Blink وButton وSerial وFade وKnob، إضافة إلى دروس WiFi الثلاثة: «WiFi: join the network» و«WiFi: fetch the weather» و«WiFi: a lamp on a web page». كل واحد منها يشغّل برنامجه الجاهز حتى تغيّره، ثم زر «تشغيل» يبني نسختك.

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

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

في مواضع أخرى