المرجع

عقد لوحة ESP32-S3-DevKitC-1 (Boards Wave C)

اللوحة S3 على نواة Xtensa LX7: ذاكرة SRAM واحدة تُرى عبر ناقلين، ومصفوفة GPIO، ومنفذ USB التسلسلي، وLEDC، وRMT خلف LED RGB، ونواة واحدة حيث للشريحة نواتان.

هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة ESP32-S3-DevKitC-1 و صفحة اللوحة.

ESP32-S3-DevKitC-1 هي لوحة Espressif الرسمية لـ ESP32-S3: وحدة ESP32-S3-WROOM-1، ونواة Xtensa LX7 بسرعة 240 MHz، ومنفذا micro-USB، وLED RGB قابل للعنونة. مكوّن نواة واحد (esp32s3 في crates/parts) يغلّف نموذج SoC لـ ESP32-S3 (crates/esp32s3) على نفس مفسّر Xtensa الذي تستخدمه ESP32 الكلاسيكية وESP8266 (crates/xtensa-core). هذا المستند هو العقد المرجعي، وهو يسود على أي تعليق في الكود.

نوع اللوحة في الفهرس هو esp32s3. نص program في الفهرس هو elf32 xtensa lx7 esp32s3.

اقرأ القسم 6 أولًا إذا كنت ستنقل بناءً من هنا إلى شريحة حقيقية. خلافًا لعقد ESP32 الكلاسيكية، تم التحقق من كل رقم هنا تقريبًا مقابل صفحة من ESP32-S3 Technical Reference Manual (الإصدار 1.8) وESP32-S3 Series Datasheet ودليل المستخدم ورسم الأبعاد الخاصين بلوحة DevKitC-1 من Espressif. يذكر القسم 6 القليل الذي لم يُتحقق منه، وكل ما لا تتم محاكاته أصلًا: النواة الثانية، وإضافة المتجهات، والذاكرة المخبئية، وflash، وPSRAM، وكلا جهازي الراديو من بينها.

A sketch for this board compiles in the browser with clang-v3, the wasm build of Espressif's LLVM fork (-mcpu=esp32s3), published 2026-09-28 and checked on this simulator (docs/compile.md). An untouched example still runs its prebuilt ELF from web/public/firmware/esp32s3/, built by Espressif's GCC for the S3. Section 7 has the details.

1. أطراف اللوحة (بترتيب الفهرس)

منظر علوي، المنفذان micro-USB في الأسفل، ووحدة WROOM-1 وهوائيها في الأعلى. يحدد رسم الأبعاد من Espressif حجم اللوحة بـ 62.74 x 25.40 mm، مع بُعد كل صف أطراف 1.27 mm عن حافته، لذا يفصل بين الصفين ذوَي الـ 22 طرفًا مسافة 22.86 mm (0.9 inch)، وتتوسط اللوحة لوحة التجارب تاركة صفًا واحدًا من الفتحات حرًّا على كل جانب. الرسم المرئي يرسمها بهذا الحجم.

J1، الصف الأيسر، الطرف 1 في الأعلى (22 فتحة): 3V3، 3V3b، RST، 4، 5، 6، 7، 15، 16، 17، 18، 8، 3، 46، 9، 10، 11، 12، 13، 14، 5V، G.

J3، الصف الأيمن، الطرف 1 في الأعلى (22 فتحة): Gb، TX، RX، 1، 2، 42، 41، 40، 39، 38، 37، 36، 35، 0، 45، 48، 47، 21، 20، 19، Gc، Gd.

44 طرفًا. الرقم يعني GPIO n. TX وRX هما GPIO43 وGPIO44، على UART0. RST هو طرف تمكين الشريحة. 5V هو خط 5 V القادم من USB. G هو الأرضي. تحمل الأسماء المكررة حرفًا لأن أسماء الأطراف في الفهرس فريدة، والطباعة الحريرية لا تطبع هذا الحرف.

تم التحقق: من ترتيب كلا الصفين، طرفًا بطرف، مقابل جدولَي J1 وJ3 في دليل المستخدم (الدليلان v1.0 وv1.1 يعطيان الترتيب نفسه)، ومن موضع الصفين مقابل رسم الأبعاد.

الأطراف GPIO 26 إلى 32 ليست على أي من الموصّلين. إنها ذاكرة SPI flash. الأطراف GPIO 22 إلى 25 غير موجودة على الشريحة أصلًا (لا يحتوي جدول وظائف IO MUX على صفوف لها). والطرفان GPIO 33 و GPIO 34 ليسا على الموصل أيضًا. يحتوي crates/parts/src/parts/esp32s3.rs على اختبار يثبت كل هذا.

الأطراف GPIO 35 و 36 و 37 موجودة على الموصل، وفي الطرازات ذات ذاكرة PSRAM الثمانية (مثل DevKitC-1-N8R8 التي يشتريها معظم الناس) إنها مخصصة لـ PSRAM ولا يجوز استخدامها. لا يتضمن هذا النموذج ذاكرة PSRAM، لذا فهي هنا أطراف عادية، وتتكرر ملاحظة دليل المستخدم في صفحة المساعدة.

الطرفان GPIO 19 و GPIO 20 هما D- و D+ لمنفذ USB في الشريحة، وهما موصولان بمقبس "USB" على اللوحة. هنا يبقيان لحمتين عاديتين ويظل المنفذ التسلسلي USB يعمل حتى عندما يقودهما كود، وهو ما لا تفعله لوحة حقيقية (القسم 3.4).

العناصر الموجودة على اللوحة:

  • The RGB LED. An addressable LED, on GPIO48 on the first revision and on GPIO38 on v1.1. The user guide's "Hardware Revision Details" says this is the one difference between the two. The revision property picks which, 1.0 or 1.1, and defaults to 1.0, which is where the Arduino core's board definition puts it. The LED's data line is the pad; the board part decodes the pad the way the LED's own receiver does (section 5).
  • BOOT هو GPIO0، منخفض عند التفعيل؛ النقر عليه على اللوحة يوصل الطرف بالأرضي. وهو موجود على J3 أيضًا كـ 0.
  • RST يعيد تعيين الشريحة.
  • LED طاقة أحمر بجهد 3.3 V، مرسوم مضيئًا، لأن اللوحة موصولة دائمًا بـ USB هنا.

كهربائيًا: كل طرف GPIO يدفع بدفع-سحب عند 3.3 V عبر R_STRONG، أو يبقى بحالة عالية المقاومة، أو يسحب للأعلى أو للأسفل عبر 45 k. يقرأ المدخل قيمة عالية عند 1.65 V (نصف جهد تغذية الإدخال/الإخراج)؛ والشبكة المتنازَع عليها (Unknown) تُقرأ 0، والشبكة الطافية تُقرأ ضجيجًا، كما في Uno (docs/uno.md القسم 1). يقرأ GPIO0 قيمة عالية عندما لا يمسكه شيء، بفعل المقاومة الرافعة على اللوحة بجوار زر BOOT. 3V3 يدفع 3.3 V عبر R_SUPPLY، و5V يدفع 5 V، وG يدفع 0 V. يحمل RST مقاومة رافعة بقيمة 10 k إلى 3.3 V، وسحبه دون 1.65 V يُبقي النواة في وضع إعادة التعيين. المكثف بجوار تلك المقاومة، وهو دائرة إعادة التعيين عند التشغيل، غير مُنمذج.

2. خريطة الذاكرة

SRAM1، ناقل التعليمات 416 KB من 0x4037_8000 إلى 0x403D_FFFF
IROM (flash code) 0x4200_0000, read-only, up to 1,310,720 bytes
DROM (flash constants) 0x3C00_0000, read-only, up to 1,310,720 bytes
SRAM1 و SRAM2، ناقل البيانات 480 KB من 0x3FC8_8000 إلى 0x3FCF_FFFF
قمة المكدس 0x3FD0_0000
UART0 0x6000_0000، القسم 3.3
مصفوفة GPIO 0x6000_4000، القسم 3.1
SENS 0x6000_8800، القسم 3.6
IO MUX 0x6000_9000، القسم 3.2
RMT 0x6001_6000، القسم 3.8
LEDC 0x6001_9000، القسم 3.7
SYSTIMER 0x6002_3000، القسم 3.5
USB Serial/JTAG 0x6003_8000، القسم 3.4
SYSTEM 0x600C_0000، القسم 3.9
مصفوفة المقاطعات 0x600C_2000، القسم 3.9

كل كتلة طرفية (peripheral) هنا بحجم 4 KB، عدا SENS التي تشغل 2 KB العلوية من كتلة إدارة الاستهلاك المنخفض.

تم التحقق: من كل عنوان في الجدول مقابل الجدولين 4.3-1 (الذاكرة الداخلية) و4.3-3 (الطرفيات) في الدليل. SENS هو "العنوان الأساسي لإدارة الاستهلاك المنخفض + 0x800" حسب ملخص السجلات 39.6.2 في الدليل.

ذاكرة SRAM واحدة، بنافذتين، والنموذج يجمعهما معًا. يقول الدليل إن SRAM1 "يعالجه المعالج عبر ناقل البيانات أو ناقل التعليمات بالترتيب نفسه": البايت الموجود عند 0x4037_8000 + n هو البايت الموجود عند 0x3FC8_8000 + n. يحتفظ النموذج بمخزن مؤقت واحد لنافذة البيانات ويطابق نافذة التعليمات على أول 416 KB منه، فيستطيع البرنامج قراءة كوده الخاص عبر ناقل البيانات والحصول على البايتات الصحيحة، وهو ما لا يستطيع نموذج ESP32 الكلاسيكي تقديمه. أما SRAM2 فهو على ناقل البيانات فقط، مباشرة بعد SRAM1. يضع firmware/esp32s3/link.ld الكود عند عنوان التعليمات ويبدأ أقسام البيانات عند عنوان ناقل البيانات لأول بايت بعد الكود، فلا يتشارك الاثنان ذاكرة RAM أبدًا، كما يرفض elfcheck.py أي صورة قد تتسبب في ذلك.

SRAM0، وهو الـ 32 KB الموجودة عند 0x4037_0000 التي يمكن لذاكرة التعليمات المؤقتة (cache) استخدامها، غير مُمثَّل في النموذج؛ وأي وصول إليه يُعتبَر خطأً.

Flash. A real ESP32-S3 runs almost all of a sketch from flash through the cache: code is read at IROM and const data at DROM, and the Arduino IDE's default partition gives the sketch 1,310,720 bytes of it. That is the room a sketch has here, counted as the IDE counts it (code, literals, constants, startup code and the initial values of the variables), and the number the editor prints after a build. firmware/esp32s3/link.ld keeps the vectors, the exception entry and the startup code in SRAM1 on the instruction bus and puts every other function in the code window and every constant in the constants window. The windows are read-only views of the loaded image, not a cache: no misses, no timing (a fetch from flash costs what one from SRAM1 costs), and a store to one faults. Literal pools sit in front of their own functions (L32R reaches 256 KB backwards) and the startup code calls through registers (CALL4 reaches 128 KB). The upload build (link-hw.ld) is loaded into RAM by the ROM and keeps SRAM1 as its room.

Every PT_LOAD segment must land in one of the two SRAM windows 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. An image built for the classic ESP32 is refused this way, since its RAM is at other addresses.

يبدأ النواة عملية الإعادة (reset) بقيمة pc عند نقطة دخول ELF وجميع سجلات العناوين صفرية. لا توجد ذاكرة قراءة فقط للإقلاع (boot ROM) هنا: محمّل المرحلة الأولى، وقراءات الفلاش، وشجرة الساعة، وإعداد الذاكرة المؤقتة، كلها غائبة، والبيئة التشغيلية تجعل الحالة المطلوبة صريحة.

3. سجلات الطرفيات

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

3.1 مصفوفة GPIO ‏(0x6000_4000)

تتراوح أرقام GPIO من 0 إلى 48، لذلك يأتي كل سجل له بت واحد لكل طرف في نصفين: السجل العادي يغطي GPIO من 0 إلى 31، والسجل الذي ينتهي بـ 1 يغطي GPIO من 32 إلى 48 في بتاته السبعة عشر السفلى.

الإزاحة سجل
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
0x4C GPIO_STATUS_W1TC_REG
0x50 GPIO_STATUS1_REG
0x58 GPIO_STATUS1_W1TC_REG
0x74 + 4n GPIO_PINn_REG
0x154 + 4y GPIO_FUNCy_IN_SEL_CFG_REG، مُخزَّن
0x554 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG

تُجاب أيضًا صيغ W1TS لسجلات الحالة، GPIO_CPU_INT_REG/GPIO_CPU_INT1_REG (تُقرأ كالحالة)، وGPIO_BT_SELECT_REG وGPIO_SDIO_SELECT_REG وGPIO_CLOCK_GATE_REG.

تم التحقق: العنوان الأساسي وكل الإزاحات، مقابل ملخص السجلات 6.14.

GPIO_PINn_REG (السجل 6.18): البت 2 PAD_DRIVER يجعل الطرف بنمط المصفّر المفتوح (open drain)؛ البتات 7..9 INT_TYPE تحدد ما يرفع مقاطعة الطرف (0 إيقاف، 1 حافة صاعدة، 2 حافة هابطة، 3 أي حافة، 4 مستوى منخفض، 5 مستوى مرتفع)؛ والبت 13 هو تفعيل مقاطعة المعالج. تم التحقق.

GPIO_FUNCn_OUT_SEL_CFG_REG (register 6.20): bits 0..8 OUT_SEL, bit 9 OUT_INV_SEL, bit 10 OEN_SEL, bit 11 OEN_INV_SEL. OUT_SEL 256 makes the pad follow GPIO_OUT with GPIO_ENABLE as its output enable. 73 to 80 hand the pad to LEDC channels 0 to 7 (ledc_ls_sig_out0 to 7) and 81 to 84 to RMT channels 0 to 3 (rmt_sig_out0 to 3); those numbers are table 6.11-1's, verified. Both peripherals' output enables are tied high in that table ("1'd1"), so with OEN_SEL clear an LEDC or RMT channel drives its pad whatever GPIO_ENABLE says, and with OEN_SEL set GPIO_ENABLE decides. Any other OUT_SEL selects a peripheral that is not modeled, and the model treats it as 256 rather than invent a level.

يقرأ GPIO_STRAP_REG القيمة 0x08: البت 3 (GPIO0) مرتفع، والبتات 2 و4 و5 (GPIO46 وGPIO45 وGPIO3) منخفضة، وهذا إقلاع عادي من فلاش بجهد 3.3 V. إسناد البتات هو إسناد السجل 6.15؛ أما القيمة فهي ثابتة هنا، وليست تسجيلًا لما فعلته الأطراف عند إعادة التعيين.

3.2 ‏IO MUX ‏(0x6000_9000)

IO_MUX_PIN_CTRL_REG عند 0x00، ثم سجل واحد لكل GPIO عند 0x04 + 4n. على خلاف ESP32 الكلاسيكي، يأتي IO MUX في S3 بترتيب GPIO. البت 7 FUN_WPD، والبت 8 FUN_WPU، والبت 9 FUN_IE، والبتات 10..11 FUN_DRV (مُخزَّن)، والبتات 12..14 MCU_SEL. لا يصل الطرف إلى GPIO_IN_REG إلا مع تفعيل مخزن الإدخال الخاص به.

تم التحقق: العنوان الأساسي والإزاحات والبتات، مقابل السجل 6.36؛ وجدول الوظائف وقيم إعادة التعيين مقابل الجدول 6.12-1.

MCU_SEL يختار إحدى خمس وظائف كحد أقصى. الوظيفة 1 هي مصفوفة GPIO على كل طرف. على معظم الأطراف تكون الوظيفة 0 هي مصفوفة GPIO أيضًا، لكن على الأطراف 26 إلى 32 هي flash، وعلى 39 إلى 42 أطراف JTAG، وعلى 43 و 44 منفذ UART0، وعلى 47 و 48 زوج ساعة flash، لذا فإن أي برنامج يريد أحدها كـ GPIO عليه ضبط MCU_SEL على 1. ودالة pinMode في بيئة التشغيل تفعل ذلك دائمًا. LED RGB على GPIO48 هو أحدها: حتى يضبط شيء ما MCU_SEL الخاص به، لا يصل إلى تلك اللحمة شيء يكتبه البرنامج في المصفوفة.

كل لحمة تبدأ بقيمة إعادة التعيين الواردة في الدليل. عمود "RST" في الجدول 6.12-1: الطرف GPIO0 وأطراف flash مع مقاوماتها الرافعة، والطرفان GPIO45 و GPIO46 مع مقاوماتهما الساحبة، ومعظم الأطراف مع تفعيل صِوان الإدخال فقط، والأطراف GPIO 4 إلى 8 و 15 و 16 و 19 إلى 21 دون حتى ذلك، لذا فإن digitalRead على أحدها يقرأ 0 حتى يُفعَّل الصِوان. الطرف MTCK، GPIO39، يبدأ بمقاومة رافعة، وهو ما يقوله الجدول لشريحة لم تُعطَّل أطراف JTAG فيها بواسطة eFuse. الطرف GPIO43، أي U0TXD، يبدأ مع تفعيل مخرجه على UART؛ لكن موجة UART نفسها غير مُنمذجة (القسم 3.3)، لذا تحتفظ تلك اللحمة بخط الخمول العالي حتى يستولي عليها برنامج.

3.3 UART0‏ (0x6000_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
0x78 UART_CLK_CONF_REG

مُتحقَّق منه: العنوان الأساسي وكل إزاحة (ملخص السجلات 26.6)، والبتات أدناه.

ذاكرتا FIFO بسعة 128 بايت لكل منهما. البتات 0..9 في السجل UART_STATUS_REG هي RXFIFO_CNT والبتات 16..25 هي TXFIFO_CNT. البت 17 في السجل UART_CONF0_REG وهو RXFIFO_RST والبت 18 وهو TXFIFO_RST تفريغانهما (السجل 26.9؛ في نموذج ESP32 الكلاسيكي موقع هذين البتين معكوس، القسم 6). يخزن السجل UART_CONF1_REG عتبتي FIFO، عشر بتات لكل منهما، وقيمتهما 96 عند إعادة الضبط. البتات 0..11 في السجل UART_CLKDIV_REG هي الجزء الصحيح من القاسم والبتات 20..23 هي أجزاء من ستة عشر، وقيمته 694 عند إعادة الضبط.

يقسم القاسم ساعة نواة UART، والتي تختارها البتات 20..21 من UART_CLK_CONF_REG وهي SCLK_SEL: القيمة 1 تعني ساعة APB بتردد 80 MHz، والقيمة 3 تعني المذبذب البلوري بتردد 40 MHz، والبلوري هو القيمة عند إعادة الضبط (السجل 26.18). القيمة 2، مذبذب RC_FAST، غير مُنمذجة وتُعامَل معاملة البلوري. يقسم SCLK_DIV_NUM (البتات 12..19) ساعة النواة على SCLK_DIV_NUM + 1، وهذا مُفترض: إذ يسمّي الدليل الحقل «الجزء الصحيح من قاسم التردد» ويطبع القاسم دون الواحد، وقيمة الحقل عند إعادة الضبط هي 1. يضبط وقت التشغيل SCLK_SEL على 1 وSCLK_DIV_NUM على 0، وعندها يصبح 694 يعادل 115 274 باود. القسمان الكسريان SCLK_DIV_A/SCLK_DIV_B غير مُنمذجين.

تغادر البايتات مخزن الإرسال المؤقت بمعدل البود لا فورًا، لذا ينقل منفذ بمعدل 115 200 بود 11 520 بايتًا في الثانية هنا كما على منضدة حقيقية؛ ويتحقق الملف crates/esp32s3/tests/runtime.rs من أن أي بايتتين في مثال serial لا تقل المسافة بينهما عن زمن بايت واحد.

لا يُنمذج UART1 و UART2، كما لا يُنمذج شكل الموجة على طرف U0TXD: فالبايتات هي قناة المضيف وليست بتّات على GPIO43.

3.4 منفذ USB التسلسلي/JTAG ‏(0x6003_8000)

النصف التسلسلي من المتحكم: منفذ CDC-ACM الذي يحمله مقبس «USB» في اللوحة، والذي يصل إليه الكود باسم USBSerial.

الإزاحة سجل
0x00 USB_SERIAL_JTAG_EP1_REG
0x04 USB_SERIAL_JTAG_EP1_CONF_REG
0x08 USB_SERIAL_JTAG_INT_RAW_REG
0x0C USB_SERIAL_JTAG_INT_ST_REG
0x10 USB_SERIAL_JTAG_INT_ENA_REG
0x14 USB_SERIAL_JTAG_INT_CLR_REG
0x18 USB_SERIAL_JTAG_CONF0_REG، محفوظ

تم التحقق: العنوان الأساسي، والإزاحات (ملخص السجلات 33.5)، والبتات: EP1_CONF البت 0 WR_DONE، والبت 1 SERIAL_IN_EP_DATA_FREE، والبت 2 SERIAL_OUT_EP_DATA_AVAIL ‏(السجل 33.2)؛ وINT_* البت 2 SERIAL_OUT_RECV_PKT_INT والبت 3 SERIAL_IN_EMPTY_INT، وهو مضبوط عند إعادة الضبط (السجل 33.6).

The behavior is section 33.3.3's: bytes written to EP1 wait in a 64-byte buffer and leave only when it is flushed, by WR_DONE or by the hardware when the 64th byte goes in; from the flush until the host has the packet, SERIAL_IN_EP_DATA_FREE is clear and a byte written is lost; when the host has it, SERIAL_IN_EMPTY_INT rises. Host bytes arrive a packet (up to 64) at a time, SERIAL_OUT_EP_DATA_AVAIL stays set while any are unread, and the next packet is accepted once the last byte of this one has been read.

التوقيت هنا خاص بهذا النموذج. يقول الدليل إن المضيف «سيتحقق دوريًا». هنا يبقى لدى المضيف طرفية مفتوحة دائمًا ويلتقط أي حزمة مفرَّغة فور إمكان عبورها ناقلًا بسرعة 12 Mbit/s: الحزمة زائد ثلاثة عشر بايتًا من الرموز والمصافحة والتأطير، أي 51.3 ميكروثانية لـ 64 بايتًا. أما المضيف الحقيقي فيضيف حتى إطار واحد (1 ms) من جدولة المهام، وهذا غير مُنمذج.

غير مُنمذج: نصف JTAG، والتعداد، ومقاطعات أخطاء الناقل، وطلبات إعادة الضبط عبر RTS/DTR ووضع التنزيل، والتعليق. المضيف متصل دائمًا.

3.5 مؤقت النظام SYSTIMER ‏(0x6002_3000)

الوحدة 0: العداد 52-بت الذي يقف خلف micros() وmillis().

الإزاحة سجل
0x00 SYSTIMER_CONF_REG
0x04 SYSTIMER_UNIT0_OP_REG
0x0C SYSTIMER_UNIT0_LOAD_HI_REG
0x10 SYSTIMER_UNIT0_LOAD_LO_REG
0x40 SYSTIMER_UNIT0_VALUE_HI_REG
0x44 SYSTIMER_UNIT0_VALUE_LO_REG
0x5C SYSTIMER_UNIT0_LOAD_REG

تم التحقق: العنوان الأساسي، والإزاحات (ملخص السجلات 11.5)، والبتات (بت 30 في CONF وهو TIMER_UNIT0_WORK_EN، يُضبط عند إعادة الضبط؛ وبت 30 في OP وهو UPDATE، وبت 29 VALUE_VALID) وساعة العد ذات 16 MHz ("XTAL_CLK/2.5, which is 16 MHz"، القسم 11.4).

القراءة تتم بالتثبيت ثم القراءة: اكتب UPDATE، وانتظر VALUE_VALID، ثم اقرأ VALUE_HI وVALUE_LO. العداد لا يُعدّ: إنه فعلًا زمن المحاكاة مقسومًا على 62.5 ns، مضافًا إليه ما وضعه هناك رفعُ برنامج، فلا يوجد ما ينحرف عنه. الوحدة 1 والمقارنات الثلاثة وإنذاراتها غير مُنمذجة؛ ونبضة وقت التشغيل هي CCOMPARE0 الخاصة بالنواة نفسها (القسم 4).

3.6 SENS: ADC1، تحويل واحد (0x6000_8800)

تحويل يبدأه البرنامج عبر متحكم ADC1 الخاص بالساعة الوقتية الحقيقية (RTC).

الإزاحة سجل البتات
0x00 SENS_SAR_READER1_CTRL_REG مخزَّن
0x0C SENS_SAR_MEAS1_CTRL2_REG البتات 0..15 MEAS1_DATA_SAR (للقراءة فقط)، البت 16 MEAS1_DONE_SAR، البت 17 MEAS1_START_SAR، البت 18 MEAS1_START_FORCE، البتات 19..30 SAR1_EN_PAD (بت واحد لكل قناة)، البت 31 SAR1_EN_PAD_FORCE
0x10 SENS_SAR_MEAS1_MUX_REG bit 31 SAR1_DIG_FORCE: set, ADC1 belongs to the digital controller and a software start converts nothing
0x14 SENS_SAR_ATTEN1_REG two bits of attenuation per channel, channel n at bits 2n..2n+1; all ones at reset

تم التحقق: من العنوان الأساسي والإزاحات الثلاث وكل بت، مقابل السجلات 39.10 إلى 39.13.

تحويل واحد: ضع التوهين في ATTEN1، واضبط START_FORCE وEN_PAD_FORCE، وضع بت القناة في SAR1_EN_PAD، ارفع MEAS1_START_SAR، انتظر MEAS1_DONE_SAR، ثم اقرأ البيانات. يستغرق التحويل 5 us ثابتة من وقت المحاكاة، وهو رقم النموذج نفسه.

عشر قنوات، والقناة n هي GPIO n + 1: ADC1_CH0 هي GPIO1 و ADC1_CH9 GPIO10 (جداول الترويسة في دليل المستخدم، طرفًا بطرف).

النتيجة اثنا عشر بتًا من جهد الشبكة لحظة بدء التحويل. عند ATTEN0 إلى ATTEN2 تكون round(4095 x Vin / Vtop)، مقصوصة القيمة، حيث Vtop هو أعلى «نطاق القياس الفعّال» في ورقة البيانات: 850 mV و1100 mV و1600 mV. ATTEN3 (12 dB)، وهو التوهين الافتراضي عند إعادة الضبط وفي نواة Arduino، يتبع منحنى قطعة نموذجية خامًا (CURVE_ATTEN3 في crates/esp32s3/src/adc.rs): شبه خطي انطلاقًا من 0 V، ينحني بدءًا من نحو 2750 mV (حيث تُظهر قياسات Espressif نفسها فقدان S3 للخطية) بعد نطاق 2900 mV الفعّال، ويشبع عند 4095 بدءًا من نحو 3.1 V. لذا فإن مقياس جهد متغير على خط 3.3 V يبلغ 4095 قليلًا قبل نهاية مداه، ونصف الخط (1.65 V) يقرأ نحو 2220. معايرة eFuse للوحدة الواحدة تحرّك ذلك بضعة بالمئة، وهي غير مُنمذجة. analogReadMilliVolts يعكس نفس المنحنى. القناة التي لا يوجد شيء على طرفها تتغيّر قيمتها عشوائيًا، كما يفعل المدخل العائم (docs/uno.md القسم 1).

‏ADC2، والمتحكم الرقمي، وDMA، وeFuses الخاصة بالمعايرة، وحساس الحرارة غائبة.

3.7 LEDC (0x6001_9000)

ثماني قنوات وأربعة مؤقتات، كلها من فئة سرعة واحدة: كامل LEDC في S3.

الإزاحة سجل البتات
0x00 + 0x14n LEDC_CHn_CONF0_REG البتات 0..1 TIMER_SEL، البت 2 SIG_OUT_EN، البت 3 IDLE_LV، البت 4 PARA_UP (كتابة فقط)
0x04 + 0x14n LEDC_CHn_HPOINT_REG البتات 0..13 HPOINT
0x08 + 0x14n LEDC_CHn_DUTY_REG البتات 0..18 دورة العمل بوحدة ستة عشر جزءًا من العدّة
0x0C + 0x14n LEDC_CHn_CONF1_REG عتاد التلاشي: مخزَّن، لا يُلاشي شيئًا
0x10 + 0x14n LEDC_CHn_DUTY_R_REG دورة العمل السارية، قراءة فقط
0xA0 + 8n LEDC_TIMERn_CONF_REG البتات 0..3 DUTY_RES، البتات 4..21 CLK_DIV (Q10.8)، البت 22 PAUSE، البت 23 RST (يُضبط عند إعادة التعيين)، البت 25 PARA_UP (كتابة فقط)
0xA4 + 8n LEDC_TIMERn_VALUE_REG العدّاد
0xC0 LEDC_INT_RAW_REG البت n = تجاوز المؤقت n
0xC4 LEDC_INT_ST_REG
0xC8 LEDC_INT_ENA_REG مخزَّن؛ لا يصل أي خط إلى النواة
0xCC LEDC_INT_CLR_REG
0xD0 LEDC_CONF_REG البتات 0..1 APB_CLK_SEL (القيمة 1، أي ساعة APB، هي المصدر الوحيد المُحاكى)، البت 31 CLK_EN
0xFC LEDC_DATE_REG تُقرأ 0x1907_2601

مُتحقَّق منه: العنوان الأساسي، وكل إزاحة وكل بت في الجدول (ملخص السجلات 35.4 والسجلات 35.1 إلى 35.13). هذا تغيير حقيقي عن نموذج ESP32 الكلاسيكي، الذي يُعتقد أن تخطيط LEDC فيه صحيح.

يعدّ المؤقت 2^DUTY_RES عدّة عند 80 MHz مقسومة على CLK_DIV: f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES). يكون خرج القناة مرتفعًا بدءًا من HPOINT لمدة DUTY >> 4 عدّة.

لا شيء يسري مفعوله دون بت التحديث الخاص به. ينتظر CLK_DIV وDUTY_RES الخاصان بالمؤقّت TIMERn_PARA_UP، وينتظر كل من HPOINT وSIG_OUT_EN وTIMER_SEL وقيمة الدورة لكل قناة PARA_UP_CHn (القوائم أسفل المسجلين 35.1 و35.7). يفصل النموذج ما تمت كتابته عمّا هو ساري المفعول، لذا فإن أي برنامج ثابت ينسى بت التحديث لن يحصل على أي PWM، تمامًا كما على منضدة حقيقية. أما PAUSE وRST وIDLE_LV فتعمل فورًا. تُدرَج قيمة الدورة أسفل DUTY_START؛ ويحمّلها النموذج عند PARA_UP_CHn سواء أكان DUTY_START مضبوطًا أم لا، ويُعتقد أن هذا ما يفعله تغيير الدورة العادي مع حالة الخمول لعتاد التلاشي.

تصل القناة إلى الطرف عبر مصفوفة GPIO عند OUT_SEL بقيمة 73 + n (القسم 3.1). العدّاد دالة بصيغة مغلقة للزمن المُحاكى، لذا فإن نواة متوقفة في waiti لا تكلف شيئًا أثناء تشغيل PWM؛ ويقيس runtime.rs دورة مثال fade مقابل 1 ms عند 1 kHz ضمن 5 us.

ساعة LEDC متوقفة عند إعادة التعيين (القسم 3.9): حتى تُضبط SYSTEM_LEDC_CLK_EN لا يستجيب هذا الجزء.

غير مُحاكى: عتاد تلاشي دورة العمل، وعدّاد الفيض، ومصادر الساعة غير APB، وخط LEDC إلى مصفوفة المقاطعات.

3.8 RMT ‏(0x6001_6000)

قنوات الإرسال الأربع للجهاز الطرفي للتحكم عن بعد: ما يشغّل LED متعدد الألوان.

الإزاحة سجل البتات
0x00 + 4n RMT_CHnDATA_REG كتابة: دفع كلمة إلى ذاكرة القناة n عبر FIFO الخاص بـ APB
0x20 + 4n RMT_CHnCONF0_REG البت 0 TX_START، البت 1 MEM_RD_RST، البت 2 APB_MEM_RST، البت 3 TX_CONTI_MODE، البت 4 MEM_TX_WRAP_EN، البت 5 IDLE_OUT_LV، البت 6 IDLE_OUT_EN، البت 7 TX_STOP، البتات 8..15 DIV_CNT، البتات 16..19 MEM_SIZE، البت 20 CARRIER_EFF_EN، البت 21 CARRIER_EN، البت 22 CARRIER_OUT_LV، البت 24 CONF_UPDATE
0x50 + 4n RMT_CHnSTATUS_REG البتات 0..9 عنوان القراءة، البتات 11..20 عنوان كتابة APB، البتات 22..24 الحالة، البت 25 MEM_EMPTY، البت 26 APB_MEM_WR_ERR
0x70 RMT_INT_RAW_REG البت n TX_END، البت 4+n ERR، البت 8+n TX_THR_EVENT، البت 12+n TX_LOOP
0x74 RMT_INT_ST_REG
0x78 RMT_INT_ENA_REG
0x7C RMT_INT_CLR_REG
0x80 + 4n RMT_CHnCARRIER_DUTY_REG البتات 0..15 للمستوى المنخفض، البتات 16..31 للمستوى المرتفع، 0x40 لكل منهما عند إعادة التعيين
0xA0 + 4n RMT_CHn_TX_LIM_REG البتات 0..8 TX_LIM، البتات 9..18 TX_LOOP_NUM، البت 19 TX_LOOP_CNT_EN، البت 20 LOOP_COUNT_RESET، البت 21 LOOP_STOP_EN
0xC0 RMT_SYS_CONF_REG البت 0 APB_FIFO_MASK، البتات 4..11 SCLK_DIV_NUM، البتات 24..25 SCLK_SEL، البت 26 SCLK_ACTIVE، البت 31 CLK_EN
0xCC RMT_DATE_REG تُقرأ 0x0210_1181
0x800 إلى 0xDFF الذاكرة 384 كلمة

سجلات قنوات الاستقبال (0x30 إلى 0x4C، و0x60 إلى 0x6C، و0x90 إلى 0x9C، و0xB0 إلى 0xBC) تُخزَّن وتُقرأ ولا تستقبل شيئًا.

مُتحقَّق منه: العنوان الأساسي، وكل إزاحة وبت في الجدول (ملخص السجلات 37.5، والسجلات 37.1 إلى 37.19)، وحجم الذاكرة وبداية NONFIFO عند "RMT base address + 0x800"، وتنسيق كود النبضة (المدة في البتات 0..14 و16..30، والمستوى في البتين 15 و31، "أقل قيمة للمدة هي صفر وتُفسَّر كعلامة نهاية الإرسال")، وساعة القناة (rmt_sclk مقسومة على DIV_CNT، "القيمة 0 تعني مقسِّم 256"، وrmt_sclk المصدر مقسومًا على SCLK_DIV_NUM + 1 + A/B)، وقيم إعادة التعيين (الحامل مفعّل، MEM_SIZE بقيمة 1، DIV_CNT بقيمة 2)، وقائمة الحقول التي تنتظر CONF_UPDATE (الجدول 37.3-1).

Believed: the manual gives transmit channel n's NONFIFO start as "RMT base address + 0x800 + n x 48", and the model reads the 48 as words, so channel n's block starts at 0x800 + 192n: the only reading under which the eight 48-word blocks of section 37.3.2 fit the 384 words. The manual's receive-channel start, "0x8c0 + m x 48", does not settle it either way, and the receive channels are not modeled.

ما يفعله الإرسال، من القسم 37.3.4: TX_START يرسل من بداية كتلة القناة، ويحتفظ كل كود بمستواه لمدة period من نبضات ساعة القناة؛ وعند علامة النهاية تتوقف القناة، وترفع TX_END، وتحتفظ بمستوى علامة النهاية، أو IDLE_OUT_LV إذا كانت IDLE_OUT_EN مضبوطة؛ وتجاوز نهاية كتل MEM_SIZE دون علامة نهاية يوقفها مع MEM_EMPTY وERR، إلا إذا أعادها وضع الالتفاف إلى البداية، وحينها يرتفع TX_THR_EVENT في كل مرة تمر فيها TX_LIM كلمة إضافية؛ ويبدأ الوضع المتصل من جديد عند كل علامة نهاية، عادًّا الحلقات إذا طُلب منه ذلك. TX_STOP يوقف فورًا.

تحديث الإعدادات. ‏DIV_CNT وIDLE_OUT_EN وIDLE_OUT_LV وTX_CONTI_MODE وTX_STOP وحقول الموجة الحاملة وحقول TX_LIM الثلاثة لا تسري إلا عند CONF_UPDATE (الجدول 37.3-1)؛ ويحتفظ النموذج بها منفصلة حتى ذلك الحين. أما MEM_SIZE ووضع الالتفاف وTX_START فتسري فورًا.

The carrier is on at reset. A code whose level matches CARRIER_OUT_LV becomes a square wave high for CARRIER_HIGH + 1 and low for CARRIER_LOW + 1 cycles of rmt_sclk. The model starts that wave high at the start of each code, which is believed, and does not modulate the idle level when CARRIER_EFF_EN is clear. A WS2812 needs the carrier off, and the runtime clears CARRIER_EN; the model counts transmissions made with it on, and the runtime tests check the count is zero.

الخرج دالة ذات صيغة مغلقة للزمن بين حدود الأكواد، لذا تقع كل حافة على البيكوثانية المقابلة لها، ولا تكلف النواة المتوقفة شيئًا أثناء خروج إطار. يفكّ runtime.rs إطارات مثالَي blink وrainbow على GPIO48 ويتحقق من كل زمن مرتفع ومنخفض مقابل نوافذ ورقة بيانات WS2812B.

ساعة RMT متوقفة عند إعادة التعيين (القسم 3.9).

غير مُحاكى: قنوات الاستقبال، وDMA على القناة 3، والبدء المتزامن، وملكية الذاكرة والطاقة، وقواعد الحد الأدنى للمدة (الصيغتان 37.1 و37.3).

‏3.9 النظام SYSTEM (0x600C_0000) ومصفوفة المقاطعات (0x600C_2000)

الإزاحة سجل
0x10 SYSTEM_CPU_PER_CONF_REG، مخزَّن
0x18 SYSTEM_PERIP_CLK_EN0_REG
0x1C SYSTEM_PERIP_CLK_EN1_REG، مخزَّن
0x20 SYSTEM_PERIP_RST_EN0_REG
0x24 SYSTEM_PERIP_RST_EN1_REG، مخزَّن

Verified: the offsets and reset values (registers 17.3 to 17.7). LEDC (bit 11) and RMT (bit 9) are gated off at reset in SYSTEM_PERIP_CLK_EN0_REG. Here, a write to either block while its clock bit is clear, or while its bit in SYSTEM_PERIP_RST_EN0_REG holds it in reset, is dropped and counted, and a read returns 0; holding one in reset puts it back to power-on. The runtime sets both clock bits before anything else. The other blocks here are clocked at reset and are not gated in the model.

مصفوفة المقاطعات: سجل الخريطة للمصدر n للنواة 0 يقع عند 0x600C_2000 + 4n، والخمسة بتات الدنيا فيه تحدد مقاطعة المعالج التي يرفعها المصدر. تم التحقق من ذلك مقابل الجدول 9.3-1 وملخص السجلات 9.4، وكذلك من أرقام المصادر الأربعة التي يوجّهها هذا النموذج:

المصدر الرقم
GPIO_INTERRUPT_CPU 16
UART_INTR 27
RMT_INTR 40
USB_DEVICE_INT 96

المصدر المُسند إلى إحدى المقاطعات الداخلية للنواة (6، 7، 11، 15، 16 أو 29) لا يصل إلى أي شيء، وهذه هي الطريقة التي يوصي بها الدليل لتعطيل مصدر (القسم 9.3.3.3). كل سجل خريطة آخر يُخزَّن ويُقرأ ولا يوجّه شيئًا.

3.10 صندوق بريد شبكة Mokxi (0x6FFF_E000)

هذه الكتلة ليست من ESP32-S3. كل عنوان آخر في هذا المستند يعود إلى الشريحة. أما هذا فعائد إلى Mokxi نفسه: الشبكة المحاكاة من crates/net، عند عنوان يتركه S3 غير مُسند. يضع الدليل الأجهزة الطرفية في النطاق "0x6000_0000~0x600D_0FFF" وتنتهي ذاكرة RTC FAST عند 0x600F_FFFF، لذا فإن أي صورة تستخدم هذه الكتلة تسبب خطأً على الشريحة الحقيقية بدلًا من قراءة سجل جهاز طرفي آخر. وهذا الخطأ هو الجواب الصادق، لأن ما يقف خلف هذه الكتلة غير موجود على الشريحة. وهو العنوان نفسه الذي تستخدمه نموذجا ESP32-C3 و C6، لأن الشرائح الثلاث تترك الفجوة نفسها.

لا ترفع هذه الكتلة أي مقاطعة على الإطلاق. كل مصدر آخر هنا يصل إلى النواة عبر مصفوفة المقاطعات في القسم 3.9، ورقم المصدر في المصفوفة يعود إلى الشريحة؛ ولا يوجد رقم صادق يمكن منحه لجهاز طرفي لا تمتلكه الشريحة، لذلك لم يُمنح صندوق البريد أي رقم. يظل NET_INT_RAW_REG قابلًا للقراءة، ويستعلم البرنامج الثابت دوريًا، وتُوقظ النواة الساكنة في waiti عندما يكون لدى الشبكة ما تقوله، تمامًا كما تُوقظ عند حافة PWM.

لا يوجد هنا لا راديو ولا 802.11 ولا إنترنت حقيقي. لا شيء في النموذج يرسل أو يمسح أو يقترن أو يشفّر أو يفتح مقبس اتصال: كلمة السر تُقارن كسلسلة نصية، والاسم الذي لا يقع تحت .mokxi لا يُحل، والمصادر التي تقدمها الشبكة هي دوال في crates/net/src/http.rs. صندوق البريد هو شكل الفاصل الحقيقي وليس قصة متخيلة عن وحدة MAC: على ESP32-S3 حقيقي يجلس عتاد 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_ الثمانية هي نصف البلوتوث من الكتلة، ولكل منها حلقاتها الخاصة: بلوتوث LE فقط، كما على الشريحة الحقيقية، لذا فإن أوامر Classic تضبط BT_ERR. لا يوجد راديو خلفها أيضًا؛ 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.11 كلاب الحراسة لمجموعات المؤقت، وإعادات ضبط RTC_CNTL، ومراقب المكدس

كما في C3 (docs/esp32c3.md القسم 3.9)، مع تخطيط S3: لا يوجد WDT_CONF_UPDATE_EN (الكتابة تسري فورًا)، وبِت مقاطعة كلب الحراسة هو البِت 2، وهو يصل إلى النواة عبر مصفوفة المقاطعات (المصدران 52 و 55؛ ويربط وقت التشغيل المصدر 52 بمقاطعة المعالج 17)، وسجلات التخزين عند 0x50..0x5C و 0xC0..0xCC، و SP_MIN الخاص بـ ASSIST_DEBUG يقع سجلًا إضافيًا بعده (0x3C). يفحص مراقب المكدس ENTRY، حيث ينقل الكود ذو النوافذ المكدس عند كل استدعاء؛ والخطأ مقابل حدود اتسعت منذ ذلك الحين يُعاد إجراءه بدلًا من الإبلاغ عنه.

تشغّل بيئة التشغيل مُراقب مهام 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. النواة: LX7، وأي ABI، وكيف تصل المقاطعة

The S3's two cores are Xtensa LX7s, and this model runs one of them on crates/xtensa-core, the interpreter the classic ESP32 and the ESP8266 already use, in a third configuration, Model::LX7.

لكل ما ينتجه المترجم، إن LX7 هنا هو LX6. تتفق ملفات التهيئة لسلسلتي الأدوات (core-isa.h في xtensa-esp32-elf وxtensa-esp32s3-elf) على كل خيار عدد صحيح يحدد الكود الذي ينتجه المترجم: أربعة وستون سجل عناوين ونافذة السجلات، الحلقة بلا تكلفة إضافية، الضرب في 32 بت ونصفه العلوي، القاسم، MIN/MAX، SEXT، CLAMPS، S32C1I، MAC16، القيم المنطقية ومعالج الفاصلة العائمة أحادي الدقة. والدليل أقوى من هذه الملفات: يحتوي crates/xtensa-core/tests/programs.rs على بناء مترجم S3 لبرنامج الاختبار نفسه الذي بناه مترجم ESP32 الكلاسيكي، وقد خرج الاثنان متطابقين بايتًا ببايت. إذًا يعمل S3 بواجهة ABI النافذية، تمامًا كما يفعل ESP32 الكلاسيكي، مع ENTRY، RETW، ROTW، MOVSP، L32E/S32E واستثناءات النافذة عبر متجهاتها الخاصة (يحتوي docs/esp32.md القسم 4 على جدول المتجهات، وهو جدول مجموعة التعليمات لا الشريحة).

ما يضيفه LX7 على هذه الشريحة هو امتداد المتجهات الخاص بـ S3، تعليمات EE.* لأعمال الذكاء الاصطناعي و DSP، التي يرمّزها المجمّع في فضاء op0 = 4 الذي يمنحه LX6 لـ MAC16. لا يُنمذج أي منهما، وكلاهما يسبب خطأ كتعليمة غير قانونية (crates/xtensa-core/tests/encoding.rs يحتوي ترميزين من ترميزات مجمّع S3). لا يُنتج GCC هذه التعليمات من C عادي.

المقاطعات. INTENABLE يقيّد؛ و PS.INTLEVEL يبوّب. لا يُنمذج إلا المستوى 1. على S3 مقاطعات المستوى 1 هي 0 إلى 10 و 12 و 13 و 17 و 18، بالقناع 0x0006_37FF، و 19 إلى 21 من المستوى 2: تم التحقق مقابل الجدول 9.3-2 من الدليل. المقارنات الثلاث CCOMPARE ترفع مقاطعات المعالج 6 و 15 و 16، من الجدول نفسه. يوجّه وقت التشغيل GPIO إلى مقاطعة المعالج 13، وهي مقاطعة جهاز طرفي من المستوى 1، ويأخذ نبضة تأخيره من CCOMPARE0 على مقاطعة المعالج 6.

يقرأ PRID القيمة 0xCDCD، كما في النموذج الكلاسيكي: مُصدَّق. المهم أن البِت 13 صفر، وهكذا تميّز البرمجيات النواة 0 عن النواة 1.

الباقي هو القسم 4 من ESP32 الكلاسيكي دون تغيير: CCOUNT هو عدّاد الدورات؛ و WSR إلى CCOMPARE يسلّحه ويمسح مقاطعته؛ "بلغ العداد أو تجاوزه" وليس "ساواه"؛ والموعد المنقضي لا يُسلَّح؛ و MOVSP لا يرفع Alloca أبدًا؛ ووحدة الفاصلة العائمة أحادية الدقة تعمل، كما على ESP32 الكلاسيكي (docs/esp32.md القسم 4)، لذا فإن أي float مبني بـ firmware/esp32s3/build.sh يحصل على الجواب الصحيح. والكود المبني في المتصفح يظل بفاصلة عائمة برمجية (-Xclang -target-feature -Xclang -fp، مع استدعاءات إلى mokxi_float.c).

5. نموذج الزمن، والمجس، والكتابة المباشرة، وقناة المضيف

يعمل المعالج بسرعة 240 MHz، بتعليمة واحدة في كل دورة. يُعاد حساب الزمن من عدد الدورات، لذا فإن شريحة من 2400 تعليمة تساوي تمامًا 10 us. داخل الشريحة يكون عدد التعليمات هو الساعة: قراءة مؤقّت، وبايت تسلسلي، وتغيّر طرف، وحافة RMT كلها تحدث عند التعليمة التي سبّبتها. النواة المتوقفة في WAITI لا تكلّف شيئًا: تطلب اللوحة إيقاظها عند الأقرب بين موعد CCOMPARE التالي، أو حافة LEDC أو RMT التالية، أو بايت تسلسلي، أو الشبكة، كما توقظها أيضًا تغيّرات الأطراف أو بايت من المضيف. القراءة من GPIO_IN_REG بعد كتابة حرّكت طرفًا في الشريحة نفسها تُنهي الشريحة قبل القراءة، فترى ما فعلته الدائرة بالكتابة، تمامًا كما في ESP32 الكلاسيكي (القسم 5 من docs/esp32.md). delayMicroseconds() تحت 50 us تَعُدّ CCOUNT ولا تكون أبدًا أقصر مما طُلب.

probe قناع بتات يحتوي على لون LED:

البتات المعنى
0 قيد التشغيل
1 متوقفة في waiti، أو موقوفة بواسطة مصحح الأخطاء
2..19 لون LED بصيغة RGB كما ثبّته في آخر إطار، ستة بتات لكل قناة: الأحمر في 14..19، والأخضر في 8..13، والأزرق في 2..7

يُفكّ ترميز الـLED بواسطة قطعة اللوحة من الحواف التي يبلّغ عنها النظام على طرف الـLED (GPIO48، أو GPIO38 في إصدار v1.1)، بنوافذ قطعة ws2812: النبضة العالية تحت 125 ns تُعدّ خللًا، وحتى 600 ns تعني 0، وحتى 950 ns تعني 1، وأي نبضة أطول تكسر الإطار، كما أن المستوى المنخفض الأقصر مما يسمح به البت يكسره أيضًا، و50 us من المستوى المنخفض تثبّت أول 24 بتًا، بدءًا بالأخضر. يحتفظ الـLED بلونه عبر إعادة تعيين الشريحة، كما يفعل WS2812، لأنه يُغذّى من اللوحة. البتّان السفليان من كل قناة لا يتّسع لهما مجس فتُهملان.

poke: 1 يُبقي BOOT (GPIO0 منخفضًا)، و0 يُطلقه؛ و2 يُبقي RST، و3 تُطلقه.

قناة المضيف تحمل كلا المنفذين التسلسليين للوحة. لوحة DevKitC-1 الحقيقية تحتوي مقبسين: "UART"، عبر جسر USB-to-UART إلى UART0، و"USB"، وهو منفذ USB Serial/JTAG الخاص بالشريحة. هنا الشاشة التسلسلية متصلة بكليهما معًا: host_read يعطي البايتات التي خرجت من UART0 والبايتات التي سلّمها منفذ USB، بترتيب وصولها، وhost_write يضع ما تتم كتابته في FIFO استقبال UART0 وفي قائمة مضيف منفذ USB معًا. الجسر نفسه غير مُحاكى، وكذلك إعادة التعيين التلقائية عبر DTR وRTS.

انهيار. 1000 مصيدة متتالية دون أي تقدّم تُعلن معه النواة منهارة ومتوقفة، مع تسجيل مكان موتها والإبلاغ عنه عبر قناة المضيف.

6. ما الذي يكون هذا النموذج واثقًا منه وما لا يكون واثقًا منه

تمت مطابقته مع الدليل الفني أو ورقة البيانات أو دليل المستخدم

نوافذ الذاكرة (الجدول 4.3-1) وكل عنوان أساسي للملحقات (الجدول 4.3-3). كل إزاحة سجل وكل بت مذكور في القسم 3، كتلةً بعد كتلة: GPIO (من 6.14 إلى 6.20)، وIO MUX (6.36 والجدول 6.12-1، بما في ذلك قيمة إعادة التعيين لكل طرف وكون الوظيفة 1 هي GPIO على كل طرف)، وUART0 (من 26.6 إلى 26.19)، وUSB Serial/JTAG (من 33.2 إلى 33.9 والسلوك في 33.3.3)، وSYSTIMER (من 11.1 إلى 11.5 وساعة 16 MHz)، وSENS (من 39.10 إلى 39.13)، وLEDC (من 35.1 إلى 35.13 وقوائم PARA_UP)، وRMT (من 37.1 إلى 37.19، وحجم الذاكرة، وصيغة رمز النبضة، وصيغة الساعة والجدول 37.3-1)، وSYSTEM (من 17.3 إلى 17.7، بما في ذلك إيقاف LEDC وRMT عند إعادة التعيين)، ومصفوفة المقاطعات (الجدول 9.3-1 والملخص 9.4). أرقام إشارات مصفوفة GPIO من 73 إلى 80 لـLEDC ومن 81 إلى 84 لـRMT (الجدول 6.11-1)، وكون تفعيلات الإخراج للملحقين مرتبطة بالمستوى العالي. مستويات مقاطعات المعالج وأرقام مقاطعات المقارنات (الجدول 9.3-2). خريطة قنوات ADC1 والنطاقات الفعلية للتوهينات الأربعة (ورقة البيانات). ترتيب الترويسات، وGPIO الخاص بـLED RGB في كل إصدار، وأبعاد اللوحة (دليل المستخدم والرسم بالأبعاد). خيارات ISA الصحيحة (ملف core-isa.h من أدوات البناء، ومخرجات مترجم S3 بايتًا ببايت).

مُعتقَد، غير مُتحقَّق منه

  • SCLK_DIV_NUM + 1 كقاسم ساعة UART0 الأساسي (القسم 3.3). بيئة التشغيل تكتب 0 هناك، وهو 1 بهذه القراءة؛ والصيغة المطبوعة في الدليل لا تحتوي على زائد واحد.
  • تخطيط ذاكرة RMT لكل قناة، 0x800 + 192n (القسم 3.8).
  • طور الموجة الحاملة: عالٍ أولًا، من بداية كل رمز (القسم 3.8).
  • تحميل نسبة الواجب عند PARA_UP_CHn دون DUTY_START (القسم 3.7).
  • توقيت حزم USB: 12 Mbit/s زائد ثلاثة عشر بايتًا، وبلا تأخير جدولة من المضيف (القسم 3.4).
  • PRID = 0xCDCD (القسم 4).

كل رقم تعتمد عليه بيئة التشغيل مذكور في مكان واحد (firmware/esp32s3/include/esp32s3.h)، وcrates/esp32s3/tests/contract.rs يُلزم هذا الترويسة وcrates/esp32s3/src/map.rs بالأرقام نفسها.

مُحاكى، لكن ليس بأرقام الشريحة

  • المحوّل ADC عند ATTEN3 هو منحنى قطعة نموذجية، لا هذه القطعة بعينها (القسم 3.6): التشبّع عند نحو 3.1 V والانحناء فوق 2.75 V موجودان، أما التباين بين القطع الذي يصحّحه معايرة eFuse فغير موجود. التوهينات الأخرى خطوط مستقيمة حتى أعلى نطاقاتها الفعلية.
  • تستغرق عملية التحويل 5 us بالضبط، وتقع حافة LEDC أو RMT عند البيكوثانية بالضبط.
  • GPIO_STRAP_REG قيمة ثابتة، وليس تثبيتًا لحالة الأطراف عند إعادة التعيين.
  • RST هو مقاومة سحب 10 k وحدها؛ مكثف التشغيل غير مُحاكى.
  • لا توجد ذاكرة ROM للإقلاع ولا شجرة ساعات. النواة عند 240 MHz وساعة APB عند 80 MHz من التعليمة الأولى، وSYSTEM_CPU_PER_CONF_REG يُخزَّن ولا يغيّر شيئًا.
  • أطراف USB لا تُنتزع. يبقى GPIO19 وGPIO20 طرفين عاديين ويواصل منفذ USB العمل حتى لو قاد الكود أحدهما.
  • يحافظ U0TXD على مستوى عالٍ ثابت ما دام UART يملكه؛ بتّات UART هي قناة المضيف، لا موجة جهد على GPIO43.
  • CCOMPARE يقارن "وصل الموعد أو تجاوزه"، و MOVSP لا يرفع استثناء Alloca أبدًا (القسم 4).

مُستبعد عمدًا

  • النواة الثانية. النواة 0 وحدها تعمل؛ لا توجد مقاطعة بين النواتين ولا FreeRTOS، لذا فإن أي شيء يشغّل مهمة على النواة 1 لن يعمل.
  • امتداد المتجهات. كل ترميز EE.* يسبّب عطلًا (القسم 4). وحدة FPU مُحاكاة.
  • SRAM0، والذاكرة المؤقتة، وMMU، وذاكرة flash وPSRAM. يعمل الكود من SRAM1.
  • راديو WiFi وBluetooth، بكل أشكالهما. شبكة WiFi التي يصل إليها الكود هي الشبكة المحاكاة في القسم 3.10.
  • الـRTC، وذاكراته، ومعالجات ULP المساعدة، والنوم العميق، ووحدة إدارة الطاقة.
  • ADC2، ووحدة ADC الرقمية، وDMA، ومعايرات eFuse، وحساس الحرارة، وحساس اللمس.
  • مؤقتات مجموعات المؤقتات، وكلب حراسة RTC وكلب حراسة المقاطعات (كلاب حراسة مجموعات المؤقتات هي الخاصة بالقسم 3.11).
  • UART1 وUART2، ووحدتا التحكم I2C وSPI، وI2S، ووحدة التحكم بالكاميرا وLCD، وTWAI، ومضيف SD، وعدّاد النبضات، وPWM المحرك، ووحدة USB OTG، وGDMA، ومسرّعات التشفير. أمّا Wire وSPI في بيئة التشغيل فهما برمجيات على أطراف عادية (SDA 8 وSCL 9، وSCK 12، وMISO 13، وMOSI 11، وSS 10، وهي القيم الافتراضية لنواة Arduino لهذه اللوحة)، تمامًا كما في كل لوحة أخرى هنا، لأن أي نموذج لوحة هنا لا يملك تلك الوحدات.
  • قنوات الاستقبال في RMT وبقية قائمة القسم 3.8، وعتاد LEDC للتلاشي التدريجي.
  • مصفوفة المقاطعات بما يتجاوز أربعة مصادر، وكل مستوى مقاطعة للمعالج فوق المستوى واحد.

لهذا لا تعمل الملفات الثنائية الرسمية لـ ESP-IDF ونواة Arduino هنا، بينما يعمل البرنامج الثابت المبني وفق هذا المستند.

صور لوحات Xtensa الثلاث ليست قابلة للتبديل. تختلف سلاسل program في الفهرس (elf32 xtensa lx7 esp32s3 هنا، وelf32 xtensa lx6 esp32 على DevKit الكلاسيكية، وelf32 xtensa lx106 esp8266 على NodeMCU)، والفرق حقيقي: صورة ESP32 الكلاسيكية تنفذ التعليمات نفسها لكنها تُحمَّل في عناوين لا تمتلكها هذه الشريحة، لذلك يرفضها المحمِّل.

7. بيئة تشغيل البرنامج الثابت (firmware/esp32s3/)

بيئة تشغيل على طراز Arduino: setup() وloop()، وpinMode وdigitalWrite وdigitalRead وshiftOut وanalogRead (مع analogReadResolution وanalogSetAttenuation وanalogSetPinAttenuation)، وanalogWrite وعائلة ledcAttach/ledcWrite/ledcRead، وrgbLedWrite وneopixelWrite، وmillis وmicros وmicros64 وdelay وdelayMicroseconds وattachInterrupt وSerial وUSBSerial وmap وrandom. لا نواة Arduino، ولا ESP-IDF، ولا libc. وWiFi.h وHTTPClient.h وWebServer.h هي بيئة وقت التشغيل المشتركة للشبكة المحاكاة في docs/wifi.md.

LED_BUILTIN and RGB_BUILTIN are the Arduino core's number for the RGB LED: the GPIO count plus the LED's pin, 49 + 48. digitalWrite(LED_BUILTIN, HIGH) sends the LED one WS2812 frame, white at RGB_BRIGHTNESS (64 of 255), and LOW sends black, which is what the Arduino core does. rgbLedWrite(pin, r, g, b) takes the GPIO number or RGB_BUILTIN. Both use RMT channel 0 at 100 ns a tick: a 0 is 400 ns high and 800 ns low, a 1 is 800 ns high and 400 ns low, both inside the WS2812B datasheet's windows, with the carrier switched off. The core has no BOOT_BUTTON: the BOOT button is GPIO 0, so sketches use 0. A0 to A9 are GPIO 1 to 10.

mokxi_init، قبل المشيدات الثابتة، يضبط بوابات ساعة LEDC وRMT، ويحوّل UART0 إلى ساعة APB بمعدل 115200، ويوجّه مصدر مقاطعة GPIO. كل كتابة تغيّر مخرج LEDC تنتهي ببت التحديث الخاص بها.

Serial هو UART0. أما USBSerial فهو منفذ USB Serial/JTAG: تدخل البايتات إلى مخزنه المؤقت بسعة 64 بايتًا، ويكتب المشغّل WR_DONE عند كل سطر جديد وفي flush()، منتظرًا تحرر المخزن المؤقت بدلًا من فقدان أي بايت.

crt0.S وsupport64.c هما ملفا ESP32 الكلاسيكية، لكنهما مُجمَّعان من جديد لهذه اللوحة بدلًا من نسخهما: معالجات النوافذ وجدول المتجهات ونقطة دخول الاستثناء تخص البنية (ISA) وليست الشريحة. ستة ملفات أخرى هي ملفات ESP32-C3، كما على ESP32 الكلاسيكية.

يبنيه GCC الخاص بـ Espressif للنسخة S3. يضع deploy/fetch-xtensa.sh esp32s3 المترجم xtensa-esp32s3-elf-gcc الإصدار 8.4.0 (esp-2021r2-patch5) في tools/xtensa/، وهو مستثنى من git. المترجم GCC مرخّص بـ GPL، ولا شيء مما يبنيه هنا يرتبط بـ libgcc أو بأي جزء آخر من سلسلة الأدوات (البيئة مبنية بـ -nostdlib مع كود مساعدة خاص بها)، لذا لا يصل أي كود مرخّص بـ GPL إلى ملف ELF موزَّع. التفاصيل الكاملة في docs/compile.md.

يُربط مع firmware/esp32s3/link.ld: .text عند عنوان ناقل التعليمات لـ SRAM1، وأقسام البيانات عند عنوان ناقل البيانات لأول بايت بعده، والمكدس في أعلى SRAM2. يرفض البناء صورة يتجاوز حجمها القابل للتحميل 64 KB، ويرفض elfcheck.py صورة يتشارك كودها وبياناتها في الذاكرة نفسها.

أحد عشر مثالًا، كل منها مع كود يعرضه الواجهة: blink (الـ LED RGB بالأبيض وLED موصّل على GPIO2)، وrainbow (الـ LED RGB يدور في عجلة الألوان)، وbutton (مفتاح إلى الأرضي على GPIO21 مع مقاومة السحب الداخلية للطرف، يشغّل الـ LED على GPIO2)، وserial (نبضة كل ثانية على UART0، مع صدى)، وusbserial (الشيء نفسه على منفذ USB)، وfade (LED على GPIO2 عبر LEDC، بثمانية بتات عند 1 kHz)، وknob (مقاومة متغيرة على GPIO4، قناة ADC1 رقم 3، تخفض سطوع الـ LED على GPIO2 مع طباعة القراءة الخام)، وأربعة أمثلة WiFi: wificonnect وwifiweather وwifiapi وwifilamp.

crates/esp32s3/tests/runtime.rs يشغّل ملفات ELF تلك ويقيس: نصف دورة blink ضمن 5 ms من 500، وإطارات WS2812 على GPIO48 مفكوكةً وكل بت بزمن مرتفعه ومنخفضه داخل نطاقات صحيفة البيانات، والألوان التي يرسلها rainbow بترتيب الأخضر أولًا، ودورة LEDC ضمن 5 us من 1 ms، وmillis() ضمن 60 ms من ساعة النواة على مدى خمس ثوانٍ، ولا بايتان متتاليان على UART0 أقرب من زمن بايت واحد عند 115200، ووصول سطر USB كحزمة واحدة. crates/esp32s3/tests/wifi.rs يشغّل أمثلة WiFi على الشبكة المحاكاة. يتخطى كل اختبار نفسه عندما لا تكون الصور مبنية.