Bo mạch

Cheap Yellow Display

Sunton ESP32-2432S028R: một ESP32 kinh điển phía sau màn hình cảm ứng ILI9341 2,8 inch 240x320, và một LED RGB sáng khi các chân của nó ở mức LOW.

Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch.

Đây là gì

The same classic ESP32 as ESP32 DevKit V1, trên mặt sau của một bo mạch vàng mà phần lớn là màn hình. Màn hình là ILI9341, 240 nhân 320 điểm ảnh, phía trên là phim cảm ứng điện trở XPT2046. Một ổ cắm USB đi qua CH340 tới UART0, chính là serial monitor.

Mọi thứ mà một sketch đầu tiên cần đều có trên bo mạch, nên một dự án CYD thường không cần linh kiện hay dây nối nào khác. Màn hình, bộ điều khiển cảm ứng và LED RGB được nối bên trong bo mạch, như trên bo thật. Chỉ các ổ cắm JST mới dùng dây.

Trên bo thật, màn hình nằm ngang trên bo đặt ngang. Bản vẽ ở đây dựng bo đứng dọc, theo chiều dọc, để nằm gọn cạnh breadboard. Xoay linh kiện để đặt nó nằm ngang.

The connectors

Ba ổ cắm JST, vẽ dọc theo cạnh trái. Chân của chúng được đặt tên như bản vẽ bo mạch của Wokwi đặt tên, nên dự án nhập vào giữ nguyên các dây nối.

Ổ cắm Pin GPIO Ghi chú
P1 VIN - 5 V từ USB khi bo mạch đang cắm
P1 TX 1 UART0 TX, cũng trên CH340
P1 RX 3 UART0 RX, cũng trên CH340
P1 GND - GND
P3 GND - GND
P3 IO35 35 Chỉ nhập, ADC1
P3 IO22 22 SCL của I2C mặc định
P3 IO21 21 Đèn nền màn hình, và SDA của I2C mặc định
CN1 GND - GND
CN1 IO27 27 Một GPIO tự do
CN1 3V3 - 3.3 V từ bộ ổn áp

Trên bo thật, CN1 còn có IO22, cùng đường mạch với chân P3. Ở đây, như bản vẽ của Wokwi, IO22 chỉ nằm trên P3, còn CN1 là GND, IO27 và 3V3.

Không có chân EN hay RST trên ổ cắm nào: reset là nút RST. IO35 chỉ là chân đầu vào, không có điện trở kéo lên hay kéo xuống riêng.

Các GPIO bên trong bo mạch

Chúng được nối tới các linh kiện trên bo mạch và không dây nào với tới. Chúng được liệt kê để sketch lấy từ hướng dẫn có ý nghĩa.

GPIO Nối tới đâu
2 DC màn hình
12 MISO màn hình
13 MOSI màn hình
14 SCK màn hình
15 CS màn hình
21 Đèn nền màn hình (cũng trên P3)
EN Reset màn hình: reset của bo mạch cũng reset tấm màn
25 CLK cảm ứng
32 DIN cảm ứng (MOSI)
39 DO cảm ứng (MISO), chỉ nhập
33 CS cảm ứng
36 IRQ cảm ứng, chỉ nhập, mức thấp khi phim bị nhấn
4 LED RGB, đỏ, sáng mức LOW
16 LED RGB, xanh lá, sáng mức LOW
17 LED RGB, màu xanh dương, sáng khi ở mức LOW
0 Nút BOOT
34 Cảm biến ánh sáng (chưa được mô phỏng)
26 Bộ khuếch đại loa (chưa được mô phỏng)
5, 18, 19, 23 Khe cắm microSD trên VSPI (chưa được mô phỏng)

Runtime cung cấp cho sketch các tên của arduino-esp32 cho jczn_2432s028r: CYD_TFT_MOSI là 13, CYD_TP_CS là 33, CYD_LED_RED là 4, v.v., cùng với CYD_LED_RED_ON() và các hàm còn lại cho LED. Không có LED_BUILTIN, giống như trong biến thể đó.

The screen

Màn hình là linh kiện ILI9341, trên HSPI: MOSI 13, MISO 12, SCK 14, CS 15 và DC 2. Chân reset của nó chính là chân reset của bo mạch, nên trình điều khiển nhận -1 cho chân này.

S sketch cho bo mạch này không cần User_Setup.h ở đây. Các hướng dẫn CYD cài đặt một User_Setup.h cho TFT_eSPI rồi không khai báo chân nào trong sketch. Mokxi đã tích hợp sẵn cấu hình đó. Nếu sketch không khai báo chân TFT nào, TFT_eSPI sẽ dùng cấu hình của bo mạch:

#define ILI9341_2_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
#define TFT_MISO 12
#define TFT_MOSI 13
#define TFT_SCLK 14
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST -1
#define TFT_BL 21
#define TFT_BACKLIGHT_ON HIGH

Trên bo mạch thật, bạn cài đặt cùng một cấu hình vào thư mục thư viện TFT_eSPI, như các hướng dẫn nói. Sketch tự khai báo chân riêng thì giữ nguyên các chân đó, như với bất kỳ User_Setup.h nào.

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
  tft.init();
  tft.setRotation(1); // landscape
  tft.fillScreen(TFT_BLACK);
  tft.drawCentreString("Hello, CYD!", 160, 30, 4);
}

Đèn nền nằm trên GPIO 21. Hàm init() của TFT_eSPI bật đèn nền, giống như bản gốc. Ở đây đèn nền sáng trừ khi GPIO 21 bị kéo LOW, nên một chân chưa ai đụng đến sẽ để đèn sáng. Trên bo mạch thật, transistor cần chân ở mức HIGH, vì vậy hãy tự đặt HIGH nếu sketch của bạn không dùng TFT_eSPI. Nó chỉ bật hoặc tắt: không thể điều chỉnh độ sáng bằng PWM.

Màn hình không đọc ngược được. readPixel() và readRect() trên màn hình trả về màu đen, vì không có gì trả lời qua MISO.

The touch film

Để chạm vào màn hình, hãy nhấn vào nó khi mạch đang chạy, và kéo để di chuyển ngón tay. Buông tay thì ngón tay cũng nhấc lên.

XPT2046 không nằm trên bus của màn hình. Bo mạch nối nó với GPIO 25 (CLK), 32 (DIN), 39 (DO) và 33 (CS), với IRQ trên 36, nên nó có một bus SPI riêng, giống cách các hướng dẫn CYD làm:

#include <SPI.h>
#include <XPT2046_Touchscreen.h>

SPIClass touchscreenSPI = SPIClass(VSPI);
XPT2046_Touchscreen touchscreen(33, 36); // CS, IRQ

void setup() {
  touchscreenSPI.begin(25, 39, 32, 33); // CLK, MISO, MOSI, CS
  touchscreen.begin(touchscreenSPI);
  touchscreen.setRotation(1);
}

Số đọc là của touch TFT: mười hai bit tại vị trí ngón tay trên mặt kính. Các mép đọc khoảng 200 và 3900, không phải 0 và 4095, nên hãy dùng map() để quy đổi ra pixel.

LED RGB và các nút nhấn

LED RGB là ba LED nối từ 3.3 V đến GPIO 4 (đỏ), 16 (xanh lá) và 17 (xanh dương), nên mỗi màu sáng khi chân của nó ở mức LOW và tắt khi ở mức HIGH. Bật hai hoặc ba màu cùng lúc để pha trộn chúng.

BOOT là GPIO 0 và RST là chân reset của chip, nó reset cả màn hình. Cả hai nằm dưới màn hình trong hình vẽ: nhấn giữ một nút khi mạch đang chạy.

I2C trên các chân kết nối

Wire.begin() đặt SDA trên 21 và SCL trên 22, như trên DevKit V1. Trên bo mạch này 21 cũng là đèn nền, nên tín hiệu I2C trên đó làm màn hình nhấp nháy. Các hướng dẫn CYD dùng IO27 và IO22 thay thế:

Wire.begin(27, 22); // SDA on CN1, SCL on P3

WiFi

Nó tham gia vào mạng mô phỏng của Mokxi, với tên mạng và mật khẩu là thuộc tính của bo mạch. Không có radio, không có 802.11 và không có internet thật: Simulated WiFi cho biết điều gì trung thực và điều gì không.

What is modeled

Chip của mô hình DevKit V1, trọn vẹn: một nhân Xtensa LX6, GPIO, UART0, các bộ định thời, ADC1 và PWM LEDC. Màn hình là linh kiện ILI9341 và lớp cảm ứng là XPT2046 của linh kiện touch TFT, mỗi cái trên các GPIO mà bo mạch nối vào. LED RGB sáng trên hình vẽ. Bo mạch mang chuỗi chương trình riêng, nên nó có các ví dụ riêng, và TFT_eSPI dùng cấu hình của bo mạch. Sketch được biên dịch trong thẻ.

Những gì không được mô hình hóa

  • Cảm biến ánh sáng trên GPIO 34.
  • Bộ khuếch đại loa trên GPIO 26, và chân kết nối của nó.
  • Khe cắm microSD trên VSPI (GPIO 5, 18, 19 và 23).
  • IO22 thứ hai của CN1: ở đây IO22 chỉ nằm trên P3.
  • Đọc ngược màn hình: nó trả về màu đen.
  • The second core, ADC2, the DAC, touch sensing on the chip's own pins and a real radio. Bluetooth Classic and LE are được mô phỏng, như trên DevKit V1.

Dự án khởi đầu

CYD hello vẽ lời chào và ba khối màu bằng TFT_eSPI, và chuyển LED RGB qua đỏ, xanh lá và xanh dương.

CYD touch paint vẽ ở nơi bạn nhấn trên màn hình. Chạm vào các màu dọc mép trên để đổi màu vẽ, hoặc "clear" để xóa hết.

Ở nơi khác