Tham khảo

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

Các ngoại vi, bản đồ bộ nhớ và thời gian của DevKitM-1.

Đâ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-C3 và trang bo mạch.

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.

Kiểu trong danh mục là esp32c3 (bo mạch ESP32-C3-DevKitM-1). Ba nhóm phát triển cùng xây dựng dựa trên tệp này: SoC và linh kiện (Rust), runtime firmware và các ví dụ (C, clang), hình bo mạch và Serial Monitor (TypeScript). Chỉ thay đổi nó bằng cách sửa tệp này trước.

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

Theo thứ tự vật lý của hai dãy chân 15 chân trên DevKitM-1 (nhìn từ trên, cổng USB ở phía dưới):

Header bên trái (từ trên xuống dưới): GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8 Header bên phải (từ trên xuống dưới): 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, NC1, NC2, NC3, NC4, NC5, NC6

Các tên trùng nhau có thêm chữ cái phía sau vì tên chân trong danh mục là duy nhất. Các chân NC* có mặt để header được vẽ đầy đủ; chúng ở trạng thái trở kháng cao và không bao giờ được đọc.

Điện:

  • 3V3* cấp 3.3 V qua R_SUPPLY; 5V* cấp 5 V qua R_SUPPLY; GND* cấp 0 V qua R_SUPPLY. Bo mạch luôn được cấp nguồn (USB). Nó là nguồn cung cho phần còn lại của mạch.
  • RST là ngõ vào có điện trở kéo lên 10 k bên trong tới 3.3 V; khi bị kéo xuống dưới 1.65 V nó giữ CPU ở trạng thái reset; khi nhả ra, chương trình chạy lại từ điểm vào.
  • GPIO 0..10, 18, 19, 20, 21 là hai chiều. Khi bật đầu ra: push-pull ở 3.3 V hoặc 0 V qua R_STRONG. Khi tắt đầu ra: trở kháng cao, cộng thêm điện trở kéo lên 45 k tới 3.3 V khi FUN_WPU được đặt trong IO_MUX, hoặc kéo xuống 45 k khi FUN_WPD được đặt. Ngõ vào đọc điện áp trên đường nối so với 1.65 V (một nửa của 3.3 V); trạng thái Unknown đọc là 0, và ngõ vào bị lơ lửng đọc được nhiễu, giống như trên Uno (docs/uno.md mục 1); GPIO9 đọc là mức cao khi không có gì giữ nó, do điện trở kéo lên của bo mạch bên cạnh nút BOOT.
  • GPIO 0 đến 4 đồng thời là các kênh ADC1 0 đến 4: điện áp trên đường nối tại năm chân đó được đọc vừa như một điện áp, vừa so với ngưỡng, nên biến trở, cần analog hoặc mạch chia áp trên một trong các chân đó là ngõ vào analog thực (mục 3.5). Một chân không có gì giữ sẽ dao động, như một ngõ vào bị lơ lửng (docs/uno.md mục 1).
  • Các chân 18/19 kiêm luôn là USB D-/D+ và 20/21 là UART0 RX/TX trên bo mạch thật; ở đây chúng là GPIO thường. Các byte UART0 đi vào kênh của máy chủ (mục 4), không ra các chân.

2. Bản đồ bộ nhớ (địa chỉ ESP32-C3 thật)

vùng địa chỉ kích thước ghi chú
SRAM, bus lệnh 0x4037_C000 400 KB một RAM, hai góc nhìn
SRAM, bus dữ liệu 0x3FC7_C000 400 KB cùng các byte: 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 mục 3.1
IO_MUX 0x6000_9000 4 KB mục 3.2
UART0 0x6000_0000 4 KB mục 3.3
SYSTIMER 0x6002_3000 4 KB mục 3.4
APB_SARADC 0x6004_0000 4 KB mục 3.5
LEDC 0x6001_9000 4 KB mục 3.7
hộp thư mạng của Mokxi 0x6FFF_E000 4 KB mục 3.8. Không phải của chip: khối riêng của Mokxi, nơi chip C3 thật không có gì

Toàn bộ 400 KB là RAM (chip thật dành phần đỉnh cho dữ liệu ROM và cache; không được mô phỏng). Bất kỳ vùng nào khác đều là lỗi truy cập (lõi xử lý bẫy; linh kiện đếm nó, xem mục 5). Các thanh ghi ngoại vi chưa ánh xạ bên trong một khối đã ánh xạ đọc là 0 và bỏ qua ghi, kèm bộ đếm để chẩn đoán.

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. Thanh ghi ngoại vi (tập con, offset thật, vị trí bit thật)

Các thanh ghi dài 32 bit và sắp theo word. Truy cập nửa word và byte vào thanh ghi không được hỗ trợ (được coi như truy cập word của word đã sắp, đó là điều chip làm khi đọc; ghi với độ hẹp hơn sẽ ghi cả word từ giá trị hẹp, không phải hành vi thật, nên firmware không được làm vậy).

3.1 GPIO (0x6000_4000)

offset tên bit
0x04 GPIO_OUT_REG bit n = mức của GPIO n khi đầu ra được bật
0x08 GPIO_OUT_W1TS_REG ghi 1 để đặt các bit của OUT
0x0C GPIO_OUT_W1TC_REG ghi 1 để xóa các bit của OUT
0x20 GPIO_ENABLE_REG bit n = bộ đẩy đầu ra của GPIO n bật
0x24 GPIO_ENABLE_W1TS_REG đặt
0x28 GPIO_ENABLE_W1TC_REG xóa
0x3C GPIO_IN_REG bit n = mức ngõ vào của GPIO n (cần FUN_IE)
0x44 GPIO_STATUS_REG trạng thái ngắt, bit n
0x4C GPIO_STATUS_W1TC_REG xóa
0x74 + 4n GPIO_PINn_REG bit 2 PAD_DRIVER (1 = hở máng), bit 7..9 INT_TYPE (0 tắt, 1 sườn lên, 2 sườn xuống, 3 cả hai, 4 mức thấp, 5 mức cao)
0x554 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG bit 0..7 OUT_SEL: 128 = pad theo bit n của GPIO_OUT_REG (giá trị khi bật nguồn được dùng ở đây); 45 đến 50 = các kênh tốc độ thấp LEDC 0 đến 5 điều khiển nó (mục 3.7); giá trị khác không được hỗ trợ và được coi như 128

Các chỉ số tín hiệu 45 đến 50 chưa được kiểm chứng: đó là điều mô hình này cài đặt cho ledc_ls_sig_out0 đến ledc_ls_sig_out5, được chọn để ma trận GPIO có chỗ đặt chúng, chứ không phải một dòng trích từ bảng tín hiệu ngoại vi của tài liệu. Một pad đang được kênh LEDC điều khiển vẫn cần bật bộ đẩy đầu ra trong GPIO_ENABLE_REG, điều mà gpio_set_direction đặt trước khi ma trận được chuyển; kênh quyết định mức còn GPIO_ENABLE quyết định pad có đẩy hay không.

Chỉ có các bit 0..21 tồn tại. Hở máng: đầu ra mức cao nghĩa là trở kháng cao. Ngắt GPIO đặt GPIO_STATUS_REG và kéo đường ngắt ngoài lên (mục 3.6).

3.2 IO_MUX (0x6000_9000)

offset tên bit
0x04 + 4n IO_MUX_GPIOn_REG bit 7 FUN_WPD kéo xuống, bit 8 FUN_WPU kéo lên, bit 9 FUN_IE bật ngõ vào, bit 12..14 MCU_SEL (1 = GPIO, giá trị duy nhất được hỗ trợ; giá trị khi bật nguồn là 1 ở đây cho mọi chân nên firmware thô chạy ngay)

3.3 UART0 (0x6000_0000)

offset tên bit
0x00 UART_FIFO_REG ghi: đẩy một byte ra TX; đọc: lấy một byte từ RX (0 khi rỗng)
0x04 UART_INT_RAW_REG bit 0 RXFIFO_FULL, bit 1 TXFIFO_EMPTY, bit 8 RXFIFO_TOUT
0x08 UART_INT_ST_REG thô và được bật
0x0C UART_INT_ENA_REG
0x10 UART_INT_CLR_REG ghi 1 để xóa
0x14 UART_CLKDIV_REG bit 0..11 phần nguyên của số chia, bit 20..23 CLKDIV_FRAG phần mười sáu của nó, trên clock lõi (baud chỉ ảnh hưởng nhịp TX trong mục 5; được lưu, đọc lại được)
0x1C UART_STATUS_REG bit 0..9 RXFIFO_CNT, bit 16..25 TXFIFO_CNT
0x20 UART_CONF0_REG được lưu, đọc lại được; bit 17 RXFIFO_RST, bit 18 TXFIFO_RST xóa các FIFO (TRM v1.4 thanh ghi 26.9)
0x24 UART_CONF1_REG bit 0..8 RXFIFO_FULL_THRHD, bit 9..17 TXFIFO_EMPTY_THRHD
0x78 UART_CLK_CONF_REG bit 20..21 SCLK_SEL (1 là clock APB 80 MHz, 3 là thạch anh 40 MHz; 2, RC_FAST, được coi như thạch anh), bit 12..19 SCLK_DIV_NUM: clock lõi là nguồn chia cho SCLK_DIV_NUM + 1. Ra khỏi reset là thạch anh, không chia, nên CLKDIV 347 là 115 274 baud. Các phần SCLK_DIV_A/SCLK_DIV_B phân số được lưu, không được mô phỏng

Runtime lập một tốc độ baud như cách uart_ll_set_baudrate của ESP-IDF làm: clock APB, tiền chia bởi SCLK_DIV_NUM + 1 nhỏ nhất đưa số chia xuống dưới 4096, và số chia tới một phần mười sáu, nên 1200 và 9600 baud chính xác thay vì bị kẹp ở 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)

Bộ đếm 52 bit tự chạy 16 MHz, một bộ so sánh nối vào ngắt timer của CPU.

offset tên bit
0x04 SYSTIMER_UNIT0_OP_REG bit 30 UPDATE: ghi 1 để chốt giá trị đếm vào VALUE_HI/LO; bit 29 VALUE_VALID đọc là 1 sau khi chốt
0x40 SYSTIMER_UNIT0_VALUE_HI_REG bit 0..19, bit 32..51 của giá trị đếm đã chốt
0x1C SYSTIMER_TARGET0_HI_REG bit 0..19
0x20 SYSTIMER_TARGET0_LO_REG
0x34 SYSTIMER_TARGET0_CONF_REG bit 30 PERIOD_MODE, bit 0..25 PERIOD
0x44 SYSTIMER_UNIT0_VALUE_LO_REG các bit đếm đã chốt 0..31
0x50 SYSTIMER_COMP0_LOAD_REG ghi 1 để nạp giá trị mục tiêu
0x64 SYSTIMER_INT_ENA_REG bit 0
0x68 SYSTIMER_INT_RAW_REG bit 0
0x6C SYSTIMER_INT_CLR_REG bit 0
0x70 SYSTIMER_INT_ST_REG bit 0

Bộ đếm thời gian luôn chạy. Giá trị đếm được suy ra từ thời gian của kernel: count = now_ps / 62_500. Nó không bao giờ lệch so với mạch.

Đã kiểm chứng từng thanh ghi với ESP32-C3 Technical Reference Manual v1.4, mục 10.6 (bảng tóm tắt thanh ghi) và các thanh ghi 10.2, 10.14 đến 10.17. Một phiên bản trước của mô hình này đặt comparator 0 tại 0x50 đến 0x5C, vốn trên C3 là các xung nạp COMP0_LOAD đến COMP2_LOAD và UNIT0_LOAD; bố cục đó chưa từng là của con chip thật, và runtime cùng các hình ảnh của nó đã được dựng lại khi lỗi được sửa.

3.5 APB_SARADC (0x6004_0000)

ADC1 ở chế độ one-shot: đúng đường đi mà trình điều khiển adc_oneshot của ESP-IDF và analogRead của Arduino core dùng, và không gì khác. Kênh 0 đến 4 là GPIO 0 đến GPIO 4; ADC2 không được mô phỏng (trên C3 thật nó dùng chung với radio, và ở đây không có radio).

Địa chỉ cơ sở của khối là của con chip. Các offset trong bảng này đánh dấu "chưa kiểm chứng" không được lấy từ trang nào của tài liệu kỹ thuật: chúng là những gì mô hình này triển khai, được chọn để khớp với hình dạng của đường one-shot, và firmware dựng ở đây khớp với mô hình bất kể nó có khớp với silicon hay không. 0x00 và 0x04 là của tài liệu; phần còn lại của các thanh ghi one-shot là chưa kiểm chứng, và một chương trình cần chạy nguyên vẹn trên DevKitM-1 nên kiểm tra chúng với tài liệu trước.

offset tên bit
0x00 APB_SARADC_CTRL_REG bit 7..14 SAR_CLK_DIV: bộ chia clock SAR. Đượ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 (offset chưa kiểm chứng)
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 (offset và vị trí trường chưa kiểm chứng)
0x44 APB_SARADC_1_DATA_STATUS_REG bit 0..16 ADC1_DATA: kết quả chuyển đổi ADC1 gần nhất, rộng mười hai bit (offset chưa kiểm chứng)
0x64 APB_SARADC_INT_ENA_REG được lưu; không có đường nào tới lõi (offset chưa kiểm chứng)
0x68 APB_SARADC_INT_RAW_REG bit 31 ADC1_DONE (offset chưa kiểm chứng)
0x6C APB_SARADC_INT_ST_REG thô và được bật (offset chưa kiểm chứng)
0x70 APB_SARADC_INT_CLR_REG ghi 1 để xóa, cùng bit (offset chưa kiểm chứng)
0x78 APB_SARADC_APB_ADC_CLKM_CONF_REG được lưu, đọc lại (offset chưa kiểm chứng)

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.

Kết quả gồm mười hai bit, round(4095 x Vin / Vfull), được chặn lại, từ điện áp trên đường nối tại thời điểm bắt đầu chuyển đổi. ONETIME_ATTEN chọn thang đo đầy đủ, theo các con số danh nghĩa mà datasheet nêu:

ONETIME_ATTEN độ suy giảm thang đo đầy đủ
0 0 dB 1.1 V
1 2.5 dB 1.5 V
2 6 dB 2.2 V
3 11 dB đường cong của linh kiện thật, bão hòa ở khoảng 2.9 V

Ba cái đầu là các đường thẳng danh nghĩa. 11 dB (12 dB trong ESP-IDF hiện tại), mặc định của Arduino core, đi theo đường cong thô của một linh kiện điển hình (CURVE_11DB trong crates/esp32c3/src/adc.rs): gần tuyến tính qua vùng hiệu dụng 0 đến 2500 mV của datasheet (3650 tại 2.5 V), rồi tiếp tục lên 4095 tại khoảng 2.9 V (người dùng báo cáo 2.8 đến 3.0 V trên bo mạch thật). Vì vậy một biến trở nối qua nguồn 3.3 V đọc được 4095 cho phần mười cuối của hành trình, và một mạch chia ở nửa nguồn đọc khoảng 2410, không phải 2048. Hiệu chuẩn eFuse của từng con chip dịch chuyển điều này vài phần trăm, điều không được mô phỏng; analogReadMilliVolts nghịch đảo đúng đường cong đó. Một kênh không nối gì ở chân sẽ dao động, như một ngõ vào bị thả nổi (docs/uno.md mục 1).

ADC1_DONE có thể được thăm dò và xóa, đó là điều đường one-shot làm, nhưng nó không tới được mip: ADC không nằm trên đường ngắt ngoài (mục 3.6). Cả bộ điều khiển số, bảng mẫu DMA, các bộ lọc, các bộ theo dõi ngưỡng lẫn các kênh nhiệt độ trong và VDD cũng không.

3.6 Ngắt

Chế độ machine của RISC-V, mtvec direct hoặc vectored tùy theo lõi hỗ trợ. Các đường:

  • Ngắt timer của bộ định thời (mip.MTIP, cause 7): SYSTIMER target 0 khi bit 0 của INT_ENA và bit 0 của INT_RAW.
  • Machine external interrupt (mip.MEIP, cause 11): GPIO (GPIO_STATUS_REG non-zero) or UART0 (UART_INT_ST_REG non-zero). Firmware reads the two status registers to find out which. The real interrupt matrix is not modeled.

wfi đưa lõi vào chế độ chờ cho tới khi có đường nào đó chờ xử lý.

3.7 LEDC (0x6001_9000)

Bộ điều khiển LED PWM, nhóm low-speed, là nhóm duy nhất con chip này có: bốn timer và sáu kênh. Đây là khối đứng sau analogWrite, ledcAttach và 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)

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 timer, một số đếm bắt đầu HPOINT và một duty, và ngõ ra của nó ở mức cao từ HPOINT trong DUTY >> 4 lần đếm, cuộn quanh đỉnh của chu kỳ. Vì vậy 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, không một cạnh nào cả, đó là lý do Arduino core biến ledcWrite(pin, 255) ở tám bit thành duty 256 thay vì để lại một khấc một đơn vị mỗi chu kỳ.

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.

offset tên bit
0x00 + 0x14n LEDC_CHn_CONF0_REG bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV (mức được giữ khi bộ tạo ngõ ra tắt), bit 4 PARA_UP (được lưu; duty ghi vào đây có hiệu lực ngay)
0x04 + 0x14n LEDC_CHn_HPOINT_REG bit 0..13 HPOINT: số đếm mà xung của kênh bắt đầu
0x08 + 0x14n LEDC_CHn_DUTY_REG bit 0..18 DUTY: độ rộng xung tính bằng một phần mười sáu của lần đếm
0x0C + 0x14n LEDC_CHn_CONF1_REG phần cứng duty-fade: đã lưu, đọc lại được, và không làm mờ gì cả
0x10 + 0x14n LEDC_CHn_DUTY_R_REG hệ số chu kỳ hiện hành, chỉ đọc
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 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
0xD0 LEDC_CONF_REG bit 0..1 APB_CLK_SEL (1 = clock APB 80 MHz, nguồn duy nhất được mô phỏng), bit 31 CLK_EN (được lưu)
0xFC LEDC_DATE_REG một con dấu phiên bản, chỉ đọc

Việc thiết lập một kênh là công việc của ledc_timer_config và ledc_channel_config: ghi LEDC_CONF_REG, ghi DUTY_RES và CLK_DIV của timer, ghi CONF0 của kênh kèm timer và SIG_OUT_EN của nó, ghi HPOINT và DUTY, bật bit GPIO_ENABLE của chân và trỏ GPIO_FUNCn_OUT_SEL_CFG_REG của nó tới 45 + channel.

Bộ đếm không được bước rời rạc: nó là một hàm dạng đóng của thời gian mô phỏng, và thời điểm cạnh kế tiếp của nó cũng vậy. Vì vậy một nhân đang nằm ở wfi không tốn chi phí nào khi một PWM đang chạy, và phần bo mạch chỉ được đánh thức cho các cạnh 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, bộ đếm tràn riêng của từng kênh, các nguồn clock khác APB, 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, giống hệt như ADC1_DONE của ADC không tới được (mục 3.6).

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

Khối này không phải của ESP32-C3. Mọi địa chỉ khác trong tài liệu này là của chip, trích từ tài liệu tham khảo kỹ thuật, và một image dựng dựa trên đó chạy được trên DevKitM-1 thật. Riêng khối này là của Mokxi: mạng mô phỏng của crates/net, được ánh xạ tại một địa chỉ mà linh kiện thật để trống, để một image dùng nó 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 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 reset RTC_CNTL và bộ giám sát stack (0x6001_F000, 0x6002_0000, 0x6000_8000, 0x600C_E000)

Watchdog chính của từng nhóm timer (crates/esp-common/src/mwdt.rs): WDTCONFIG0..5, WDTFEED và khóa WDTWPROTECT, bốn giai đoạn, mỗi giai đoạn có hành động riêng (một ngắt, một reset CPU hoặc một reset hệ thống), bộ chia tần trên clock APB 80 MHz hoặc, với WDT_USE_XTAL, thạch anh 40 MHz, và cấu hình được ghi sẽ có hiệu lực tại WDT_CONF_UPDATE_EN. Bit của watchdog trong TIMG_INT_ENA/RAW/ST/CLR (bit 1) phát ngắt ngoài của máy, giống như GPIO và UART0 (mục 3.6). Một giai đoạn reset sẽ reset chip với RTC_CNTL_RESET_STATE_REG cho biết lý do (7 hoặc 8 cho reset hệ thống, 0xB hoặc 0x11 cho reset CPU); RAM được nạp lại từ image, RTC_CNTL_STORE0..7 giữ nguyên giá trị, và RTC_CNTL_SW_SYS_RST cùng RTC_CNTL_SW_PROCPU_RST trong RTC_CNTL_OPTIONS0_REG cũng reset nó (nguyên nhân 3 và 0xC).

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.

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. Kênh host

host = "utf-8 bytes on UART0". readHost trả về các byte TX của UART0 ngay khi chúng rời FIFO; writeHost đẩy byte vào FIFO RX của UART0 (tràn thì bỏ, như trên chip thật). Serial Monitor hiển thị byte dạng văn bản, giải mã UTF-8 và coi \n là kết thúc dòng (\r bị bỏ qua).

5. Mô hình thời gian

CPU chạy ở 160 MHz với một lệnh mỗi chu kỳ. Linh kiện chạy theo lát cắt: mỗi lần được đánh thức, nó chạy SLICE_NS * 160 lệnh (SLICE_NS = 10 us, tức 1600 lệnh) rồi đặt lịch đánh thức tiếp theo, với các quy tắc sau:

  • Các ghi vào ngoại vi làm thay đổi chân (GPIO OUT hoặc ENABLE, điện trở kéo của IO_MUX) sẽ điều khiển chân tại thời điểm bắt đầu lát cắt cộng với số lệnh đã chạy chia cho 160 MHz. Dùng drive_after với độ trễ đó để hai lần bật/tắt trong cùng một lát cắt giữ nguyên khoảng cách của chúng. Việc đọc GPIO_IN thấy mức chân tính từ lúc bắt đầu lát cắt.
  • So sánh của bộ đếm giờ và nhịp UART được tính theo cùng thời gian trong lát cắt, nên micros() là đơn điệu tăng và delayMicroseconds bằng vòng lặp chờ chính xác đến một lệnh.
  • Cycle counters: rdcycle/cycle (0xC00, 0xC80), mcycle/mcycleh (0xB00, 0xB80) and the ESP32-C3's own performance counter, mpcer/mpcmr/mpccr (0x7E0 to 0x7E2, user views 0x800 to 0x802, the one ESP-IDF's esp_cpu_get_cycle_count reads), all read without trapping and count one per 160 MHz cycle, which is one per instruction. mpccr counts from reset (mpcer and mpcmr read 1); a write sets it, and mpcmr bit 0 clear holds it. None of them advance while the core is parked in wfi.
  • wfi: linh kiện ngừng cắt lát và đặt lịch đánh thức vào thời điểm sớm nhất giữa mục tiêu của bộ đếm giờ và một sự kiện UART; chân GPIO thay đổi sẽ đánh thức ngay lập tức.
  • Lỗi truy cập: lõi xử lý trap đến mtvec; với mtvec = 0 thì sẽ trap lại mãi mãi. Linh kiện đếm số trap và sau 1000 trap liên tiếp không tiến triển gì thì dừng lại và báo "firmware crashed at pc=…, mcause=…" qua probe (xem bên dưới) và kênh host (một dòng).

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. Môi trường chạy firmware (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. 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, cùng cách phân loại mà mục 7 của docs/esp32c6.md dùng. Nó tồn tại vì một mô hình bo mạch âm thầm đoán một địa chỉ còn tệ hơn một mô hình nói rằng nó không biết.

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.

Được tin là đúng, chưa kiểm chứng. Được nêu đích danh từng thanh ghi trong các mục 3.1 và 3.5, và nhắc lại ở đây để danh sách nằm tại một nơi:

  • Mọi offset thanh ghi one-shot bên trong APB_SARADC trừ 0x00 và 0x04. Đó là FSM_WAIT ở 0x0C, ONETIME_SAMPLE ở 0x38 và vị trí các trường của nó, 1_DATA_STATUS ở 0x44, bốn thanh ghi ngắt từ 0x64 đến 0x70, và APB_ADC_CLKM_CONF ở 0x78. Chúng là những gì mô hình này triển khai, được chọn để khớp với hình dạng của đường one-shot, chứ không phải các dòng trích từ một trang của tài liệu.
  • Các chỉ số tín hiệu 45 đến 50 của ma trận GPIO cho ledc_ls_sig_out0 đến ledc_ls_sig_out5, được chọn để ma trận có chỗ đặt chúng.

Firmware dựng cho tài liệu này khớp với mô hình, bất kể nó có khớp với chip thật hay không. Một ảnh được đem sang DevKitM-1 thật nên kiểm tra các #define đó trong firmware/include/esp32c3.h với tài liệu trước.

Được mô hình hóa, nhưng không bị ràng buộc theo các con số trong tài liệu. Là các hành vi chứ không phải địa chỉ:

  • ADC ở 11 dB là đường cong của một linh kiện điển hình, không phải của chính đơn vị này. Bão hòa ở khoảng 2,9 V và độ lợi trên dải hiệu dụng 2,5 V có mặt ở đây (mục 3.5); độ lệch giữa các đơn vị mà hiệu chỉnh eFuse bù cho, và nhiễu chuyển đổi, thì không. Các mức suy giảm còn lại là các đường thẳng danh nghĩa (1,1 V; 1,5 V; 2,2 V).
  • Một lệnh là một chu kỳ ở 160 MHz. Không có cản đường ống (pipeline stall), không có cache (vốn không có cache), không có chu kỳ chờ flash và không có tranh chấp bus, nên số lệnh chính là xung nhịp. Một C3 thật chạy từ flash chậm hơn và kém đều đặn hơn thế.
  • Các pad là ba trạng thái và một ngưỡng. Push-pull ở 3,3 V, high-Z, hoặc điện trở kéo trong 45 kΩ, đọc lại so với một nửa nguồn cấp, không có trễ (hysteresis), không có cài đặt độ mạnh dẫn, không có thời gian lên và không có giới hạn dòng. Một chân không được dẫn đọc là 0 thay vì trôi tới một giá trị nào đó.
  • Bo mạch là một nguồn cấp lý tưởng: 3V3 và 5V ở trở kháng bằng nguồn mãi mãi, nên không có gì sụt áp. Khởi động mất một microgiây, trong khi một C3 thật tiêu tốn hàng chục mili giây trong boot ROM của nó.
  • Một lát cắt là 10 µs, và SoC gặp mạch tại các biên lát cắt hoặc tại thứ mà chip đang chờ.

Cố ý không có. Được bỏ ngoài chứ không phải bịa ra, vì bố cục thanh ghi không phải thứ mô hình này có thể tái tạo một cách trung thực: Bluetooth LE (không radio, và không giả vờ có), SPI, I2C, I2S, RMT, USB Serial/JTAG, các bộ định thời của nhóm timer (watchdog của chúng là của mục 3.9), ma trận ngắt đầy đủ (mục 3.6 nói rõ thứ thay thế nó), ADC2 và bảng mẫu DMA của SAR ADC, bộ điều khiển số, các bộ lọc, bộ theo dõi ngưỡng và eFuse hiệu chỉnh, nhóm tốc độ cao của LEDC cùng phần cứng duty-fade và đường ngắt của nó vào lõi, PMU và cây clock, cache, ROM và flash. Đó là lý do các file nhị phân 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.

WiFi: được mô phỏng, xem 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 là bản hợp đồng cho việc mạng đó làm gì và, nói kỹ hơn, cho việc nó không làm gì.

Câu hỏi

Does it do WiFi?

WiFi mô phỏng, có chứ. Sketch của bạn dùng các lệnh Arduino thật (WiFi.begin, HTTPClient, WebServer) và bo mạch tham gia mạng, tải và phục vụ nội dung, nhưng bên dưới không có sóng vô tuyến và không có 802.11. Khi đã đăng nhập, bạn có thể bật Internet thật trong bảng Cloud. Mục 3.8 và trang WiFi mô phỏng có bản hợp đồng đầy đủ.

Firmware của tôi có chạy trên DevKitM-1 thật không?

Có. Mô hình nằm đúng trên bản đồ bộ nhớ và offset thanh ghi thật cho mọi thứ nó triển khai, nên bản biên dịch từ đây không riêng gì cho Mokxi.