هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة ESP32 DevKit V1 و صفحة اللوحة.
ESP32 DevKit V1 هي لوحة DOIT ذات الأطراف الثلاثين حول وحدة ESP32-WROOM-32: معالج Xtensa LX6 بتردد 240 MHz، أول قطعة هنا ليست RISC-V ولا AVR ولا Arm. مكوّن نواة واحد (esp32 في crates/parts) يغلّف نموذج نظام ESP32 على شريحة (crates/esp32) فوق مفسّر Xtensa (crates/xtensa-core). هذا المستند هو العقد، وهو يغلب أي تعليق في الكود.
نوع الفهرس esp32. وسلسلة program في الفهرس هي elf32 xtensa lx6 esp32.
اقرأ القسم 6 أولًا إن كنت تنقل بناءً من هنا إلى شريحة حقيقية. يقول عنوانًا بعنوان أي الأرقام جاءت من ESP32 Technical Reference Manual وأيها اعتقاد هذا النموذج، ويعدّد ما هو غائب كليًا: النواة الثانية، والذاكرة المؤقتة، والفلاش، وPSRAM، وكلا جهازي الراديو ضمنها. لا شيء يُخمَّن بصمت.
الكود الخاص بهذه اللوحة يُترجم في المتصفح باستخدام clang-v3، وهي نسخة wasm من فرع LLVM الخاص بـ Espressif (-mcpu=esp32)، المنشورة بتاريخ 2026-09-28 والمدقّقة على هذا المحاكي (docs/compile.md). المثال الذي لم يُلمَس لا يزال يشغّل ملف ELF الجاهز مسبقًا من web/public/firmware/esp32/، والذي يبنيه GCC الخاص بـ Espressif. القسم 7 يحتوي على التفاصيل.
1. أطراف اللوحة (بترتيب الفهرس)
منظر علوي، منفذ micro-USB في الأسفل، ووحدة WROOM-32 مع هوائيها المدمج على اللوحة في الأعلى. أبعاد اللوحة 51.5 x 28.3 مم، والمسافة بين صفّي الأطراف المكوّنين من 15 طرفًا هي 22.86 مم (0.9 إنش)، وهذا ما يسمح للوحة DOIT DevKit V1 بالجلوس على لوحة التجارب مع ترك صف ثقوب واحد حرًّا على كل جانب. الرسم يعرضها بهذا الحجم.
لوحة Espressif DevKitC ذات الـ 38 طرفًا هي اللوحة الأخرى التي يقصدها الناس بعبارة "ESP32 DevKit"، وصفّا أطرافها يبعدان عن بعضهما إنشًا كاملًا: على لوحة التجارب لا يتبقى أي صف حر. هذه هي لوحة DOIT ذات الثلاثين طرفًا.
الرأس الأيسر، من الأعلى إلى الأسفل (15 ثقبًا): EN، VP، VN، D34، D35، D32، D33، D25، D26، D27، D14، D12، GND، D13، VIN.
الصف الأيمن، من الأعلى إلى الأسفل (15 ثقبًا): D23، D22، TX0، RX0، D21، D19، D18، D5، TX2، RX2، D4، D0، D2، D15، 3V3.
30 طرفًا. Dn هو GPIO n. VP هو GPIO 36 وVN هو GPIO 39: وهما طرفا SENSOR_VP وSENSOR_VN في المحوّل، وقد سمّاهما الطباعة الحريرية بأسماء وظيفتهما. TX0/RX0 هما GPIO 1 و3، منفذ UART الخاص بالطرفية؛ TX2/RX2 هما GPIO 17 و16. EN هو تمكين الشريحة، وهو ما يعمل كإعادة تشغيل لهذه اللوحة. VIN هو خط USB ذو 5 فولت. الأسماء المكرّرة تحمل حرفًا إضافيًا، لأن أسماء الأطراف في الفهرس فريدة؛ وهذه اللوحة لا تحتوي على أي تكرار.
الأطراف GPIO من 6 إلى 11 ليست على أي من الصفّين. فهي ذاكرة SPI flash (SD_CLK، SD_DATA0..3 وSD_CMD)، والبرنامج يعمل منها. لوحة تسمح للكود بالتحكم بها ستكون لوحة تدمّر نفسها، ولذلك فهي ليست أطرافًا هنا. الملف crates/parts/src/parts/esp32.rs يحتوي على اختبار يرفض ظهورها على أي صف أطراف.
الأطراف GPIO من 34 إلى 39 لا تحتوي على مشغّل مخرج. في هذه الشريحة هي مداخل وليس غير ذلك: لا push-pull، ولا open drain، ولا مقاومة سحب لأعلى أو لأسفل داخلية. الأمر pinMode(34, OUTPUT) يكتب في GPIO_ENABLE1_REG، لكن البتّة لا تثبت، ويبقى الطرف في حالة high-Z. أربعة من الأطراف الستة موجودة على الصف (D34، D35، VP، VN). النموذج يحصي كل محاولة، وقطعة اللوحة تُبلغ عن العدد من خلال probe (القسم 5)، لأن هذا هو الخطأ الذي يكلّف صاحب ESP32 عصرًا كاملًا، ومحاكٍ يسمح بمروره سيكون يعلّم الشيء الخطأ.
طرفان يحملان شيئًا ما على اللوحة:
- الطرف GPIO 2 عليه LED أزرق، وهو LED عادي على نقطة توصيل عادية: مستوى النقطة هو حالة المصباح، لا يوجد أي شيء يفكّ أي ترميز. وهو أيضًا طرف strapping، لذا حالة LED على لوحة DevKit حقيقية قبل تنفيذ
pinModeتختلف من لوحة إلى أخرى. - الطرف GPIO 0 هو زر BOOT، فعّال بمستوى منخفض. وهو موجود على الصف الأيمن باسم
D0، فيمكن التوصيل إليه أيضًا؛ والأمرpokeيوصّله بالأرضي على اللوحة.
كهربائيًا: كل طرف GPIO يحتوي على مشغّل مخرج يدفع push-pull عند 3.3 فولت عبر R_STRONG، أو يبقى في حالة high-Z، أو يسحب لأعلى أو لأسفل عبر 45 k. المدخل يقرأ مرتفعًا عند 1.65 فولت (نصف جهد التغذية للـ I/O)؛ والشبكة المتنازَع عليها (غير المعروفة) تُقرأ 0، والشبكة العائمة تقرأ ضجيجًا، كما في Uno (docs/uno.md القسم 1). الطرف GPIO0 يقرأ مرتفعًا عندما لا يشدّه شيء، بفضل مقاومة السحب الخاصة بلوحة DevKit بجوار زر BOOT. الطرف 3V3 يمدّ 3.3 فولت عبر R_SUPPLY، والطرف VIN يمدّ 5 فولت، والطرف GND يمدّ 0 فولت. الطرف EN عليه مقاومة سحب 10 k نحو 3.3 فولت، وسحبه دون 1.65 فولت يُبقي النواة في حالة إعادة تشغيل. المكثف 100 nF بجوار تلك المقاومة على لوحة DevKit حقيقية هو دائرة إعادة التشغيل عند التغذية، وهو غير مُنمذج، لذا الطرف EN هنا هو المقاومة وحدها.
الترتيب الدقيق للطباعة على اللوحة للصفّين هو قراءة هذا النموذج لمخطط أطراف DOIT DevKit V1. أرقام GPIO تخص الشريحة وهي ما يعتمد عليه البرنامج الثابت؛ أما موضعها على الصف فهو ما تعتمد عليه المخططات. لو كانت صفوف لوحة DevKit معينة مرتّبة بشكل مختلف (وهي تختلف فعلًا بين لوحات الـ 30 طرفًا والـ 36 طرفًا)، فستحتاج دائرة مرسومة هنا إلى إعادة توصيل على المنضدة، ولا شيء آخر سيتغير.
2. خريطة الذاكرة
| IRAM (التعليمات) | 128 KB عند 0x4008_0000 إلى 0x4009_FFFF |
| IROM (flash code) | 0x400D_0000, read-only, up to 1,310,720 bytes, section 2.1 |
| DROM (flash constants) | 0x3F40_0000, read-only, up to 1,310,720 bytes, section 2.1 |
| DRAM (البيانات) | 192 KB عند 0x3FFB_0000 إلى 0x3FFD_FFFF |
| قمة المكدس | 0x3FFE_0000 |
| DPORT | 0x3FF0_0000، القسم 3.7 |
| UART0 | 0x3FF4_0000، القسم 3.3 |
| مصفوفة GPIO | 0x3FF4_4000، القسم 3.1 |
| SENS | 0x3FF4_8800، القسم 3.5 |
| IO_MUX | 0x3FF4_9000، القسم 3.2 |
| LEDC | 0x3FF5_9000، القسم 3.6 |
| Timer group 0 | 0x3FF5_F000، القسم 3.4 |
كل كتلة طرفيات هنا بحجم 4 KB.
Two windows, not one, and that is the shape of this chip. The ESP32 has three internal SRAMs, two of which are visible through both the instruction bus and the data bus at different addresses, and SRAM1's 32 KB blocks appear in the opposite order through the two. That alias is not modeled. What is modeled is the pair ESP-IDF itself uses and keeps apart: IRAM for code, DRAM for data. The vectors, the exception entry and the startup code go in the 128 KB at 0x4008_0000; the rest of the code and the constants run from flash (section 2.1); .data, .bss and the stack go in the 192 KB at 0x3FFB_0000. A program that tries to read its own .text through the data bus is refused rather than served, because on the real part that read would have come back through the other window with the blocks in a different order.
Every PT_LOAD segment must land inside one of those two ranges or one of the two flash windows; anything else is refused with the offending address in the message, and the chip is left with no program.
2.1 Flash: code and constants
A real ESP32 runs almost all of a sketch from flash through the cache: code is read at IROM (0x400D_0000) and const data at DROM (0x3F40_0000), and the Arduino IDE's default partition table ("Default 4MB with spiffs") gives the sketch 1,310,720 bytes (0x14_0000) of it. That is the room a sketch has here, and the number the editor prints after a build ("Sketch uses N bytes ... Maximum is 1,310,720 bytes"). It counts what the IDE counts: code, literals, constants, the startup code and the initial values of the variables.
What is modeled: two read-only windows over the loaded image. A fetch or a read from either costs what a fetch from IRAM costs, which is the speed of a warm cache; there is no cache to miss and no MMU, and docs/esp32.md section 6 still says so. A store to a flash window faults, as it does on the chip. The code window shares one buffer with the instruction RAM (so a fetch is one range check whichever it is in), which means the unmapped 192 KB between them reads as zeros here, where the chip would fault; a jump into it still stops the core, since an all-zero word is an illegal instruction.
The link script (firmware/esp32/link.ld) puts .text.vectors, .text.exception, .text.start and anything marked .iram in the instruction RAM and every other function in the code window. Its literal pools sit in front of their own functions, because L32R only reaches 256 KB backwards, and every call out of the startup code goes through a register, because CALL4 and CALL8 reach 128 KB. Global variables are still limited by the data RAM (192 KB here); a program over it is refused with "no room for the stack".
تبدأ النواة بعد إعادة التشغيل وpc عند نقطة دخول ELF وكل سجلات العناوين صفرية. لا توجد ذاكرة boot ROM هنا: عشرات المللي ثانية التي تقضيها ESP32 حقيقية في محمّل المرحلة الأولى، وقراءات flash، وشجرة الساعة، وإعداد الذاكرة المؤقتة، كلها غير موجودة، والملف firmware/esp32/crt0.S يجعل الحالة التي يريدها صريحة بدلًا من افتراض ما تركته ذاكرة ROM.
3. سجلات الطرفيات
الجزء المُنفَّذ هو المجموعة أدناه فقط. أي عنوان آخر داخل كتلة مُعيَّنة بحجم 4 KB يُقرأ 0 ويُحتسب وصولًا شاردًا؛ وأي شيء خارج كل الكتل هو خطأ وصول.
3.1 مصفوفة GPIO (0x3FF4_4000)
أربعون طرفًا، لذا كل سجل فيه بتّة لكل طرف يأتي في نصفين: السجل العادي يغطي GPIO من 0 إلى 31، والسجل الذي ينتهي بـ 1 يغطي GPIO من 32 إلى 39 في بتّاته الثماني السفلى.
| الإزاحة | سجل |
|---|---|
0x00 |
GPIO_BT_SELECT_REG |
0x04 |
GPIO_OUT_REG |
0x08 |
GPIO_OUT_W1TS_REG |
0x0C |
GPIO_OUT_W1TC_REG |
0x10 |
GPIO_OUT1_REG |
0x14 |
GPIO_OUT1_W1TS_REG |
0x18 |
GPIO_OUT1_W1TC_REG |
0x20 |
GPIO_ENABLE_REG |
0x24 |
GPIO_ENABLE_W1TS_REG |
0x28 |
GPIO_ENABLE_W1TC_REG |
0x2C |
GPIO_ENABLE1_REG |
0x30 |
GPIO_ENABLE1_W1TS_REG |
0x34 |
GPIO_ENABLE1_W1TC_REG |
0x38 |
GPIO_STRAP_REG |
0x3C |
GPIO_IN_REG |
0x40 |
GPIO_IN1_REG |
0x44 |
GPIO_STATUS_REG |
0x48 |
GPIO_STATUS_W1TS_REG |
0x4C |
GPIO_STATUS_W1TC_REG |
0x50 |
GPIO_STATUS1_REG |
0x54 |
GPIO_STATUS1_W1TS_REG |
0x58 |
GPIO_STATUS1_W1TC_REG |
0x88 + 4n |
GPIO_PINn_REG |
0x530 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
تم التحقق مقابل الدليل المرجعي التقني: العنوان الأساسي للكتلة وكل إزاحة في هذا الجدول.
في السجل GPIO_PINn_REG، البتّة 2 PAD_DRIVER تجعل الطرف open drain؛ والبتّات 7..9 INT_TYPE تختار ما يرفع مقاطعة الطرف (0 إيقاف، 1 حافة صاعدة، 2 حافة هابطة، 3 أي حافة، 4 مستوى منخفض، 5 مستوى مرتفع)؛ والبتّة 13 PIN_INT_ENA الخاصة بالنواة PRO تسمح للطرف بالوصول إلى المصفوفة أصلًا.
السجل GPIO_FUNCn_OUT_SEL_CFG_REG عند القيمة 256 يجعل الطرف يتبع GPIO_OUT. القيم من 71 إلى 78 تسلّمه لقنوات LEDC عالية السرعة من 0 إلى 7. أي قيمة أخرى تختار طرفية غير مُنمذجة، ويتعامل معها النموذج كأنها 256 بدلًا من اختراع مستوى. الطرف الذي تقوده قناة LEDC لا يزال بحاجة إلى تشغيل مُخرِجه في GPIO_ENABLE.
غير مُتحقَّق منه: فهارس إشارات مصفوفة GPIO من 71 إلى 78 للإشارات ledc_hs_sig_out0 إلى ledc_hs_sig_out7. جدول إشارات المصفوفة ليس جدولًا يمكن لهذا النموذج أن يقتبسه، والرقم موجود في مكانين فقط بالضبط (OUT_SEL_LEDC_HS_SIG في crates/esp32/src/map.rs وGPIO_FUNC_OUT_SEL_LEDC_HS في firmware/esp32/include/esp32.h)، لذا يتفق النموذج مع بيئة التشغيل لأن كليهما يقرأ الثابت نفسه، لا لأن أيًّا منهما تحقق منه. أما GPIO_FUNC_OUT_SEL_GPIO = 256 فهو من الدليل الرسمي.
يعيد GPIO_STRAP_REG القراءة بالقيمة 0b1101: GPIO 0 و2 و5 مرتفعة وكل ما عداها منخفض، وهكذا تخرج WROOM-32 من المصنع. إنها قيمة ثابتة هنا، وليست حافظة لما كانت عليه الأطراف لحظة إعادة التعيين.
الأطراف الستة التي بلا مُخرِج (GPIO 34 إلى 39) تقبل الكتابة في بت ENABLE1 الخاص بها وتبقيه صفرًا، ويحسب النموذج المحاولة (القسم 1، القسم 5).
3.2 IO_MUX (0x3FF4_9000)
IO_MUX_PIN_CTRL_REG عند 0x00، ثم سجل واحد لكل طرف. البت 7 هو FUN_WPD، والبت 8 هو FUN_WPU، والبت 9 هو FUN_IE، والبتات 12..14 هي MCU_SEL وقيمة 2 منها تعني GPIO عاديًا في هذه الشريحة. لا يصل الطرف إلى GPIO_IN_REG إلا عند تمكين المخزن المؤقت للمدخل، وهذا ما يفعله العتاد فعلًا.
IO_MUX في ESP32 غير مفهرس برقم GPIO. السجلات مرتبة حسب ترتيب الوسائط في الحزمة، والتحويل من GPIO إلى وسيط هو جدول في الدليل. جدول هذا النموذج هو:
| GPIO | الإزاحة | GPIO | الإزاحة | GPIO | الإزاحة | GPIO | الإزاحة |
|---|---|---|---|---|---|---|---|
| 0 | 0x44 |
10 | 0x58 |
20 | 0x78 |
32 | 0x1C |
| 1 | 0x88 |
11 | 0x5C |
21 | 0x7C |
33 | 0x20 |
| 2 | 0x40 |
12 | 0x38 |
22 | 0x80 |
34 | 0x14 |
| 3 | 0x84 |
13 | 0x3C |
23 | 0x8C |
35 | 0x18 |
| 4 | 0x48 |
14 | 0x30 |
24 | 0x90 |
36 | 0x04 |
| 5 | 0x6C |
15 | 0x34 |
25 | 0x24 |
37 | 0x08 |
| 6 | 0x60 |
16 | 0x4C |
26 | 0x28 |
38 | 0x0C |
| 7 | 0x64 |
17 | 0x50 |
27 | 0x2C |
39 | 0x10 |
| 8 | 0x68 |
18 | 0x70 |
28..31 | لا شيء | ||
| 9 | 0x54 |
19 | 0x74 |
مُعتقَد أكثر منه مُتحقَّقًا فيه. الجدول هو قراءة هذا النموذج لترتيب اللبّادات وليس صفحة مقتبسة. إنه في موضعين، IOMUX_INDEX في crates/esp32/src/map.rs وmokxi_iomux_index[] في firmware/esp32/src/gpio.c، لذا يتفق النموذج مع بيئة التشغيل فيما بينهما سواء اتفقا مع السيليكون أم لا. الأطراف GPIO 28 إلى GPIO 31 غير موجودة في هذه الشريحة ولا سجل لها.
كل طرف يبدأ التشغيل عند FUN_IE | (2 << 12) هنا: GPIO عادي مع تشغيل مخزن الإدخال. قيم إعادة الضبط لكل طرف في الدليل الرسمي تختلف (أطراف strapping وأطراف الفلاش تبدأ مع مقاومات سحب)، وهذا النموذج يعطي كل طرف الحالة المحايدة نفسها حتى يسلك البرنامج الذي يكتب في GPIO_ENABLE وGPIO_OUT فقط السلوك نفسه على كل طرف. يكرر القسم 6 هذا كتقريب لا كعنوان.
3.3 UART0 (0x3FF4_0000)
| الإزاحة | سجل |
|---|---|
0x00 |
UART_FIFO_REG |
0x04 |
UART_INT_RAW_REG |
0x08 |
UART_INT_ST_REG |
0x0C |
UART_INT_ENA_REG |
0x10 |
UART_INT_CLR_REG |
0x14 |
UART_CLKDIV_REG |
0x1C |
UART_STATUS_REG |
0x20 |
UART_CONF0_REG |
0x24 |
UART_CONF1_REG |
مُتحقَّق منه: العنوان الأساسي وكل الإزاحات، وبتّا إعادة ضبط FIFO الاثنان، وعرض عدّادي FIFO الاثنين أدناه. إنه نفس IP الخاص بـ UART الموجود في ESP32-C3 وESP8266، سجلًا بسجل، ولهذا فإن crates/esp32/src/uart.rs وcrates/esp8266/src/uart.rs هما الملف نفسه مكررًا مرتين.
ذاكرتا FIFO بسعة 128 بايت لكل منهما. البت 17 RXFIFO_RST والبت 18 TXFIFO_RST في UART_CONF0_REG تفرغانهما: الدليل المرجعي التقني لـ ESP32 (الإصدار v5.8)، السجل 19.9 UART_CONF0_REG، يضع TXFIFO_RST عند البت 18 وRXFIFO_RST عند البت 17. إصدار سابق من هذا النموذج ومن firmware/esp32/include/esp32.h كان يضع الاثنين معكوسين. دالة Serial.begin في بيئة التشغيل تضبط البتين معًا ثم تمسحهما معًا، فالقيمة المكتوبة هي نفسها في الحالتين ولم تتأثر الصور.
البتات 0..6 من UART_CONF1_REG هي RXFIFO_FULL_THRHD والبتات 8..14 هي TXFIFO_EMPTY_THRHD، وكلاهما 96 عند إعادة الضبط (السجل 19.10)؛ إصدار سابق من هذا النموذج كان يضع حقولًا بتسعة بتات عند 0 و9، وبيئة التشغيل لا تكتب في هذا السجل أبدًا. البتات 0..19 من UART_CLKDIV_REG هي الجزء الصحيح من القاسم (السجل 19.6؛ الجزء الكسري عند البتات 20..23 غير مُنمذج). القاسم يقسم ساعة APB البالغة 80 MHz ويُعاد ضبطه إلى 694، أي 115 274 باود: قريب من 115200 بما يكفي لألا تفرق الشاشة التسلسلية، وهو بالضبط ما يعطيه الرقم. كانت وتيرة الإرسال تقرأ اثني عشر بتًا منه فقط، فكانت Serial.begin(9600)، التي قاسمها 8333، ترسل البايتات أسرع بنحو 59 مرة؛ أما الآن فتقرأ العشرين كلها.
البِتات من 0 إلى 7 في UART_STATUS_REG هي RXFIFO_CNT والبِتات من 16 إلى 23 هي TXFIFO_CNT (السجل 19.8). البِتات من 8 إلى 11 ومن 24 إلى 27 فوقها هي حالتا آلتَي الاستقبال والإرسال (ST_URX_OUT وST_UTX_OUT). يُرجع النموذج العدّادين في تلك المواضع والقيمة 0 في بِتات آلات الحالة، لأنه لا يشغّل أيًّا من الآلتين. تقرأ بيئة التشغيل ثمانية بِتات كما تحدد الدليل الحقول. كانت نسخة سابقة من بيئة التشغيل تقرأ عشرة، وهو ما أعطى هنا الأرقام نفسها لأن البِتات الأعلى تقرأ 0، لكن على الشريحة الحقيقية كانت ستلتقط بِتين من ST_UTX_OUT: كان عدّاد الإرسال سيقرأ 256 أو أكثر بينما البايت على السلك، وكانت Serial.write، التي تنتظر توفر مساحة في الـFIFO، ستنتظر إلى الأبد. أعيد بناء الصور بعد تصحيح ذلك، ويُلزم الملف crates/esp32/tests/contract.rs أقنعة الترويسة بأن تطابق النموذج.
تغادر البايتات FIFO الإرسال بسرعة الباود، لا فورًا. من دونه يفرغ برنامج يطبع في حلقة FIFO بسرعة امتلائه، فلا يرتفع TXFIFO_CNT أبدًا، ولا يضطر البرنامج الثابت الذي يفحصه قبل الكتابة إلى الانتظار. بفضله ينقل منفذ بسرعة 115 200 باود 11 520 بايتًا في الثانية هنا تمامًا كما يفعل على المنضدة، ويقيس crates/esp32/tests/runtime.rs الفاصل بين بايتين من مثال serial مقابل 86.8 us التي يستغرقها البايت.
3.3a UART1 (0x3FF5_0000) وUART2 (0x3FF6_E000)
كتلة سجلات UART0 مرتين إضافيتين، عند REG_UART_BASE(1) وREG_UART_BASE(2) في ESP-IDF، بالإزاحات نفسها. مُتحقَّق منه مقابل soc/esp32/register/soc/uart_reg.h في ESP-IDF: العناوين الأساسية، والإزاحات، والحقول أدناه. وخلافًا لـ UART0 لا يتصلان بأي قناة مضيف: يصلان إلى الدائرة عبر مصفوفة GPIO فقط (القسم 3.1)، بتًا بتًا.
- توجيه المصفوفة. الإشارة 17 في
GPIO_FUNCn_OUT_SEL_CFG_REGهيU1TXD، و198 هيU2TXD؛ وGPIO_FUNCm_IN_SEL_CFG_REG(عند0x130 + 4m، 256 منها) للإشارة 17 هيU1RXDوللإشارة 198 هيU2RXD، حيث يأخذSIG_IN_SEL(البت 7) طرف GPIO منIN_SEL(البتات 0..5)، ويعكسIN_INV_SEL(البت 6) الإشارة. الأرقام منgpio_sig_map.hفي ESP-IDF. أماINV_SEL(البت 9) فيOUT_SELفيعكس المخرج. الإشارة التي تكون قيمةSIG_IN_SELفيها صفرًا تأتي من طرف IO_MUX الخاص بها على الشريحة؛ وهذا المسار غير مُنمذج (يقرأ الخط خامولًا)، وبيئة التشغيل توجّه كل الأطراف عبر المصفوفة، وهو ما يعمل على كل طرف على الشريحة الحقيقية أيضًا. - الإطار.
UART_CONF0_REGيتضمّنPARITY/PARITY_EN(البِتّان 0 و1)، وBIT_NUM(2..3، من خمسة إلى ثمانية بِتّات) وSTOP_BIT_NUM(4..5: بت إيقاف واحد، واحد ونصف، اثنان). على الشريحة الحقيقية يتطلّب بتا إيقاف اثنان الحل البديلRS485_CONF.DL1_ENمن ESP-IDF؛ أما هنا فالقيمةSTOP_BIT_NUM3 تعني ببساطة بتّي إيقاف.RXD_INV(19) وTXD_INV(22) يعكسان الخطوط، وERR_WR_MASK(26) يمنع وصول البايتات ذات خطأ الإطار أو التكافؤ إلى الـ FIFO. - الساعة.
TICK_REF_ALWAYS_ON(البِت 27، مضبوط عند إعادة التعيين) يقسّم ساعة APB البالغة 80 MHz؛ وعند تصفيره تُستخدم ساعةREF_TICKالبالغة 1 MHz، والتي يعتمدها ESP-IDF حتى 250 000 باود.UART_CLKDIV_REGيحمل الجزء الصحيح في البِتّات 0..19 والأجزاء من ستة عشر فيCLKDIV_FRAG، البِتّات 20..23، وكلاهما مُنمذج: 9600 باود انطلاقًا منREF_TICKتعني 104 و2/16، أي بِت مدّته 104.125 ميكروثانية، أي 9603.8 باود، كما على الشريحة. - ذاكرات FIFO والعتبات. 128 بايتًا في كل اتجاه. يبدأ البايت لحظة تحرّر سجل الإزاحة ويليه التالي مباشرة بعد آخر بت إيقاف دون أي فجوة (
tx_idle_numبقيمة 0، كما يضبطه ESP-IDF). يعدّTXFIFO_CNTالبايتات المنتظرة فقط، لا البايت الجاري إرساله، ويُبلغST_UTX_OUT(24..27) وST_URX_OUT(8..11) عن الخانة التي يقع فيها كل جهاز حالة، و0 عند الخمول. البِت 15 فيSTATUSيمثّل خط الاستقبال والبِت 31 خط الإرسال. - الاستقبال. جبهة هابطة على خط خامل تبدأ إطارًا؛ يُفحص بت البدء في منتصفه (يُتجاهل أي نبضة عابرة)، ويُؤخذ عينة كل بت آخر من منتصف خانته، ويستقر البايت عند منتصف بت الإيقاف. يعمل النواة سابقًا الدائرة بمقدار شريحة زمنية واحدة على الأكثر، لذا لا يأخذ المستقبِل عيناته إلا من أوقات سبق أن أبلغت عنها الدائرة.
- المقاطعات.
RXFIFO_FULL(البِت 0) وTXFIFO_EMPTY(1) مقابل عتباتCONF1، وPARITY_ERR(2)، وFRM_ERR(3)، وRXFIFO_OVF(4)، وRXFIFO_TOUT(8) وTX_DONE(14)، على مصدرَي مصفوفة المقاطعات 35 و36. يضبطRX_TOUT_ENوRX_TOUT_THRHD(بِتّاCONF131 و24..30) المهلة بالوحدات نفسها التي يكتبهاuart_ll_set_rx_toutمن ESP-IDF: كل وحدة تعادل ثماني أزمنة بت انطلاقًا من APB، وثُمن واحدة انطلاقًا منREF_TICK. - غير مُنمذج: التحكم في التدفق العتادي والبرمجي، وRS-485، وIrDA، والباود التلقائي، والكسر (break)، وبِت الاسترجاع، وكاشف أوامر AT، وبِتّا تمكين الساعة وإعادة التعيين في
DPORT(كلا منفذي UART يُغذّى بالساعة دائمًا). سجلاتها مبعثرة.
منفذ UART لا يكتب إليه البرنامج إطلاقًا لا يكلّف المحاكي شيئًا: لا يُنظر إليه على أي مسار حتى تُكتب قيمة في أحد سجلاته، وcrates/esp32/src/bus.rs يحتوي اختبارًا يؤكّد ذلك.
إنّ Serial1 وSerial2 في بيئة التشغيل (firmware/esp32/src/uartn.c) تشغّل هذه المنافذ بالطريقة نفسها التي تشغّلها بها نواة arduino-esp32 3.x ومشغّل ESP-IDF؛ ويشرح docs/help/boards/esp32-devkit.md ما يراه الكود.
3.4 مجموعة المؤقّتات 0، المؤقّت 0 (0x3FF5_F000)
العدّاد 64-بت المستخدم في micros() وmillis().
| الإزاحة | سجل |
|---|---|
0x00 |
TIMG_T0CONFIG_REG |
0x04 |
TIMG_T0LO_REG |
0x08 |
TIMG_T0HI_REG |
0x0C |
TIMG_T0UPDATE_REG |
0x10 |
TIMG_T0ALARMLO_REG |
0x14 |
TIMG_T0ALARMHI_REG |
0x18 |
TIMG_T0LOADLO_REG |
0x1C |
TIMG_T0LOADHI_REG |
0x20 |
TIMG_T0LOAD_REG |
0x98 |
TIMG_INT_ENA_TIMERS_REG |
0x9C |
TIMG_INT_RAW_TIMERS_REG |
0xA0 |
TIMG_INT_ST_TIMERS_REG |
0xA4 |
TIMG_INT_CLR_TIMERS_REG |
مُتحقَّق منه: العنوان الأساسي للكتلة. مُفترَض لا مُتحقَّق منه: كل إزاحة في هذا الجدول. العنوان الأساسي هو من الدليل؛ أما التوزيع داخله فهو من هذا النموذج، وهو نفسه في crates/esp32/src/map.rs وfirmware/esp32/include/esp32.h.
T0CONFIG البِت 31 EN، والبِت 30 INCREASE، والبِت 29 AUTORELOAD، والبِتّات 13..28 DIVIDER، والبِت 10 ALARM_EN. تضبط بيئة التشغيل DIVIDER على 80، أي نبضة واحدة كل ميكروثانية انطلاقًا من ساعة APB البالغة 80 MHz.
القراءة تتم بالقفل ثم القراءة، كما يتطلبه العتاد: اكتب T0UPDATE، ثم اقرأ T0HI و T0LO. العداد لا يُحتسب. إنه فعلًا زمن المحاكاة مقسومًا على القاسم، تمامًا كما هو حال SYSTIMER في C3، لذا لا يوجد ما ينحرف عنه، والبرنامج الثابت الذي ينتظر في حلقة مشغولة على micros() يقيس بالضبط الزمن الذي رأى بقية الدائرة أنه مرّ.
المنبّه مُنفَّذ ويصعد TIMG_INT_RAW عندما يتجاوز العداد قيمته، لكن لا يخرج أي خط مقاطعة من هذه الكتلة. لا شيء يوجّهه إلى مصفوفة المقاطعات. نبضة المللي ثانية في النموذج تأتي من CCOMPARE0 الخاص بالنواة نفسها (القسم 4)، وهو سجل في النواة موصول بمقاطعة CPU ثابتة، وبذلك لا يقف خلف أي عنوان كان على النموذج تخمينه. ولا يزال بإمكانك استطلاع TIMG_INT_ST ومسحه.
المؤقت 1 من مجموعة المؤقتات 0 ومجموعة المؤقتات 1 بأكملها غائبتان؛ وكلب الحراسة الخاص بمجموعة المؤقتات 0 مذكور في القسم 3.9.
3.5 SENS: ADC1، وضع اللقطة الواحدة (0x3FF4_8800)
ADC1 في وضع اللقطة الواحدة: المسار adc1_get_raw ودالة analogRead في نواة Arduino يعملان على هذه القطعة، ولا شيء غير ذلك.
| الإزاحة | سجل | البتات |
|---|---|---|
0x00 |
SENS_SAR_READ_CTRL_REG |
مُخزَّن، يُقرأ مرة أخرى؛ توقيت التحويل هنا ثابت |
0x34 |
SENS_SAR_ATTEN1_REG |
بتّا توهين لكل قناة، القناة n عند البتين 2n..2n+1 |
0x54 |
SENS_SAR_MEAS_START1_REG |
البتات 0..15 MEAS1_DATA_SAR (النتيجة، للقراءة فقط)، البت 16 MEAS1_DONE_SAR، البت 17 MEAS1_START_SAR، البت 18 MEAS1_START_FORCE، البتات 19..26 SAR1_EN_PAD (بت واحد لكل قناة)، البت 31 SAR1_EN_PAD_FORCE |
تم التحقق: العنوان الأساسي. يُعتمد على صحة ما يلي دون تحقق: الإزاحات الثلاث وكل مواضع البتات فيها. إنها قراءة هذا النموذج لكتلة SENS، بالمعنى نفسه الذي تشير به القسم 3.5 في docs/esp32c3.md إلى إزاحات SAR الخاصة بـ C3 نفسها. البرنامج الثابت المبني هنا يتفق مع النموذج سواء اتفق مع السيليكون أم لا.
تحويل واحد: ضع التوهين في ATTEN1، فعّل START_FORCE وEN_PAD_FORCE، ضع بت القناة في SAR1_EN_PAD، ارفع MEAS1_START_SAR، انتظر MEAS1_DONE_SAR، ثم اقرأ البيانات. يستغرق التحويل زمنًا ثابتًا مقداره 5 us من زمن المحاكاة، وهو ما ينتظره البرنامج الثابت فعلًا.
ثماني قنوات، وعلى ESP32 ليست GPIO n:
| قناة | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
|---|---|---|---|---|---|---|---|---|
| GPIO | 36 | 37 | 38 | 39 | 32 | 33 | 34 | 35 |
القناة 0 هي SENSOR_VP والقناة 3 هي SENSOR_VN؛ والطرفان 37 و 38 غير موصولين خارجيًا في WROOM-32، فالأطراف الأربعة التي تُخرجها لوحة DevKit كأرقام عادية هي القنوات 4 إلى 7. هذا الجدول من الدليل.
النتيجة هي اثنا عشر بتًا من جهد الشبكة في اللحظة التي بدأت فيها التحويل. عند 0 و2.5 و6 dB يكون هذا هو الخط المستقيم الاسمي الموجود في ورقة البيانات، round(4095 x Vin / Vfull) مع تقييد القيمة، والمدى الكامل 1.1 V أو 1.5 V أو 2.2 V. أما عند 11 dB، وهو الإعداد الافتراضي لنواة Arduino، فهو المنحنى الخام للقطعة الحقيقية (CURVE_11DB في crates/esp32/src/adc.rs): صفر حتى نحو 80 mV، ثم قريب من الخطية في المنتصف، وينحني صعودًا قرب الأعلى ويشبع عند 4095 بدءًا من نحو 3.15 V. المدى الكامل الاسمي 3.9 V ليس هو ما تعطيه القراءة الخام؛ فورقة البيانات لا تضمن الدقة إلا من 150 إلى 2450 mV عند 11 dB، والعد الخام لقطعة نموذجية ينتهي قبل 3.9 V بفترة طويلة. لذا فإن مقياس جهد متغيّرًا موصولًا عبر خط 3.3 V يقرأ من 0 إلى 4095، ويصل إلى 4095 قبل نهاية مداره بقليل، ونصف الخط (1.65 V) يقرأ نحو 1890، وmap(analogRead(pin), 0, 4095, 0, 180) تدير محرك سيرفو دورة كاملة. النقاط هي الملاءمة من الرتبة الرابعة الشائعة الاستخدام لقياسات ESP32، معكوسة؛ ومعايرة eFuse في وحدة ما تحرّكها بضعة بالمئة، وهذا غير ممثَّل في النموذج. analogReadMilliVolts تعكس المنحنى نفسه، كما تفعل معايرة النواة، لذا تقرأ نحو 1650 عند 1.65 V. والقناة التي لا شيء على طرفها تتوه، كما يفعل مدخل عائم (docs/uno.md القسم 1).
دالة التحويل للمحوّل الحقيقي تنحني عند الطرفين وتُصحَّح عبر منحنى معايرة eFuse. لا شيء من ذلك ممثَّل في المحاكاة: هذا خط مستقيم. القسم 6 يذكره على أنه تقريب.
ADC2 (وهو ما تتقاسمه ESP32 الحقيقية مع WiFi)، ومسار DMA وجدول الأنماط، والمتحكم الرقمي، وeFuse الخاصة بالمعايرة، والمرجع الداخلي، وحساس اللمس، وحساس هول: كلها غائبة.
3.6 وحدة LEDC، المجموعة عالية السرعة (0x3FF5_9000)
متحكم LED PWM. المجموعة عالية السرعة هي ما تصل إليه ledcSetup وledcAttachPin وledcWrite عبر القنوات من 0 إلى 7، وهي ما تستخدمه analogWrite هنا: أربعة مؤقتات وثماني قنوات.
| الإزاحة | سجل | البتات |
|---|---|---|
0x00 + 0x14n |
LEDC_HSCHn_CONF0_REG |
البتان 0..1 هما TIMER_SEL، والبت 2 هو SIG_OUT_EN، والبت 3 هو IDLE_LV، والبت 4 هو PARA_UP (مخزَّن؛ وقيمة duty مكتوبة هنا تسري فورًا) |
0x04 + 0x14n |
LEDC_HSCHn_HPOINT_REG |
البتات 0..19 هي HPOINT: العدّ الذي يبدأ عنده النبض |
0x08 + 0x14n |
LEDC_HSCHn_DUTY_REG |
البتات 0..24 هي DUTY: عرض النبضة بالأجزاء من ستة عشر جزءًا من العدّ |
0x0C + 0x14n |
LEDC_HSCHn_CONF1_REG |
عتاد تلاشي duty: مخزَّن ويُقرأ، ولا يلاشي شيئًا |
0x10 + 0x14n |
LEDC_HSCHn_DUTY_R_REG |
قيمة duty كما هي، للقراءة فقط |
0x140 + 8n |
LEDC_HSTIMERn_CONF_REG |
البتات 0..4 هي DUTY_RES، من 1 إلى 20 بتًا (أما 0 فهو مؤقت لم يضبطه أحد ولا يعدّ شيئًا)، والبتات 5..22 هي CLK_DIV، والبت 23 هو PAUSE، والبت 24 هو RST |
0x144 + 8n |
LEDC_HSTIMERn_VALUE_REG |
العداد، للقراءة فقط |
0x180 |
LEDC_INT_RAW_REG |
البت n = تجاوز المؤقت n |
0x184 |
LEDC_INT_ST_REG |
خام ومُمكَّن |
0x188 |
LEDC_INT_ENA_REG |
مخزَّن؛ لا يصل أي خط إلى النواة |
0x18C |
LEDC_INT_CLR_REG |
اكتب 1 للمسح |
0x190 |
LEDC_CONF_REG |
البتان 0..1 هما APB_CLK_SEL، والقيمة 1 تعني ساعة APB ذات 80 MHz، وهي المصدر الوحيد المُحاكى |
0x1FC |
LEDC_DATE_REG |
يقرأ 0x1605_3100 |
تم التحقق منه: العنوان الأساسي للكتلة. مُعتقَد دون تحقق: التصميم الداخلي كله: طول خطوة القناة، وكتلة المؤقت عند 0x140، وسجلات المقاطعة والإعداد عند 0x180 فما فوق.
يعدّ المؤقت 2^DUTY_RES عدًّا عند 80 MHz مقسومة على CLK_DIV، وهو عدد بصيغة Q10.8 من نبضات ساعة APB لكل عدّ:
f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES)
لذا فإن 5 kHz عند ثمانية بتات هي DUTY_RES بقيمة 8 مع CLK_DIV بقيمة 16000، بالضبط. تختار القناة مؤقتًا وعدّ بدء HPOINT وقيمة duty، ويكون خرجها مرتفعًا بدءًا من HPOINT لمدة DUTY >> 4 عدّة، مع لفّ حول أعلى الدورة. قيمة duty تساوي 0 تعني مستوى منخفضًا دائمًا، وقيمة 2^DUTY_RES << 4 تعني مستوى مرتفعًا دائمًا بلا أي حافة، ولهذا تحوّل نواة Arduino استدعاء ledcWrite(pin, 255) عند ثمانية بتات إلى duty بقيمة 256 بدلًا من 255، التي كانت ستترك ثلمةً بمقدار عدّة واحدة في كل دورة.
تصل القناة إلى طرف عبر مصفوفة GPIO: اضبط بت GPIO_ENABLE للطرف ووجّه سجل GPIO_FUNCn_OUT_SEL_CFG_REG الخاص به إلى 71 + channel (القسم 3.1، وهذا الفهرس لم يُتحقَّق منه).
لا يتقدّم العداد خطوة بخطوة: بل هو دالة بصيغة مغلقة في الزمن المحاكى، وكذلك وقت حافته التالية. لذلك فإن نواة متوقفة في waiti لا تكلف شيئًا أثناء عمل PWM، وتُوقَظ اللوحة للحافات ولا لشيء آخر. يقيس crates/esp32/tests/runtime.rs دورة مثال fade مقابل 1 ms لكل 1 kHz ضمن 5 us.
غير مُحاكى: المجموعة منخفضة السرعة (لدى ESP32 واحدة، بمؤقتاتها الأربعة وقنواتها الثماني وساعتها البطيئة؛ لا شيء في بيئة التشغيل يستخدمها)، وعتاد تلاشي دورة التشغيل (duty)، وعداد التجاوز الخاص بالقناة، ومصادر الساعة غير APB، وخط LEDC إلى مصفوفة المقاطعات: يمكن استقصاء LEDC_INT_RAW_REG وتصفيره لكنه لا يصل أبدًا إلى النواة.
3.7 وحدة DPORT ومصفوفة المقاطعات (0x3FF0_0000)
في ESP32 لا تملك الطرفية مقاطعة CPU ثابتة، بل لها رقم مصدر، وسجل الخريطة في المصفوفة الخاص بهذا المصدر يحدد أي مقاطعة من المقاطعات الـ 32 في النواة تُطلقها. لهذا فإن attachInterrupt هنا ثلاث كتابات لا كتابة واحدة: ضبط الطرف، وتوجيه المصدر، ورفع الحجب عن مقاطعة CPU.
| الإزاحة | سجل |
|---|---|
0x104 + 4n |
DPORT_PRO_..._INTR_MAP_REG للمصدر n |
96 مصدرًا. يحمل سجل الخريطة رقم مقاطعة CPU في بتاته الخمس السفلى؛ والمصدر المُوجَّه إلى 0 يرفع المقاطعة 0، التي لا يفعّلها شيء، فلا يحدث شيء، وهذا ما يفعله العتاد أيضًا، وهكذا يُطفَّأ المصدر.
تم التحقق: DPORT_BASE = 0x3FF0_0000. مُفترض لا مؤكَّد: إزاحة مصفوفة الخريطة 0x104، والرقمين المصدرين اللذين يوجّههما هذا النموذج:
| المصدر | الرقم |
|---|---|
| GPIO | 22 |
| UART0 | 34 |
| UART1 | 35 |
| UART2 | 36 |
رقمَي UART1 وUART2 تم التحقق منهما مقابل ترتيب soc/esp32/include/soc/interrupts.h في ESP-IDF، الذي يضع GPIO أيضًا عند 22 وUART0 عند 34. هذه المصادر فقط، وعداد مراقبة مجموعة المؤقتات 0 (القسم 3.9)، تصل إلى أي شيء. أما كل سجل خريطة آخر فيُخزَّن ويُقرأ ولا يوجّه شيئًا، لأن لا شيء آخر في هذا النموذج يرفع مقاطعة. وبقية DPORT (التحكم في الذاكرة المؤقتة وMMU، وسجلات التحكم في APP-CPU، وبوابات ساعة الطرفيات وإعادتها، وتحكيم DMA) غائبة.
3.8 صندوق بريد شبكة Mokxi (0x3FEF_E000)
هذه الكتلة ليست ملكًا لـ ESP32. كل عنوان آخر في هذا المستند هو عنوان الشريحة، منقول من الدليل المرجعي التقني، وأي صورة مبنية عليه فهي صورة لوحة WROOM-32 حقيقية. أما هذه فمن صنع Mokxi: شبكة crates/net المحاكاة، في الفجوة التي يتركها ناقل البيانات بين نوافذ الذاكرة الخارجية (المنتهية عند 0x3FBF_FFFF) ونافذة الطرفيات (البدء من DPORT عند 0x3FF0_0000)، وهو نطاق تحتفظ به الشريحة ولا تجيب فيه بشيء، بحيث إن أي صورة تستخدمه يحدث فيها خطأ على السيليكون بدلًا من قراءة سجل طرفية أخرى. وهذا الخطأ هو الجواب الصادق، لأن ما وراء هذه الكتلة غير موجود على الشريحة.
الكتلة لا ترفع أي مقاطعة على الإطلاق. كل مصدر آخر هنا يصل إلى النواة عبر مصفوفة المقاطعات في القسم 3.7، ورقم المصدر في المصفوفة هو رقم الشريحة؛ لا يوجد رقم صادق يمكن منحه لجهاز طرفي لا تمتلكه الشريحة، لذا لا يُعطى صندوق البريد أي رقم. يظل NET_INT_RAW_REG قابلاً للقراءة، ويستعلم البرنامج الثابت باستمرار، وتبقى النواة المتوقفة في waiti تستيقظ عندما تكون لدى الششبكة ما تقوله، بالطريقة نفسها التي تستيقظ بها عند حافة PWM.
لا يوجد هنا لا راديو، ولا 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_ هي نصف الكتلة الخاص بـ Bluetooth، بحلقات خاصة بها حتى لا تتمكن دالة استدعاء Bluetooth أبدًا من لمس متن HTTP: Bluetooth Classic وLE، وكلاهما تمتلكه ESP32 الكلاسيكية. لا يوجد راديو خلفهما أيضًا؛ 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") |
| 19 | ETH |
Ethernet سلكي (firmware/include/ETH.h)، القيمة في NET_ARG_REG: 1 ترفع الوصلة عبر كابل محاكى، بلا SSID وبلا كلمة مرور، وترتبط بعد 1.5 ثانية بعقد الإيجار نفسه؛ 2 تضع 1 في NET_RESULT_REG عندما تكون الوصلة (أو كانت آخر مرة) سلكية. توجد وصلة واحدة: STATUS وIP وكل طلب يقرؤها أيًّا كانت الطريقة التي نشأت بها |
| 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.9 مراقب مجموعة المؤقتات 0 وإعادة تعيين RTC_CNTL (0x3FF5_F048، 0x3FF4_8000)
المُراقب الرئيسي لمجموعة المؤقتات 0، مثل C3 (docs/esp32c3.md القسم 3.9) لكن بتخطيط ESP32: الكتابة تسري فورًا، وبِتّ المقاطعة هو البِتّ 2 من TIMG_INT_* (0x98..0xA4)، ويصل إلى النواة عبر مصفوفة المقاطعات كمصدر رقم 16 (بيئة التشغيل تحيله إلى مقاطعة المعالج 17). RTC_CNTL (0x3FF4_8000، الكيلوبايتان أسفل SENS): RTC_CNTL_RESET_STATE_REG عند 0x34، وسجلات التخزين عند 0x4C..0x58 و0xB0..0xBC، وإعادتا الضبط البرمجيتان. مجموعة المؤقتات 1 غير مُمثَّلة في النموذج.
تشغّل بيئة التشغيل مُراقب مهام ESP-IDF على مُراقب مجموعة المؤقتات 0، كما يفعل ESP-IDF (firmware/src/main.cpp): نبضات كل 500 µs، المرحلة 0 مقاطعة عند انتهاء المهلة والمرحلة 1 إعادة ضبط للنظام عند ضعفها، ويبدأ قبل setup() عند 5 ثوانٍ مع حالة panic، ويراقب مهمة الخمول للنواة 0. يعمل الكود على النواة 1، ومهمة خمولها غير مراقَبة ما لم تطلب ذلك (enableCore1WDT())، لذا تستمر حلقة لا تُسلّم التنفيذ أبدًا في العمل، كما على اللوحة. تطبع المقاطعة أسطر ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …"، والمهام، و"Aborting."، وسطر الإحباط و"Rebooting...")، وتترك تلميح ESP_RST_TASK_WDT في سجل تخزين RTC وتعيد ضبط المعالج عبر إعادة الضبط البرمجية، فيعيد esp_reset_reason() القيمة 6 بعدها. تعمل esp_task_wdt_* وenableLoopWDT() وenable/disableCore0WDT() عليه. مُراقب مجموعة المؤقتات 1 مُمثَّل في النموذج بالطريقة نفسها ولا شيء في بيئة التشغيل يُفعّله: مُراقب المقاطعات غير مُحاكى.
4. النواة: أي ABI، وكيف تصل المقاطعة
crates/xtensa-core هو مفسِّر Xtensa LX كُتِب من مرجع Xtensa Instruction Set Architecture ومن الترميزات التي تنتجها أدوات Espressif. لا شيء فيه مشتق من QEMU ولا من ESP-IDF ولا من أنوية Arduino ولا من أي مُحاكٍ آخر. استُخدم xtensa-esp32-elf-as كما تُستخدم أداة في المنضدة (تُجمِّع تعليمة، وتقرأ الترميز الناتج، وتكتب المُفكِّك بناءً على ما ظهر)، ويحفظ crates/xtensa-core/tests/encoding.rs تلك القياسات، بحيث يمكن التحقق من المُفكِّك مقابل الأدلة لا مقابل جدول كتبه شخص ما.
ABI النافذة، ولم يكن هناك خيار آخر. يُصدر xtensa-esp32-elf-gcc تعليمات entry وcall8 وretw.n، ولا يملك خيار -mabi=call0 أصلًا. لذا فإن تهيئة LX6 هنا فيها أربعة وستون سجل عناوين فيزيائية ونافذة السجلات، مع ENTRY وRETW وROTW وMOVSP وL32E/S32E واستثناءَي فائض النافذة ونقصها عبر متجهيهما الخاصين. (LX106 في ESP8266 فيه ستة عشر سجلًا ولا نافذة فيه، لذا يُصدر مُترجِمه call0؛ القسم 4 من docs/esp8266.md هو النصف الآخر من هذه الحكاية.)
What the LX6 configuration has that the LX106 does not: hardware divide (QUOS, QUOU, REMS, REMU), the 32-bit high multiply, MIN/MAX, SEXT, CLAMPS, the zero-overhead loop (LOOP, LOOPNEZ, LOOPGTZ) and the two atomic loads. Each of those differences was put to the assembler of the toolchain that builds for that chip; the encodings that came back are in tests/encoding.rs.
تمت النمذجة: عمليات التحميل والتخزين بجميع الأعراض مع استثناء المحاذاة، مجموعة التفرعات الشرطية وغير الشرطية كاملةً، CALL0/CALL4/CALL8/CALL12 وصيغها غير المباشرة، L32R، MOVI، تعليمات الكثافة (.n)، وحدة ALU للأعداد الصحيحة، MUL16/MULL/MULUH/MULSH، السجلات الخاصة، وWAITI.
المتجهات. VECBASE سجل خاص والجدول هو جدول الـ ISA:
الإزاحة من VECBASE |
المتجه |
|---|---|
0x000 |
WindowOverflow4 |
0x040 |
WindowUnderflow4 |
0x080 |
WindowOverflow8 |
0x0C0 |
WindowUnderflow8 |
0x100 |
WindowOverflow12 |
0x140 |
WindowUnderflow12 |
0x300 |
KernelException (مسح PS.UM) |
0x340 |
UserException (PS.UM مضبوط)، وكل مقاطعة من المستوى 1، مع EXCCAUSE بقيمة 4 |
0x3C0 |
DoubleException (PS.EXCM مضبوط مسبقًا) |
أيٌّ من معالجات الفائض الثلاثة يُختار يقرره عرض الإطار الذي يُفرَغ، لا مدى دوران النافذة للوصول إليه: WindowOverflow4 يُفرغ حتى a5، و8 حتى a9، و12 حتى a13، وهذه هي مؤشرات المكدس بعد نافذة ونافذتين وثلاث نوافذ. تكتب CALL8 في a8 قبل أن يعمل ENTRY الخاص بالمُستدعى أصلًا، لذا فقاعدة الفائض تعتمد على الوصول إلى السجل لا على ENTRY فقط. كلا الأمرين كانا خطأَين اكتشفهما البرنامج الثابت لهذه اللوحة نفسها، وكلاهما مُصحَّح في النواة.
المقاطعات. INTENABLE يُقنِّع؛ PS.INTLEVEL يُرشِّح. لا يُمثَّل في النموذج سوى المستوى 1: مستويات المقاطعات فوق الواحد وNMI ومقاطعة التنقيح غير مُمثَّلة. مقاطعات المستوى 1 هي 0 إلى 10 و12 و13 و17 و18، بالقناع 0x0006_37FF. تم التحقق من ذلك مقابل ESP32 Technical Reference Manual (v5.8)، الجدول 8.3-2 "CPU Interrupts": فالمقاطعات 19 و20 و21 مُشغَّلة بالمستوى عند المستوى 2، فهي ليست في القناع. نسخة سابقة من هذا النموذج كانت تضمها (0x003E_37FF)، وهو ما كان سيُوزِّع خط مستوى 2 عند المستوى 1؛ ويحفظ crates/xtensa-core/tests/interrupts.rs الآن القناع مطابقًا للجدول. بيئة التشغيل لا تُمكِّن سوى 6 و13 (القسم 7)، وكلتاهما من المستوى 1 في الجدول نفسه، فلم يعتمد أي برنامج ثابت على القناع القديم.
CCOUNT وCCOMPARE. لدى LX6 ثلاثة مقارنات. أي مقاطعة معالج يرفعها كلٌّ منها قد اعتُبرت:
| المقارن | مقاطعة المعالج |
|---|---|
CCOMPARE0 |
6 |
CCOMPARE1 |
15 |
CCOMPARE2 |
16 |
تم التحقق من ذلك مقابل الجدول 8.3-2 نفسه، الذي يجعل مقاطعاته الداخلية 6 و15 و16 "Timer.0" و"Timer.1" و"Timer.2". الجدول أيضًا يضع 15 عند المستوى 3 و16 عند المستوى 5، لذا لا يُستخدم هنا سوى CCOMPARE0. تستخدم بيئة التشغيل CCOMPARE0 ومقاطعة المعالج 6 لنبضتها، وهي التي يستخدمها كل منفذ Xtensa.
WSR إلى CCOMPARE هو ما يُفعِّل المقارن، وكتابته تمسح أيضًا المقاطعة المعلّقة. هذه قاعدة العتاد وهي القاعدة هنا. تفصيلان في النموذج، كلاهما مقصود وكلاهما لأن الزمن المُحاكى ليس ساعةً متدرجة:
- العتاد الحقيقي يرفع المقاطعة في الدورة الوحيدة التي يساوي فيها
CCOUNTالمقارن ويثبّتها حتى يُكتب في المقارن مجددًا. هنا المقارنة "بلغ أو تجاوز"، لأن نواة متوقفة فيWAITIتتوقف عن إنهاء التعليمات بينما يستمر الزمن في التحرك، وكانت ستتجاوز الدورة الوحيدة المهمة دون أن تلمسها. ولمعالج يضبط الموعد التالي (وهو كل استخدام لهذا السجل)، يتطابق السلوكان. - الموعد الذي مضى لا يُفعَّل. يحتاج معالج الاستثناء بضع مئات من الدورات، فمقارن مضبوط على "الآن" يصبح في الماضي قبل أن يعود معالج الاستثناء، فينطلق فورًا مجددًا، ولا ينال البرنامج المقاطَع سوى تعليمة واحدة في كل مرة. ثلاث ثوانٍ من
blinkكانت تكلّف 200 مليون تعليمة قبل هذه القاعدة وأقل من نصف مليون بعدها.
MOVSP لا يرفع استثناء Alloca هنا؛ بل يقوم بما يقوم به الاستثناء ومعالجه معًا. على العتاد MOVSP يقع الفخ عندما تكون نافذة المُستدعي قد فُرِغت مسبقًا (WINDOWSTART شاغرة من أجل WINDOWBASE - 1 إلى - 3)، والمعالج ينسخ منطقة الحفظ الأساسية الخاصّة بالمُستدعي a0..a3, منطقة الحفظ الأساسية في الـ 16 بايت الواقعة أسفل مؤشر المكدس القديم، إلى ما دون المؤشر الجديد قبل النقل. هذا النموذج يجري تلك النسخة في مكانها ثم ينقل (crates/xtensa-core/src/cpu.rs, movsp). الكود يعتمد على هذا فعلًا: يحيط clang-v3 كل استدعاء يمرّر وسائطه على المكدس بـ movsp a1, a8، وقبل إجراء هذه النسخة كان كود يستدعي WiFi.scanNetworks() (ثماني وسائط مع this) انهار تحت حدّ النافذة الأدنى في طريق العودة. وكذلك أي عنصر طويل setup() يستدعي sprintf بأكثر من ستة وسائط بعد طباعات كافية لتجاوز مستدعيها: يُطبع كل شيء، ثم exccause=9 عند WindowUnderflow8 كـ setup() يعود (على ESP32 و S3؛ أما C3 و Pico فلا نافذة لديهما). crates/xtensa-core/tests/alloca.rs يشغّل CALL8 و CALL12 إطارات يحرّك كل منها مؤشر المكدس إلى الأسفل ثم إلى الأعلى بـ MOVSP حول استدعاء، عند كل عمق من 0 إلى 40، و web/src/compile/xtensa-movsp.test.ts يشغّل الكود على كلتا اللوحتين.
The FPU is modeled. The ESP32's single-precision coprocessor runs on this model (crates/xtensa-core/tests/fpu.rs): the loads and stores (LSI, SSI, LSX, SSX and their post-incrementing forms), ADD.S, SUB.S, MUL.S, the fused MADD.S, MSUB.S and MADDN.S, the conversions (FLOAT.S, UFLOAT.S, TRUNC.S, UTRUNC.S, ROUND.S, FLOOR.S, CEIL.S), the compares into the boolean registers with BT, BF, MOVT and MOVF, the conditional moves, WFR, RFR, FCR and FSR, and the division and square-root steps libgcc's __divsf3 and newlib's sqrtf are built from, which return the correctly rounded IEEE answer. Arithmetic rounds to nearest whatever FCR says and sets no FSR flags. On this bare-metal model the coprocessor is on from reset, as there is no OS to turn it on at first use; the system model (docs/micropython-esp32.md) still waits for CPENABLE. So a float in an example built by Espressif's GCC through firmware/esp32/build.sh runs and prints the right number, and the browser's soft-float builds (-Xclang -target-feature -Xclang -fp, calls into mokxi_float.c) are unchanged.
5. نموذج الزمن، والمجس، والكتابة المباشرة، وقناة المضيف
يعمل المعالج بتردد 240 MHz، تعليمة واحدة لكل دورة، ويعمل ناقل الملحقات بتردد 80 MHz. لا يمثل 240 MHz عددًا صحيحًا من البيكوثانية في الدورة، لذا يُعاد حساب زمن التعليمة k بالصيغة ps_for(k) = k * 12500 / 3 بدلًا من تجميعه (كما في Blue Pill و XIAO)، وشريحة من 2400 تعليمة تساوي 10 us بالضبط.
داخل شريحة زمنية، عدد التعليمات هو الساعة: قراءة مؤقّت وبايت من UART وتغيّر طرف، كلها تُسجَّل عند التعليمة التي سبّبتها لا في نهاية الشريحة. قطعة اللوحة تحوّل هذه إلى نداءات drive_after عند الإزاحات نفسها، فكتابتان تفصلهما أربع تعليمات متباعدتان فعلًا 16.7 ns على الشبكة. وRSR.CCOUNT يقرأ الساعة نفسها.
نواة متوقفة في وضع WAITI لا تكلّف شيئًا: تطلب اللوحة إيقاظها عند الأبكر بين موعد CCOMPARE التالي وحافة LEDC التالية، كما يوقظها تغيّر طرف أو بايت من المضيف.
قراءة المدخلات بعد كتابة المخرجات تنتظر الدائرة. تعمل النواة بشريحة زمنية متقدمة على الدائرة، وGPIO_IN_REG يحمل المستويات المأخوذة عند بدء الشريحة. فبعد أن تنقل كتابة GPIO أو IO_MUX طرفًا في شريحة ما، لا تُجاب قراءة GPIO_IN_REG أو GPIO_IN1_REG: يعيد الناقل BusError::Retry، وxtensa-core يوقف النواة قبل تلك التعليمة دون تنفيذ أي شيء منها، وتنتهي الشريحة هناك، وتضع اللوحة النقل على الشبكة، ثم تأخذ الشريحة التالية عيّنة من المدخلات وتنفّذ القراءة. مسح لوحة مفاتيح (تشغيل عمود ثم قراءة الصفوف) وسلك بين طرف وآخر، كلاهما يقرأ ما فعلته الدائرة بالكتابة. تتوقف لوحات AVR قبل قراءة كهذه بالطريقة نفسها.
probe قناع بتّي، وليس مستوى، لأن هذه اللوحة فيها أربعة أشياء تستحق أن تُقال:
| البت | المعنى |
|---|---|
| 1 | قيد التشغيل |
| 2 | متوقفة في waiti |
| 4 | أن LED الأزرق على GPIO 2 مضاء |
| 8 | حاول البرنامج الثابت جعل أحد الأطراف من GPIO 34 إلى 39 مخرجًا فرُفض |
0 تعني عدم وجود برنامج، أو الإبقاء في إعادة الضبط، أو انهيارًا. البت 8 لا يرتبط بحالة التشغيل: البرنامج الذي رُفض له مخرج من قبل يبقى مرفوضًا، وتواصل اللوحة إبلاغ ذلك.
poke: 1 يُبقي BOOT (GPIO 0 منخفضًا)، و0 يحرره؛ و2 يُبقي EN، و3 تُطلقه.
قناة المضيف. تضع host_write البايتات في FIFO الخاص باستقبال UART0 (وما لا يتسع له حجمه البالغ 128 بايت يُحتفظ به ويصل بايتًا بايتًا كل فترة بايت مع قراءة الكود لها، تمامًا كما تتقاطر بايتات لوحة حقيقية بمعدل البود في المخزن الحلقي لنواة Arduino بدلًا من إسقاطها)؛ وتأخذ host_read البايتات التي غادرت FIFO الخاص بالإرسال. هذا هو Serial في الكود والشاشة التسلسلية في الواجهة. البايتات بصيغة UTF-8 من وجهة نظر الواجهة، وغير شفافة بالنسبة للنموذج. مقبس micro-USB في DevKit متصل بجسر CP2102 أو CH340 على هذا المنفذ؛ الجسر نفسه غير مُمثَّل، وكذلك إعادة التعيين التلقائية عبر DTR/RTS.
انهيار. بعد 1000 مصيدة متتالية دون أي تقدّم، يُعلَن انهيار النواة وتُوقَف، مع تسجيل مكان توقفها.
6. ما الذي يكون هذا النموذج واثقًا منه وما لا يكون واثقًا منه
ثلاث مجموعات، ثم رابعة للتقريبات التي لا علاقة لها بالعناوين أصلًا. يوجد هذا القسم لأن نموذج لوحة يخمّن عنوانًا بصمت هو أسوأ من نموذج يقول إنه لم يعرف.
مأخوذ من الدليل الفني المرجعي
DPORT_BASE 0x3FF0_0000، وUART0_BASE 0x3FF4_0000، وGPIO_BASE 0x3FF4_4000، وSENS_BASE 0x3FF4_8800، وIOMUX_BASE 0x3FF4_9000، وLEDC_BASE 0x3FF5_9000 وTIMG0_BASE 0x3FF5_F000. كل إزاحات السجلات داخل مصفوفة GPIO وداخل UART0، وRXFIFO_RST (البتة 17) وTXFIFO_RST (البتة 18) من السجل UART_CONF0_REG في البند 19.9، وUART_STATUS_REG بقيمه الثماني البتات RXFIFO_CNT وTXFIFO_CNT (السجل 19.8)، وعتبات UART_CONF1_REG (السجل 19.10) والقاسم ذو العشرين بتة في UART_CLKDIV_REG (السجل 19.6). وقناع مقاطعات المعالج من المستوى 1 0x0006_37FF (من 0 إلى 10، و12، و13، و17، و18)، ومقاطعات CCOMPARE رقم 6 و15 و16، وكلاهما من الجدول 8.3-2 (القسم 4). ونافذة IRAM عند 0x4008_0000 ونافذة DRAM عند 0x3FFB_0000. وGPIO_FUNC_OUT_SEL = 256 لخيار "تابع GPIO_OUT". وقيمة MCU_SEL وهي 2 لوضع GPIO العادي. وخريطة قنوات ADC1: القنوات من 0 إلى 7 هي GPIO 36، 37، 38، 39، 32، 33، 34، 35. والأطراف GPIO الأربعون، وأن الأطراف من 6 إلى 11 مخصصة للفلاش، وأن الأطراف من 34 إلى 39 لا تحتوي على مشغّل إخراج. وLED الأزرق على GPIO 2 وزر BOOT على GPIO 0. وإزاحات متجهات Xtensa وأرقام EXCCAUSE، وهي تابعة لمجموعة التعليمات وليس للشريحة.
مُعتقَد، غير مُتحقَّق منه
- جدول ترتيب أطراف IO_MUX (القسم 3.2). السجلات مرتبة حسب ترتيب الأطراف، وهذا هو تفسير هذا الطراز لأي طرف يقابل كل GPIO.
- إزاحات سجلات مجموعة المؤقتات 0 (القسم 3.4). الأساس من الدليل؛ أما التنسيق داخله فليس كذلك.
- تخطيط كتلة LEDC (القسم 3.6): خطوة القناة، وكتلة المؤقت عند
0x140وسجلات المقاطعة والإعداد. الأساس مأخوذ من الدليل. - إزاحات SENS ومواضع البتات (القسم 3.5).
DPORT_INTR_MAP= 0x104، ورقما المصدرين GPIO 22 وUART0 34 (القسم 3.7).- مؤشرات إشارات مصفوفة GPIO من 71 إلى 78 لقنوات LEDC عالية السرعة من 0 إلى 7 (القسم 3.1). هذا أضعف ادعاء في المستند.
كل واحد منها مسمّى في موضع يقرؤه البرنامج الثابت (firmware/esp32/include/esp32.h)، فأي صورة تُنقل إلى شريحة حقيقية لديها قائمة قصيرة من تعريفات #define للتحقق منها. ويُلزم ملف crates/esp32/tests/contract.rs تلك الترويسة وcrates/esp32/src/map.rs بالأرقام نفسها، فلا يمكن للنصفين أن يفترقا؛ لكن ذلك لا يجعل أيًّا منهما صحيحًا.
محاكاة موجودة، لكنها ليست مطابقة لأرقام الدليل
هذه تقريبات لا عناوين، والكود يستطيع رؤية كل واحد منها:
- تُقرأ حقول آلة الحالة في
UART_STATUS_REGبالقيمة 0 (القسم 3.3). على الشريحة الحقيقيةST_URX_OUTوST_UTX_OUTتتحرك أثناء انتقال بايت على السلك؛ لكن بيئة التشغيل تقرأ العدادات الثمانية فقط، فهي لا ترى الفرق. - منحنى ADC عند 11 dB هو منحنى قطعة نموذجية، وليس منحنى هذه الوحدة بعينها. القراءة الخام تتبع مقاربة مبنية على قياسات ESP32s فعلية (القسم 3.5): المنطقة الميتة في الأسفل، والانحناء في الأعلى، والتشبع عند نحو 3.15 V كلها موجودة، أما التباين بين الوحدات الذي تصححه معايرة eFuse فغير موجود. أما التوهينات الأخرى فهي خطوط مستقيمة اسمية.
- كل طرف يستيقظ بالحالة نفسها (القسم 3.2): GPIO عادي، والمخزن المؤقت للإدخال مفعّل، وبلا مقاومة سحب. الدليل يعطي أطراف strapping وأطراف الفلاش قيم إعادة ضبط مختلفة.
GPIO_STRAP_REGقيمة ثابتة,0b1101، لا سجلًا يحفظ حالة الأطراف لحظة إعادة الضبط.- التحويل يستغرق 5 us تمامًا وحافة LEDC تقع على البيكوثانية بالضبط. القطعة الحقيقية فيها تذبذب، ولا يُعدّ أي من الرقمين رقمًا من ورقة البيانات.
ENليست سوى مقاومة سحب بقيمة 10 k. مكثف إعادة ضبط التشغيل 100 nF المجاور له غير محاكى، لذا فإنENمجرد إفلاته يعود هنا فورًا.- لا توجد ذاكرة قراءة للإقلاع، ولا شجرة ساعات. جهاز ESP32 حقيقي يقضي عشرات الميلي ثانية في محمّل المرحلة الأولى قبل أول تعليمة من الكود؛ هنا
POWER_ONيساوي 1 us، والنواة عند 240 MHz وساعة APB عند 80 MHz منذ التعليمة الأولى، ولا يوجد ما يمكن ضبطه في أي منهما أصلًا. CCOMPAREيقارن "وصل الموعد أو تجاوزه"، وموعدٌ في الماضي لا يُفعَّل (القسم 4).MOVSPلا يرفع استثناء Alloca أبدًا؛ بل يجعل معالج الاستثناء ينسخ منطقة حفظ الأساس بنفسه (القسم 4).- نافذتا RAM غير مترادفتين. على القطعة الحقيقية تظهر ذاكرة SRAM نفسها عبر الناقلين بعنوانين مختلفين، مع كتل SRAM1 بترتيب معكوس (القسم 2).
مُستبعد عمدًا
كل واحد من هذه العناصر استُبعد بدل أن يُخترع:
- النواة الثانية. يحتوي ESP32 على نواتين Xtensa LX6، PRO وAPP، ونواة PRO وحدها تعمل هنا. لا يوجد
DPORT_APPCPU_CTRL، ولا مقاطعة عابرة للنواتين، ولا FreeRTOS لجدولتهما. كود مكتوب لـloop()الوحيدة في نواة Arduino لا يلاحظ شيئًا؛ أما أي شيء يبدأ مهمة على النواة 1 فلن يعمل. - The cache, the MMU and flash. Code and constants are read from two fixed, read-only windows (section 2.1); there is no flash device, no MMU and no cache to miss, so a fetch from flash is as fast as one from IRAM.
PSRAMlikewise. - WiFi وBluetooth، في كل صورة: لا راديو، لا حزمة بروتوكولات، لا
WiFi.h، ولا حتى كعب يفشل بأدب. - ساعة الوقت الحقيقي RTC، وذاكرتها البطيئة، والمعالج المساعد ULP، والنوم العميق، ووحدة إدارة الطاقة.
- ADC2، وDMA الخاص بـ SAR والمتحكم الرقمي، ومعايرات eFuse، والمرجع الداخلي، وحساس اللمس وحساس هول.
- مجموعة LEDC منخفضة السرعة وعتاد تلاشي دورة العمل الخاص بها.
- مجموعة المؤقتات 1، والمؤقت 1 من مجموعة المؤقتات 0، وكلب حراسة RTC وكلب حراسة المقاطعات.
- I2C وSPI وI2S وRMT وعدّاد النبضات وPWM الخاص بالمحرك وSDIO وEthernet ووحدة CAN ومعجلات AES وSHA وRSA وRNG.
- مصفوفة المقاطعات عدا مصادر القسم 3.7، وكل مستوى مقاطعة للمعالج أعلى من المستوى الأول.
لهذا لا تعمل الملفات الثنائية الرسمية لـ ESP-IDF ونواة Arduino هنا، بينما يعمل البرنامج الثابت المبني وفق هذا المستند.
صورتا لوحتي Xtensa غير قابلتين للتبادل أيضًا. سلسلة program في الفهرس هي elf32 xtensa lx6 esp32 هنا وelf32 xtensa lx106 esp8266 على NodeMCU، والفرق حقيقي لا مجرد تسمية: هذه النواة تشغّل ABI بنوافذ وتلك لا تملك نافذة تشغّله بها، فالصورة المبنية لواحدة تنهار على الأخرى بدل أن تعمل بشكل خاطئ بهدوء.
7. بيئة تشغيل البرنامج الثابت (firmware/esp32/)
An Arduino-shaped runtime: setup() and loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (with analogReadResolution, analogSetAttenuation and analogSetPinAttenuation), analogWrite and the ledcAttach/ledcWrite/ledcRead family, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, Serial1 and Serial2, map, random. No Arduino core, no ESP-IDF, no 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 is 2. The core has no BOOT_BUTTON: the BOOT button is GPIO 0, so sketches use 0. A0 is 36, and A3 to A7 are 39, 32, 33, 34 and 35, which is what the DevKit's own analog pins are called.
analogRead هو ADC1 أحادي التشغيل (القسم 3.5)، باثني عشر بت عند 11 dB افتراضيًا. أما analogWrite(pin, 0..255) فهو ثمانية بتات عند 1 kHz على أي طرف GPIO لديه مُخرِج، ويُلحِق قناة LEDC عالية السرعة حرة في أول مرة يُستدعى فيها؛ وledcAttach(pin, frequency, bits) هو ما يحتاجه الكود عندما يكون التردد مهمًا، والقنوات التي تطلب التردد والدقة نفسيهما تتشارك أحد المؤقتات الأربعة. وmokxi_pin_is_input_only(pin) موجودة ليستعلم الكود قبل أن يُرفَض.
millis() وmicros() يأتيان من المؤقت 0 في مجموعة المؤقتات 0 بنبضة كل ميكروثانية (القسم 3.4). أما delayMicroseconds() تحت 50 us فيَعُدّ CCOUNT، بواقع 240 دورة لكل ميكروثانية، فلا يكون أبدًا أقصر مما طُلب (فعدّ مؤقت الميكروثانية قد يجعل delayMicroseconds(10) تساوي 9.01 us، وهو ما يتجاهله HC-SR04 كإشارة إطلاق)؛ ومن 50 us فأكثر ينتظر مثل delay(). وdelay() يوقف النواة على CCOMPARE0 بدلًا من الدوران في حلقة، لذا فإن ثانية من blink تكلّف النواة أقل من نصف مليون تعليمة من أصل 240 مليون دورة عدّها الساعة. وattachInterrupt ثلاث كتابات بدلًا من واحدة، لأن الطرفية تصل إلى النواة عبر مصفوفة المقاطعات (القسم 3.7).
Serial1 وSerial2 هما src/uartn.c على UART1 وUART2 (القسم 3.3a)، موصولَين عبر مصفوفة GPIO إلى الأطراف التي يسمّيها begin(baud, config, rx, tx) أو setPins()، مع القيم الافتراضية لـ arduino-esp32 3.x عند عدم تحديدها (GPIO 26 و27 لـ Serial1، و4 و25 لـ Serial2). وهو يسلك سلوك مشغّل ESP-IDF في النواة: REF_TICK حتى 250 000 باود وAPB فوق ذلك، ومقاطعة عند RXFIFO_FULL (120 بايت) أو عند مهلة استلام رمز واحد تنقل الـ FIFO إلى حلقة بحجم setRxBufferSize() بايت (256)، إما المقطع كله أو لا شيء، مع إبقاء المقطع جانبًا وإيقاف مقاطعات الاستلام بينما الحلقة ممتلئة، ومقاطعة الفيض تفرّغ الـ FIFO في الأثناء؛ وavailable() يَعُدّ الحلقة فقط. وwrite() ينتظر على FIFO بسعة 128 بايت، وflush() حتى يهدأ المرسِل. وكلا الـ UART يشاركان مقاطعة المعالج 18. وonReceive() يعمل من mokxi_uartn_events()، الذي تستدعيه delay() وyield() وحلقة main.cpp (بين استدعاءات loop())، لأنه لا توجد مهام FreeRTOS. وغير موجود: التحكم بالتدفق، وRS-485، وIrDA، والباود التلقائي، وحلقة إرسال.
الأمثلة المرفقة تبنيها GCC من Espressif، بينما كود المستخدم تبنيه clang. لا يستطيع ld.lld من LLVM الرسمي ربط Xtensa إطلاقًا، لذا يستخدم المتصفح clang-v3، بناء wasm من نسخة Espressif المتفرعة من LLVM، الذي يبني كل مثال هنا بقائمة أوامر المتصفح (docs/compile.md). ملفات ELF الجاهزة تبقى من GCC: فهي أصغر حجمًا (docs/compile.md، "Code size") ولا حاجة لتغييرها. وdeploy/fetch-xtensa.sh يضع xtensa-esp32-elf-gcc بإصدار 8.4.0 في tools/xtensa/، وهو مستثنى من git: لأن GCC مرخّص بترخيص GPL، ولا شيء مما يبنيه هنا يرتبط مع libgcc أو أي جزء آخر من سلسلة الأدوات، لذا لا يصل أي كود GPL إلى ملف ELF يُشحن. وdocs/compile.md يضم الشرح الكامل والخطوات المتبقية.
crt0.S يحمل معالجات فيض وتقاعِس النوافذ الستة عند VECBASE، مكتوبةً من مرجع ISA لا من أي مصدر للبائع، ويمنح الإطار الجذري منطقة حفظ أساسية خاصة به: ففيض نافذة للإطار الجذري ينفّذ l32e a0, a1, -12 ليجد مؤشر المكدس للمستدعي ثم يكتب عبره، والإطار الجذري لا مستدعي له، لذا يُبنى واحد على مسافة أربعة وستين بايت أسفل قمة المكدس. وبدونه فإن أول سلسلة استدعاءات عميقة تفيض عبر مؤشر فارغ.
مدخل الاستثناء لا يمسّ a1، وهذا هو أساس الصحّة لا مجرد ترتيب: فالمعالج يعمل في نافذة الدالة المقطوعة نفسها، وفيض نافذة لإطار أقدم يجد مكان الفيض بقراءة مؤشر المكدس من تلك النافذة. حرّك a1 وكل إطار أقدم يفيض إلى المكان الخطأ ويعود مشوّهًا. السجلات المُقاطَعة تُوضع في كتلة ثابتة في .bss بدلًا من ذلك، وهو آمن دون قفل لأن المعالج يعمل عند INTLEVEL 1.
Linked against firmware/esp32/link.ld: the vectors and startup code in the 128 KB of IRAM, code in the flash code window, constants in the flash constants window, .data, .bss and the stack in the 192 KB of DRAM. A WROOM-32 has 4 MB of flash and an example should be a small part of it, so the build refuses an image with more than 64 KB loadable; the real ceiling the linker script enforces is the 1,310,720 bytes of the default app partition.
خمسة أمثلة، يعرض المحرر كود كل منها: blink (LED اللوحة على GPIO 2 وآخر موصّل على GPIO 4)، button (مفتاح إلى GND على GPIO 15 مع مقاومة الرفع الداخلية في اللوحة)، serial (نبضة كل ثانية، وصدى لما تكتبه)، fade (LED على GPIO 4 عبر LEDC بدقة ثماني بتات وتردد 1 kHz) وknob (مقاومة متغيرة على GPIO 32، وهي القناة 4 في ADC1، تخفّض إضاءة LED على GPIO 4 مع طباعة القراءة الخام). أما pzemmonitor، وهو عدّاد طاقة PZEM-004T على Serial2 (GPIO 16 و17) عبر مكتبة PZEM004Tv30، فيتم بناؤه بواسطة مترجم المتصفح بدلًا من GCC (القسم 4)، وهو مشروع ESP32 PZEM-004T energy monitor.
crates/esp32/tests/runtime.rs يشغّل ملفات ELF الخمسة تلك ويقيس بدلًا من أن يراقب: نصف دورة blink ضمن 5 ms من 500، ودورة LEDC ضمن 5 us من 1 ms الخاصة بـ 1 kHz، وmillis() ضمن 60 ms من ساعة النواة نفسها على مدى خمس ثوانٍ، ولا يوجد بايتان على UART0 أقرب من 86.8 us الخاصة بـ 115200 باود. كل اختبار يتخطى نفسه عندما لا تكون الصور مبنيّة، فلا تعتمد اختبارات الحزمة أبدًا على وجود المترجم المتقاطع.