نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج ESP8266 NodeMCU (كل السجلات).
ما هي
لوحة NodeMCU V1.0 «Amica»، وهي وحدة ESP-12E على حامل بثلاثين طرفًا، تعمل على نواة Xtensa الخاصة بنا بتهيئة LX106. البرنامج الثابت ملف ELF لمعمارية Xtensa يتعامل مع عناوين ESP8266 الحقيقية، مع استثناء واحد، مذكور أدناه، يصرّح به النموذج بوضوح.
اللوحة بقياس 48.3 في 25.6 mm وصفّا أطرافها الخمسة عشر يبعدان 0.9 inch، فتقف على القناة الوسطى للوحة التجارب تاركة صفًّا من الثقوب حرًّا على كل جانب. اللوحة التي يصوّرها الناس جسرًا فوق لوحتي تجارب هي V3 «LoLin» الأعرض، التي تبعد صفوفها inch كاملًا. هذه القطعة هي V1.0.
D0 to D8 are not GPIO numbers
هذا هو الأمر الذي يفاجئ به هذه اللوحة الجميع، لذلك نذكره أولًا:
| الطباعة الحريرية | D0 |
D1 |
D2 |
D3 |
D4 |
D5 |
D6 |
D7 |
D8 |
RX |
TX |
|---|---|---|---|---|---|---|---|---|---|---|---|
| GPIO | 16 | 5 | 4 | 0 | 2 | 14 | 12 | 13 | 15 | 3 | 1 |
digitalWrite(2, HIGH) هو D4، وليس D2. بيئة تشغيل Mokxi تعرّف D0 إلى
D8، لذا يمكنك أن تكتب digitalWrite(D2, HIGH) وتقصد الطرف الذي تنظر إليه.
الأطراف
خمسة عشر طرفًا على كل حافة طويلة، ومقبس micro-USB في الأسفل.
العمود الأيسر، من الأعلى إلى الأسفل: A0، RSV، RSV، SD3، SD2، SD1، CMD، SD0، CLK، GND، 3V3، EN، RST، GND، VIN.
العمود الأيمن، من الأعلى إلى الأسفل: D0، D1، D2، D3، D4، 3V3، GND، D5، D6، D7، D8، RX، TX، GND، 3V3.
هذه لوحة 3.3 فولت وأطرافها لا تتحمل 5 V. VIN هو خط 5 V القادم من USB.
SD0 إلى SD3، وCMD وCLK هي أسلاك شريحة flash الستة. هي موجودة على رأس لوحة NodeMCU حقيقية وموجودة على هذه القطعة، وهنا لا تتصل بشيء: لا تُخرِج ولا تقرأ. تشغيل أحدها على لوحة حقيقية يوقف الـ flash الذي يعمل منه برنامجك، فمحاكٍ يتيح لك استخدامها كان سيعلّمك إتلاف لوحة. الطرفان RSV هما مثل أحدهما.
صمامان LED، وكلاهما معكوس
D4 (GPIO 2) يحمل LED وحدة ESP-12 الأزرق، وD0 (GPIO 16) يحمل LED لوحة الحامل. كلاهما نشط بمستوى منخفض: digitalWrite(LED_BUILTIN, LOW) يضيء LED الوحدة. LED_BUILTIN يساوي 2.
مثال blink يكتب إلى LED اللوحة وآخر موصول على D1 في اتجاهين متعاكسين عمدًا، فيبقى الاثنان دائمًا على وضعين متضادين، وهذا ما تراه على المكتب.
زر FLASH هو GPIO 0، وهو D3، نشط بمستوى منخفض. النقر عليه على اللوحة يأرض الطرف.
D0 ليس طرفًا عاديًا
GPIO 16 (D0) هو طرف الـ RTC، لا طرف كتلة GPIO. وينتج عن ذلك ثلاثة أمور:
- له مقاومة سحب للأسفل، بينما كل طرف آخر على هذه القطعة له مقاومة سحب للأعلى.
- لا يمكنه توليد مقاطعة.
attachInterrupt(D0, ...)لا يفعل شيئًا. - على لوحة حقيقية هو الطرف الذي توصّله بـ
RSTلإيقاظ النوم العميق، وهو غير مُحاكى هنا لأن النوم العميق غير مُحاكى.
analogRead: طرف واحد، عشرة بتات، ومقسِم جهد
A0 هو طرف الإشارة التناظرية الوحيد في ESP8266. وهو ليس GPIO ولا يمكن الكتابة إليه.
طرف الشريحة نفسه يحوّل من 0 إلى 1.0 V. تضع لوحة NodeMCU أمامه مقسِم جهد 220k/100k، فيكون A0 على الرأس من 0 إلى نحو 3.2 V، ومقاوم متغيّر عبر خط 3.3 V يغطي المدى تقريبًا تمامًا. المقسِم جزء من اللوحة، وMokxi يحاكيه: يحمّل الطرف شبكتك بـ 320 k، وهو ما تفعله لوحة حقيقية.
عشرة بتات، من 0 إلى 1023، وهو أيضًا مدى PWM لهذه اللوحة، لذا يغذّي مثال knob القراءة مباشرة في نسبة العمل.
هذا هو الشيء الوحيد على هذه اللوحة الذي ليس على عنوان حقيقي. لم تنشر Espressif قط سجلات ADC في ESP8266 (يستدعي الـ SDK الدالة system_adc_read() من ملف ثنائي مغلق)، فبدلًا من اختراع عنوان وتركك تفترض أنه عنوان الشريحة، يضع Mokxi هناك ثلاثة سجلات خاصة به ويقول ذلك صراحة. ما يعنيه ذلك عمليًا: إذا نقلت بناءً من هنا إلى لوحة NodeMCU حقيقية، فـ analogRead هي الاستدعاء الوحيد الذي ستضطر إلى تغييره. لا شيء غيره.
analogWrite برمجية، والمدى 1023، وتكلّف النواة شيئًا ما
لا يحتوي ESP8266 على أي عتاد PWM إطلاقًا. ليس LEDC مصغّرًا: لا شيء. نواة Arduino ESP8266 تولّد موجاتها من معالج مؤقت، وكذلك تفعل بيئة التشغيل هذه: ثمانية أطراف معًا، و1 kHz افتراضيًا، analogWriteFreq(40..60000).
ينتج عن ذلك أمران، وكلاهما حقيقي:
analogWriteتقبل قيمًا من 0 إلى 1023، وليس من 0 إلى 255.analogWrite(pin, 255)هي ربع السطوع، وليس السطوع الكامل. هذا ما تفعله النواة الحقيقية، وقد كان تقليدها اختيارًا بين مفاجأتك هنا أو مفاجأتك على المنضدة.analogWriteRange(255)يجعل كود Uno يعمل كما ينبغي.- تستيقظ النواة مرتين في كل دورة لتحريك الطرف. على ESP32 يكون تخفيت سطوع LED مجانيًا، أما هنا فلا. اللوحتان متاحتان هنا، والفرق بينهما من أنفع ما يعلّمه هذا الثنائي.
التسلسلي
Serial هو UART0 على TX وRX، وهو المنفذ الذي يتصل به جسر USB، وهو موصول بالشاشة التسلسلية. تخرج البايتات بمعدل الباود الذي حددته.
Serial1 غير مُحاكى. على ESP8266 حقيقي يكون طرف TX في UART1 هو GPIO 2، وهو نفسه طرف LED في الوحدة، ولهذا لا يمكن الجمع بينهما.
للحصول على منفذ ثانٍ، تعمل SoftwareSerial.h على أي طرفين عدا D0 (لأن GPIO 16 بلا مقاطعة)، بالاستدعاءات نفسها في EspSoftwareSerial، وهي المكتبة التي تأتي مع نواة ESP8266: SoftwareSerial gps(D5, D6); gps.begin(9600);. يُقاس كل تغيّر على طرف الاستقبال عبر مقاطعة مقابل عدّاد الدورات، لذا تستقبل عدة منافذ في وقت واحد ولا توقف listen() بقية المنافذ. بصيغة 8N1 فقط.
What is modeled
معالج Xtensa LX106 بواجهة call0: ستة عشر سجلًا (register) وبلا نافذة سجلات، وهذا ما يولّده المترجم الخاص به، وهو السبب في أن صورة ESP32 تسبب خطأً في النواة (fault) بدلًا من مجرد سلوك خاطئ صامت. حوله: كتلة GPIO وIO_MUX، وسجلات RTC التي تخص GPIO 16، ومنفذ UART0، ومحوّل TOUT، وسجلّا CCOUNT وCCOMPARE0 اللذان يقفان خلف millis() وmicros() وdelay() وPWM البرمجي.
هذا هو ما تحتاجه الدوال pinMode وdigitalWrite وdigitalRead وanalogRead وanalogWrite وmillis وmicros وdelay وattachInterrupt وSerial، عند عناوينها الحقيقية، باستثناء ADC كما هو مذكور.
WiFi, simulated
لا يوجد راديو. ولن يكون هناك أبدًا: فطبقة MAC الخاصة بمعيار 802.11 ليست شيئًا يمكن لهذا النموذج أن يعيد إنتاجه بأمانة.
ما يوجد بدلًا من ذلك هو شبكة محاكاة. كتلة هي من Mokxi نفسه لا من الشريحة (صندوق بريد عند 0x6FFF_E000، حيث لا يوجد أي شيء مخطط في ESP8266 حقيقي أصلًا) تحمل 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 في ESP8266 كتلة ثنائية داخل SDK، ولم تنشر Espressif سجلاتها قط. هذا النموذج لا يخمّنها. ما يقدمه بدلًا منها صندوق بريد هو بصدق من Mokxi، عند عنوان هو بصدق ليس من نصيب الشريحة.
تأتي مع هذه اللوحة ثلاثة أمثلة: WiFi: الانضمام إلى الشبكة و WiFi: جلب حالة الطقس و WiFi: مصباح على صفحة ويب.
WiFi، محاكى هو كيفية استخدامه؛ وWiFi المحاكى هو العقد، حدًّا بعد حد.
ما لم يُحتَذَ به
راديو من أي نوع. لا 802.11، ولا PHY، ولا قناة، ولا WPA2، ولا سجل واحد لراديو الشريحة نفسها، لأن Espressif لم تنشر شيئًا منها قط. على شريحة كل سبب لوجودها هو WiFi، يكون هذا أكبر ما ينقص هنا، ولذلك يُذكر أولًا لا آخرًا، ولهذا القسم الذي قبله هو الشبكة المحاكاة لا هذا.
غائب أيضًا: ذاكرة flash والذاكرة المؤقتة التي تحوّل عناوينها، فلا PROGMEM قراءة من flash، ولا SPIFFS، ولا LittleFS، ولا OTA. FRC1 وFRC2، وهما المؤقتان العتاديان. الساعة هنا هي عدّاد دورات النواة نفسه، وهو سجل لا يحتاج أي نموذج إلى تخمينه. النوم العميق وRTC، وعدّاده وذاكرته. وSPI وI2S وUART1 العتادي. لا توجد أصلًا وحدة I2C عتادية على هذه الشريحة؛ نواة Arduino تحاكيها برمجيًا بتقليب الأطراف، وهذا غير موجود هنا أيضًا. وكذلك eFuse. أما المراقبات (watchdog) فهي مُحاكاة: الكود الذي لا يستدعي yield لمدة 3 إلى 5 ثوانٍ يحصل على رسالة النواة "Soft WDT reset"، والذي عطّلها بـ ESP.wdtDisable() إعادة تعيين مراقب العتاد عند نحو 8.4 ثوانٍ.
لن تعمل هنا ملفات SDK التجارية وثنائيات نواة Arduino: بيئة التشغيل من صنعنا.
ترجمة الكود الخاص بك
عدّل الكود واضغط «تشغيل»: تتم الترجمة في علامة التبويب، كبقية اللوحات هنا. لهذه الشريحة المترجم هو clang من Espressif نفسها، ويحمل الواجهة الخلفية لـ Xtensa، لذا ينزّل البناء الأول سلسلة أدوات منفصلة (clang-v3، نحو 80 MB، مرة واحدة) وتعيد البناءات اللاحقة استخدامها. لا يتم رفع أي شيء. يظل المثال غير المعدّل يشغّل برنامجه المُبنى مسبقًا؛ عدّل سطرًا واحدًا وسيبني زر «تشغيل» كودك.
الحساب بالنقطة العائمة يعمل: لا يحتوي LX106 على وحدة FPU، لذا تُنفَّذ عمليات جمع float وdouble برمجيًا، كما على ESP8266 حقيقي. التفاصيل الكاملة في الترجمة داخل المتصفح.
The full list of what the model implements, and a plain account of which addresses are as real as this part allows, which are believed and which three are invented, is in نموذج ESP8266 NodeMCU. القسم 6 هو ما ينبغي قراءته قبل نقل بناء من هنا إلى شريحة حقيقية.
مكتبات Arduino القياسية التي تترجمها اللوحات الأخرى (Servo.h وWire.h وEEPROM.h وAdafruit_SSD1306.h وغيرها) موجودة على مسار التضمين هنا أيضًا، لكن لم يُتحقق منها على هذه اللوحة بعد.
الأمثلة
Blink وButton وSerial وFade وKnob، إضافة إلى دروس WiFi الثلاثة: «WiFi: join the network» و«WiFi: fetch the weather» و«WiFi: a lamp on a web page». كل واحد منها يشغّل برنامجه الجاهز حتى تغيّره، ثم زر «تشغيل» يبني نسختك.
في مواضع أخرى
- صفحة اللوحة: /boards/nodemcu
- وثيقة العقد: نموذج ESP8266 NodeMCU
- اللوحة الأخرى بمعمارية Xtensa: ESP32 DevKit
- الشريحة التي حلّت محلها: ESP32-C3
- الشريحة نفسها على لوحات أصغر: Wemos D1 mini وESP-01S