هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة ESP8266 NodeMCU و صفحة اللوحة.
لوحة NodeMCU V1.0 هي اللوحة ذات الأطراف الثلاثين المحيطة بوحدة ESP-12E: معالج Xtensa LX106 بتردد 80 MHz، أصغر أجزاء هذه المجموعة وأقدمها، وما تزال اللوحة التي كانت أول لوحة WiFi لكثير من الناس. مكوّن نواة واحد (esp8266 في crates/parts) يغلّف نموذج شريحة ESP8266 SoC (crates/esp8266) على المفسّر Xtensa نفسه المستخدم مع ESP32 (crates/xtensa-core)، بإعداد مختلف. هذا المستند هو العقد، وهو يعلو على أي تعليق في الكود.
نوع الفهرس هو esp8266. سلسلة program في الفهرس هي elf32 xtensa lx106 esp8266.
اقرأ القسم 6 أولًا إذا كنت ستنقل بناءً من هنا إلى شريحة حقيقية. معظم هذه اللوحة في عنوانها الحقيقي؛ لكن ADC ليس كذلك، وهذا مذكور في القسم 3.5، وفي صفحة اللوحة، وفي مقالة المساعدة، كما هو هنا، لأن Espressif لم تنشر إطلاقًا واجهة سجلات محوّل TOUT.
A sketch for this board compiles in the browser with clang-v3, the wasm build of Espressif's LLVM fork (-mcpu=esp8266), published 2026-09-28 and checked on this simulator (docs/compile.md). An untouched example still runs its prebuilt ELF from web/public/firmware/esp8266/, which Espressif's GCC builds. Section 7 has the details.
1. أطراف اللوحة (بترتيب الفهرس)
منظر علوي، مقبس micro-USB في الأسفل، ووحدة ESP-12E وهوائيها المدمج في اللوح في الأعلى. مقاس اللوحة 48.3 x 25.6 mm، والرأسان ذوا الـ 15 طرفًا يبعدان 22.86 mm (0.9 inch)، فهي تجلس على لوحة التجارب تاركة صف ثقوب حرًّا على كل جانب. يرسمها الشكل بهذا الحجم.
هذه هي V1.0 Amica، وهي اللوحة التي تحاكيها هذه القطعة. أما V3 "LoLin" التي يسميها الناس أيضًا NodeMCU فهي أعرض، بمسافة بوصة كاملة بين صفّي أطرافها: على لوحة التجارب لا تترك أي صف حر، ومن هنا جاءت شهرة هذه اللوحة بأنها تحتاج لوحتي تجارب.
الصف الأيسر، من الأعلى إلى الأسفل (15 ثقبًا): A0، RSV، RSVb، SD3، SD2، SD1، CMD، SD0، CLK، GND، 3V3، EN، RST، GNDb، VIN.
الصف الأيمن، من الأعلى إلى الأسفل (15 ثقبًا): D0، D1، D2، D3، D4، 3V3b، GNDc، D5، D6، D7، D8، RX، TX، GNDd، 3V3c.
30 طرفًا. الأسماء المكررة تحمل حرفًا لأن أسماء الأطراف في الفهرس فريدة.
أسماء الطباعة الحريرية ليست أرقام GPIO
هذا هو الشيء الوحيد الذي تخدع به هذه اللوحة الناس، لذلك كُتب هنا، وفي مقالة المساعدة، وفي صفحة اللوحة:
| الطباعة الحريرية | 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. بيئة التشغيل تُعرّف D0 إلى D8 بحيث يمكن للكود استخدام أيٍّ منهما، و crates/parts/src/parts/esp8266.rs يحتوي على اختبار يغطي الجدول كاملًا.
ثمانية أطراف غير متصلة بشيء
SD0، SD1، SD2، SD3، CMD وCLK هي GPIO 7 و8 و9 و10 و11 و6: وهي أسلاك ذاكرة الفلاش الستة، والبرنامج يعمل منها. وهي موجودة فعلًا على أطراف NodeMCU حقيقية، لذلك هي على هذه القطعة؛ لكنها هنا لا تقود ولا تُقرأ. الطرفان RSV كذلك الأمر. كودٌ اشتغل في محاكٍ لأنه استخدم SD1 سيوقف الفلاش على المنضدة الحقيقية، وهذا هو الشيء الوحيد الذي وُجدت هذه القطعة لمنعه.
A0 خلف مقسّم الجهد في اللوحة
طرف TOUT في الشريحة يحوّل من 0 إلى 1.0 V. لوحة NodeMCU تضع مقسّم جهد 220k/100k أمامه، لذا فإن A0 على صف الأطراف يستقبل من 0 إلى نحو 3.2 V تقريبًا، ومقاومة متغيرة عبر خط 3.3 V تغطي المدى تقريبًا بالكامل. المقسّم يعود للوحة لا للشريحة، لذلك يعيش في قطعة اللوحة: الطرف يحمّل شبكته بـ 320 k، وتُسلَّم للشريحة ثلث الجهد الذي يصل إلى طرفها. A0 ليس GPIO ولا يمكن الكتابة إليه.
المصباحان، وكلاهما يعمل بالمستوى المنخفض
- GPIO 2، وهو
D4، عليه مصباح LED الأزرق في وحدة ESP-12. وهو أيضًا طرف TX لوحدة UART1 في القطعة الحقيقية، ولهذا يفقده الكود الذي يستخدمSerial1. - GPIO 16، وهو
D0، عليه مصباح LED في لوحة NodeMCU الحاملة.
كلاهما موصّل من 3V3 إلى الطرف، لذا LOW يضيئهما. عكس هذا هو الخطأ الذي تُجيده هذه اللوحة في إثارته، لذلك probe يبلّغ عن كل مصباح بأنه مضاء عندما تكون نقطته منخفضة (القسم 5).
GPIO 16 ليس طرفًا عاديًا
D0 هو طرف RTC. لا يظهر في أي سجل من سجلات كتلة GPIO (له سجلات إخراج وتمكين وإدخال خاصة به في كتلة RTC، القسم 3.2)؛ وله مقاومة سحب للأسفل بينما لكل نقطة أخرى على القطعة مقاومة سحب للأعلى، ولا يمكنه رفع مقاطعة. على NodeMCU هو الطرف الذي توصّله بـ RST للاستيقاظ من النوم العميق، وهو D0، فليس غرابة يمكن للكود تجاهلها.
Electrical: every GPIO drives push-pull at 3.3 V through R_STRONG, sits high-Z, or pulls through 45 k. An input reads high at 1.65 V; a contended (Unknown) net reads 0, and a floating one reads noise, as on the Uno (docs/uno.md section 1); the board's boot straps hold GPIO0 and GPIO2 high and GPIO15 low when nothing else does. 3V3 drives 3.3 V at R_SUPPLY, VIN drives 5 V, the four grounds drive 0 V. RST and EN are tied to the same node here, as a NodeMCU ties them, with a 10 k pull-up to 3.3 V; pulling either below 1.65 V holds the core in reset. The capacitor beside that resistor is the board's power-on reset and is not modeled.
الترتيب الدقيق للطباعة الحريرية للصفين هو قراءة هذا النموذج لتوزيع أطراف NodeMCU V1.0 (Amica). أرقام GPIO تعود للشريحة وهي ما يعتمد عليه البرنامج الثابت؛ أما موضعها على الصف فهو ما تعتمد عليه المخططات. V3 LoLin تنقل طرفين منها فضلًا عن كونها أعرض، ودائرة مرسومة هنا ستحتاج إلى إعادة توصيل من أجل واحدة منها.
2. خريطة الذاكرة
| IRAM (التعليمات) | 32 KB عند 0x4010_0000 إلى 0x4010_7FFF |
| IROM (flash code and constants) | 0x4020_0000, read-only, up to 1,044,464 bytes |
| DRAM (البيانات) | 80 KB عند 0x3FFE_8000 إلى 0x3FFF_BFFF |
| قمة المكدس | 0x3FFF_C000 |
| UART0 | 0x6000_0000، القسم 3.4 |
| GPIO | 0x6000_0300، القسم 3.1 |
| RTC (GPIO16) | 0x6000_0700، القسم 3.2 |
| IO_MUX | 0x6000_0800، القسم 3.3 |
| SAR (TOUT) | 0x6000_0D00، القسم 3.5، من صنع هذا النموذج |
كل كتلة طرفية تشغل 0x100 هنا، لأنها على هذه القطعة فعلًا متقاربة إلى هذا الحد.
Three windows, as on the real part: the vectors, the exception entry and the startup code in iram1_0_seg (the 32 KB of instruction RAM), the rest of the code and every constant in irom0_0_seg, which a real ESP8266 reads from flash through the cache at 0x4020_0000, and the data in dram0_0_seg. Every ESP8266 linker script uses these names and these addresses.
The Arduino IDE gives a NodeMCU sketch 1,044,464 bytes of flash by default ("4MB (FS:2MB OTA:~1019KB)"), and that is the room here: code, literals, constants, startup code and the initial values of the variables, which is what the IDE adds up and the editor prints after a build. The flash window is a read-only view of the loaded image, not a cache: there are no misses and no timing, so a fetch from flash costs what a fetch from IRAM costs here. A store to it faults. Global variables are limited by the 80 KB of data RAM and a program over it is refused with "no room for the stack". Literal pools sit in front of their own functions (L32R reaches 256 KB backwards) and calls out of the startup code go through a register (CALL0 reaches 128 KB).
Every PT_LOAD segment must land inside one of those three ranges; anything else is refused with the offending address in the message, and the chip is left with no program.
The core resets with pc at the ELF entry point and every address register zero. There is no boot ROM: the real part's ROM loader, the flash reads, the cache set-up and the SDK's own initialization are absent, and firmware/esp8266/crt0.S makes the state it wants explicit.
3. سجلات الطرفيات
الجزء الموضّح أدناه فقط هو المنفَّذ. أي شيء آخر داخل كتلة مُسجَّلة في الخريطة يُقرأ على أنه 0 ويُحتسب وصولاً شاردًا؛ وأي شيء خارج كل الكتل يُعدّ خطأ وصول.
3.1 GPIO (0x6000_0300)
سبعة عشر طرفًا، لكن ستة عشر فقط موجودة هنا: GPIO من 0 إلى 15 عادية وGPIO 16 موجود في كتلة RTC بدلًا منها (القسم 3.2).
| الإزاحة | سجل |
|---|---|
0x00 |
GPIO_OUT |
0x04 |
GPIO_OUT_W1TS |
0x08 |
GPIO_OUT_W1TC |
0x0C |
GPIO_ENABLE |
0x10 |
GPIO_ENABLE_W1TS |
0x14 |
GPIO_ENABLE_W1TC |
0x18 |
GPIO_IN |
0x1C |
GPIO_STATUS |
0x20 |
GPIO_STATUS_W1TS |
0x24 |
GPIO_STATUS_W1TC |
0x28 + 4n |
GPIO_PINn، حيث n من 0 إلى 16 |
مُتحقَّق منه بقدر ما تسمح هذه القطعة: العنوان الأساسي وكل إزاحة هنا هي نفسها التي استخدمتها كل ترويسات ESP8266 وسكربتات الربط وأوصاف السجلات المفتوحة لمدة عقد، وهي ما يقدمه ESP8266 Technical Reference Manual من Espressif لكتلة GPIO. وهي ليست أرقامًا اختارها هذا النموذج.
البت 2 PAD_DRIVER في GPIO_PINn يجعل النقطة مُصرَّفة مفتوحة؛ البتات 7..9 INT_TYPE تختار ما يرفع مقاطعة الطرف: 0 إيقاف، 1 حافة صاعدة، 2 حافة هابطة، 3 أي حافة، 4 مستوى منخفض، 5 مستوى مرتفع. لا توجد مصفوفة GPIO على هذه القطعة: النقطة إما GPIO أو تابعة لطرفي آخر، ويُختار ذلك في IO_MUX.
لا توجد بت تمكين مقاطعة لكل طرف عدا INT_TYPE، ولا نصف ثانٍ لأي سجل، لأن ستة عشر بتًا هي كل ما تحتاجه الكتلة.
3.2 سجلات RTC خلف GPIO16 (0x6000_0700)
| الإزاحة | سجل | البتات |
|---|---|---|
0x68 |
RTC_GPIO_OUT |
البت 0 هو مستوى إخراج GPIO16 |
0x74 |
RTC_GPIO_ENABLE |
البت 0 هو مُشغِّل إخراج GPIO16 |
0x8C |
RTC_GPIO_IN_DATA |
البت 0 هو ما تراه نقطة GPIO16 |
0x90 |
RTC_GPIO_CONF |
bit 0 clear puts the pad under RTC_GPIO_ENABLE |
0xA0 |
PAD_XPD_DCDC_CONF |
البتات 0..1 تختار GPIO16 بدلًا من طرف DCDC |
مُعتقد أكثر من كونه موثّقًا. هذه الخمسة هي السجلات التي استخدمها كل تسلسل ESP8266 GPIO16 منذ 2015، وهي التي يكتبها نواة Arduino عبر pinMode(16, ...)، لكنها ليست صفحة من دليل مقتبسة كما هي. المقاومة على هذا الطرف هي مقاومة سحب لأسفل، بخلاف كل طرف آخر في القطعة.
لا شيء آخر في كتلة RTC مُحاكى: لا عدّاد RTC، ولا ذاكرة RTC، ولا نوم عميق، ولا مصدر تنبيه.
3.3 IO_MUX (0x6000_0800)
PERIPHS_IO_MUX_CONF_U عند 0x00، ثم سجل واحد لكل طرف. البتة 7 هي مقاومة السحب لأعلى الداخلية.
لا توجد بتة لتمكين المدخل في أي مكان، ولا مقاومة سحب لأسفل داخلية على GPIO من 0 إلى 15. صِدار مدخل ESP8266 مُفعّل دائمًا، وINPUT_PULLDOWN غير موجود في هذه القطعة؛ GPIO16 وحده له مقاومة سحب لأسفل، وهي في كتلة RTC. الكود الذي يريد سحبًا لأسفل يحتاج إلى مقاومة خارجية.
كما في ESP32، السجلات مرتبة حسب ترتيب الأطراف، لا حسب ترتيب GPIO:
| GPIO | الإزاحة | GPIO | الإزاحة |
|---|---|---|---|
| 0 | 0x34 |
8 | 0x24 |
| 1 | 0x18 |
9 | 0x28 |
| 2 | 0x38 |
10 | 0x2C |
| 3 | 0x14 |
11 | 0x30 |
| 4 | 0x3C |
12 | 0x04 |
| 5 | 0x40 |
13 | 0x08 |
| 6 | 0x1C |
14 | 0x0C |
| 7 | 0x20 |
15 | 0x10 |
مُعتقد أكثر من كونه موثّقًا. لا يمتلك GPIO16 سجل IO_MUX أصلًا.
3.4 UART0 (0x6000_0000)
| الإزاحة | سجل |
|---|---|
0x00 |
UART_FIFO |
0x04 |
UART_INT_RAW |
0x08 |
UART_INT_ST |
0x0C |
UART_INT_ENA |
0x10 |
UART_INT_CLR |
0x14 |
UART_CLKDIV |
0x1C |
UART_STATUS |
0x20 |
UART_CONF0 |
0x24 |
UART_CONF1 |
Verified: the base and every offset, and the bits below, against the ESP8266 Technical Reference v1.7, appendix 3 "UART Registers". The offsets are the ESP32's and the ESP32-C3's, but this part's fields are narrower, so crates/esp8266/src/uart.rs is no longer crates/esp32/src/uart.rs twice.
ذاكرتا FIFO بسعة 128 بايت لكل منهما. بتات UART_STATUS من 0 إلى 7 هي RXFIFO_CNT والبتات من 16 إلى 23 هي TXFIFO_CNT، والنموذج وبيئة التشغيل يقرآن حقولًا من ثماني بتات هناك، كما يعطيها الملحق 3. كانت بيئة التشغيل تقرأ عشر بتات سابقًا، وهو ما أعطى الأرقام نفسها لأن البتات فوق كل حقل محجوزة وتُقرأ 0؛ أما الملف الرأسي فيطابق الدليل الآن، كما في ESP32 حيث البتات العليا غير محجوزة. البتة 17 من UART_CONF0 هي RXFIFO_RST والبتة 18 هي TXFIFO_RST. بتات UART_CONF1 من 0 إلى 6 هي RXFIFO_FULL_THRHD والبتات من 8 إلى 14 هي TXFIFO_EMPTY_THRHD، وكلتاهما 96 عند إعادة الضبط. بتات UART_CLKDIV من 0 إلى 19 هي المقسّم، الذي يقسم ساعة APB البالغة 80 MHz ويُعاد ضبطه إلى 694 (أي 0x2B6 كما في الملحق)، أي 115 274 باود.
ثلاثة من تلك كانت خاطئة هنا قبل ذلك الفحص، ولم يغيّر أي منها صورة مبنية: بتّا إعادة ضبط FIFO كانتا معكوستان (دالة Serial.begin في بيئة التشغيل تضبطهما وتمسحهما معًا، فكانت القيمة المكتوبة نفسها)؛ وكان CONF1 يحمل حقول ESP32-C3 التسع بتات عند 0 و9 (بيئة التشغيل لا تكتب CONF1 أبدًا)؛ وكانت وتيرة الإرسال تقرأ اثنتي عشرة بتة فقط من المقسّم، فكان Serial.begin(9600)، الذي مقسّمه 8333، يرسل البايتات أسرع بنحو 59 مرة. تستخدم الوتيرة الآن البتات العشرين كلها.
تخرج البايتات من ذاكرة FIFO الخاصة بالإرسال بمعدل الباود، لا فورًا، للسبب الذي يذكره القسم 3.3 من docs/esp32.md. يقيس crates/esp8266/tests/runtime.rs الفاصل بين بايتين من مثال serial مقابل 86.8 us التي يستغرقها البايت عند 115200.
UART1 غير مُحاكى. على ESP8266 حقيقي، يكون إرسال UART1 على GPIO 2، وهو نفسه LED الوحدة، وهذا هو السبب كله في استحالة الجمع بين Serial1 وLED الأزرق.
3.5 The TOUT converter (0x6000_0D00): the one block that is not the chip's
اقرأ هذا قبل أن تصدّق أي عنوان. كل جهاز طرفي آخر في هذا النموذج عند عنوانه الحقيقي بإزاحاته الحقيقية، لذا البرنامج الثابت المبني هنا يعمل على NodeMCU حقيقي. المحوّل ADC هو الاستثناء، وليس استثناءً صغيرًا. لم تنشر Espressif قط سجلات SAR الخاصة بـ ESP8266: دالة system_adc_read() تعيش داخل ملف SDK الثنائي المغلق، ونواة Arduino تستدعيها، ولا توجد صفحة في دليل يمكن اقتباسها. وبدلًا من اختلاق عنوان وترك القارئ يظنه من الشريحة، يضع هذا النموذج ثلاثة سجلات من عنده هو عند SAR_BASE:
| الإزاحة | سجل | البتات |
|---|---|---|
0x00 |
SAR_CFG |
البتة 0 START تبدأ التحويل؛ والبتة 1 مخزّنة ولا تفعل شيئًا |
0x04 |
SAR_STATUS |
البتة 31 هي DONE، والبتات من 0 إلى 9 هي النتيجة ذات العشر بتات |
غير مُتحقَّق منه، بل هو أكثر من ذلك: مُختلَق. الاستدعاء الوحيد على هذه اللوحة الذي يحتاج إلى تعديل للعتاد الحقيقي هو analogRead. إنه system_adc_read() من SDK. لا شيء غيره يحتاج إلى ذلك.
ما يُحاكى فعليًا هو ما تستطيع الدائرة رؤيته: قناة واحدة، عشرة بتات، round(1023 x Vin / 1.0 V)، بقيمة مقيّدة، لجهد طرف الشريحة. مقسّم 220k/100k في NodeMCU هو جزء من اللوحة (القسم 1)، لذا المدى الكامل للملف الرأسي حوالي 3.2 فولت. الطرف A0 غير الموصول يتشوّش كما يفعل المدخل العائم (docs/uno.md القسم 1).
تستغرق عملية التحويل وقتًا ثابتًا قدره 80 us من وقت المحاكاة. الرقم الحقيقي يعتمد على حلقة أخذ العينات في الـ SDK وهو أقرب إلى مئة ميكروثانية، وهذا هو الرقم الوحيد في هذه الكتلة الذي يُعد اختيارًا من نموذج المحاكاة لا قياسًا، وهو مذكور في القسم 6.
3.6 The clock: CCOUNT, and no timer peripheral
FRC1 وFRC2 غير مُحاكيين. يحتوي ESP8266 على مؤقّتين عتاديين، وليس أي منهما موجودًا هنا. الساعة التي يقرأها مشغّل هذه اللوحة هي ساعة النواة نفسها CCOUNT، ونبضتها بالميلي ثانية وكذلك PWM البرمجي يأتيان منها CCOMPARE0. كلاهما سجلّان أساسيان في كل معالج Xtensa، فلا يوجد عنوان طرفيّ مفترض وراءهما millis().
The cost is written down rather than hidden. CCOUNT is thirty-two bits at 80 MHz, so it wraps every 53.7 seconds. The sixty-four-bit count the runtime hands out is kept by sampling CCOUNT and adding the difference, which is exact as long as no more than one wrap happens between two samples. Every millis(), micros() and delay() samples it, and the scheduler never lets the next interrupt be more than 2^30 cycles (13.4 seconds) away. So only a sketch that turns interrupts off for a minute and asks the time for nothing in that minute can lose a wrap. Section 6 says so again.
يقيس crates/esp8266/tests/runtime.rs دالة millis() مقابل ساعة النواة نفسها على مدى خمس ثوانٍ.
3.7 إشارة PWM، وهي برمجية على هذه القطعة
لا يملك ESP8266 أي عتاد PWM على الإطلاق: لا يوجد LEDC ولا شيء. نواة Arduino لـ ESP8266 تولّد موجاتها من معالج مؤقّت، ويفعل وقت التشغيل هذا مثله: ثمانية خانات، في كل خانة طرف وزمن مرتفع وزمن منخفض بوحدات دورات المعالج، وموعد CCOMPARE0 المشترك مضبوط على الحافة التالية أيًّا كانت.
هذا هو الفرق الصادق بين لوحتي Xtensa هنا. على ESP32 لا تكلّف LED المتلاشي النواة شيئًا، لأن LEDC عتاد والمحاكي يوقظ اللوحة عند الحافة فقط. أما على ESP8266 فتستيقظ النواة مرتين في كل دورة لتحريك الطرف بنفسها، وهذا بالضبط ما تكلفه القطعة الحقيقية، ويظهر ذلك في عدد التعليمات. صفحة اللوحة تقول ذلك أيضًا.
ثمانية أطراف في آنٍ واحد. التردد الافتراضي هو 1 kHz وتقبل analogWriteFreq المدى من 40 Hz إلى 60 kHz. يحافظ crates/esp8266/tests/runtime.rs على دورة مثال fade عند 1 kHz ضمن اهتزاز بقدر معالج واحد، لا بقدر الميكروثواني الخمس الخاصة بـ ESP32، لأن اهتزازًا بقدر معالج واحد هو ما تملكه إشارة PWM البرمجية.
المدى هو 1023 وليس 255؛ انظر القسم 7.
3.8 ما لا يملك سجلّات هنا إطلاقًا
منفذ SPI ومنفذ HSPI، وI2C (لا توجد وحدة I2C طرفية في هذه القطعة أصلًا؛ نواة Arduino تنفّذه برمجيًا بتقنية bit-bang)، وI2S، ومنفذ UART1 العتادي، وعدّاد الـ RTC وذاكرته، والنوم العميق، وeFuses، وكامل طبقتَي WiFi MAC وPHY.
3.9 صندوق بريد شبكة Mokxi (0x6FFF_E000)
هذه الكتلة ليست ملك ESP8266. كل ما عداها في هذا المستند إمّا يخصّ القطعة نفسها أو موسوم كابتكار خاص بهذا النموذج مع ذكر السبب بجانبه (القسم 3.5، محوّل TOUT). وهذا ليس أيًّا منهما: إنها شبكة crates/net التي تحاكيها Mokxi، في أعلى نافذة الأطراف الطرفية التي تقبع كتلها الحقيقية كلها في أوائل كيلوبايتاتها، بحيث أي صورة تستخدمها تسبب خطأً على السيليكون بدلًا من قراءة سجل طرف آخر. ذلك الخطأ هو الجواب الصادق، لأن ما يقبع خلف هذه الكتلة غير موجود على الشريحة. لا شيء هنا مأخوذ من SDK الخاص بـ Espressif ولا من نواة Arduino ESP8266.
هذه هي القطعة ذات الراديو التي لا توثيق لها إطلاقًا. إن WiFi الخاص بـ ESP8266 كتلة ثنائية داخل الـ SDK؛ لم تنشر Espressif سجلاته قط، وهذا النموذج لا يخمّنها. ما يقدّمه بدلًا من ذلك صندوق بريد هو بصدق ملك Mokxi، على عنوان لا يخصّ القطعة بصدق.
لا ترفع هذه الكتلة أي مقاطعة. أرقام المقاطعات التي يستخدمها هذا النموذج هي ما تتفق عليه كل ترويسات ESP8266، ولا يوجد رقم كهذا لطرفٍ لا تملكه الشريحة، لذا لم يُعطَ صندوق البريد أيًّا منها. البرنامج الثابت يستعمل الاستطلاع، والنواة المتوقفة في waiti تُوقظ مع ذلك عندما يكون لدى الشبكة ما تقوله.
لا يوجد هنا لا راديو، ولا 802.11، ولا إنترنت حقيقي. لا شيء في النموذج يرسل أو يمسح أو يرتبط أو يشفّر أو يفتح مقبسًا: كلمة المرور تُقارن كسلسلة نصية، والاسم الذي لا يقع تحت .mokxi لا يُحلّ، والأصول الثلاثة التي تخدمها الشبكة هي دوال في crates/net/src/http.rs. صندوق البريد هو شكل الفاصل الحقيقي وليس خيالًا عن MAC: على ESP32 حقيقية، عتاد WiFi هو كتلة ثنائية مغلقة ذات واجهة أوامر، وتنتهي مكتبة WiFi.h الخاصة بـ Arduino على الجانب الآخر من إحدى هذه الواجهات. docs/wifi.md هو العقد الذي يحدد ما خلفها؛ هذا القسم هو السجلات فقط.
سجل أوامر، وسجل حالة، وذاكرة حلقية بحجم 4096 بايت في كل اتجاه، وبت مقاطعة. كتابة NET_CMD_REG تشغّل الأمر؛ الأمر الذي يستغرق وقتًا في المحاكاة يرفع BUSY ثم يمسحه، مع DONE في NET_INT_RAW_REG، عند اكتماله.
| الإزاحة | الاسم | البتات |
|---|---|---|
0x00 |
NET_ID_REG |
يقرأ 0x494B4F4D، ولا شيء آخر يقرأه. الكود الذي يريد معرفة إن كان يعمل على Mokxi يقرأ هذا؛ أما على الرقاقة الحقيقية فيفشل الوصول |
0x04 |
NET_CMD_REG |
اكتب كود أمر (الجدول أدناه)؛ الكتابة تشغّله |
0x08 |
NET_ARG_REG |
وسيطة واحدة من كلمة، تُقرأ مجددًا: المنفذ لأمر LISTEN، والحالة لأمر REPLY |
0x0C |
NET_STATUS_REG |
البت 0 BUSY، البت 1 ERR، البت 2 RX_READY، البت 3 LINK، البت 4 SERVE، البتات 8..11 STATE |
0x10 |
NET_RESULT_REG |
ما أجاب به الأمر الأخير |
0x14 |
NET_INT_RAW_REG |
البت 0 DONE، البت 1 EVENT |
0x18 |
NET_INT_ENA_REG |
نفس البتّين |
0x1C |
NET_INT_CLR_REG |
اكتب 1 للمسح، نفس البتّين |
0x20 |
NET_TX_LEN_REG |
البايتات المجهّزة في حلقة الإرسال |
0x24 |
NET_TX_DATA_REG |
كتابة: ادفع بايتًا واحدًا (البتات 0..7) إلى حلقة الإرسال |
0x28 |
NET_RX_LEN_REG |
البايتات المنتظرة في حلقة الاستقبال |
0x2C |
NET_RX_DATA_REG |
قراءة: أخرج بايتًا واحدًا من حلقة الاستقبال، ويكون 0 عند فراغها |
0x30 |
NET_RING_LEN_REG |
سعة كل حلقة بالبايتات، حتى لا يضطر البرنامج الثابت إلى تثبيت 4096 في الكود |
0x40 |
NET_BT_CMD_REG |
Bluetooth: اكتب رمز أمر Bluetooth (docs/bluetooth.md)؛ الكتابة تشغّله |
0x44 |
NET_BT_ARG_REG |
Bluetooth: كلمة وسيطة واحدة، تُقرأ مجددًا؛ الحدث يترك رقمه هنا |
0x48 |
NET_BT_RESULT_REG |
Bluetooth: ما أجاب به أمر Bluetooth الأخير |
0x4C |
NET_BT_STATUS_REG |
البت 0 CLASSIC_ON، البت 1 CLASSIC_LINK، البت 2 EVENT، البت 3 BLE_ADV، البت 4 BLE_LINK، البت 5 BT_ERR، البت 8 HAS_CLASSIC، البت 9 HAS_BLE |
0x50 |
NET_BT_TX_LEN_REG |
Bluetooth: البايتات المجهّزة في حلقة الإرسال الخاصة به |
0x54 |
NET_BT_TX_DATA_REG |
Bluetooth: كتابة: ادفع بايتًا واحدًا إلى تلك الحلقة |
0x58 |
NET_BT_RX_LEN_REG |
Bluetooth: البايتات المنتظرة في حلقة الاستقبال الخاصة به |
0x5C |
NET_BT_RX_DATA_REG |
Bluetooth: قراءة: أخرج بايتًا واحدًا، ويكون 0 عند الفراغ |
سجلات NET_BT_ الثمانية تُقرأ 0 وتتجاهل الكتابة على هذه اللوحة: فـ ESP8266 لا يحتوي على Bluetooth (docs/bluetooth.md).
STATE يدل على حالة المحطة: 0 خاملة، 1 تبدأ بالعمل، 2 تتصل، 3 متصلة، 4 فشلت، 5 لا توجد شبكة بهذا الاسم. NET_CMD_STATUS يحوّل الشيء نفسه إلى رمز wl_status_t الخاص بـ Arduino الذي يقرأه الكود من WiFi.status().
NET_CMD_REG |
الاسم | ما يفعله |
|---|---|---|
| 0 | NOP |
لا شيء |
| 1 | RESET |
قطع الاتصال، وإسقاط الحلقتين، وإسقاط أي طلب |
| 2 | CONNECT |
تحمل حلقة الإرسال ssid\0password؛ يرفع BUSY لمدة ثانية إلى ثلاث ثوانٍ |
| 3 | DISCONNECT |
قطع الاقتران والعنوان |
| 4 | STATUS |
NET_RESULT_REG = رمز wl_status_t |
| 5 | IP |
NET_RESULT_REG = العنوان المستأجر، والمجموعة الثمانية الأولى في البايت المنخفض |
| 6 | RSSI |
NET_RESULT_REG = الإشارة بوحدة dBm، بعد تمديد بت الإشارة |
| 7 | SSID |
تستقبل حلقة الاستقبال اسم نقطة الوصول |
| 8 | MAC |
تستقبل حلقة الاستقبال بايتات MAC الستة للوحة |
| 9 | REQUEST |
تحمل حلقة الإرسال الصادرة method\0url\0headers\0body؛ وتطلق BUSY |
| 10 | POLL |
NET_RESULT_REG = 0 أثناء التنفيذ، ثم حالة HTTP، أو خطأ سالب مع رفع ERR؛ ويهبط المتن في حلقة الاستقبال |
| 11 | LISTEN |
استمع على المنفذ الموجود في NET_ARG_REG |
| 12 | ACCEPT |
NET_RESULT_REG = 1 وتحمل حلقة الاستقبال method\0path\0query\0body، أو 0 عندما لا ينتظر شيء |
| 13 | REPLY |
أجب على الطلب المقبول بالحالة الموجودة في NET_ARG_REG؛ وتحمل حلقة الإرسال content-type\0body |
| 14 | STOP |
أوقف الاستماع |
| 15 | WL_GPIO_SET |
يشغّل أطراف GPIO الخاصة بالقطعة اللاسلكية من NET_ARG_REG. ليست هذه اللوحة: راديو هذه القطعة لا يمتلك مثل هذا الطرف، لذا يرفع ERR ولا يشغّل شيئًا. إنه المسار الذي يسلكه LED المدمج في Pico W (docs/picow.md قسم 3.8) |
| 16 | WL_GPIO_GET |
تُقرأ مجددًا، ونفس ERR هنا |
| 17 | BLYNK |
عملية واحدة على خادم Blynk المحاكى، العملية في NET_ARG_REG وحقولها في حلقة الإرسال؛ وتُجاب فورًا في NET_RESULT_REG، مع رفع ERR بمعزل عن الشبكة (docs/wifi.md، "Blynk") |
| 20 | SOFTAP |
نقطة الوصول الناعمة (crates/net/src/softap.rs، docs/wifi.md)، العملية في NET_ARG_REG: 1 ترفعها (حلقة الإرسال ssid\0password\0 وبايت القناة؛ وNET_RESULT_REG بقيمة 1، أو 0 مع ERR لاسم فارغ أو كلمة مرور من حرف إلى سبعة أحرف)، 2 تخفضها، 3 تضبطها (العنوان والبوابة وقناع الشبكة، أربعة بايتات لكل منها)، 4 عنوانها (0 وهي مخفضة)، 5 المحطات المنضمة، 6 الانضمامات والمغادرات وبتّ الرفع التي يحوّلها وقت التشغيل إلى أحداث، 7 و8 تشغيل خادم DNS لبوابة أسيرة (الاسم، وبايت صفر، والعنوان) وإيقافه، 9 اسمها إلى حلقة الاستقبال، 10 عنوان الهاتف، 11 Host للطلب الجاري خدمته إلى حلقة الاستقبال. المحطة الوحيدة هي هاتف لوحة الويب |
رموز POLL السالبة: -1 الاسم لا يُحلّ، -2 المحطة غير مقترنة، -3 https:// وTLS غير محاكى، -4 متن أطول من الحلقة، -5 عنوان URL لا تستطيع هذه الشبكة تحليله، -6 طلب قيد التنفيذ بالفعل. firmware/include/HTTPClient.h يحوّلها إلى الرموز على طريقة Arduino التي يقارنها الكود بها، وdocs/wifi.md يسرد المطابقة.
التوقيت، كله من هذا النموذج وكله مذكور في docs/wifi.md: يستغرق الاقتران بين ثانية وثلاث ثوانٍ، محددًا من SSID حتى يستغرق الدرس الوقت نفسه مرتين؛ كلمة المرور الخاطئة تصبح WL_CONNECT_FAILED بعد خمس ثوانٍ؛ الطلب إلى أصل محاكى يعود بعد 60 ms؛ والطلب إلى خادم الكود نفسه الذي لا يجيبه الكود أبدًا تغلقه الشبكة بخطأ 504 بعد عشر ثوانٍ.
3.10 عمليات إعادة التعيين وكلاب الحراسة (0x6000_0700، 0x6000_0900)
لا توثّق Espressif هذه السجلات: فالـ SDK والـ ROM يشغّلانها عبر كود مغلق. الأسماء والإزاحات هنا هي ما تستخدمه esp8266_peri.h ودالتا الـ ROM rtc_get_reset_reason() وsoftware_reset() بقدر ما هو معروف، والنموذج يأخذها كأمور مفترضة لا مُتحقَّق منها. كلب الحراسة العتادي: البت 0 في WDTCTL يشغّله، وكتابة 0x73 في WDTFEED (0x14) تُطعمه، ومرور 2^23 µs (نحو 8.4 ثوانٍ) دون إطعام يعيد تعيين الشريحة. الـ RTC: البت 31 في 0x00 هو إعادة التعيين البرمجية للنظام، والبتات 3:0 في 0x14 سبب إعادة التعيين لدى الـ ROM (1 عند التشغيل بالطاقة، 2 لإعادة تعيين برمجية، 4 لكلب الحراسة)، و0x30..0x3C أربعة سجلات تخزين تنجو من كل إعادة تعيين عدا تشغيل الطاقة.
The runtime (firmware/esp8266/src/time.c) is the SDK's: the software watchdog counts the hardware one's 1.6 s first stage, feeding it when the sketch has yielded (loop() returned, delay(), yield(), ESP.wdtFeed()) and, on the second tick in a row that finds it has not (3.2 to 4.8 s after it last yielded), prints the Arduino core's "Soft WDT reset" postmortem (exception 4, the epc, the stack dump between the cut lines) and resets. ESP.wdtDisable() stops only the software watchdog, as on the board, which leaves the hardware one; ESP.getResetReason() and getResetInfo() say which it was.
4. النواة: أي ABI، وكيف تصل المقاطعة
crates/xtensa-core هو نفس المفسّر الذي يعمل عليه ESP32، في تهيئة LX106. لا شيء فيه مشتق من QEMU ولا من SDK الخاص بـ Espressif ولا من نواة Arduino ESP8266 ولا من أي محاكٍ آخر؛ استُخدم xtensa-lx106-elf-as كأداة قياس على المنضدة، ويحفظ crates/xtensa-core/tests/encoding.rs الترميزات التي عادت بها.
واجهة call0 الثنائية، ولم يكن ثمة خيار. يمتلك LX106 ستة عشر سجلًا ولا نافذة سجلات إطلاقًا، لذا يُصدر xtensa-lx106-elf-gcc تعليمات call0 وret وaddi sp, sp, -16 صريحة. لا ENTRY ولا RETW ولا ROTW ولا سكب ولا معالجات فائض أو عجز نافذة لكتابتها. crt0.S هنا أقصر بكثير من نظيره في ESP32 لهذا السبب الواحد، وجدول متجهاته أقصر بستة خانات. متجهات النافذة عند VECBASE + 0x000 إلى +0x140 لا يمكن بلوغها على قطعة بلا خيار النوافذ، لذا تحمل قفزة إلى مبلّغ الأخطاء بدلًا من أي شيء يعثر عليه في الذاكرة.
والنتيجة الأخرى أن معالج المقاطعات في هذه اللوحة قد يحفظ السجلات على المكدس المُقاطَع، خلافًا لمعالج ESP32: فبلا نافذة لا يوجد إطار أقدم يتعلق بمؤشر مكدس هذه النافذة.
ما لا تتضمنه تهيئة LX106، وقد رُفع كل اختلاف إلى المُجمِّع بدلًا من افتراضه: القسمة العتادية، وضرب الـ 32 بت العالي، وMIN/MAX، وSEXT، وCLAMPS، وحلقة التكرار بلا كلفة إضافية، وعمليات التحميل الذرّية. أما MUL16 وMULL فموجودان. لذلك يفشل البرنامج المبني لـ ESP32 على هذه النواة بخطأ بدلًا من أن يسلك سلوكًا خاطئًا بصمت، ولهذا تختلف سلسلتا program بين اللوحتين.
المتجهات. VECBASE سجل خاص؛ والسجلان المهمّان هنا هما KernelException في +0x300 و UserException في +0x340. Every level-1 interrupt takes the user exception vector with EXCCAUSE 4، لذا فإن crt0.S يرسلها كلها إلى موضع واحد، وبيئة التشغيل تستنتج أيّ المصدر كان.
Interrupts. INTENABLE masks and PS.INTLEVEL gates, and only level 1 is modeled. Every interrupt the ESP8266 brings out is level 1 except the NMI, which is not modeled, so the level-1 mask here is all ones. That is believed rather than verified.
لا توجد مصفوفة مقاطعات على هذه القطعة: لكل مصدر رقم مقاطعة ثابت للمعالج، ولهذا فإن attachInterrupt هنا كتابتان لا ثلاث كما في ESP32.
| المصدر | مقاطعة المعالج |
|---|---|
| GPIO | 4 |
| UART0 | 5 |
CCOMPARE0 |
6 |
مُصدَّق بالاعتقاد لا بالتحقق. الرقم 4 هو ما تسميه كل ترويسات ESP8266 بـ ETS_GPIO_INUM والرقم 5 هو ETS_UART_INUM؛ فهما ليسا رقمين منقولين من دليل. أما 6 الخاصة بـ CCOMPARE0 فهي من Xtensa ISA.
الفاصلة العائمة. لا FPU في LX106، فلا شيء هنا لحذفه: كل ترميز فاصلة عائمة يرفع EXCCAUSE 32، المعالج المساعد معطّل، وبيئة التشغيل تعتمد الفاصلة العائمة البرمجية، وهو ما يحصل عليه كود ESP8266 حقيقي أيضًا.
تنطبق هنا قواعد CCOMPARE في القسم 4 من docs/esp32.md (المقارنة هي "بلغ الموعد أو تجاوزه"، وموعدٌ في الماضي أصلًا لا يُفعَّل)، وهذه اللوحة هي التي كشفت القاعدة الثانية منهما.
5. نموذج الزمن، والمجس، والكتابة المباشرة، وقناة المضيف
يعمل المعالج عند 80 MHz بتعليمة واحدة لكل دورة، فالتعليمة الواحدة تستغرق 12.5 ns بالضبط، وشريحة من 800 تعليمة تستغرق 10 µs بالضبط. وخلافًا لناقل ESP32، يستطيع هذا الناقل الضرب بدل القسمة: التعليمة k تكتمل عند slice_start + 12.5 ns * k.
يمكن تشغيل ESP8266 عند 160 MHz. هذا النموذج دائمًا عند 80، وهو التردد الذي تُقلع عنده القطعة وتتركه نواة Arduino؛ ولا توجد هنا شجرة ساعة لتغييره بها.
داخل الشريحة يكون عدد التعليمات هو الساعة: قراءة CCOUNT، وبايت UART، وتغيّر طرف، كلها تهبط عند التعليمة التي سبّبتها. والنواة المتوقفة في WAITI لا تكلف شيئًا، وتُوقظ عند موعد CCOMPARE0 التالي لها (تكة الميلي ثانية، أو delay يستفيق، أو الحافة التالية لـ PWM البرمجي) أو بتغيّر طرف أو ببايت من المضيف.
probe هو قناع بتّات:
| البت | المعنى |
|---|---|
| 1 | قيد التشغيل |
| 2 | متوقفة في waiti |
| 4 | LED الوحدة على GPIO 2 مضاء |
| 8 | LED لوحة الحمل على GPIO 16 مضاء |
0 means no program, held in reset, or crashed. Both LEDs are active low, so each bit is set when its pad is low.
poke: 1 تحتجز FLASH (GPIO 0 منخفض)، و0 تُطلقها؛ و2 تحتجز RST، و3 تُطلقه.
قناة المضيف. يضع host_write البايتات في FIFO استقبال UART0؛ ويأخذ host_read البايتات التي خرجت من FIFO إرساله. هذه هي Serial في الكود والشاشة التسلسلية في الواجهة. البايتات هي UTF-8 من منظور الواجهة، وغير شفافة من منظور النموذج. منفذ micro-USB في لوحة NodeMCU يذهب إلى جسر CP2102 أو CH340 عبر هذا المنفذ؛ الجسر غير مُنمذَج، وكذلك رقصة الإعادة التلقائية عبر DTR/RTS.
انهيار. بعد 1000 مصيدة متتالية دون أي تقدّم، يُعلَن انهيار النواة وتُوقَف، مع تسجيل مكان توقفها.
6. ما الذي يكون هذا النموذج واثقًا منه وما لا يكون واثقًا منه
أكثر ما تقترب هذه القطعة من الواقع
ليس لدى ESP8266 مرجع تقني كمرجع ESP32 (مرجع Espressif قصير ويترك كتلًا كاملة)، لذا فإن "مُتحقق منه" هنا تعني أن الرقم هو ما استخدمته كل ترويسات ESP8266 وسكربتات الوصل وأوصاف المسجلات المفتوحة لعقد كامل، وهو ما تعطيه قائمة المسجلات الرسمية. وفقًا لهذا المعيار:
UART0_BASE 0x6000_0000, GPIO_BASE 0x6000_0300, IOMUX_BASE 0x6000_0800 and RTC_BASE 0x6000_0700. Every register offset inside the GPIO block and inside UART0, and UART0's CONF0 FIFO resets, CONF1 thresholds, CLKDIV width and STATUS counts, each checked against appendix 3 of the ESP8266 Technical Reference v1.7 (section 3.4). The iram1_0_seg at 0x4010_0000 with 32 KB and the dram0_0_seg at 0x3FFE_8000 with 80 KB. The seventeen GPIOs, that 6 to 11 are the flash, and that 16 is the RTC's pin and is in no GPIO register. The D0 to D8 silkscreen table. The module's LED on GPIO 2 and the carrier board's on GPIO 16, both active low. The 220k/100k divider on A0. That there is no PWM hardware, no input-enable bit and no pull-down on GPIO 0 to 15. The Xtensa vector offsets and EXCCAUSE numbers, which are the ISA's.
مُعتقَد، غير مُتحقَّق منه
- جدول ترتيب أطراف IO_MUX (القسم 3.3).
- مسجلات RTC الخمسة خلف GPIO16 (القسم 3.2).
- أرقام مقاطعات المعالج: GPIO لها 4، وUART0 لها 5 (القسم 4). وهي
ETS_GPIO_INUMوETS_UART_INUM، لا أرقامًا مكتوبة نصًّا. - The level-1 interrupt mask, taken to be every interrupt the part brings out (section 4).
كلها في مكان واحد يقرأه البرنامج الثابت، firmware/esp8266/include/esp8266.h، بحيث يكون أمام صورة متجهة إلى سيليكون حقيقي قائمة قصيرة من #define للتحقق منها. ويُمسك crates/esp8266/tests/contract.rs تلك الترويسة وcrates/esp8266/src/map.rs على الأرقام نفسها؛ لكنه لا يجعل أيًّا منهما صحيحًا.
مُخترع، ومُسمّى على أنه مُخترع
- مسجلات SAR الثلاثة عند 0x6000_0D00 (القسم 3.5).
SAR_CFGوSAR_STATUSوبتّاتهما تخص هذا النموذج، لأن ما يخص الشريحة غير منشور.analogReadهي النداء الوحيد على هذه اللوحة الذي يحتاج تغييرًا ليعمل على NodeMCU حقيقية.
منمذج، لكن ليس بأرقام القطعة
- التحويل يستغرق 80 us بالضبط. الرقم الحقيقي يعتمد على حلقة أخذ العينات في SDK وهو أقرب إلى المئة.
- المحوّل ADC خط مستقيم على مدى 0 إلى 1.0 V عند طرف الشريحة، والمقسّم هو 100/320 بالضبط.
- الساعة دائمًا 80 MHz. لا 160 MHz، ولا شيء للتبديل إليه.
RSTوENمقاومة سحب لأعلى 10 k فقط؛ ومكثف إعادة التعيين عند التشغيل غير منمذج.- لا توجد ذاكرة ROM للإقلاع.
POWER_ONهنا هي 1 us؛ أما ESP8266 حقيقية فتقضي وقتًا أطول بكثير في محمّل ROM وتطبع رسالة الإقلاع بمعدل 74880 باود التي لا تطبعها هذه اللوحة أبدًا. micros64()قد تفقد دورة التفاف إذا حُجبت المقاطعات لأكثر من 53.7 ثانية ولم يسأل أحد عن الوقت في تلك النافذة (القسم 3.6).- PWM البرمجي يرتجف بمقدار معالج مقاطعة، لأنه برمجي (القسم 3.7). وهذا ما تفعله القطعة الحقيقية أيضًا.
- كل طرف يستيقظ بالحالة نفسها: GPIO عادي، دون سحب.
مُستبعد عمدًا
- WiFi، بكل أشكاله. لا راديو، ولا PHY، ولا MAC، ولا حزمة برمجيات، ولا
ESP8266WiFi.h، ولا حتى stub يفشل بأدب. على قطعة كل سبب وجودها هو WiFi، هذا أكبر ناقص، وصفحة اللوحة تقوله أولًا لا آخرًا. - Flash and the cache that maps it. Code and constants are read from a fixed, read-only window (section 2): no cache to miss, no SPI flash device, no 32-bit-only access rule for it, and no SPIFFS, LittleFS or OTA.
FRC1وFRC2، المؤقتان العتاديان (القسم 3.6). أما كلاب الحراسة ففي القسم 3.10.- النوم العميق وRTC، مع عدّاده وذاكرته، والإيقاظ عبر GPIO16-to-RST.
- SPI وHSPI وI2S وUART1 العتادي (القسم 3.8).
- الـeFuses ومعرّف الشريحة.
- كل مستوى مقاطعة أعلى من الواحد، وNMI.
لهذا لا تعمل هنا ثنائيات SDK للبائع وArduino core، بينما تعمل البرامج الثابتة المبنية وفقًا لهذه الوثيقة.
صورة ESP32 لن تعمل هنا أيضًا. سلسلة program في الفهرس هي elf32 xtensa lx106 esp8266 مقابل elf32 xtensa lx6 esp32 للوحة DevKit، وهذا فرق حقيقي: لا يملك LX106 نافذة مسجلات، فأول entry في صورة ذات نوافذ هو تعليمة غير قانونية لا إجابة خاطئة خفية.
7. بيئة تشغيل البرنامج الثابت (firmware/esp8266/)
بيئة تشغيل على شكل Arduino: setup() وloop()، وpinMode، وdigitalWrite، وdigitalRead، وshiftOut، وanalogRead، وanalogWrite مع تحكمها في المدى والتردد، وmillis، وmicros، وmicros64، وdelay، وdelayMicroseconds، وattachInterrupt، وSerial، وmap، وrandom. لا Arduino core، ولا Espressif SDK، ولا libc.
المشيدات الساكنة تخرج هنا من .ctors لا من .init_array. إصدار Espressif من GCC 8.4 مهيّأ بلا --enable-initfini-array ولا يحتوي على -fuse-init-array، لذا ينتهي مُنشئ الكائن العام في .ctors بينما كل سلاسل أدوات أخرى في هذا المستودع تُصدره في .init_array. link.ld يجمع الاثنين في نطاق واحد crt0.S يمرّ عليه. من دونه، فإن كودًا يحتوي على كائنًا عامًا (WebServer server(80) في wifilamp) سيربط ويعمل ثم يجد أعضاءه أصفارًا. يمرّ على الاثنين في جولة واحدة و .ctors لا يُعكس، لأن ترتيب تنفيذ المُنشئات عبر وحدات الترجمة غير محدد في ++C ولا يجوز أن يعتمد الكود عليه.
LED_BUILTIN هي 2: LED الوحدة، نشط بمستوى منخفض. وFLASH_BUTTON هي 0. وD0 إلى D8 وRX وTX معرّفة وفق الجدول في القسم 1، وA0 هي 17، طرف زائف: ليست GPIO، وanalogRead لأي طرف آخر تُرجع 0 لا رقمًا يستحيل على هذه اللوحة إنتاجه.
analogWrite تقبل قيمًا من 0 إلى 1023، وليس من 0 إلى 255. هذا هو ما يفعله Arduino ESP8266 core PWMRANGE ، وكان نسخه هو الخيار بين مفاجأتك في المتصفح أو مفاجأتك على المنضدة. analogWriteRange(255) يجعل كود Uno يتصرف كما ينبغي، و analogWriteResolution(8) هو الشيء نفسه مقولًا على طريقة ESP32. إنه PWM برمجي (القسم 3.7): ثمانية أطراف في وقت واحد، 1 kHz افتراضيًا، ومدى من 40 Hz إلى 60 kHz.
analogRead بعشرة بتات، وanalogReadResolution تُزيح ما تُرجعه بدلًا من تغيير المحوّل، كما يفعل Arduino ESP32 core.
millis() and micros() come from CCOUNT extended to sixty-four bits by the tick handler (section 3.6). micros() wraps every 71.6 minutes and millis() every 49.7 days, like Arduino; micros64() does not wrap. delay() parks the core on CCOMPARE0 rather than spinning. One comparator has two customers (the next delay deadline and the next PWM edge), so the scheduler works out which comes first, arms that, and the handler services whatever was due and schedules again.
attachInterrupt كتابتان لا ثلاث، لأنه لا توجد مصفوفة مقاطعات (القسم 4). GPIO16 لا يستطيع رفع واحدة.
الأمثلة المرفقة يبنيها GCC من Espressif، أما كود المستخدم فيبنيه clang-v3 في المتصفح، للأسباب المذكورة في القسم 7 من docs/esp32.md. يضع deploy/fetch-xtensa.sh المترجم xtensa-lx106-elf-gcc إصدار 8.4.0 في tools/xtensa/، وهو مستثنى من git: لأن GCC مرخّص بترخيص GPL ولا شيء مما يبنيه هنا يرتبط بـ libgcc، لذلك لا يصل أي كود مرخّص بـ GPL إلى ملف ELF مرفق.
ثلاثة من ملفات هذا الـ runtime هي ملفات ESP32، أعيدت ترجمتها لهذه اللوحة بدل نسخها: تنسيق الأرقام، ومساعدات الرياضيات، ودالة floor المستقلة، إضافة إلى Print وmain. أما ملفات هذه اللوحة الخاصة فهي crt0.S، وترويسة السجلات، وسكربت الربط، ومشغّلات GPIO وADC وPWM والوقت وUART والمقاطعات. وsupport32.c موجود هنا لأن معالج LX106 لا يملك قسمة عتادية: مساعدات القسمة والباقي على 32 بت التي يستدعيها المترجم هي من عندنا، حتى لا يرتبط أي شيء بـ libgcc.
Linked against firmware/esp8266/link.ld: the vectors and startup code in the 32 KB of IRAM, code and constants in the flash window, .data, .bss and the stack in the 80 KB of DRAM. A NodeMCU has 4 MB of flash and an example should be a small part of it, so the build refuses an image over its budget; the real ceiling the linker script enforces is the 1,044,464 bytes of the IDE's default sketch partition. The upload build (firmware/esp8266/link-hw.ld) is loaded into RAM by the ROM and keeps the 32 KB.
خمسة أمثلة، كل منها مع كود يعرضه الواجهة: blink (LED الوحدة على D4 وآخر موصّل على D1، دائمًا في حالة معاكسة لأن أحدهما نشط بمستوى منخفض)، button (مفتاح نحو الأرضي على D2 مع مقاومة السحب الداخلية في اللوحة)، serial (نبضة كل ثانية، وصدى للرسائل)، fade (LED على D1 عبر PWM برمجي، من 0 إلى 1023) وknob (المقاومة المتغيرة على A0، عشرة بت، تدخل مباشرة في دورة PWM لأن النطاقين متساويان).
يشغّل crates/esp8266/tests/runtime.rs ملفات ELF الخمسة تلك ويقيس: نصف دورة blink، ودورة 1 kHz لـ PWM البرمجي ضمن مقدار التذبذب الطبيعي لمعالج المقاطعة، وmillis() مقارنة بساعة النواة، وإيقاع بايتات UART0 عند 115200 باود. كل اختبار يتخطى نفسه عندما لا تكون الصور مبنية.