Bo mạch

LilyGO TTGO T-Display

Một ESP32 kinh điển với màn hình màu ST7789 1,14 inch 135x240 trên các đường SPI riêng, và hai nút nhấn, ở GPIO 0 và GPIO 35.

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, on a black board 51.5 by 25 mm with the screen filling the middle. Two twelve-pin rows run down the long edges, 0.9 inch apart, so it straddles a breadboard with one row free on each side. A USB-C socket goes to UART0, which is the serial monitor, and a small JST socket takes a LiPo cell.

Màn hình và cả hai nút nhấn đều được nối dây bên trong bo mạch, giống như trên bo thật, nên sketch đầu tiên không cần linh kiện nào khác. Bo mạch không có LED cho người dùng.

Các chân

Các con số in trên silkscreen là số GPIO. Từ trên xuống dưới như trong hình vẽ, với màn hình hướng về phía bạn và ổ cắm USB-C ở dưới:

Trái Phải
GND 3V3
GND 36
21 37
22 38
17 39
2 32
15 33
13 25
12 26
GND 27
GND GND
3V3 5V

36, 37, 38 và 39 chỉ là các chân vào, không có điện trở kéo lên hay kéo xuống riêng. Wire dùng 21 cho SDA và 22 cho SCL. Không có chân TX hay RX: GPIO 1 và 3 chỉ nối tới chip USB. Cũng không có chân EN. 5V là đường nguồn USB.

2, 12 và 15 là các chân strapping trên chip. Mokxi không mô phỏng strapping, nên bo mạch khởi động bất kể gì được nối ở đó; trên bàn thật, một điện trở kéo lên ở 12 sẽ chặn việc khởi động.

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

Các chân này đã được nối với linh kiện trên bo mạch và không dây nào nối tới được.

GPIO Nối tới đâu
19 MOSI màn hình
18 SCLK màn hình
5 CS màn hình
16 DC màn hình
23 Chân reset màn hình
4 Đèn nền màn hình
35 BUTTON1, có điện trở kéo lên trên bo mạch
0 BUTTON2, chính là BOOT
34 Mạch chia áp pin (không được mô phỏng)
14 Đóng ngắt mạch chia áp pin (không được mô phỏng)

SPI.begin() không tham số sẽ dùng 18, 19, 23 và 5, trên bo mạch này chính là các đường của màn hình. Để dùng thiết bị SPI thứ hai, hãy nêu các chân còn trống: SPI.begin(sck, miso, mosi, ss).

The screen

Màn hình là linh kiện ST7789 với kích thước 135x240. ST7789 có bộ nhớ 240 x 320 điểm ảnh, và tấm kính này là một cửa sổ vào bộ nhớ đó, tính từ cột 52 và hàng 40, nên driver phải cộng thêm các offset này nếu không sẽ vẽ ra chỗ không ai nhìn thấy. Tấm kính là loại IPS và hiển thị màu của controller bị đảo cho đến khi driver gửi lệnh INVON. TFT_eSPI làm cả hai việc, như mọi driver ST7789 khác. Driver tự viết mà bỏ sót INVON sẽ cho ra ảnh âm bản, ở đây cũng như trên bo mạch thật.

Sketch cho bo mạch này không cần User_Setup.h ở đây. LilyGO cung cấp sẵn một thiết lập TFT_eSPI cho bo mạch, Setup25_TTGO_T_Display.h, và Mokxi đã tích hợp sẵn. Nếu sketch không nêu chân TFT nào, TFT_eSPI sẽ lấy các chân của bo mạch:

#define ST7789_DRIVER
#define TFT_WIDTH 135
#define TFT_HEIGHT 240
#define CGRAM_OFFSET
#define TFT_MOSI 19
#define TFT_SCLK 18
#define TFT_CS 5
#define TFT_DC 16
#define TFT_RST 23
#define TFT_BL 4
#define TFT_BACKLIGHT_ON HIGH

Trên bo mạch thật, bạn cài thiết lập đó vào thư mục thư viện TFT_eSPI: trong User_Setup_Select.h, chú thích dòng mặc định và dùng Setup25_TTGO_T_Display.h. Sketch tự nêu chân của mình thì vẫn giữ nguyên các chân đó.

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
  tft.init();
  tft.setRotation(1); // landscape, 240 wide
  tft.fillScreen(TFT_BLACK);
  tft.drawString("T-Display", 20, 20, 4);
}

Đèn nền nối với GPIO 4, và init() của TFT_eSPI sẽ bật đèn, giống như bản gốc. Kéo chân này LOW thì hình ảnh tắt hẳn. Màn hình không đọc ngược được dữ liệu: readPixel() trên màn hình trả về màu đen.

The buttons

Cả hai nút nhấn đều kéo chân của nó xuống LOW khi được nhấn. Nhấn một trong hai nút ngay trên hình vẽ trong khi mạch đang chạy để giữ nút ở trạng thái nhấn.

  • BUTTON1, nút bên phải, là GPIO 35. GPIO 35 chỉ là chân vào và không có điện trở kéo riêng, nên bo mạch có sẵn một điện trở kéo lên, được mô phỏng là 100 k. Dùng pinMode(35, INPUT) là đủ.
  • BUTTON2, nút bên trái, là GPIO 0, cũng chính là BOOT. Dùng pinMode(0, INPUT_PULLUP).

Bộ thực thi đặt tên các nút này giống như biến thể lilygo_t_display của arduino-esp32: LEFT_BUTTON là 0 và RIGHT_BUTTON là 35. Không có LED_BUILTIN, giống như trong biến thể đó.

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ẫu DevKit V1, toàn bộ: một nhân Xtensa LX6, GPIO, UART0, các timer, ADC1 và LEDC PWM. Màn hình là linh kiện ST7789 ở độ phân giải 135x240, với offset cửa sổ và kính đảo màu của nó, trên các GPIO mà bo mạch nối tới. BUTTON1 là nút nhấn có điện trở pull-up 100 k, còn BUTTON2 là BOOT của bo mạch. Bo mạch mang chuỗi chương trình riêng của nó, nên có các ví dụ riêng, và TFT_eSPI dùng cấu hình của LilyGO. Sketch được biên dịch trong tab.

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

  • The battery connector and its charger.
  • The battery divider on GPIO 34, switched by GPIO 14.
  • Đọc ngược màn hình: nó trả về màu đen.
  • The second core, ADC2, the DAC, touch sensing and a real radio. Bluetooth Classic and LE are được mô phỏng, như trên DevKit V1.

Dự án khởi động

T-Display hello viết lên màn hình bằng TFT_eSPI và đếm số lần nhấn của hai nút.

Ở nơi khác