Tham khảo

Hợp đồng bo mạch ESP32-C6 (Giai đoạn 9)

DevKitC-1: ba mươi mốt GPIO, một cửa sổ SRAM, và một bản trình bày thẳng thắn về những gì không được mô phỏng.

Đây là tài liệu tham khảo kỹ thuật cho mô hình: nó mô tả những gì được triển khai, thanh ghi này đến thanh ghi khác, dành cho những người viết firmware chạy trên đó. Để dùng bo mạch trong trình soạn thảo, hãy bắt đầu với ESP32-C6-DevKitC-1 và trang bo mạch.

ESP32-C6-DevKitC-1 là bo mạch RISC-V thứ hai ở đây. Một thành phần của kernel (esp32c6 trong crates/parts) bọc một mô hình SoC ESP32-C6 (crates/esp32c6) trên cùng một hart với C3 (crates/rv32-core). Lõi thì dùng chung; vi mạch quanh nó thì không. Tài liệu này là bản hợp đồng, và nó thắng mọi ghi chú trong code.

Kiểu trong danh mục là esp32c6. Ở đâu một mục viết "như docs/esp32c3.md", tài liệu đó là bản hợp đồng cho phần đó.

Đọc mục 7 trước nếu bạn định đưa một bản build từ đây lên silicon thật. Mô hình này nhỏ hơn C6, và nhiều phần hơn bình thường được đánh dấu "được tin là đúng, chưa kiểm chứng": mục 7 cho biết những địa chỉ đó là gì và những gì vắng mặt hẳn. Không có gì ở đây được đoán bừa một cách âm thầm. Mục 3.6, các offset thanh ghi của SAR ADC, là khối duy nhất có bố cục nằm trong danh sách đó.

1. Chân bo mạch (thứ tự trong danh mục)

Nhìn từ trên, hai ổ cắm USB-C ở dưới, mô-đun ESP32-C6-WROOM-1 với ăng-ten PCB của nó ở trên. Bo mạch có kích thước 52,5 x 25,4 mm và hai hàng header 15 chân cách nhau 22,86 mm (đúng 0,9 inch), nên nó bắt vắt qua rãnh giữa của breadboard.

Thứ tự lấy theo hướng dẫn sử dụng ESP32-C6-DevKitC-1 của Espressif, mục "Header Block", J1 và J3 (bo mạch v1.2). Mỗi header có một lỗ thứ mười sáu, NC, không được liệt kê.

Header trái (J1), từ trên xuống dưới (15 lỗ): 3V3, RST, 4, 5, 6, 7, 0, 1, 8, 10, 11, 2, 3, 5V, GND.

Header phải (J3), từ trên xuống dưới (15 lỗ): GNDb, TX, RX, 15, 23, 22, 21, 20, 19, 18, 9, GNDd, 13, 12, GNDc.

Rồi 14, chân không nằm trên header nào của bo mạch thật (xem dưới).

31 chân. TX và RX là GPIO 16 và 17: silkscreen đặt tên theo chức năng vì chúng là UART console. Các tên trùng nhau mang một chữ cái vì tên chân trong danh mục phải duy nhất.

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.

Vi mạch có GPIO 0 đến 30. GPIO 24 trở lên là flash SPI trên package này và không nằm trên header nào.

Hai chân trên bo mạch không nằm trên header nào cả:

  • GPIO 8 có một LED RGB địa chỉ hóa được hàn sẵn vào nó. Một poke không với tới được và linh kiện bo mạch không giải mã nó: WS2812 là một giao thức, không phải một mức tín hiệu. Nối linh kiện ws2812 vào GPIO 8 và nó sẽ sáng với các màu mà sketch đang gửi, đúng như ví dụ rainbow làm.
  • GPIO 9 là nút BOOT, tác động ở mức thấp. Nó cũng có trên header phải nên có thể nối dây vào; poke nối nó xuống đất trên bo mạch.

Điện: như docs/esp32c3.md mục 1. Mọi GPIO đẩy kéo ở 3,3 V qua R_STRONG, ở mức high-Z, hoặc kéo lên hoặc kéo xuống qua 45 k. Ngõ vào đọc cao ở 1,65 V; một đường nối xung đột (Unknown) đọc là 0, và một đường nối lơ lửng đọc là nhiễu, như trên Uno (docs/uno.md mục 1). GPIO9 đọc cao khi không có gì giữ nó, nhờ điện trở kéo lên trên bo mạch cạnh nút BOOT. 3V3 xuất 3,3 V qua R_SUPPLY, 5V xuất 5 V, ba chân đất xuất 0 V. RST có điện trở kéo lên 10 k lên 3,3 V, và kéo nó xuống dưới 1,65 V sẽ giữ lõi ở trạng thái reset.

Thứ tự silkscreen chính xác của hai header là cách mô hình này đọc chân ra của DevKitC-1. Số GPIO là của vi mạch và là thứ firmware dựa vào; vị trí của chúng trên header là thứ sơ đồ dựa vào. Nếu hàng chân trên bo mạch thật sắp khác, mạch vẽ ở đây sẽ cần nối dây lại trên bàn thực hành, và không có gì khác thay đổi.

2. Bản đồ bộ nhớ

HP SRAM 512 KB tại 0x4080_0000 đến 0x4087_FFFF
Flash (code and constants) 0x4200_0000, read-only, up to 1,310,720 bytes
đỉnh stack 0x4088_0000
UART0 0x6000_0000, mục 3.3
LEDC 0x6000_7000, mục 3.7
SYSTIMER 0x6000_A000, mục 3.4
APB_SARADC 0x6000_E000, mục 3.6 (các offset bên trong được tin là đúng)
IO_MUX 0x6009_0000, mục 3.2
GPIO 0x6009_1000, mục 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.

Một cửa sổ. Đây là điểm khác đầu tiên so với C3, nơi cùng 400 KB RAM đó xuất hiện hai lần (tại 0x4037_C000 cho bus lệnh và 0x3FC7_C000 cho bus dữ liệu), và mỗi lần truy cập phải thử cả hai. Ở đây cả hai bus đều tới được HP SRAM tại cùng địa chỉ, nên địa chỉ nạp là địa chỉ chạy, .data không cần sao chép khi reset, và bus là một lần kiểm tra khoảng thay vì hai.

Mọi đoạn PT_LOAD phải nằm gọn trong khoảng đó; ngoài ra sẽ bị từ chối kèm địa chỉ vi phạm trong thông báo, và vi mạch bị để không có chương trình.

3. Thanh ghi ngoại vi

Chỉ phần con dưới đây được triển khai. Bất cứ thứ gì khác nằm trong một khối 4 KB đã ánh xạ sẽ đọc được giá trị 0 và được tính là truy nhập lạc; bất cứ thứ gì nằm ngoài mọi khối sẽ gây lỗi truy nhập.

3.1 GPIO (0x6009_1000)

offset thanh ghi
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

Các bit 0 đến 30 tồn tại; bit 31 bị che đi khi ghi. Bit 2 PAD_DRIVER của GPIO_PINn_REG đưa pad về open drain, và các bit 7..9 INT_TYPE chọn điều gì tạo ngắt cho chân: 0 tắt, 1 sườn lên, 2 sườn xuống, 3 cả hai sườn, 4 mức thấp, 5 mức cao. GPIO_FUNCn_OUT_SEL_CFG_REG tại 128 khiến pad theo GPIO_OUT; 45 đến 50 giao nó cho các kênh tốc độ thấp 0 đến 5 của LEDC (mục 3.7, và sáu chỉ số đó chưa được kiểm chứng); giá trị nào khác chọn một ngoại vi không được mô hình hóa, và mô hình đối xử với nó như 128 thay vì bịa ra một mức. Một pad được kênh LEDC điều khiển vẫn cần trình điều khiển ngõ ra bật trong GPIO_ENABLE_REG.

3.2 IO_MUX (0x6009_0000)

IO_MUX_GPIOn_REG tại 0x04 + 4n. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, các bit 12..14 MCU_SEL trong đó 1 là GPIO thường. Một pad chỉ tới được GPIO_IN_REG khi bộ đệm ngõ vào của nó được bật, đúng như phần cứng làm. Mọi chân khởi động với FUN_IE | (1 << 12), nên một chương trình chỉ ghi GPIO_ENABLE và GPIO_OUT sẽ hoạt động giống nhau trên mọi chân.

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.

Nhưng các bit thì không phải của C3. Đã đối chiếu với cùng tài liệu đó:

  • UART_CONF0_REG (UART_CONF0_SYNC_REG trong tài liệu, thanh ghi 27.9): bit 22 RXFIFO_RST và bit 23 TXFIFO_RST xóa các FIFO. Một phiên bản trước của mô hình này dùng bit 17 và 18 của C3, vốn trên C6 là các trường khác. Trên chip thật, ghi vào thanh ghi _SYNC chỉ có hiệu lực khi UART_REG_UPDATE (0x98) được đặt; mô hình áp dụng ngay lập tức.
  • UART_CONF1_REG (thanh ghi 27.10): bit 0..7 RXFIFO_FULL_THRHD và bit 8..15 TXFIFO_EMPTY_THRHD, cả hai reset về 96. Một phiên bản trước của mô hình này có trường chín bit ở vị trí 0 và 9.
  • UART_STATUS_REG (thanh ghi 27.21): bit 0..7 RXFIFO_CNT và bit 16..23 TXFIFO_CNT. Bộ thực thi đọc chúng bằng mặt nạ tám bit, đúng như tài liệu đưa ra. Trước đây nó đọc mười bit, vẫn trả về cùng số vì hai bit phía trên mỗi trường là dự phòng và đọc ra 0; header giờ khớp với tài liệu.

Số chia (UART_CLKDIV_REG bit 0..11, phần mười sáu ở CLKDIV_FRAG, bit 20..23) chia xung nhịp lõi của UART, mà trên C6 được chọn trong PCR chứ không phải trong UART: PCR_UART0_SCLK_CONF_REG (0x6009_6004, thanh ghi PCR duy nhất được mô hình hóa) bit 20..21 UART0_SCLK_SEL (1 là PLL_F80M_CLK 80 MHz, 3 là thạch anh 40 MHz; giá trị 2, RC_FAST, được coi như thạch anh) và bit 12..19 UART0_SCLK_DIV_NUM, một bộ chia trước bằng DIV_NUM + 1. Ra khỏi reset đó là thạch anh, không chia, và UART_CLKDIV reset về 347, tương ứng 115 274 baud. Bộ thực thi lập trình một tốc độ theo cách của uart_ll_set_baudrate trong ESP-IDF (PLL_F80M, bộ chia trước nhỏ nhất đưa số chia xuống dưới 4096, rồi UART_REG_UPDATE), nên 1200 và 9600 baud chính xác thay vì bị kẹp ở số chia 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.

Bộ đếm là số nhịp 52 bit 16 MHz suy ra từ thời gian mô phỏng thay vì đếm từng nhịp, nên không bao giờ lệch với phần còn lại của mạch. Đọc nó theo kiểu chốt rồi đọc: đặt UPDATE, chờ VALUE_VALID, đọc HI rồi LO. Cả chế độ một lần và chế độ chu kỳ đều hoạt động.

3.5 Ngắt

Như phần 3.5 trong docs/esp32c3.md. Ma trận ngắt của C6 không được mô hình hóa: GPIO và UART0 dùng chung ngắt ngoài mức máy, mcause 11, và trình xử lý đọc hai thanh ghi trạng thái để biết nguồn nào gây ngắt; bộ so sánh SYSTIMER là ngắt bộ hẹn giờ mức máy, mcause 7. mstatus.MIE, mie.MTIE và mie.MEIE hoạt động đúng; mtvec chạy ở chế độ trực tiếp.

3.6 APB_SARADC (0x6000_E000)

ADC1 ở chế độ một lần, thanh ghi nào ra thanh ghi đó như phần 3.5 trong docs/esp32c3.md mô tả: đúng đường mà driver adc_oneshot của ESP-IDF và analogRead của nhân Arduino đi, và không gì khác. Khác biệt ở đây là sơ đồ chân (bảy kênh, 0 đến 6, trên vỏ này là GPIO 0 đến GPIO 6) và địa chỉ gốc của khối.

Địa chỉ gốc là của tài liệu (bảng 5.3-2); một phiên bản trước của mô hình này có 0x6000_F000, vốn là bộ điều khiển USB Serial/JTAG. Mọi offset thanh ghi trong mục này đều chưa được kiểm chứng: chúng là của C3, là bố cục chung của họ chip, chứ không phải trích từ một trang nào của tài liệu kỹ thuật C6. Một chương trình cần chạy trên DevKitC-1 thật nên kiểm tra chúng trước.

offset tên bit
0x00 APB_SARADC_CTRL_REG bit 7..14 SAR_CLK_DIV. Được lưu và đọc lại; thời gian chuyển đổi ở đây là cố định
0x04 APB_SARADC_CTRL2_REG được lưu, đọc lại. Các đường kích hoạt bằng timer và DMA không được mô phỏng
0x0C APB_SARADC_FSM_WAIT_REG được lưu, đọc lại được
0x38 APB_SARADC_ONETIME_SAMPLE_REG bit 23..24 ONETIME_ATTEN, bit 25..28 ONETIME_CHANNEL, bit 29 ONETIME_START, bit 30 SAR2_ONETIME_SAMPLE (được lưu, không chuyển đổi gì), bit 31 SAR1_ONETIME_SAMPLE
0x44 APB_SARADC_1_DATA_STATUS_REG bit 0..16 ADC1_DATA: lần chuyển đổi ADC1 gần nhất, rộng mười hai bit
0x64 APB_SARADC_INT_ENA_REG đã lưu; không có đường nối nào tới được lõi
0x68 APB_SARADC_INT_RAW_REG bit 31 ADC1_DONE
0x6C APB_SARADC_INT_ST_REG thô và được bật
0x70 APB_SARADC_INT_CLR_REG ghi 1 để xóa, cùng bit
0x78 APB_SARADC_APB_ADC_CLKM_CONF_REG được lưu, đọc lại được

Một lần chuyển đổi: ghi ONETIME_SAMPLE với SAR1_ONETIME_SAMPLE, kênh và mức suy giảm, ghi lại lần nữa với ONETIME_START lên, chờ ADC1_DONE trong INT_RAW, đọc thanh ghi dữ liệu, xóa cờ và hạ ONETIME_START. Một lần chuyển đổi mất 5 us thời gian mô phỏng cố định, mà firmware thực sự chờ đợi.

Kết quả là mười hai bit, round(4095 x Vin / Vfull), bị kẹp, của điện áp trên đường nối tại thời điểm bắt đầu chuyển đổi, và ONETIME_ATTEN chọn thang đầy theo số liệu danh nghĩa của datasheet: 0 dB là 1.1 V, 2.5 dB là 1.5 V, 6 dB là 2.2 V và 11 dB là 3.3 V. Vậy một mạch chia ở một nửa nguồn 3.3 V sẽ đọc vào khoảng 2048 ở 11 dB. Đường thẳng đó đúng cho chip này, khác với ESP32 cổ điển, S3 và C3 vốn bão hòa trước khi chạm nguồn ở mức suy giảm rộng nhất: datasheet của C6 và chính các phép đo của Espressif cho nó khoảng khả dụng 0 đến 3300 mV ở 12 dB. Một kênh không nối gì trên chân sẽ dao động, như một ngỏ vào lơ lửng vẫn vậy (docs/uno.md phần 1).

ADC2, bảng mẫu DMA, bộ điều khiển số, các bộ lọc và trình theo dõi ngưỡng, các eFuse hiệu chuẩn và kênh nhiệt độ nội bộ đều vắng mặt, và ADC1_DONE không bao giờ đến được mip.

3.7 LEDC (0x6000_7000)

Bộ điều khiển LED PWM, nhóm tốc độ thấp, là nhóm duy nhất chip này có: bốn bộ hẹn giờ và sáu kênh. Đây là khối đứng sau analogWrite, ledcAttach và ledcWrite. Các khối kênh và bộ hẹn giờ nằm đúng chỗ của C3, nhưng LEDC của C6 không phải là bản sao thanh ghi của C3: trường độ phân giải của bộ hẹn giờ là năm bit và lên đến hai mươi, HPOINT và DUTY rộng hơn, và các thanh ghi toàn cục đã dời chỗ.

Một bộ đếm thời gian đếm 2^DUTY_RES xung nhịp ở 80 MHz chia cho CLK_DIV, một số Q10.8 là số xung nhịp 80 MHz trên mỗi bước đếm, vậy nên f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES) và 5 kHz ở tám bit là DUTY_RES 8 với CLK_DIV 16000, chính xác. Một kênh chọn một bộ đếm thời gian, một giá trị bắt đầu HPOINT và một độ rộng xung (duty), và ngõ ra của nó ở mức cao từ HPOINT trong DUTY >> 4 bước đếm, quay vòng ở đỉnh của chu kỳ. Duty bằng 0 là mức thấp liên tục và duty bằng 2^DUTY_RES là mức cao liên tục, hoàn toàn không có cạnh xung.

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.

offset tên bit
0x00 + 0x14n LEDC_CHn_CONF0_REG các bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (được lưu; giá trị duty cycle ghi vào đây có hiệu lực ngay)
0x04 + 0x14n LEDC_CHn_HPOINT_REG các bit 0..19 HPOINT: giá trị đếm mà xung của kênh bắt đầu
0x08 + 0x14n LEDC_CHn_DUTY_REG các bit 0..24 DUTY: độ rộng xung tính theo một phần mười sáu của một bước đếm
0x0C + 0x14n LEDC_CHn_CONF1_REG bit 31 DUTY_START, điểm kích hoạt duty-fade: được lưu, đọc lại được, và không thực hiện việc mờ dần xung nào cả
0x10 + 0x14n LEDC_CHn_DUTY_R_REG hệ số chu kỳ hiện hành, chỉ đọc
0xA0 + 8n LEDC_TIMERn_CONF_REG các bit 0..4 DUTY_RES (1 đến 20; 0 là một bộ đếm thời gian chưa ai cấu hình và nó không đếm gì), các bit 5..22 CLK_DIV, bit 23 PAUSE, bit 24 RST, bit 26 PARA_UP (được lưu); bit 25 được bảo lưu
0xA4 + 8n LEDC_TIMERn_VALUE_REG bộ đếm, chỉ đọc
0xC0 LEDC_INT_RAW_REG bit n = timer n bị tràn
0xC4 LEDC_INT_ST_REG thô và được bật
0xC8 LEDC_INT_ENA_REG đã lưu; không có đường nối nào tới được lõi
0xCC LEDC_INT_CLR_REG ghi 1 để xóa
0x1F0 LEDC_CONF_REG các bit 0..1 SCLK_SEL (0 = PLL_F80M_CLK 80 MHz, nguồn duy nhất được mô phỏng; 1 là RC_FAST_CLK, 2 là XTAL_CLK; được lưu), các bit 2..7 là cổng xung nhịp gamma-RAM (được lưu), bit 31 CLK_EN (được lưu)
0x1FC LEDC_DATE_REG một con dấu phiên bản, chỉ đọc: 0x0211_1150

Một kênh đi đến một chân thông qua ma trận GPIO: đặt bit của chân GPIO_ENABLE và trỏ GPIO_FUNCn_OUT_SEL_CFG_REG tại 45 + channel. Những chỉ số tín hiệu đó, 45 đến 50 cho ledc_ls_sig_out0 đến ledc_ls_sig_out5, cũng chưa được kiểm chứng. Section 3.1's OUT_SEL of 128 still means the pad follows GPIO_OUT, và bất kỳ giá trị nào không phải 128 cũng không phải một kênh LEDC thì được coi là 128 thay vì bị bịa ra.

Bộ đếm không được tăng dần từng bước: nó là một hàm dạng đóng của thời gian mô phỏng, và thời gian cạnh xung kế tiếp của nó cũng vậy, nên một nhân đang dừng ở wfi không tốn gì trong khi PWM vẫn chạy, và bo mạch chỉ được đánh thức cho các cạnh xung và không cho gì khác.

Không được mô phỏng: nhóm tốc độ cao (chip này không có), phần cứng duty-fade và gamma, các nguồn xung nhịp khác ngoài xung PLL 80 MHz, và đường ngắt LEDC vào ma trận ngắt: LEDC_INT_RAW_REG có thể được thăm dò và xóa nhưng không bao giờ tới được mip.

3.8 Hộp thư mạng của Mokxi (0x6FFF_E000)

Khối này không phải của ESP32-C6. Mọi địa chỉ khác trong tài liệu này là của chip, được tin tưởng hoặc trích dẫn như mục 7 sắp xếp, và một image dựng theo đó là một image cho DevKitC-1. Còn khối này là của riêng Mokxi: mạng mô phỏng của crates/net, ánh xạ tại một địa chỉ mà linh kiện thật để trống (các ngoại vi của C6 nằm ở phần dưới của vùng 0x6000_xxxx và trong 0x6009_xxxx, và không gì trả lời ở phần trên của nó), sao cho một image dùng nó sẽ lỗi trên silicon thay vì đọc thanh ghi của một ngoại vi khác. Lỗi đó là câu trả lời trung thực, vì thứ đứng sau khối này không tồn tại trên chip. Đây là cùng địa chỉ mà ESP32-C3 dùng, vì cả hai linh kiện đều để trống cùng một chỗ.

Ở đây không có sóng vô tuyến, không có 802.11 và không có internet thật. Không có gì trong mô hình truyền tín hiệu, quét, kết nối với mạng, mã hóa hay mở socket: mật khẩu được so sánh như một chuỗi, một tên không nằm dưới .mokxi sẽ không phân giải được, và ba origin mà mạng phục vụ là các hàm trong crates/net/src/http.rs. Hộp thư mang hình dạng của đường nối thật chứ không hư cấu về một MAC: trên ESP32 thật, phần cứng WiFi là một blob nhị phân đóng với một giao diện lệnh, và WiFi.h của Arduino nằm ở phía bên kia của một giao diện như vậy. docs/wifi.md là hợp đồng cho thứ nằm đằng sau; mục này chỉ nói về các thanh ghi.

Một thanh ghi lệnh, một thanh ghi trạng thái, một vòng đệm 4096 byte cho mỗi chiều và một bit ngắt. Ghi vào NET_CMD_REG sẽ chạy lệnh; một lệnh mất thời gian mô phỏng sẽ bật BUSY và xóa nó, kèm DONE trong NET_INT_RAW_REG, khi hoàn tất.

offset tên bit
0x00 NET_ID_REG đọc ra 0x494B4F4D, và không thanh ghi nào khác đọc ra giá trị đó. Một sketch muốn biết mình có đang chạy trên Mokxi hay không sẽ đọc giá trị này; trên silicon thì lần truy cập này sẽ gây fault
0x04 NET_CMD_REG ghi một mã lệnh (bảng dưới đây); khi ghi, mã lệnh sẽ được chạy
0x08 NET_ARG_REG một từ đối số, đọc lại được: cổng cho LISTEN, trạng thái cho REPLY
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bits 8..11 STATE
0x10 NET_RESULT_REG câu trả lời của lệnh cuối cùng
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG cùng hai bit đó
0x1C NET_INT_CLR_REG ghi 1 để xóa, cùng hai bit đó
0x20 NET_TX_LEN_REG số byte đã xếp vào vòng đệm gửi đi
0x24 NET_TX_DATA_REG ghi: đẩy một byte (bit 0..7) vào bộ đệm vòng đi ra
0x28 NET_RX_LEN_REG số byte đang chờ trong bộ đệm vòng vào
0x2C NET_RX_DATA_REG đọc: lấy một byte từ vòng đệm vào, giá trị 0 khi rỗng
0x30 NET_RING_LEN_REG dung lượng mỗi ring tính bằng byte, để firmware khỏi phải ghi cứng 4096
0x40 NET_BT_CMD_REG Bluetooth: ghi một mã lệnh Bluetooth (docs/bluetooth.md); lệnh ghi sẽ chạy nó
0x44 NET_BT_ARG_REG Bluetooth: một từ đối số, đọc lại được; một sự kiện để lại số của nó ở đây
0x48 NET_BT_RESULT_REG Bluetooth: câu trả lời của lệnh Bluetooth cuối
0x4C NET_BT_STATUS_REG bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE
0x50 NET_BT_TX_LEN_REG Bluetooth: các byte đã được xếp vào hàng đợi vòng gửi ra riêng của nó
0x54 NET_BT_TX_DATA_REG Bluetooth: ghi: đẩy một byte vào bộ đệm vòng đó
0x58 NET_BT_RX_LEN_REG Bluetooth: số byte đang chờ trong bộ đệm vòng vào riêng của nó
0x5C NET_BT_RX_DATA_REG Bluetooth: đọc: lấy một byte ra, giá trị 0 khi rỗng

Tám thanh ghi NET_BT_ là nửa Bluetooth của khối, với các vòng đệm riêng: chỉ Bluetooth LE, như trên chip thật, nên các lệnh Classic đặt BT_ERR. Cũng không có sóng radio nào phía sau chúng; docs/bluetooth.md là hợp đồng của chúng.

STATE là nơi trạm đang ở: 0 rảnh, 1 đang khởi động, 2 đang kết nối, 3 đã kết nối, 4 thất bại, 5 không có mạng đó. NET_CMD_STATUS chuyển cùng thông tin đó thành mã wl_status_t của Arduino mà một sketch đọc từ WiFi.status().

NET_CMD_REG tên tác dụng
0 NOP không có gì
1 RESET ngắt kết nối, bỏ cả hai ring, bỏ mọi request
2 CONNECT vòng đệm gửi đi giữ ssid\0password; báo BUSY trong một đến ba giây
3 DISCONNECT bỏ liên kết và địa chỉ
4 STATUS NET_RESULT_REG = mã wl_status_t
5 IP NET_RESULT_REG = địa chỉ được cấp, octet đầu ở byte thấp
6 RSSI NET_RESULT_REG = cường độ tín hiệu theo dBm, giãn dấu
7 SSID vòng vào nhận tên của điểm truy cập
8 MAC ring vào nhận sáu byte MAC của bo mạch
9 REQUEST ring đi ra giữ method\0url\0headers\0body; kích hoạt BUSY
10 POLL NET_RESULT_REG = 0 khi đang thực hiện, sau đó là trạng thái HTTP, hoặc một mã lỗi âm khi ERR lên mức cao; phần thân được ghi vào vòng đệm nhận
11 LISTEN lắng nghe trên cổng ghi trong NET_ARG_REG
12 ACCEPT NET_RESULT_REG = 1 và vòng đệm vào chứa method\0path\0query\0body, hoặc 0 khi không có gì đang chờ
13 REPLY trả lời request đã được chấp nhận với trạng thái ghi trong NET_ARG_REG; ring đi ra giữ content-type\0body
14 STOP ngừng lắng nghe
15 WL_GPIO_SET điều khiển các chân GPIO riêng của linh kiện không dây từ NET_ARG_REG. Không phải bo mạch này: bộ phát vô tuyến của linh kiện này không có chân như vậy, nên nó bật ERR và không điều khiển gì cả. Đây là đường đi của đèn LED trên bo mạch Pico W (docs/picow.md mục 3.8)
16 WL_GPIO_GET đọc lại chúng, và cũng có ERR ở đây
17 BLYNK một thao tác trên máy chủ Blynk được mô phỏng, thao tác nằm trong NET_ARG_REG cùng các trường của nó trong ring đi ra; được trả lời ngay trong NET_RESULT_REG, với ERR bật mà không qua mạng (docs/wifi.md, "Blynk")
19 ETH Ethernet có dây (firmware/include/ETH.h), thao tác trong NET_ARG_REG: 1 kích hoạt kết nối qua một dây cáp mô phỏng, không có SSID và không có mật khẩu, kết nối lại sau 1,5 s với cùng một lease; 2 đặt 1 vào NET_RESULT_REG khi kết nối (hoặc lần gần nhất) là kiểu có dây. Chỉ có một kết nối duy nhất: STATUS, IP và mọi yêu cầu đều đọc nó bất kể nó được thiết lập theo cách nào
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), thao tác trong NET_ARG_REG: 1 kích hoạt nó (ring đi ra chứa ssid\0password\0 và byte kênh; NET_RESULT_REG bằng 1, hoặc 0 với ERR nếu tên rỗng hoặc mật khẩu dài một đến bảy ký tự), 2 tắt nó, 3 cấu hình nó (địa chỉ, gateway và netmask, mỗi thứ bốn byte), 4 địa chỉ của nó (bằng 0 khi tắt), 5 các trạm đã tham gia, 6 các lượt tham gia, lượt rời đi và bit báo bật mà runtime biến thành sự kiện, 7 và 8 khởi động (tên, một byte rỗng, địa chỉ) và dừng máy chủ DNS của captive portal, 9 tên của nó vào ring vào, 10 địa chỉ của điện thoại, 11 phần Host của yêu cầu đang được phục vụ vào ring vào. Trạm duy nhất chính là điện thoại của bảng Web

Các mã POLL âm: -1 tên không phân giải được, -2 trạm chưa được kết hợp, -3 https:// và TLS không được mô phỏng, -4 phần thân dài hơn ring, -5 một URL mà mạng này không phân tích được, -6 đã có một yêu cầu đang thực thi. firmware/include/HTTPClient.h biến chúng thành các mã theo kiểu Arduino để sketch so sánh, và docs/wifi.md liệt kê ánh xạ đó.

Thời gian, tất cả thuộc về chính mô hình này và đều được nêu trong docs/wifi.md: một lượt kết hợp mất từ một đến ba giây, được quyết định từ SSID để một bài học mất đúng thời gian đó ở lần thứ hai; mật khẩu sai trở thành WL_CONNECT_FAILED sau năm giây; một yêu cầu đến một nguồn mô phỏng quay lại sau 60 ms; một yêu cầu vào chính máy chủ của sketch mà sketch không bao giờ trả lời sẽ bị mạng đóng với mã 504 sau mười giây.

3.9 Watchdog của các nhóm timer, các bit reset và bộ theo dõi stack (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.

Runtime chạy task watchdog của ESP-IDF trên watchdog của nhóm timer 0, như ESP-IDF làm (firmware/src/main.cpp): tick 500 µs, giai đoạn 0 là một ngắt khi hết thời gian chờ và giai đoạn 1 là một reset hệ thống ở gấp đôi thời gian đó, khởi động trước setup() tại 5 giây kèm một panic, theo dõi idle task của nhân 0. Ngắt in các dòng của ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …", các task, "Aborting.", dòng abort và "Rebooting..."), để lại gợi ý ESP_RST_TASK_WDT của ESP-IDF trong thanh ghi RTC store và reset CPU qua phần mềm reset, nên esp_reset_reason() trả về 6 sau đó. esp_task_wdt_*, enableLoopWDT() và enable/disableCore0WDT() tác động lên nó. Watchdog của nhóm timer 1 được mô phỏng theo cách tương tự và không gì trong runtime kích hoạt nó: interrupt watchdog không được mô phỏng.

4. Kênh host

host_write đặt các byte vào FIFO nhận của UART0; host_read lấy các byte đã rời FIFO truyền của nó. Đó là Serial trong một sketch và serial monitor trong UI. Các byte là UTF-8 theo như UI quan tâm và không rõ nghĩa với mô hình.

Một DevKitC-1 có hai cổng USB-C: một nối tới cầu USB-to-UART, đó là kênh này, và một nối tới USB riêng của chip, không được mô phỏng chút nào.

5. Mô hình thời gian

Như docs/esp32c3.md mục 5. Nhân HP chạy ở 160 MHz, một lệnh mỗi chu kỳ, vậy nên một lệnh đúng bằng 6250 ps và một lát 10 us đúng bằng 1600 lệnh. Bên trong một lát, số lệnh là đồng hồ: một lệnh đọc SYSTIMER, một byte UART và một thay đổi chân đều rơi đúng vào lệnh gây ra chúng.

probe là 1 khi firmware chạy, 0.5 khi dừng ở wfi, 0 khi bị ngừng (không có chương trình, bị giữ reset, hoặc bị treo).

poke: 1 giữ BOOT (GPIO 9 xuống thấp), 0 nhả nó; 2 giữ RST, 3 nhả nó.

6. Thời gian chạy firmware (firmware/c6/)

Một runtime hình Arduino dẫn xuất từ của C3: setup() và loop(), pinMode, digitalWrite, digitalRead, analogRead (kèm analogReadResolution, analogSetAttenuation và analogSetPinAttenuation), analogWrite và cặp ledcAttach/ledcWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial. Không có Arduino core, không có ESP-IDF, không có libc.

analogRead là ADC1 chế độ one-shot trên GPIO 0 đến GPIO 6 (mục 3.6), mười hai bit ở 11 dB theo mặc định, nên firmware/lib/mokxi_joystick.h biên dịch và chạy được ở đây như trên C3. analogWrite(pin, 0..255) là tám bit ở 1 kHz trên bất kỳ GPIO nào và gắn một kênh LEDC tự do lần đầu tiên được gọi; ledcAttach(pin, frequency, bits) là thứ một sketch cần khi tần số quan trọng, và các kênh yêu cầu cùng tần số và độ phân giải dùng chung một trong bốn bộ đếm thời gian.

Dựng bằng clang --target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32, liên kết với firmware/c6/link.ld. Ba tệp của thời gian chạy là của C3, được biên dịch lại cho bo mạch này thay vì sao chép: phần định dạng số, các hàm toán học và floor dạng freestanding, cùng Print và main. Riêng của bo mạch này là header thanh ghi, số chân, mã khởi động, script liên kết, và các driver GPIO, ADC, PWM, thời gian, UART và ngắt.

Chuỗi program trong danh mục là elf32 riscv32imc esp32c6. Nó khác của C3 vì ELF thật sự khác: cùng tập lệnh, bản đồ bộ nhớ khác nhau, và một image liên kết cho cái này sẽ không chạy trên cái kia.

LED_BUILTIN là 8, mà trên bo mạch này là LED RGB địa chỉ được. Kéo nó lên cao và xuống thấp vẫn làm được việc hữu ích trên breadboard; ví dụ rainbow mới là thứ chân này thực sự dành cho.

Sáu ví dụ: blink, button (nút BOOT trên GPIO 9), serial, fade (một LED trên GPIO 10 thở sáng bằng phần cứng PWM), stick (một KY-023 trên kênh 0 và 1 của ADC1, với độ sáng của hai LED xuất ngược lại qua LEDC) và rainbow (vòng sắc độ được bẻ tín hiệu thủ công ra LED RGB và bảy LED nữa trên GPIO 8). Mỗi ví dụ được cấp 16 KB.

7. Những gì mô hình này chắc chắn, và những gì không chắc chắn

Ba nhóm. Mục này tồn tại vì một mô hình bo mạch âm thầm đoán một địa chỉ thì tệ hơn một mô hình nói rõ là nó không biết.

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.

Cố ý không đưa vào. Mỗi thứ sau đây bị bỏ qua thay vì bịa ra, vì bố cục thanh ghi của nó không phải điều mô hình này có thể tái tạo một cách trung thực:

  • Các bộ đếm thời gian của hai nhóm timer (TIMG0 và TIMG1). Watchdog của chúng là của mục 3.9. Thời gian ở đây đến từ SYSTIMER, đủ cho millis, micros và một delay dừng hẳn.
  • RMT, thứ lẽ ra sẽ điều khiển LED RGB. Ví dụ rainbow bẻ tín hiệu thủ công thay thế, và đó không phải lối tắt: đó là cách duy nhất ở đây.
  • LP core và các ngoại vi của nó, gồm LP_UART và LP_I2C. Vùng nguồn thấp của C6 là một nửa điều làm linh kiện này thú vị, và không có gì trong số đó ở đây.
  • Interrupt matrix, đường định tuyến dạng PLIC quyết định ngoại vi nào đến được mcause nào. Mục 3.5 nói rõ cái gì đứng thay cho nó.
  • ADC2, DMA và bộ điều khiển số của SAR ADC, các bộ lọc, bộ theo dõi ngưỡng và các eFuse hiệu chuẩn của nó. Mục 3.6 chỉ là ADC1 chế độ một lần và không hơn.
  • Phần cứng duty-fade của LEDC và đường ngắt của nó: mục 3.7 là các timer, các kênh và ngõ ra, còn LEDC_INT_RAW_REG được thăm dò chứ không được gửi tới.
  • PMU và cây clock, cache, ROM, flash, SPI, I2C, I2S, USB Serial/JTAG, WiFi 6, Bluetooth LE và 802.15.4.

Đó là lý do các binary ESP-IDF và Arduino core của hãng không chạy được ở đây, còn firmware dựng cho tài liệu này thì chạy.