هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة ESP32-C6-DevKitC-1 و صفحة اللوحة.
لوحة ESP32-C6-DevKitC-1 هي ثاني لوحة RISC-V هنا. مكوّن نواة واحد (esp32c6 في crates/parts) يغلّف نموذج شريحة ESP32-C6 (crates/esp32c6) على نفس الـ hart الخاص بـ C3 (crates/rv32-core). النواة مشتركة، أما الشريحة حولها فلا. هذا المستند هو العقد، وهو يعلو على أي تعليق في الشيفرة.
نوع المجموعة في الفهرس هو esp32c6. وحيثما يقول قسم ما "كما في docs/esp32c3.md"، فإن ذلك المستند هو العقد لذلك الجزء.
اقرأ القسم 7 أولًا إذا كنت تنقل بناءً من هنا إلى سيليكون حقيقي. هذا النموذج أصغر من C6، وجزء أكبر من المعتاد منه موسوم بـ"مُصدَّق على صحته منطقيًا لا عمليًا": القسم 7 يذكر أي العناوين تلك وما هو غائب كليًا. لا شيء هنا يُخمَّن في صمت. القسم 3.6، أي إزاحات سجلات SAR ADC، هو الكتلة الوحيدة التي تخطيطها على تلك القائمة.
1. أطراف اللوحة (بترتيب الفهرس)
منظر علوي، مقبسا USB-C في الأسفل، ووحدة ESP32-C6-WROOM-1 وهوائيها المطبوع في الأعلى. اللوحة مقاسها 52.5 x 25.4 mm وتبعد رأساها ذوا الـ 15 طرفًا مسافة 22.86 mm (وهي 0.9 inch بالضبط)، فيمتطيان القناة الوسطى في لوحة التجارب.
الترتيب هو دليل مستخدم ESP32-C6-DevKitC-1 من Espressif، قسم "Header Block"، الرأسان J1 وJ3 (اللوحة v1.2). لكل رأس ثقب سادس عشر، NC، غير مُدرج.
الرأس الأيسر (J1)، من الأعلى إلى الأسفل (15 ثقبًا): 3V3، RST، 4، 5، 6، 7، 0، 1، 8، 10، 11، 2، 3، 5V، GND.
الرأس الأيمن (J3)، من الأعلى إلى الأسفل (15 ثقبًا): GNDb، TX، RX، 15، 23، 22، 21، 20، 19، 18، 9، GNDd، 13، 12، GNDc.
ثم 14، وهو ليس على أيٍّ من رأسَي اللوحة الحقيقية (انظر أدناه).
31 طرفًا. TX وRX هما GPIO 16 و17: الطباعة على اللوحة تسمّيهما بوظيفتهما لأنهما منفذ UART الخاص بالوحدة الطرفية. الأسماء المكررة تحمل حرفًا لأن أسماء الأطراف في الفهرس فريدة.
Until late October 2026 the drawing had J3 as GNDb, TX, RX, 9, 12, 13, 14, 21, 20, 19, 18, 15, 23, 22, GNDc and the bottom of J1 as GND, 5V. A diagram saved then is read with the part's header setting at early and keeps that drawing (web/src/parts/header-layout.ts); the catalog keeps GPIO 14's pin for it. On the real order (header: board, the default) the editor draws no 14, and a wire to it is left out of the circuit. The model does not read the setting.
الشريحة فيها GPIO من 0 إلى 30. GPIO من 24 فما فوق هي ذاكرة SPI flash في هذه الحزمة وليست على أي من الرأسين.
طرفان على اللوحة ليسا على رأس أصلًا:
- GPIO 8 موصول به LED RGB قابل للعنونة. أمر
pokeلا يصل إليه وقطعة اللوحة لا تفك ترميزه: فالشريحة WS2812 بروتوكول وليست مستوى جهد. وصّل القطعةws2812بـ GPIO 8 وستضيء بالألوان التي يرسلها الكود، وهو ما يفعله المثالrainbow. - GPIO 9 هو زر BOOT، فعّال بمستوى منخفض. وهو على الرأس الأيمن كذلك، فيمكن التوصيل به، وأمر
pokeيأرضه على اللوحة.
الكهرباء: كما في القسم 1 من docs/esp32c3.md. كل طرف GPIO يدفع push-pull عند 3.3 V عبر R_STRONG، أو يقف في حالة high-Z، أو يسحب إلى الأعلى أو الأسفل عبر 45 k. المدخل يقرأ مرتفعًا عند 1.65 V؛ والشبكة المتنازع عليها (Unknown) تقرأ 0، والشبكة الطافية تقرأ ضجيجًا، كما في أونو (docs/uno.md القسم 1). GPIO9 يقرأ مرتفعًا حين لا يمسكه شيء، بفعل مقاومة السحب على اللوحة بجوار زر BOOT. 3V3 يدفع 3.3 V عبر R_SUPPLY، و5V يدفع 5 V، والأرضيات الثلاث تدفع 0 V. وRST يحمل مقاومة سحب 10 k إلى 3.3 V، وسحبه تحت 1.65 V يُبقي النواة في حالة إعادة تعيين.
الترتيب الدقيق للطباعة الحرارية للرأسين هو قراءة هذا النموذج لتوزيع أطراف DevKitC-1. أرقام GPIO هي أرقام الشريحة وهي ما يعتمد عليه البرنامج الثابت، أما موقعها على الرأس فهو ما يعتمد عليه المخطط. لو كانت صفوف اللوحة الحقيقية مرتبة بشكل مختلف، لدعت الدائرة المرسومة هنا إلى إعادة توصيل على المنضدة، ولا شيء آخر كان سيتغير.
2. خريطة الذاكرة
| ذاكرة HP SRAM | 512 KB عند 0x4080_0000 إلى 0x4087_FFFF |
| Flash (code and constants) | 0x4200_0000, read-only, up to 1,310,720 bytes |
| قمة المكدس | 0x4088_0000 |
| UART0 | 0x6000_0000، القسم 3.3 |
| LEDC | 0x6000_7000، القسم 3.7 |
| SYSTIMER | 0x6000_A000، القسم 3.4 |
| APB_SARADC | 0x6000_E000، القسم 3.6 (الإزاحات الداخلية مُقدَّرة) |
| IO_MUX | 0x6009_0000، القسم 3.2 |
| GPIO | 0x6009_1000، القسم 3.1 |
Every base address in this table is the ESP32-C6 Technical Reference Manual v1.2, table 5.3-2. An earlier version of this model put APB_SARADC at 0x6000_F000, which that table gives to the USB Serial/JTAG controller.
Flash. A real ESP32-C6 runs almost all of a sketch from flash through the cache, code and const data alike at 0x4200_0000, 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/c6/link.ld keeps the startup code and the trap entry in the HP SRAM and puts every other function and every constant in the flash window, with the variables and the stack in the SRAM from the end of the startup code up. The window is a read-only view 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 it faults.
نافذة واحدة. هذا أول ما يختلف عن C3، حيث تظهر ذاكرة RAM نفسها البالغة 400 KB مرتين (عند 0x4037_C000 لناقل التعليمات وعند 0x3FC7_C000 لناقل البيانات)، وكل وصول يجب أن يجرب كليهما. هنا يصل الناقلان إلى HP SRAM عند العناوين نفسها، لذا فالعنوان عند التحميل هو العنوان عند التنفيذ، ولا تحتاج .data إلى نسخ عند إعادة التشغيل، ويصبح الناقل فحص نطاق واحد بدلًا من اثنين.
يجب أن يقع كل مقطع PT_LOAD داخل هذا النطاق؛ أي شيء آخر يُرفض مع ذكر العنوان المخالف في الرسالة، وتبقى اللوحة بلا برنامج.
3. سجلات الطرفيات
الجزء المُنفَّذ هو المجموعة أدناه فقط. أي عنوان آخر داخل كتلة مُعيَّنة بحجم 4 KB يُقرأ 0 ويُحتسب وصولًا شاردًا؛ وأي شيء خارج كل الكتل هو خطأ وصول.
3.1 GPIO (0x6009_1000)
| الإزاحة | سجل |
|---|---|
0x04 |
GPIO_OUT_REG |
0x08 |
GPIO_OUT_W1TS_REG |
0x0C |
GPIO_OUT_W1TC_REG |
0x20 |
GPIO_ENABLE_REG |
0x24 |
GPIO_ENABLE_W1TS_REG |
0x28 |
GPIO_ENABLE_W1TC_REG |
0x3C |
GPIO_IN_REG |
0x44 |
GPIO_STATUS_REG |
0x4C |
GPIO_STATUS_W1TC_REG |
0x74 + 4n |
GPIO_PINn_REG |
0x554 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
البتات من 0 إلى 30 موجودة؛ أما البت 31 فيُحجب عند الكتابة. البت 2 PAD_DRIVER في GPIO_PINn_REG يجعل الباد drain مفتوحًا، والبتات من 7 إلى 9 INT_TYPE تحدد ما يرفع مقاطعة الطرف: 0 إيقاف، 1 حافة صاعدة، 2 حافة هابطة، 3 أي حافة، 4 مستوى منخفض، 5 مستوى مرتفع. السجل GPIO_FUNCn_OUT_SEL_CFG_REG عند 128 يجعل الباد يتبع GPIO_OUT؛ والقيم من 45 إلى 50 تسلّمه لقنوات LEDC منخفضة السرعة من 0 إلى 5 (القسم 3.7، وهذه الفهارس الستة غير موثقة)؛ وأي قيمة أخرى تختار طرفًا محيطيًا غير مُنمذج، فيتعامل معها النموذج كأنها 128 بدلًا من اختلاق مستوى. ويظل الباد الذي تقودها قناة LEDC بحاجة إلى تشغيل مشغّل الإخراج الخاص به في GPIO_ENABLE_REG.
3.2 IO_MUX (0x6009_0000)
IO_MUX_GPIOn_REG عند 0x04 + 4n. البت 7 FUN_WPD، والبت 8 FUN_WPU، والبت 9 FUN_IE، والبتات من 12 إلى 14 MCU_SEL التي تكون القيمة 1 فيها هي GPIO العادي. لا يصل الباد إلى GPIO_IN_REG إلا مع تمكين صِوان الإدخال الخاص به، وهذا ما يفعله العتاد. يبدأ كل طرف عند التشغيل بالقيمة FUN_IE | (1 << 12)، لذا فالبرنامج الذي يكتفي بالكتابة في GPIO_ENABLE وGPIO_OUT يتصرف بالطريقة نفسها على كل طرف.
3.3 UART0 (0x6000_0000)
The C3's offsets, as docs/esp32c3.md section 3.3 gives them: UART_FIFO_REG 0x00, UART_INT_RAW_REG 0x04, UART_INT_ST_REG 0x08, UART_INT_ENA_REG 0x0C, UART_INT_CLR_REG 0x10, UART_CLKDIV_REG 0x14, UART_STATUS_REG 0x1C, UART_CONF0_REG 0x20, UART_CONF1_REG 0x24 (the ESP32-C6 Technical Reference Manual v1.2, section 27 register summary). Two 128-byte FIFOs, and bytes leave the transmit FIFO at the baud rate rather than instantly.
لكن ليست بتات C3. تم التحقق مقابل الدليل نفسه:
UART_CONF0_REG(وهوUART_CONF0_SYNC_REGفي الدليل، السجل 27.9): البت 22RXFIFO_RSTوالبت 23TXFIFO_RSTيفرغان المخزنين. نسخة سابقة من هذا النموذج استخدمت بتّي C3 وهما 17 و18، وهما على C6 حقول أخرى. على السيليكون، الكتابة إلى سجل_SYNCتسري مرة واحدة بعد ضبطUART_REG_UPDATE(0x98)، أما النموذج فيطبقها فورًا.UART_CONF1_REG(السجل 27.10): البتات 0..7 هيRXFIFO_FULL_THRHDوالبتات 8..15 هيTXFIFO_EMPTY_THRHD، وكلتاهما تعود عند إعادة الضبط إلى 96. نسخة سابقة من هذا النموذج كانت فيها حقول بتسعة عند 0 و9.UART_STATUS_REG(السجل 27.21): البتات 0..7 هيRXFIFO_CNTوالبتات 16..23 هيTXFIFO_CNT. يقرأها وقت التشغيل بأقنعة من ثمانية بتات، كما يذكرها الدليل. كان يقرأها ذات مرة بعشرة بتات، فأعادت الأرقام نفسها لأن البتين فوق كل حقل محجوزتان وتُقرآن 0؛ والآن يطابق الترويسة الدليل.
المقسوم عليه (UART_CLKDIV_REG البتات 0..11، مع أجزاء من ستة عشر في CLKDIV_FRAG، البتات 20..23) يقسم ساعة نواة UART، وهي على C6 تُختار في PCR لا في UART نفسه: PCR_UART0_SCLK_CONF_REG (0x6009_6004، وهو سجل PCR الوحيد المُحاكى) البتات 20..21 UART0_SCLK_SEL (القيمة 1 تعني PLL_F80M_CLK بسعة 80 MHz، والقيمة 3 البلورة بسعة 40 MHz؛ والقيمة 2، أي RC_FAST، تُؤخذ على أنها البلورة) والبتات 12..19 UART0_SCLK_DIV_NUM، وهو مقسوم مسبق بقيمة DIV_NUM + 1. بعد إعادة التعيين يكون المصدر هي البلورة دون قسمة، وتعود UART_CLKDIV إلى 347، أي 115 274 باود. يبرمج وقت التشغيل معدلًا كما يفعل uart_ll_set_baudrate في ESP-IDF (PLL_F80M، أصغر مقسوم مسبق يجعل المقسوم عليه أقل من 4096، ثم UART_REG_UPDATE)، ولذلك فإن 1200 و9600 باود دقيقتان تمامًا لا مبتورتان عند مقسوم عليه قدره 4095.
3.4 SYSTIMER (0x6000_A000)
Unit 0 and comparator 0. SYSTIMER_UNIT0_OP_REG 0x04, SYSTIMER_UNIT0_VALUE_HI_REG 0x40, ..._LO_REG 0x44, SYSTIMER_TARGET0_HI_REG 0x1C, ..._LO_REG 0x20, SYSTIMER_TARGET0_CONF_REG 0x34, SYSTIMER_COMP0_LOAD_REG 0x50, SYSTIMER_INT_ENA_REG 0x64, ..._RAW_REG 0x68, ..._CLR_REG 0x6C, ..._ST_REG 0x70. Verified against the ESP32-C6 Technical Reference Manual v1.2, section 13 register summary and registers 13.14 to 13.17. An earlier version of this model put comparator 0 at 0x50 to 0x5C, which on the C6 are the load strobes; the runtime's images were rebuilt when that was corrected.
العداد عدد نبضات بسعة 52 بت عند 16 MHz مشتق من الزمن المحاكى لا معدودًا، فلا ينحرف أبدًا عن بقية الدائرة. قراءته تتم بالتثبيت ثم القراءة: اضبط UPDATE، انتظر VALUE_VALID، اقرأ HI ثم LO. يعمل وضع التشغيل الفردي ووضع الدورة على حد سواء.
3.5 المقاطعات
كما في docs/esp32c3.md القسم 3.5. مصفوفة المقاطعات في C6 غير مُحاكاة: يتشارك GPIO وUART0 مقاطعة الآلة الخارجية، mcause 11، ويقرأ المعالج سجلَي الحالة ليعرف أيهما أطلق؛ ومقارن SYSTIMER هو مقاطعة مؤقت الآلة، mcause 7. يتصرف mstatus.MIE وmie.MTIE وmie.MEIE كما ينبغي؛ ويعمل mtvec في الوضع المباشر.
3.6 APB_SARADC (0x6000_E000)
ADC1 في وضع التحويل الفردي، سجلًا سجلًا كما يصفه docs/esp32c3.md القسم 3.5: المسار الذي يسلكه محرك adc_oneshot في ESP-IDF ودالة analogRead في نواة Arduino، ولا شيء غيره. ما يختلف هنا هو توزيع الأطراف (سبعة قنوات، من 0 إلى 6، وهي في هذه الحزمة من GPIO 0 إلى GPIO 6) والعنوان الأساسي للكتلة.
العنوان الأساسي هو عنوان الدليل (الجدول 5.3-2)؛ نسخة سابقة من هذا الطراز كان فيها 0x6000_F000، وهو متحكم USB Serial/JTAG. كل إزاحة سجل في هذا القسم غير مُتحققة: فهي إزاحات C3، وهي تخطيط العائلة، لا صفحة من الدليل التقني لـ C6 منقولة حرفيًا. أي برنامج يجب أن يعمل على DevKitC-1 حقيقي ينبغي أن يتحقق منها أولًا.
| الإزاحة | الاسم | البتات |
|---|---|---|
0x00 |
APB_SARADC_CTRL_REG |
البتات 7..14 SAR_CLK_DIV. تُخزَّن وتُقرأ مرة أخرى؛ توقيت التحويل هنا ثابت |
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 |
مخزَّنة وتُقرأ مرة أخرى |
تحويل واحد: اكتب في ONETIME_SAMPLE قيمة SAR1_ONETIME_SAMPLE والقناة والتوهين، ثم اكتبها مرة أخرى مع رفع ONETIME_START، وانتظر ADC1_DONE في INT_RAW، واقرأ سجل البيانات، وامسح الراية وأنزل ONETIME_START. يستغرق التحويل 5 us ثابتة من الزمن المحاكى، والبرنامج الثابت ينتظرها فعلًا.
النتيجة اثنا عشر بتًا، round(4095 x Vin / Vfull)، مع تقييد، لجهد الشبكة لحظة بدء التحويل، وONETIME_ATTEN يحدد السلم الكامل بالقيم الاسمية في ورقة البيانات: 0 dB تعني 1.1 V، و2.5 dB تعني 1.5 V، و6 dB تعني 2.2 V، و11 dB تعني 3.3 V. لذلك فإن مقسمًا عند نصف خط 3.3 V يقرأ نحو 2048 عند 11 dB. هذا الخط المستقيم صحيح لهذه الشريحة، بخلاف ESP32 الكلاسيكي وS3 وC3، التي تشبع قبل بلوغ الخط عند أوسع توهين لها: ورقة بيانات C6 وقياسات Espressif نفسها تعطيها مدى عمليًا من 0 إلى 3300 mV عند 12 dB. القناة التي لا شيء على طرفها تهوم، كما يفعل مدخل عائم (docs/uno.md القسم 1).
ADC2 وجدول أنماط DMA والمتحكم الرقمي والمرشحات ومراقبات العتبة وeFuses الخاصة بالمعايرة وقناة الحرارة الداخلية كلها غائبة، وADC1_DONE لا تصل أبدًا إلى mip.
3.7 LEDC (0x6000_7000)
متحكم PWM للـ LED، المجموعة البطيئة، وهي المجموعة الوحيدة في هذه الشريحة: أربعة مؤقتات وست قنوات. هذه هي الكتلة التي تقف خلف analogWrite وledcAttach وledcWrite. تقع كتلتا القناة والمؤقت حيث تقعان في C3، لكن LEDC في C6 ليست C3 سجلًا سجلًا: حقل دقة المؤقت خمسة بتات ويصل إلى عشرين، وHPOINT وDUTY أعرض، والسجلات العامة انتقلت.
يعدّ المؤقت 2^DUTY_RES عدًّا عند 80 MHz مقسومة على CLK_DIV، وهو عدد Q10.8 من نبضات 80 MHz لكل عدّة، إذن f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES)، و5 kHz عند ثمانية بتات تكون بـ DUTY_RES 8 مع CLK_DIV 16000، بدقة تامة. تختار القناة مؤقتًا وعدّة بداية HPOINT ودورة تشغيل، ومخرجها مرتفع بدءًا من HPOINT لمقدار DUTY >> 4 عدّة، ملتفًّا حول قمة الدورة. دورة 0 هي مستوى منخفض ثابت ودورة 2^DUTY_RES مستوى مرتفع ثابت، بلا أي حافة على الإطلاق.
Verified: the base address (table 5.3-2) and every offset and bit in the table below, against the ESP32-C6 Technical Reference Manual v1.2, section 35.4 (register summary) and registers 35.1, 35.2, 35.8 to 35.14 and 35.23. An earlier version of this model used the C3's LEDC_CONF_REG at 0xD0 and LEDC_DATE_REG at 0xFC, the C3's fourteen-bit HPOINT, nineteen-bit DUTY and fourteen-bit resolution limit, and wrote LEDC_SCLK_SEL = 1, which on the C6 selects RC_FAST_CLK rather than the 80 MHz PLL clock. The C6's event-task, compare, capture and gamma-RAM registers (0x100 to 0x1CC) are not modeled.
| الإزاحة | الاسم | البتات |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
البتان 0..1 هما TIMER_SEL، والبت 2 هو SIG_OUT_EN، والبت 3 هو IDLE_LV، والبت 4 هو PARA_UP (مخزَّن؛ وقيمة duty مكتوبة هنا تسري فورًا) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
البتات 0..19 HPOINT: العدّة التي يبدأ عندها نبض القناة |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
البتات 0..24 هي DUTY: عرض النبضة بالأجزاء من ستة عشر جزءًا من العدّ |
0x0C + 0x14n |
LEDC_CHn_CONF1_REG |
البت 31 DUTY_START، مطلق تلاشي دورة التشغيل: مخزَّن ويُقرأ مرة أخرى، ولا يلاشي شيئًا |
0x10 + 0x14n |
LEDC_CHn_DUTY_R_REG |
قيمة duty كما هي، للقراءة فقط |
0xA0 + 8n |
LEDC_TIMERn_CONF_REG |
البتات 0..4 DUTY_RES (من 1 إلى 20؛ القيمة 0 مؤقت لم يضبطه أحد ولا يعدّ شيئًا)، البتات 5..22 CLK_DIV، البت 23 PAUSE، البت 24 RST، البت 26 PARA_UP (مخزَّن)؛ البت 25 محجوز |
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 للمسح |
0x1F0 |
LEDC_CONF_REG |
البِتّان 0..1 SCLK_SEL (0 = الساعة PLL_F80M_CLK بسعة 80 ميغاهرتز وهي المصدر الوحيد المحاكى؛ 1 RC_FAST_CLK، 2 XTAL_CLK؛ مخزَّنة)، البِتّات 2..7 بوابات ساعة ذاكرة غاما (مخزَّنة)، البِت 31 CLK_EN (مخزَّن) |
0x1FC |
LEDC_DATE_REG |
ختم نسخة، للقراءة فقط: 0x0211_1150 |
تصل القناة إلى الطرف عبر مصفوفة GPIO: اضبط GPIO_ENABLE البِت الخاص بالطرف ووجِّه GPIO_FUNCn_OUT_SEL_CFG_REG في 45 + channel. مؤشرات الإشارات تلك، من 45 إلى 50 لكل من ledc_ls_sig_out0 إلى ledc_ls_sig_out5، هي أيضًا غير موثَّقة. Section 3.1's OUT_SEL of 128 still means the pad follows GPIO_OUT، وأي قيمة ليست 128 ولا قناة LEDC تُعامَل كأنها 128 بدلًا من اختراع قيمة.
العداد لا يُزاد خطوة بخطوة: فهو دالة صيغة مغلقة في الزمن المحاكى، وكذلك زمان حافته التالية، لذا فإن نواة متوقفة في wfi لا تكلّف شيئًا أثناء عمل PWM، ولا تُوقظ اللوحة إلا عند الحواف ولا شيء غيرها.
غير محاكى: المجموعة عالية السرعة (لا توجد في هذه الشريحة)، عتاد duty-fade وغاما، مصادر الساعة غير ساعة PLL بسعة 80 ميغاهرتز، وخط مقاطعة LEDC نحو مصفوفة المقاطعات: يمكن استطلاع LEDC_INT_RAW_REG ومسحه لكنه لا يصل أبدًا إلى mip.
3.8 صندوق بريد شبكة Mokxi (0x6FFF_E000)
هذه الكتلة ليست من ESP32-C6. كل عنوان آخر في هذا المستند هو عنوان الشريحة، موثوقًا به أو مقتبسًا كما يرتّبه القسم 7، وأي صورة بُنيت عليه فهي صورة لـ DevKitC-1. أما هذه فهي من صنع Mokxi نفسه: شبكة crates/net المحاكاة، موضوعة عند عنوان يتركه الجزء الحقيقي غير مُعيَّن (الملحقات في C6 تقع في أسفل نافذة 0x6000_xxxx وفي 0x6009_xxxx، ولا شيء يستجيب في أعلاها)، بحيث تُنتج الصورة التي تستخدمه خطأً على السيليكون بدلًا من قراءة سجل ملحق آخر. ذلك الخطأ هو الجواب الصادق، لأن ما يقف خلف هذه الكتلة غير موجود على الشريحة. وهو العنوان نفسه الذي يستخدمه ESP32-C3، لأن كلي الجزأين يترك المكان نفسه فارغًا.
لا يوجد هنا لا راديو، ولا 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 كلاب حراسة مجموعات المؤقت، وإعادة الضبط ومراقب المكدس (0x6000_8000، 0x6000_9000، 0x600B_0400، 0x600B_1000، 0x600C_2000)
As the C3's (docs/esp32c3.md section 3.9), with the C6's addresses: the timer groups at 0x6000_8000 and 0x6000_9000, always on the 40 MHz crystal (their clock select is in PCR, of which only UART0's clock register is modeled), the reset cause in LP_CLKRST_RESET_CAUSE_REG, the store registers LP_AON_STORE0..9, LP_AON_HPSYS_SW_RESET and LP_AON_CPU_CORE0_SW_RESET for the software resets, and ASSIST_DEBUG at 0x600C_2000.
يشغّل بيئة التشغيل كلّاب مهام 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 فيُحاكى بالطريقة نفسها ولا شيء في بيئة التشغيل يفعّله: كلّاب المقاطعات غير محاكى.
4. قناة المضيف
يضع host_write البايتات في FIFO استقبال UART0؛ ويأخذ host_read البايتات التي خرجت من FIFO إرساله. ذلك هو Serial في الكود والشاشة التسلسلية في الواجهة. البايتات هي UTF-8 بقدر ما يخص الواجهة، وغير شفافة بالنسبة للنموذج.
تحتوي لوحة DevKitC-1 على مقبسي USB-C: واحد يصل بجسر USB-to-UART، وهو هذه القناة، وواحد يصل بمنفذ USB الشريحة نفسه، وهو غير محاكى إطلاقًا.
5. نموذج الزمن
كما في docs/esp32c3.md قسم 5. تعمل نواة HP عند 160 ميغاهرتز، تعليمة واحدة في كل دورة، فالتعليمة الواحدة تساوي 6250 ps بالضبط، وشريحة 10 us تساوي 1600 تعليمة بالضبط. داخل الشريحة يكون عدد التعليمات هو الساعة: قراءة SYSTIMER وبايت UART وتغيّر طرف كلها تهبط عند التعليمة التي سبّبتها.
probe تساوي 1 أثناء عمل البرنامج الثابت، و0.5 عند التوقف في wfi، و0 عند الإيقاف (لا برنامج، أو ممسوك في إعادة ضبط، أو متعطل).
poke: 1 يمسك BOOT (GPIO 9 منخفضًا)، 0 يطلقه؛ 2 يمسك RST، 3 يطلقه.
6. زمن تشغيل البرنامج الثابت (firmware/c6/)
بيئة تشغيل على طراز Arduino مشتقة من بيئة C3: setup() وloop()، وpinMode، وdigitalWrite، وdigitalRead، وanalogRead (مع analogReadResolution وanalogSetAttenuation وanalogSetPinAttenuation)، وanalogWrite وزوج ledcAttach/ledcWrite، وmillis، وmicros، وdelay، وdelayMicroseconds، وattachInterrupt، وSerial. لا يوجد Arduino core، ولا ESP-IDF، ولا libc.
analogRead هو ADC1 بوضع اللقطة الواحدة على GPIO 0 إلى GPIO 6 (القسم 3.6)، اثنا عشر بِتًا عند 11 dB افتراضيًا، لذا فإن firmware/lib/mokxi_joystick.h يُترجم ويعمل هنا كما يعمل على C3. وanalogWrite(pin, 0..255) هو ثمانية بِتّات عند 1 كيلوهرتز على أي GPIO، ويربط قناة LEDC حرة عند أول استدعاء؛ أما ledcAttach(pin, frequency, bits) فهو ما يريده الكود عندما يكون التردد مهمًّا، والقنوات التي تطلب التردد والدقة نفسيهما تتشارك واحدًا من المؤقتات الأربعة.
مبني بـ clang --target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32، ومرتبط بـ firmware/c6/link.ld. ثلاثة من ملفات بيئة التشغيل هي ملفات C3، جرت ترجمتها من جديد لهذه اللوحة بدلًا من نسخها: تنسيق الأرقام، ومساعدات الرياضيات، ودالة floor المستقلة، بالإضافة إلى Print وmain. أما ملفات هذه اللوحة الخاصة فهي: ترويسة السجلات، وعدد الأطراف، وكود الإقلاع، ونص الرابط، ومشغّلات GPIO وADC وPWM والوقت وUART والمقاطعات.
سلسلة program في الفهرس هي elf32 riscv32imc esp32c6. وتختلف عن سلسلة C3 لأن ملف ELF يختلف فعلًا: طقم التعليمات نفسه، وخريطة ذاكرة مختلفة، وصورة مربوطة لأحدهما لن تعمل على الآخر.
LED_BUILTIN هو 8، وهو على هذه اللوحة LED RGB القابل للعنونة. وقياده مرتفعًا ومنخفضًا ما زال يفعل الشيء المفيد على لوحة التجارب؛ ومثال rainbow هو الغرض الحقيقي من هذا الطرف.
ستة أمثلة: blink، وbutton (زر BOOT على GPIO 9)، وserial، وfade (LED على GPIO 10 يتنفس عبر PWM عتادي)، وstick (حساس KY-023 على قناتي ADC1 رقم 0 و1، مع إخراج سطوع اثنين من LED عبر LEDC)، وrainbow (عجلة ألوان تُرسل برمجيًا إلى LED RGB وسبعة LED أخرى على GPIO 8). ميزانية كل مثال 16 KB.
7. ما تثق به هذه المواصفة، وما لا تثق به
ثلاث مجموعات. هذا القسم موجود لأن نموذج لوحة يخمّن عنوانًا بصمت أسوأ من نموذج يقول إنه لم يعرف.
Taken from the technical reference manual. Every base address in section 2 (the ESP32-C6 Technical Reference Manual v1.2, table 5.3-2): UART0_BASE = 0x6000_0000, LEDC_BASE = 0x6000_7000, SYSTIMER_BASE = 0x6000_A000, APB_SARADC_BASE = 0x6000_E000, IOMUX_BASE = 0x6009_0000 and GPIO_BASE = 0x6009_1000. Every register offset inside the UART, GPIO and IO_MUX blocks. The UART's FIFO-reset bits and CONF1 thresholds (registers 27.9 and 27.10), the SYSTIMER comparator (chapter 13) and every LEDC register in section 3.7 (chapter 35), all checked against that manual while the ESP32-S3 was being added; the C6 differs from the C3 in each of them, and each was wrong here before that check and has been corrected, with the runtime's images rebuilt. The GPIO range, 0 to 30. The HP SRAM's 512 KB at 0x4080_0000, and the fact that it is one window rather than two. The RGB LED on GPIO 8 and the BOOT button on GPIO 9. ADC1's channel map: channel n is GPIO n for n in 0 to 6.
Believed, not verified. The register offsets inside APB_SARADC, which are the C3's (section 3.6), and the GPIO matrix signal indices 45 to 50 for ledc_ls_sig_out0 to ledc_ls_sig_out5. Both are named in one place, firmware/c6/include/esp32c6.h, so an image being taken to real silicon has a short list of #defines to check. Firmware built here agrees with the model whether or not it agrees with silicon.
غائبة عن قصد. تُرِك كل واحدة من هذه بدلًا من اختلاقها، لأن تخطيط سجلاتها ليس شيئًا يمكن لهذا النموذج إعادة إنتاجه بأمانة:
- مؤقتات مجموعات المؤقتات (TIMG0 و TIMG1). أما كلب الحراسة فيها فهو من القسم 3.9. يأتي الزمن هنا من SYSTIMER، وهو كافٍ لـ
millisوmicrosوdelayمعلَّقة. - RMT، وهو ما يقود عادةً LED RGB. يستخدم مثال
rainbowمحاكاة البرمجة النقطية يدويًا بدلًا من ذلك، وهذا ليس اختصارًا: إنه الأسلوب الوحيد الممكن هنا. - النواة منخفضة الطاقة LP core وملحقاتها، بما في ذلك LP_UART و LP_I2C. نطاق الطاقة المنخفضة في C6 هو نصف ما يجعل الشريحة مثيرة للاهتمام، ولا شيء منه موجود هنا.
- مصفوفة المقاطعات، التوجيه الشبيه بـ PLIC الذي يقرر أي ملحق يصل إلى أي
mcause. القسم 3.5 يوضح ما يحل محلها. - ADC2، وDMA ووحدة التحكم الرقمية الخاصين بمحوّل SAR ADC، ومرشحاته ومراقبات العتبة و eFuses الخاصة بالمعايرة. القسم 3.6 هو ADC1 بوضع الطلقة الواحدة ولا شيء غير ذلك.
- عتاد تلاشي دورة العمل في LEDC وخط المقاطعة الخاص به: القسم 3.7 هو المؤقتات والقنوات والمخرج، و
LEDC_INT_RAW_REGيُقرأ بالاستطلاع بدلًا من إرسال مقاطعة. - وحدة PMU وشجرة الساعات، والذاكرة المخبئية، و ROM، وذاكرة flash، و SPI، و I2C، و I2S، و USB Serial/JTAG، و WiFi 6، و Bluetooth LE و 802.15.4.
لهذا السبب لا تعمل هنا ملفات ESP-IDF الرسمية وملفات نواة Arduino الثنائية، بينما يعمل البرنامج الثابت المبني لهذا المستند.