المرجع

عقد لوحة ESP32-C3 (المرحلة 2)

الملحقات الطرفية، وخريطة الذاكرة، والتوقيت في DevKitM-1.

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

The first microcontroller in Mokxi. One kernel component (esp32c3 in crates/parts) wraps a SoC model (crates/esp32c3) built on the RV32IMC core (crates/rv32-core). Firmware is a plain RV32 ELF that talks to the peripherals below at their real ESP32-C3 addresses, so a program built for Mokxi also runs on a real board. Running vendor ESP-IDF or Arduino-core binaries is out of scope for Phase 2: they need the ROM, the clock tree, the cache and the interrupt matrix, none of which are modeled.

النوع في الفهرس هو esp32c3 (لوحة ESP32-C3-DevKitM-1). ثلاثة وكلاء تبني اعتمادًا على هذا الملف: SoC والقطعة (Rust)، ووقت تشغيل البرنامج الثابت والأمثلة (C، clang)، والمظهر البصري للوحة والشاشة التسلسلية (TypeScript). غيّره فقط بتحرير هذا الملف أولًا.

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

بالترتيب المادي للرأسين ذوَي الـ 15 طرفًا على DevKitM-1 (منظر علوي، موصل USB في الأسفل):

الرأس الأيسر (من الأعلى إلى الأسفل): GND، 3V3، 3V3b، 2، 3، RST، GNDb، 0، 1، 10، 4، 5، 6، 7، 8 الرأس الأيمن (من الأعلى إلى الأسفل): 5V، 5Vb، GNDc، GNDd، 9، 18، 19، 20، 21، NC1، NC2، NC3، NC4، NC5، NC6

الأسماء المكررة تحمل لاحقة حرفية لأن أسماء الأطراف في الفهرس فريدة. الأطراف NC* موجودة فقط لكي يُرسم الرأس كاملًا؛ وهي عالية المقاومة (high-Z) ولا تُقرأ أبدًا.

كهربائيًا:

  • 3V3* تُخرج 3.3 V عند R_SUPPLY؛ و5V* تُخرج 5 V عند R_SUPPLY؛ وGND* تُخرج 0 V عند R_SUPPLY. اللوحة مزوّدة بالطاقة دائمًا (USB)، وهي مصدر طاقة لبقية الدائرة.
  • RST هو مدخل بمقاومة سحب داخلية 10 k إلى 3.3 V؛ إذا أُنزل عن 1.65 V يُبقي المعالج في حالة إعادة تعيين؛ وعند إفلاته يعاد تشغيل البرنامج من نقطة البداية.
  • أطراف GPIO 0..10, 18, 19, 20, 21 مدخل ومخرج في آن واحد. مع تمكين الإخراج: push-pull عند 3.3 V أو 0 V عبر R_STRONG. مع تعطيل الإخراج: حالة high-Z، إضافة إلى مقاومة سحب 45 k إلى 3.3 V عند ضبط FUN_WPU في IO_MUX، أو مقاومة سحب للأسفل 45 k عند ضبط FUN_WPD. المدخل يقرأ جهد الشبكة مقارنةً بـ 1.65 V (نصف 3.3 V)؛ الحالة غير المعروفة تُقرأ 0، والمدخل العائم يقرأ ضوضاء كما في Uno (docs/uno.md القسم 1)؛ ويقرأ GPIO9 مستوى مرتفعًا عندما لا يثبّته شيء، بسبب مقاومة السحب الخاصة باللوحة بجوار زر BOOT.
  • الأطراف من GPIO 0 إلى 4 هي أيضًا قنوات ADC1 من 0 إلى 4: يُقرأ جهد الشبكة على هذه الأطراف الخمسة كجهد تناظري بالإضافة إلى المقارنة بالعتبة، لذا فإن مقياس جهد متغير أو عصا تحكم أو مقسّم جهد على أحدها يُعد مدخلًا تناظريًا حقيقيًا (القسم 3.5). والطرف الذي لا يثبّته شيء يتشرد، كما يفعل المدخل العائم (docs/uno.md القسم 1).
  • الطرفان 18/19 يؤديان أيضًا دور USB D-/D+ والطرفان 20/21 دور UART0 RX/TX على اللوحة الحقيقية؛ هنا هما GPIO عادية. بايتات UART0 تذهب إلى قناة المضيف (القسم 4)، لا إلى الأطراف.

2. خريطة الذاكرة (عناوين ESP32-C3 الحقيقية)

المنطقة العنوان الحجم ملاحظات
SRAM، ناقل التعليمات 0x4037_C000 400 KB ذاكرة RAM واحدة، منظران
SRAM، ناقل البيانات 0x3FC7_C000 400 KB نفس البايتات: DRAM = IRAM - 0x0070_0000
IROM (flash code) 0x4200_0000 up to 1,310,720 bytes read-only, section 2.1
DROM (flash constants) 0x3C00_0000 up to 1,310,720 bytes read-only, section 2.1
GPIO 0x6000_4000 4 KB القسم 3.1
IO_MUX 0x6000_9000 4 KB القسم 3.2
UART0 0x6000_0000 4 KB القسم 3.3
SYSTIMER 0x6002_3000 4 KB القسم 3.4
APB_SARADC 0x6004_0000 4 KB القسم 3.5
LEDC 0x6001_9000 4 KB القسم 3.7
صندوق بريد شبكة Mokxi 0x6FFF_E000 4 KB القسم 3.8. ليست من الشريحة: كتلة خاصة بـ Mokxi، حيث لا يوجد شيء في C3 الحقيقية

كامل الـ 400 KB هو RAM (الرقائق الحقيقية تحجز الجزء العلوي لبيانات ROM وذاكرة التخزين المؤقت؛ غير مُمثَّل هنا). وأي شيء آخر يسبب خطأ وصول (النواة تتعثر؛ والقطعة تحصيه، انظر القسم 5). وسجلات الأجهزة الطرفية غير المعيَّنة داخل كتلة معيَّنة تُقرأ 0 وتتجاهل الكتابة، مع عدّاد لأغراض التشخيص.

2.1 Flash. A real ESP32-C3 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 ("Default 4MB with spiffs") gives the sketch 1,310,720 bytes of it. That is the room a sketch has here, counted as the IDE counts it (code, constants, startup code and the initial values of the variables), and the number the editor prints after a build. firmware/link.ld keeps the startup code and the trap entry in SRAM through the instruction view and puts every other function in the code window and every constant in the constants window; the variables and the stack take the SRAM from the end of the startup code up. 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 SRAM costs), and a store to one faults. RISC-V calls through AUIPC and JALR, which reach 2 GB, so no literal pools or long-call tricks are needed. The upload build (link-hw.ld) is loaded into RAM by the ROM and keeps the 400 KB SRAM as its room.

Firmware ELF: loadProgram takes an ELF32 little-endian RISC-V executable. Every PT_LOAD segment must fall inside SRAM through either view or inside one of the two flash windows. Entry is the ELF entry point; the CPU resets with pc = entry, sp = top of SRAM data view (0x3FCE_0000), all other registers zero, mtvec = 0. A load at run time resets the board.

3. سجلات الأجهزة الطرفية (مجموعة فرعية، إزاحات حقيقية، مواضع بتات حقيقية)

السجلات 32 بت ومحاذاة كلمة. الوصول بنصف كلمة أو بايت إلى سجل غير مدعوم (يُعامل كوصول بكلمة للكلمة المحاذاة، وهو ما تفعله الشريحة في القراءات؛ أما الكتابات الأضيق فتكتب الكلمة كاملة من القيمة الضيقة، وهو سلوك غير حقيقي، لذا يجب ألا يفعله البرنامج الثابت).

3.1 GPIO‏ (0x6000_4000)

الإزاحة الاسم البتات
0x04 GPIO_OUT_REG البت n = مستوى GPIO n عند تمكين الإخراج
0x08 GPIO_OUT_W1TS_REG اكتب 1 لضبط بتات OUT
0x0C GPIO_OUT_W1TC_REG اكتب 1 لمسح بتات OUT
0x20 GPIO_ENABLE_REG البت n = مشغّل إخراج GPIO n مفعّل
0x24 GPIO_ENABLE_W1TS_REG ضبط
0x28 GPIO_ENABLE_W1TC_REG مسح
0x3C GPIO_IN_REG البت n = مستوى مدخل GPIO n (يحتاج FUN_IE)
0x44 GPIO_STATUS_REG حالة المقاطعة، البت n
0x4C GPIO_STATUS_W1TC_REG مسح
0x74 + 4n GPIO_PINn_REG البت 2 PAD_DRIVER (1 = مصب مفتوح)، البتات 7..9 INT_TYPE (0 معطل، 1 حافة صاعدة، 2 حافة هابطة، 3 أيهما، 4 مستوى منخفض، 5 مستوى مرتفع)
0x554 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG البتات 0..7 OUT_SEL: 128 = الوسادة تتبع البت n في GPIO_OUT_REG (قيمة التشغيل المستخدمة هنا)؛ 45 إلى 50 = قنوات LEDC منخفضة السرعة من 0 إلى 5 تقودها (القسم 3.7)؛ وأي قيمة أخرى غير مدعومة وتُعامل كـ 128

مؤشرات الإشارة 45 إلى 50 غير مُتحقَّق منها: هي ما ينفّذه هذا الطراز لـ ledc_ls_sig_out0 إلى ledc_ls_sig_out5، اختيرت لتكون لمصفوفة GPIO مكانًا تضعها فيه، وليست صفًا منقولًا من جدول إشارات الأجهزة الطرفية في الدليل. والطرف الذي تقوده قناة LEDC يحتاج مع ذلك إلى تفعيل مشغّل إخراجه في GPIO_ENABLE_REG، وهو ما يضبطه gpio_set_direction قبل تحويل المصفوفة؛ القناة تحدد المستوى وGPIO_ENABLE تحدد إن كان الطرف يقود أصلًا.

البتات 0..21 فقط موجودة. المصب المفتوح: الإخراج المرتفع يعني حالة high-Z. مقاطعات GPIO تضبط GPIO_STATUS_REG وترفع خط المقاطعة الخارجي (القسم 3.6).

3.2 IO_MUX‏ (0x6000_9000)

الإزاحة الاسم البتات
0x04 + 4n IO_MUX_GPIOn_REG البت 7 FUN_WPD سحب للأسفل، البت 8 FUN_WPU سحب للأعلى، البت 9 FUN_IE تمكين المدخل، البتات 12..14 MCU_SEL (1 = GPIO، القيمة الوحيدة المدعومة؛ قيمة التشغيل 1 هنا لكل طرف حتى يعمل البرنامج الثابت الخام مباشرة)

3.3 UART0‏ (0x6000_0000)

الإزاحة الاسم البتات
0x00 UART_FIFO_REG الكتابة: دفع بايت إلى TX؛ القراءة: سحب بايت من RX (تكون 0 عند الفراغ)
0x04 UART_INT_RAW_REG البت 0 RXFIFO_FULL، البت 1 TXFIFO_EMPTY، البت 8 RXFIFO_TOUT
0x08 UART_INT_ST_REG خام ومُمكَّن
0x0C UART_INT_ENA_REG
0x10 UART_INT_CLR_REG اكتب 1 للمسح
0x14 UART_CLKDIV_REG البتات 0..11 الجزء الصحيح من القاسم، والبتات 20..23 CLKDIV_FRAG أجزاؤه من ستة عشر، من ساعة النواة (معدل البود يؤثر فقط على إيقاع TX في القسم 5؛ يُخزَّن ويُقرأ مرة أخرى)
0x1C UART_STATUS_REG البتات 0..9 RXFIFO_CNT، البتات 16..25 TXFIFO_CNT
0x20 UART_CONF0_REG مخزَّن ويُقرأ مرة أخرى؛ البت 17 RXFIFO_RST والبت 18 TXFIFO_RST يمسحان المخزنين المؤقتين (TRM v1.4 السجل 26.9)
0x24 UART_CONF1_REG البتات 0..8 RXFIFO_FULL_THRHD، البتات 9..17 TXFIFO_EMPTY_THRHD
0x78 UART_CLK_CONF_REG البتات 20..21 SCLK_SEL (1 ساعة APB بسعة 80 MHz، و3 الكريستال 40 MHz؛ و2 أي RC_FAST يُعامل كالكريستال)، البتات 12..19 SCLK_DIV_NUM: ساعة النواة هي المصدر مقسومًا على SCLK_DIV_NUM + 1. بعد إعادة التهيئة يكون الكريستال بلا قسمة، لذا CLKDIV بقيمة 347 يعطي 115 274 بود. أما SCLK_DIV_A/SCLK_DIV_B الكسرية فتُخزَّن ولا يُمثَّل أثرها

تُبرمِج بيئة التشغيل معدل البود بالطريقة التي يفعلها uart_ll_set_baudrate في ESP-IDF: ساعة APB، مُقسَّمة مسبقًا بأصغر SCLK_DIV_NUM + 1 تُنزل القاسم عن 4096، والقاسم بدقة جزء من ستة عشر، بحيث يكون 1200 و9600 بود مضبوطين تمامًا لا مقصوصين عند 4095.

FIFOs are 128 bytes. TX bytes leave the FIFO at the configured baud (default 115200: one byte per 86.8 us) into the host channel; a full TX FIFO drops bytes (real behavior). RX bytes arrive from the host channel instantly. RXFIFO_TOUT raises when RX has data and no byte arrived for 10 byte times.

3.4 SYSTIMER‏ (0x6002_3000)

عدّاد حر 52 بت بساعة 16 MHz، مع مقارن واحد موصول بمقاطعة مؤقت المعالج.

الإزاحة الاسم البتات
0x04 SYSTIMER_UNIT0_OP_REG البت 30 UPDATE: اكتب 1 لتثبيت العدد في VALUE_HI/LO؛ والبت 29 VALUE_VALID يُقرأ 1 بعد التثبيت
0x40 SYSTIMER_UNIT0_VALUE_HI_REG البتات 0..19، بتات العدد المثبَّت 32..51
0x1C SYSTIMER_TARGET0_HI_REG الباتات 0..19
0x20 SYSTIMER_TARGET0_LO_REG
0x34 SYSTIMER_TARGET0_CONF_REG البت 30 PERIOD_MODE، البتات 0..25 PERIOD
0x44 SYSTIMER_UNIT0_VALUE_LO_REG بتات العد المقفلة 0..31
0x50 SYSTIMER_COMP0_LOAD_REG اكتب 1 لتحميل الهدف
0x64 SYSTIMER_INT_ENA_REG البت 0
0x68 SYSTIMER_INT_RAW_REG البت 0
0x6C SYSTIMER_INT_CLR_REG البت 0
0x70 SYSTIMER_INT_ST_REG البت 0

يعمل المؤقت دائمًا. يُشتق العد من زمن النواة: count = now_ps / 62_500. ولا ينحرف عن الدائرة أبدًا.

تم التحقق سجلًا بسجل مقابل ESP32-C3 Technical Reference Manual الإصدار v1.4، القسم 10.6 (ملخص السجلات) والسجلات 10.2 و10.14 إلى 10.17. وضعَت نسخة سابقة من هذا النموذج المقارن 0 عند 0x50 إلى 0x5C، وهي على C3 نبضات التحميل COMP0_LOAD إلى COMP2_LOAD وUNIT0_LOAD؛ لم يكن هذا التخطيط تخطيط الشريحة قط، وقد أعيد بناء بيئة التشغيل وصورها عند تصحيحه.

3.5 APB_SARADC (0x6004_0000)

ADC1 في وضع التحويل الواحد: هو المسار الذي يسلكه محرّك adc_oneshot في ESP-IDF ودالة analogRead في نواة Arduino، ولا شيء غيره. القنوات 0 إلى 4 هي GPIO 0 إلى GPIO 4؛ أما ADC2 فغير مُنمذج (على C3 حقيقية هو مشترك مع الراديو، ولا راديو هنا).

العنوان الأساسي للكتلة هو عنوان الشريحة. الإزاحات المعلَّمة بـ "غير مُتحقق منها" في هذا الجدول لم تُؤخذ من صفحة في الدليل المرجعي التقني: إنها ما ينفّذه هذا النموذج، وقد اختيرت لتطابق شكل مسار التحويل الواحد، والبرنامج الثابت المبني هنا يتفق مع النموذج سواء اتفق مع السيليكون أم لا. 0x00 و0x04 من الدليل؛ وبقية سجلات التحويل الواحد غير مُتحقق منها، وينبغي لبرنامج يحتاج إلى العمل على DevKitM-1 دون تغيير أن يراجعها مقابل الدليل أولًا.

الإزاحة الاسم البتات
0x00 APB_SARADC_CTRL_REG البتات من 7 إلى 14 SAR_CLK_DIV: مقسّم تردد ساعة SAR. يُخزَّن ويُقرأ مرة أخرى؛ توقيت التحويل هنا ثابت
0x04 APB_SARADC_CTRL2_REG يُخزَّن ويُقرأ مرة أخرى. مسارا الإطلاق بالمؤقت وDMA غير مُنمذجين
0x0C APB_SARADC_FSM_WAIT_REG يُخزَّن ويُقرأ مرة أخرى (إزاحة غير مُتحقق منها)
0x38 APB_SARADC_ONETIME_SAMPLE_REG البتات من 23 إلى 24 ONETIME_ATTEN، البتات من 25 إلى 28 ONETIME_CHANNEL، البت 29 ONETIME_START، البت 30 SAR2_ONETIME_SAMPLE (يُخزَّن، ولا يحوّل شيئًا)، البت 31 SAR1_ONETIME_SAMPLE (إزاحة ومواضع حقول غير مُتحقق منها)
0x44 APB_SARADC_1_DATA_STATUS_REG البتات من 0 إلى 16 ADC1_DATA: آخر تحويل لـ ADC1، بعرض اثني عشر بتًا (إزاحة غير مُتحقق منها)
0x64 APB_SARADC_INT_ENA_REG يُخزَّن؛ لا خط يصل إلى النواة (إزاحة غير مُتحقق منها)
0x68 APB_SARADC_INT_RAW_REG البت 31 ADC1_DONE (إزاحة غير مُتحقق منها)
0x6C APB_SARADC_INT_ST_REG خام ومُمكَّن (إزاحة غير مُتحقق منها)
0x70 APB_SARADC_INT_CLR_REG اكتب 1 للمسح، نفس البت (إزاحة غير مُتحقق منها)
0x78 APB_SARADC_APB_ADC_CLKM_CONF_REG يُخزَّن ويُقرأ مرة أخرى (إزاحة غير مُتحقق منها)

One conversion: write ONETIME_SAMPLE with SAR1_ONETIME_SAMPLE, the channel and the attenuation, write it again with ONETIME_START up, wait for ADC1_DONE in INT_RAW, read APB_SARADC_1_DATA_STATUS_REG, clear the flag and drop ONETIME_START. A conversion starts on the write that raises ONETIME_START with ADC1 taking part, and takes a fixed 5 us. The real figure depends on the SAR clock and the FSM's counts and is a few microseconds; firmware waits for it either way, since the result does not appear early.

النتيجة اثنا عشر بتًا، round(4095 x Vin / Vfull)، مقصوصة الحدود، من جهد الشبكة في لحظة بدء التحويل. تحدد ONETIME_ATTEN السلم الكامل، بالأرقام الاسمية التي يذكرها كتيّب البيانات:

ONETIME_ATTEN التوهين السلم الكامل
0 0 dB 1.1 V
1 2.5 dB 1.5 V
2 6 dB 2.2 V
3 11 dB منحنى الجزء الحقيقي، يشبع عند نحو 2.9 V

الثلاثة الأولى خطوط مستقيمة اسمية. أما 11 dB (12 dB في ESP-IDF الحالية)، وهي القيمة الافتراضية لنواة Arduino، فتتبع منحنى قطعة نموذجية خام (CURVE_11DB في crates/esp32c3/src/adc.rs): قريب من الخطية عبر مدى 0 إلى 2500 mV الفعّال في كتيّب البيانات (3650 عند 2.5 V)، ثم يواصل إلى 4095 عند نحو 2.9 V (يذكر الناس 2.8 إلى 3.0 V على وحدات حقيقية). لذا يعطي مقياس جهد متغير عبر قضيب 3.3 V قراءة 4095 لآخر عُشر مداه، ويعطي مقسّم عند نصف القضيب نحو 2410 لا 2048. ومعايرة eFuse للوحدة تحرّك ذلك بضعة بالمئة، وهي غير مُنمذجة؛ وanalogReadMilliVolts تعكس المنحنى نفسه. والقناة التي لا شيء على طرفها تتيه، كما يفعل مدخل عائم (docs/uno.md القسم 1).

يمكن استطلاع ADC1_DONE ومسحه، وهو ما يفعله مسار التحويل الواحد، لكنه لا يصل إلى mip: فالمحوّل ADC ليس على خط المقاطعة الخارجي (القسم 3.6). وكذلك المتحكم الرقمي وجدول أنماط DMA والمرشِحات ومراقبات العتبة وقناتا درجة الحرارة الداخلية وVDD.

3.6 المقاطعات

وضع الآلة في RISC-V، وmtvec مباشر أو متجهي كما تدعمه النواة. الخطوط:

  • مقاطعة مؤقت الآلة (mip.MTIP، السبب 7): الهدف 0 من SYSTIMER عندما يكون البت 0 في INT_ENA والبت 0 في INT_RAW.
  • Machine external interrupt (mip.MEIP, cause 11): GPIO (GPIO_STATUS_REG non-zero) or UART0 (UART_INT_ST_REG non-zero). Firmware reads the two status registers to find out which. The real interrupt matrix is not modeled.

wfi يوقف النواة حتى يصبح أي خط قيد الانتظار.

3.7 LEDC (0x6001_9000)

متحكم LED PWM، المجموعة منخفضة السرعة، وهي المجموعة الوحيدة في هذه الشريحة: أربعة مؤقتات وست قنوات. هذه هي الكتلة التي تقف خلف analogWrite وledcAttach وledcWrite.

A timer is a free-running counter of 2^DUTY_RES counts clocked at 80 MHz divided by CLK_DIV, which is a Q10.8 fixed-point number of APB clocks per count, so

f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES)

و5 kHz عند ثمانية بتات هي DUTY_RES بقيمة 8 مع CLK_DIV بقيمة 16000، بالضبط. تختار القناة مؤقتًا وعدّ بداية HPOINT ودورة تشغيل، ومخرجها مرتفع بدءًا من HPOINT لمدة DUTY >> 4 عدّة، مع الالتفاف حول قمة الدورة. لذا فدورة تشغيل 0 تعني مستوى منخفضًا ثابتًا، ودورة 2^DUTY_RES تعني مستوى مرتفعًا ثابتًا، بلا أي حافة، ولهذا تحوّل نواة Arduino ledcWrite(pin, 255) عند ثمانية بتات إلى دورة 256 بدل ترك ثُلمة عدّة واحدة كل دورة.

Verified: the base address, every offset in the table below and every bit it names, against the ESP32-C3 Technical Reference Manual v1.4, section 32.5 (register summary) and registers 32.1 to 32.13.

الإزاحة الاسم البتات
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 DUTY: عرض النبضة بوحدات مقدارها جزء من ستة عشر من العدّة
0x0C + 0x14n LEDC_CHn_CONF1_REG عتاد تلاشي duty: مخزَّن ويُقرأ، ولا يلاشي شيئًا
0x10 + 0x14n LEDC_CHn_DUTY_R_REG قيمة duty كما هي، للقراءة فقط
0xA0 + 8n LEDC_TIMERn_CONF_REG bits 0..3 DUTY_RES (1 to 14; 0 is a timer nobody has configured and it counts nothing), bits 4..21 CLK_DIV (Q10.8 APB clocks per count), bit 22 PAUSE, bit 23 RST, bit 25 PARA_UP (stored); bit 24 is reserved. TRM v1.4 register 32.7. The C3 has no per-timer TICK_SEL: the clock is chosen for all four timers in LEDC_CONF_REG. An earlier version of this model used the classic ESP32's layout here (five resolution bits and the divider from bit 5). The manual's reset value has RST set; here the register powers up as 0
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 اكتب 1 للمسح
0xD0 LEDC_CONF_REG البِتات 0..1 APB_CLK_SEL (1 = ساعة APB ذات 80 MHz، وهي المصدر الوحيد المحاكى)، البِت 31 CLK_EN (مخزّن)
0xFC LEDC_DATE_REG ختم إصدار، للقراءة فقط

إعداد القناة هو ما يقوم به ledc_timer_config وledc_channel_config: اكتب LEDC_CONF_REG، واكتب DUTY_RES وCLK_DIV الخاصة بالمؤقت، واكتب CONF0 الخاصة بالقناة مع مؤقتها وSIG_OUT_EN، واكتب HPOINT وDUTY، واضبط بت GPIO_ENABLE الخاص بالطرف ووجّه GPIO_FUNCn_OUT_SEL_CFG_REG الخاص به إلى 45 + channel.

العدّاد لا يتحرك خطوة خطوة: فهو دالة صيغة مغلقة للزمن المحاكى، وكذلك وقت حافّته التالية. لذا فإن نواة متوقفة في wfi لا تكلف شيئًا أثناء عمل PWM، ولا تُوقظ قطعة اللوحة إلا عند الحواف ولا شيء غيرها.

غير مُحاكى: المجموعة عالية السرعة (لا توجد في هذه الشريحة)، وعتاد duty-fade، وعدّاد التجاوز الخاص بالقناة نفسه، ومصادر الساعة غير APB، وخط مقاطعة LEDC إلى مصفوفة المقاطعات. يمكن استعلام LEDC_INT_RAW_REG ومسحه لكنه لا يصل أبدًا إلى mip، تمامًا كما أن ADC1_DONE الخاص بالـ ADC لا يصل (القسم 3.6).

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

هذه الكتلة ليست خاصة بـ ESP32-C3. كل عنوان آخر في هذا المستند هو عنوان الشريحة، مقتبس من الدليل المرجعي التقني، وأي صورة مبنية عليه تعمل على لوحة DevKitM-1 حقيقية. أما هذا فخاص بـ Mokxi: شبكة crates/net المحاكاة، موضوعة عند عنوان يتركه الجزء الحقيقي غير معيّن، بحيث تُحدث صورة تستخدمه خطأً على السيليكون بدلًا من قراءة مسجّل جهاز طرفي آخر. ذلك الخطأ هو الجواب الصادق، لأن ما وراء هذه الكتلة غير موجود على الشريحة.

لا يوجد هنا لا راديو، ولا 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_ الثمانية هي نصف البلوتوث من الكتلة، ولكل منها حلقاتها الخاصة: بلوتوث 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.9 كلاب مراقبة مجموعات المؤقتات، وإعادة تعيين RTC_CNTL، ومراقب المكدس (0x6001_F000، 0x6002_0000، 0x6000_8000، 0x600C_E000)

كلاب المراقبة الرئيسي لكل مجموعة مؤقتات (crates/esp-common/src/mwdt.rs): WDTCONFIG0..5 وWDTFEED ومفتاح WDTWPROTECT، بأربع مراحل، لكل منها فعلها (مقاطعة، أو إعادة تعيين للمعالج، أو إعادة تعيين للنظام)، ومقسّم على ساعة APB بتردد 80 MHz أو، مع WDT_USE_XTAL، على البلورة بتردد 40 MHz، والإعداد المكتوب يسري عند WDT_CONF_UPDATE_EN. بت كلاب المراقبة في TIMG_INT_ENA/RAW/ST/CLR (البت 1) يرفع مقاطعة المعالج الخارجية، كما تفعل GPIO وUART0 (القسم 3.6). مرحلة إعادة التعيين تعيد تعيين الشريحة والساعة تعمل، وRTC_CNTL_RESET_STATE_REG يخبر بالسبب (7 أو 8 لإعادة تعيين النظام، و0xB أو 0x11 لإعادة تعيين المعالج)؛ ويُعاد تحميل الذاكرة من الصورة، وRTC_CNTL_STORE0..7 تحتفظ بقيمها، وRTC_CNTL_SW_SYS_RST وRTC_CNTL_SW_PROCPU_RST في RTC_CNTL_OPTIONS0_REG تعيد التعيين أيضًا (السببان 3 و0xC).

يشغّل بيئة التشغيل كلّاب مهام ESP-IDF على كلّاب مجموعة المؤقتات 0، كما تفعل ESP-IDF (firmware/src/main.cpp): نبضات كل 500 µs، المرحلة 0 مقاطعة عند انته المهلة والمرحلة 1 إعادة تعيين نظام عند ضعفها، ويبدأ قبل setup() عند 5 ثوانٍ مع panic، ويراقب مهمة الخمول للنواة 0. تطبع المقاطعة أسطر ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …"، والمهام، و"Aborting."، وسطر الإيقاف و"Rebooting...")، وتترك تلميح ESP_RST_TASK_WDT الخاص بـ ESP-IDF في مسجّل التخزين RTC وتعيد تعيين المعالج عبر إعادة التعيين البرمجية، لذا يقول esp_reset_reason() بعدها 6. وesp_task_wdt_* وenableLoopWDT() وenable/disableCore0WDT() تعمل عليه. أما كلّاب مجموعة المؤقتات 1 فيُحاكى بالطريقة نفسها ولا شيء في بيئة التشغيل يفعّله: كلّاب المقاطعات غير محاكى.

ASSIST_DEBUG's stack monitor (SP_MIN, SP_MAX, INTR_ENA, INTR_RAW, SP_PC; the region monitors are not modeled): while it is on, an instruction that would move sp outside the bounds does not retire and the board reports "firmware crashed at pc=…, stack overflow: the stack ran out of RAM (SP=…)". The runtime points SP_MIN at the top of the heap, which malloc moves, and SP_MAX at the top of RAM, so runaway recursion stops at the heap instead of running down through the program in the RAM it shares. Narrower bounds reach the core at its next pass and wider ones at once, so neither costs a sketch anything it would notice: a tight loop ran at 154 to 159 MIPS before the check and 164 to 175 after, the same within the noise of the machine.

4. قناة المضيف

host = "utf-8 bytes on UART0". يعيد readHost بايتات إرسال UART0 عند خروجها من الـ FIFO؛ ويدفع writeHost بايتات إلى FIFO استقبال UART0 (الفيض يُهمَل، كما على الشريحة). تعرض الشاشة التسلسلية البايتات كنص، بفك ترميز UTF-8 واعتبار \n نهاية سطر (\r يُهمَل).

5. نموذج الزمن

يعمل المعالج بتردد 160 MHz بتعليمة واحدة لكل دورة. تنفّذ القطعة عملها في شرائح: عند كل إيقاظ تنفّذ SLICE_NS * 160 تعليمة (SLICE_NS = 10 us، أي 1600 تعليمة) ثم تجدول الإيقاظ التالي، وفق هذه القواعد:

  • الكتابات الطرفية التي تغيّر طرفًا (GPIO OUT أو ENABLE، أو مقاومات الرفع في IO_MUX) تدفع الطرف في اللحظة التي بدأت فيها الشريحة زائد عدد التعليمات حتى الآن مقسومًا على 160 MHz. استخدم drive_after بذلك التأخير حتى يحتفظ تبديلان داخل شريحة واحدة بالتباعد بينهما. أما قراءات GPIO_IN فترى مستوى الطرف كما كان عند بدء الشريحة.
  • يُقارن مقارن المؤقت وإيقاع UART على الزمن نفسه داخل الشريحة، لذا فإن micros() رتيب، وdelayMicroseconds في انتظار مشغول دقيق إلى حد تعليمة واحدة.
  • Cycle counters: rdcycle/cycle (0xC00, 0xC80), mcycle/mcycleh (0xB00, 0xB80) and the ESP32-C3's own performance counter, mpcer/mpcmr/mpccr (0x7E0 to 0x7E2, user views 0x800 to 0x802, the one ESP-IDF's esp_cpu_get_cycle_count reads), all read without trapping and count one per 160 MHz cycle, which is one per instruction. mpccr counts from reset (mpcer and mpcmr read 1); a write sets it, and mpcmr bit 0 clear holds it. None of them advance while the core is parked in wfi.
  • wfi: تتوقف القطعة عن التقسيم وتجدول إيقاظًا عند الأقدم من هدف المؤقت وحدث UART؛ وتغيّر طرف GPIO يوقظها فورًا.
  • أخطاء الوصول: تقع النواة في مصيدة إلى mtvec؛ ومع mtvec = 0 يتكرر ذلك إلى ما لا نهاية. تعدّ القطعة المصائد، وبعد 1000 مصيدة متتالية دون تقدم للأمام تتوقف وتُبلغ "firmware crashed at pc=…, mcause=…" عبر probe (انظر أدناه) وقناة المضيف (سطر واحد).

Probe: 1 when running, 0 when halted (no program, in reset, or crashed), 0.5 while parked in wfi. Poke: 1 = press the BOOT button (GPIO 9 low while held), 0 = release; 2 = press RST, 3 = release RST. The UI gives the board interaction: 'hold' on its RST button region only if the visual supports region-specific interaction; for Phase 2 the whole board is not interactive, and BOOT/RST are wired to pushbuttons by users if they want them.

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

A freestanding C and C++ runtime built with clang (--target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32) and lld, no libc, no GPL: crt0.S (stack, .data copy, .bss clear, trap vector, main), esp32c3.h (the registers above as macros), arduino.h with pinMode, digitalWrite, digitalRead, analogRead (one-shot ADC1 on GPIO 0..4, twelve bits, with analogReadResolution, analogSetAttenuation and analogSetPinAttenuation), analogWrite and the ledcAttach/ledcWrite pair (LEDC, section 3.7: eight bits at 1 kHz on any GPIO by default, with analogWriteResolution and analogWriteFrequency, and a channel allocated to a pin the first time it is written to), delay, delayMicroseconds, millis, micros, Serial.begin/print/println/write/available/read (a small C++ Print class with integer, float, string and char overloads), attachInterrupt for GPIO. The sketch is setup() and loop(). build.sh compiles every example under firmware/examples/ to web/public/firmware/<name>.elf, which the UI ships. Examples: blink (GPIO 8, the DevKitM-1 LED pin, 500 ms), button (GPIO 9 with pull-up lights GPIO 8), serial (prints millis() once a second and echoes what it receives), fade (bit-banged PWM on GPIO 8 for a breathing LED), counter (74HC595 driven on GPIO 4 = DS, 5 = SHCP, 6 = STCP, counting on eight LEDs), interrupt (attachInterrupt on GPIO 9 counts presses and prints the count), pwmfade (the same breathing LED as fade, on analogWrite rather than by hand, so the core sleeps through it), servo (an SG90 swept end to end by a 50 Hz LEDC channel on GPIO 4).

The board's code in the editor is not compiled in Phase 2 (see docs/compile-options.md); the UI offers the built-in examples and an ELF upload.

7. ما تثق به هذه المواصفة، وما لا تثق به

ثلاث مجموعات، بالتصنيف نفسه الذي يستخدمه القسم 7 من docs/esp32c6.md. وهي موجودة لأن نموذج لوحة يخمّن عنوانًا بصمت هو أسوأ من نموذج يقول إنه لم يعرف.

Taken from the technical reference manual, and run through by real firmware. UART0_BASE = 0x6000_0000, GPIO_BASE = 0x6000_4000, IOMUX_BASE = 0x6000_9000, SYSTIMER_BASE = 0x6002_3000, APB_SARADC_BASE = 0x6004_0000 and LEDC_BASE = 0x6001_9000, with every register offset inside the GPIO, IO_MUX, UART0, SYSTIMER and LEDC blocks. Checked against the ESP32-C3 Technical Reference Manual v1.4 while the ESP32-S3 was being added: the SYSTIMER comparator 0 offsets (section 10.6: TARGET0_HI 0x1C, TARGET0_LO 0x20, TARGET0_CONF 0x34, COMP0_LOAD 0x50), LEDC_TIMERn_CONF_REG's fields (register 32.7), LEDC's interrupt and global registers (registers 32.3 and 32.9 to 32.13) and UART_CONF0_REG's FIFO resets (register 26.9). The first two and the last were wrong here before that check and were corrected, with the runtime's images rebuilt. The GPIO range 0 to 21, ADC1's channel map (channel n is GPIO n for n in 0 to 4), the 400 KB of SRAM at two views 0x0070_0000 apart, and the 16 MHz SYSTIMER tick. Each of those blocks is driven by a test that loads a real ELF and runs it: crates/esp32c3/tests/firmware.rs for GPIO, UART0 and SYSTIMER, and tests/examples.rs's pwmfade and servo for LEDC.

مُعتقد بها، لا مُتحقق منها. مسمّاة كسجلات، سجلًا سجلًا، في القسمين 3.1 و3.5، ومُعادة هنا لتكون القائمة في مكان واحد:

  • كل إزاحة سجل تشغيل أحادي داخل APB_SARADC عدا 0x00 و0x04. أي FSM_WAIT عند 0x0C، ONETIME_SAMPLE عند 0x38 ومواضع حقوله، 1_DATA_STATUS عند 0x44، والسجلات الأربعة للمقاطعات من 0x64 إلى 0x70، و APB_ADC_CLKM_CONF عند 0x78. وهي ما تنفذه هذه المواصفة، اختيرت لتوافق شكل مسار التشغيل الأحادي، لا صفوفًا منقولة من صفحة في الدليل.
  • مؤشرات إشارات مصفوفة GPIO من 45 إلى 50 لـ ledc_ls_sig_out0 حتى ledc_ls_sig_out5، اختيرت كي يكون للمصفوفة مكان تضعها فيه.

البرنامج الثابت المبني لهذا المستند يوافق النموذج سواء وافق رقاقة حقيقية أم لا. إذا كنت ستنقل صورة إلى DevKitM-1 حقيقي، فتحقق أولًا من تعريفات #define في firmware/include/esp32c3.h مقابل الدليل.

منمذجة، لكن بلا إلزام بأرقام الدليل. سلوكيات لا عناوين:

  • ADC عند 11 dB هو منحنى قطعة نموذجية، لا منحنى هذه الوحدة. التشبع عند نحو 2.9 V والكسب فوق المدى الفعلي 2.5 V موجودان (القسم 3.5)؛ أما تباين الوحدات الذي تصححه معايرة eFuse وضجيج التحويل فغير موجودين. التخميدات الأخرى خطوط مستقيمة اسمية (1.1 V، 1.5 V، 2.2 V).
  • التعليمة الواحدة دورة واحدة عند 160 MHz. لا توقفات في خط الأنابيب، ولا ذاكرة تخزين مؤقت (فلا توجد أصلًا)، ولا دورات انتظار للفلاش، ولا تنافس على الناقل، فعَدّ التعليمات هو الساعة. أما C3 حقيقي يعمل من الفلاش فهو أبطأ وأقل انتظامًا من هذا.
  • الأطراف ثلاث حالات وعتبة واحدة. دفع وجذب عند 3.3 V، أو مقاومة عالية، أو مقاومة سحب داخلية 45 kΩ، وتُقرأ القيمة مقابل نصف جهد التغذية، بلا تخلق، بلا ضبط لقوة الدفع، بلا زمن صعود، وبلا حد للتيار. الطرف غير المُغذّى يقرأ 0 بدلًا من أن يطفو إلى قيمة ما.
  • اللوحة مصدر تغذية مثالي: 3V3 و5V بمقاومة المصدر ذاتها إلى الأبد، فلا يحدث أي انخفاض جهد. والإقلاع يستغرق ميكروثانية، بينما تقضي C3 حقيقية عشرات المللي ثانية في boot ROM الخاص بها.
  • الشريحة الزمنية 10 µs، ويلتقي SoC والدائرة عند حدود الشرائح أو عند ما تنتظره الشريحة.

غائبة عمدًا. تُركت بدل أن تُختلق، لأن تخطيط السجلات ليس شيئًا تستطيع هذه المواصفة إعادة إنتاجه بأمانة: Bluetooth LE (لا راديو، ولا ادعاء بواحد)، وSPI، وI2C، وI2S، وRMT، وUSB Serial/JTAG، ومؤقتات مجموعات المؤقتات (كلاب الحراسة الخاصة بها هي كلاب القسم 3.9)، ومصفوفة المقاطعات الكاملة (القسم 3.6 يوضح ما يقوم مقامها)، وADC2 وجدول أنماط DMA الخاص بـ SAR ADC، والمتحكم الرقمي، والمرشحات، ومراقبات العتبة، وeFuses المعايرة، ومجموعة السرعة العالية في LEDC وعتاد duty-fade وخط مقاطعته إلى النواة، وPMU وشجرة الساعة، وذاكرة التخزين المؤقت، وROM والفلاش. لهذا لا تعمل هنا ملفات ESP-IDF ونواة Arduino الرسمية الثنائية، بينما يعمل البرنامج الثابت المبني لهذه الوثيقة.

WiFi: محاكى، انظر docs/wifi.md. It was in the list above until September 2026, as "absent: WiFi in every form". It is not absent any more and it is not modeled either: there is no radio and no 802.11, and what there is instead is section 3.8's mailbox (a block this chip does not have, at an address it leaves unmapped) with a network written in software behind it. docs/wifi.md هو العقد الذي يحدد ما تفعله تلك الشبكة، وبتفصيل أكبر، ما لا تفعله.

الأسئلة

Does it do WiFi?

محاكاة WiFi، نعم. يستخدم كودك الاستدعاءات الحقيقية في Arduino‏ (WiFi.begin وHTTPClient وWebServer) وتنضم اللوحة وتجلب البيانات وتخدمها، لكن لا يوجد راديو ولا بروتوكول 802.11 تحتها. إذا كنت مسجّلًا للدخول، يمكنك تفعيل «الإنترنت الحقيقي» في لوحة السحابة. القسم 3.8 وصفحة Simulated WiFi فيهما العقد الكامل.

هل سيعمل برنامجي الثابت على لوحة DevKitM-1 حقيقية؟

نعم. يستند النموذج إلى خريطة الذاكرة الحقيقية وإزاحات السجلات لكل ما ينفّذه، لذا فالبناء من هنا ليس خاصًا بـ Mokxi.