Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch và Mô hình ESP32-C3 (mọi thanh ghi).
Đây là gì
ESP32-C3-DevKitM-1: một chip RISC-V 32 bit chạy trên nhân RV32IMC do chính chúng tôi viết, vượt qua bộ kiểm tra riscv-tests ngay trong trình duyệt. Mô hình dùng đúng sơ đồ bộ nhớ của ESP32-C3 thật và đúng offset thanh ghi cho mọi phần được triển khai, nên firmware biên dịch ở đây chạy được trên một bo mạch DevKitM-1 thật.
CPU chạy trong các lát 10 microgiây ở 160 MHz, một lệnh mỗi chu kỳ, và một thay đổi chân xảy ra trong lát được đặt đúng vào lệnh gây ra nó.
Các chân
Hai dãy chân 15 chân, theo đúng thứ tự trên bo mạch thật.
Dãy châ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.
Dãy chân phải: 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, sau đó là sáu chân ghi NC, được vẽ ra cho đủ dãy chân và không bao giờ được đọc.
Các chân GPIO 0 đến 10, 18, 19, 20 và 21 dùng được. Đây là bo mạch 3.3 volt: một ngõ ra kéo lên 3.3 V hoặc 0 V, ngưỡng vào là 1.65 V, và điện trở pull-up lẫn pull-down bên trong đều khoảng 45 k.
Chân RST có điện trở pull-up 10 k; kéo nó xuống dưới 1.65 V sẽ giữ chip trong trạng thái reset.
Chân GPIO 8 gắn với LED trên bo mạch, đó là lý do LED_BUILTIN bằng 8. Ở đây nó được vẽ như một LED thường. Trên ESP32-C3-DevKitM-1 thật, đó là một LED RGB địa chỉ hóa (linh kiện loại WS2812 có bộ điều khiển riêng), nên nó bỏ qua chân chỉ được kéo lên cao hoặc xuống thấp: sketch Blink nạp từ Mokxi sẽ không sáng gì trên bo mạch thật. Arduino core của Espressif xử lý việc này bằng cách gán cho LED_BUILTIN một con số riêng và biến digitalWrite() trên chân đó thành một màu gửi tới LED, nên Blink của Arduino IDE có làm nó sáng, màu trắng mờ. Để thấy nhấp nháy từ bản biên dịch của Mokxi trên bo mạch thật, hãy nối một LED và một điện trở vào chân khác.
Các chân analog
GPIO 0 đến GPIO 4 là các kênh ADC1 từ 0 đến 4, và analogRead() trên một trong các chân này là một phép chuyển đổi thật của điện áp trên chân: mười hai bit, từ 0 đến 4095, theo thang đo đầy đủ do mức suy giảm chọn. Mặc định là 11 dB, gần như toàn dải 3.3 V, nên một chiết áp hoặc cần gạt nối qua nguồn sẽ phủ kín cả dải; analogSetPinAttenuation() nhận ADC_0db (1.1 V), ADC_2_5db (1.5 V), ADC_6db (2.2 V) hoặc ADC_11db, còn analogReadResolution() dịch kết quả nếu bạn muốn lấy lại mười bit như của Uno.
One read costs about five microseconds of simulated time, which is what the
converter takes. A pin with nothing on it reads 0 rather than noise. Any other
pin reads 0 too: there are five analog inputs and no more.
PWM
analogWrite(pin, 0..255) hoạt động trên bất kỳ chân GPIO nào. Tín hiệu ra đến từ LEDC, bộ điều khiển PWM cho LED của chip, và đến chân thông qua GPIO matrix, nên không có tập chân ~ cố định như trên Uno.
Mặc định là tám bit ở 1 kHz. Khi tần số quan trọng (một servo cần năm mươi khung mỗi giây và một độ rộng xung, không phải duty), hãy dùng cách viết của ESP32:
ledcAttach(4, 50, 14); // fifty frames a second, 16384 counts each
ledcWrite(4, 1229); // 1.5 ms of a 20 ms frame: the middle
Có sáu kênh và bốn bộ định thời. Các kênh yêu cầu cùng tần số và độ phân giải dùng chung một bộ định thời, nên sáu chân fade cùng lúc chỉ tốn một trong bốn; yêu cầu cặp giá trị khác thứ năm thì ledcAttach trả về false thay vì chỉnh lại bộ định thời mà chân khác đang dùng. pinMode() và digitalWrite() lấy chân về khỏi LEDC.
Duty 0 là mức thấp liên tục và duty 255 là mức cao liên tục, xuất trực tiếp từ phần cứng, hoàn toàn không có sườn xung, điều này cũng nghĩa là trình mô phỏng không có gì để đánh thức bo mạch, và một bo mạch đang fade LED trong khi đứng ở wfi chỉ tốn hai lần đánh thức mỗi mili giây và không gì hơn.
Serial
Trên bo mạch thật, chân 20 và 21 là UART0, chân 18 và 19 là USB. Ở đây chúng là GPIO thường, và các byte của UART0 được gửi sang Serial Monitor. Xem chạy và serial monitor.
What is modeled
GPIO, IO_MUX, UART0, SYSTIMER, đường chuyển đổi một lần của ADC1 và nhóm tốc độ thấp của LEDC, ở địa chỉ thật với các bit thật, cùng ngắt ngoài machine cho GPIO và UART.
delay() cho nhân đứng chờ trên một báo thức SYSTIMER thay vì quay vòng, nên một sketch rảnh chỉ tốn của trình mô phỏng vài trăm lệnh mỗi giây mô phỏng thay vì một trăm sáu mươi triệu.
Một số địa chỉ thanh ghi chưa được kiểm chứng
Hai khối nói trên mang những địa chỉ mà mô hình này không thể cam kết. Các địa chỉ cơ sở và các offset của GPIO, IO_MUX, UART0 và SYSTIMER lấy từ cẩm nang kỹ thuật. Bên trong SAR ADC, mọi offset thanh ghi chuyển đổi một lần trừ hai cái đầu đều do mô hình này tự chọn chứ không phải dòng trích từ trang cẩm nang; điều tương tự đúng với bốn thanh ghi ngắt của LEDC, thanh ghi cấu hình toàn cục và thanh ghi ngày của nó, và sáu số hiệu tín hiệu GPIO matrix mà các kênh LEDC đi qua để tới pad. Firmware biên dịch ở đây khớp với mô hình dù nó có khớp với silicon hay không, và một image chuẩn bị mang sang DevKitM-1 thật nên kiểm tra trước danh sách ngắn các #define trong firmware/include/esp32c3.h. Mục 7 của mô hình ESP32-C3 phân loại mọi địa chỉ thành: lấy từ cẩm nang, tin là đúng nhưng chưa kiểm chứng, và thiếu.
WiFi, simulated
Không có radio. Và sẽ không bao giờ có: một MAC 802.11 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 được mô phỏng giống như mạng, với một chiếc điện thoại trong khung Bluetooth của trình soạn thảo (Bluetooth, được mô phỏng).
Thay vào đó là một mạng được mô phỏng. Một block do chính Mokxi cung cấp chứ không phải của chip (một hộp thư tại 0x6FFF_E000, nơi mà chip C3 thật không ánh xạ gì cả) mang theo WiFi.h, HTTPClient.h và WebServer.h, nên code Arduino mà một bài hướng dẫn đưa cho bạn vẫn chạy được ở đây: bo mạch tham gia một điểm truy cập mà tên và mật khẩu là các thuộc tính của bo mạch, WiFi.status() đi qua các trạng thái giống hệt trong khoảng một đến ba giây, DHCP cấp cho nó địa chỉ 192.168.4.2, và một sketch có thể tải về một trang web hoặc phục vụ một trang.
Đằng sau nó là phần mềm, và không có gì che giấu điều đó. Không có 802.11, không có kênh, không quét mạng, không WPA2, không TCP, không TLS và không có internet thật: chỉ bốn cái tên bịa đặt dưới .mokxi là phân giải được và không có gì khác, và chẳng có gì mà sketch làm có thể chạm tới mạng mà trình duyệt của bạn đang dùng. WiFiClientSecure biên dịch được nhưng sẽ thất bại, báo rằng TLS không được mô phỏng. Các bảng Web và Cloud dọc theo đáy trình soạn thảo mở ra với câu đó và không cuộn nó đi.
Ngoại lệ duy nhất là Internet thật, một công tắc trong bảng Cloud dành cho ai đã đăng nhập (nhiều hơn với Pro), tắt mỗi lần trang được tải. Khi bật nó, một yêu cầu cho tên ngoài .mokxi,
https:// bao gồm cả, sẽ đi ra qua cổng của Mokxi và câu trả lời quay về sketch. Xem Internet thật.
WiFi, simulated hướng dẫn cách dùng; Simulated WiFi là bản hợp đồng, giới hạn từng điều khoản một.
Watchdog và stack
As on the board, ESP-IDF's task watchdog runs from before setup() with a
5 s timeout: a sketch that neither calls delay() nor returns from loop()
for that long prints the "Task watchdog got triggered" lines and reboots, and
esp_reset_reason() says ESP_RST_TASK_WDT (6) afterwards.
disableCore0WDT() turns that off, and esp_task_wdt_add(NULL) watches the
sketch's own resets. A stack that runs out (recursion that never ends) stops
with a "stack overflow" crash line at the top of the heap, before it writes
over the program.
Những gì không có
Thiếu: SPI và I2C ở vai trò peripheral, các timer trong các nhóm timer (watchdog của chúng vẫn có, dành cho task watchdog), RMT, USB Serial/JTAG, toàn bộ ma trận ngắt, và mọi thứ từ ESP-IDF. Trong SAR ADC chỉ có đường one-shot của ADC1 được mô phỏng, không có ADC2 (mà trên silicon thật radio dùng chung), bảng mẫu DMA, bộ điều khiển digital, các bộ lọc và bộ theo dõi ngưỡng, hay đường cong hiệu chuẩn trong eFuse, nên giá trị đọc ở đây là đường thẳng danh nghĩa thay vì độ cong nhẹ của linh kiện thật, hoàn toàn không có nhiễu hay phi tuyến. Cờ done của ADC có thể được poll nhưng không đến được bộ điều khiển ngắt. Các file nhị phân của hãng nằm ngoài phạm vi; cái chạy ở đây là firmware build với runtime của riêng chúng tôi, chính là cái trình soạn code build cho bạn.
Một lệnh là một chu kỳ ở 160 MHz, không có cache, không có chu kỳ chờ flash và không có stall pipeline, nên chương trình ở đây chạy đều đặn hơn trên silicon thật. Các chân 3V3 và 5V là nguồn lý tưởng không bao giờ sụt áp, nên không gì trong Mokxi bị brown out.
Từng thanh ghi một, mô hình ESP32-C3 có đầy đủ tất cả.
Thư viện Arduino có sẵn
Một tutorial có Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h với Adafruit_SSD1306.h, Adafruit_NeoPixel.h, ESP32Servo.h và DHT.h sẽ biên dịch được ở đây nguyên vẹn. Mỗi cái là header riêng của Mokxi dưới tên thượng nguồn, viết trên driver cho các linh kiện trong hộp, và không có phần nào là code của thư viện thượng nguồn.
Wire.begin()đặt bus I2C lên GPIO8(SDA) và GPIO9(SCL), lựa chọn của Arduino core cho bo mạch này;Wire.begin(sda, scl)sẽ chuyển nó đi chỗ khác.EEPROM.hhoạt động, nhưng mô hình của bo mạch này không có EEPROM hay flash ghi được, nên các byte nằm trong 4 KB RAM: chúng đọc lại được trong một lần Chạy và biến mất khi reset.
Trình soạn code và biên dịch liệt kê mỗi thư viện hỗ trợ những gì và khác gì so với thư viện thượng nguồn.
Các ví dụ
Blink, Button, Serial, Fade, PWM fade, Servo sweep, Counter, Interrupt, WiFi: join the network, WiFi: fetch the weather, WiFi: a lamp on a web page, Thumb stick, Rainbow strip, Plasma panel, OLED text and shapes, OLED dice, OLED pong, Pong console, Binary clock, Electronic dice, Knight Rider, Morse sender, Simon, Stacker và Talker.
PWM fade và Servo sweep là hai demo dùng LEDC. Demo đầu là cũng LED thở như Fade, nhưng do phần cứng tạo ra thay vì tự viết, chính là khác biệt giữa một core thức suốt từng microgiây của sóng và một core ngủ giữa các bước; demo sau quét một SG90 bằng kênh 50 Hz, nơi servo đọc là độ rộng xung chứ không phải duty cycle.
Thumb stick và OLED pong là hai demo đọc ADC. Demo stick in ra cả hai trục và sáng LED ở phía bạn đẩy về, sáng đậm hay nhạt tùy độ lệch; OLED pong là trò chơi stick của Uno trên bo mạch này, với vợt chạy theo biến trở trục Y của stick trên GPIO 0 và điểm số bằng font 5x7 mà Uno không đủ chỗ chứa.
Các demo dải LED và bảng được viết riêng cho bo mạch này. Cùng driver WS2812 đó cũng chạy trên các bo mạch AVR, phần còn lại của họ ESP32, Pico và Uno R4.
Stacker là demo trên trang chủ. Hai ma trận 8x8 MAX7219 xếp chồng lên nhau, tạo thành sân chơi rộng tám pixel và cao mười sáu pixel, và một nút arcade 30 mm trên GPIO 3 làm rơi khối đang trượt. Chúng nối chuỗi đúng cách chip được thiết kế: dữ liệu trên GPIO 7 chỉ đến module trên cùng, DOUT của nó cấp cho DIN của module dưới, còn clock trên GPIO 5 và chân chip select duy nhất trên GPIO 6 đến cả hai. Sketch gửi hai gói giữa một cặp sườn CS, gói của module dưới trước, vì gói gửi trước bị đẩy sâu nhất trong chuỗi. Các ma trận chạy bằng chân 5V của bo mạch thay vì 3V3, vì MAX7219 cần bốn volt trở lên. Nếu không ai bấm nút trong bốn giây, sketch tự chơi, và một lần bấm đưa trò chơi trở lại.
MicroPython
Chọn MicroPython (main.py) trong bảng firmware của bo mạch, và Chạy khởi động firmware MicroPython v1.29.0 chính thức cho ESP32-C3 với main.py, trên một mô hình của cả con chip được khởi động từ chính ROM của Espressif. machine.Pin, PWM,
ADC, I2C, SPI, UART(1) và neopixel làm việc, và network.WLAN tham gia mạng mô phỏng. Xem
MicroPython trên ESP32.
Ở nơi khác
- Trang bo mạch: /boards/esp32-c3
- Tài liệu đặc tả: mô hình ESP32-C3
- Lộ trình học: Embedded on the ESP32-C3, tại /learn
- Cùng con chip trên các bo mạch nhỏ hơn: XIAO ESP32-C3 và ESP32-C3 SuperMini
- Bo mạch RISC-V mới hơn: ESP32-C6