هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة 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_REGnon-zero) or UART0 (UART_INT_ST_REGnon-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(0x7E0to0x7E2, user views0x800to0x802, the one ESP-IDF'sesp_cpu_get_cycle_countreads), all read without trapping and count one per 160 MHz cycle, which is one per instruction.mpccrcounts from reset (mpcerandmpcmrread 1); a write sets it, andmpcmrbit 0 clear holds it. None of them advance while the core is parked inwfi. 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 هو العقد الذي يحدد ما تفعله تلك الشبكة، وبتفصيل أكبر، ما لا تفعله.