Linh kiện

Những linh kiện tạo nên trò chơi

Một màn hình, một thứ để cầm, và năm trò chơi trong thư viện kết hợp chúng lại.

Trò chơi là phần khiến mọi người quay lại với Mokxi nhiều nhất, nên có bốn linh kiện đáng tìm hiểu kỹ: màn hình OLED nhỏ, cần điều khiển, bộ mã hóa quay (rotary encoder) và vòng LED địa chỉ. Trang này nói về chức năng của từng linh kiện, firmware phải làm gì để điều khiển nó, và nên mở ví dụ nào để thấy nó hoạt động.

OLED SSD1306, 128x64

Màn hình xanh trắng bé nhỏ mà bộ kit nào cũng có. Hai dây và nguồn: nó là một thiết bị tớ I2C ở địa chỉ 0x3c, và cũng trả lời ở 0x3d nếu bạn đặt thuộc tính như vậy.

Linh kiện này mô phỏng đúng bộ lệnh mà các thư viện phổ biến thực sự gửi (bật và tắt màn hình, chế độ đánh địa chỉ, cửa sổ cột và trang, độ tương phản, segment remap, chiều quét COM và charge pump) cùng cả hai chế độ đánh địa chỉ theo trang và theo ngang, nên driver viết cho màn hình thật sẽ chạy ở đây không cần sửa đổi. Những gì bạn thấy trên khung vẽ chính là RAM đồ họa của chính màn hình, được vẽ lại từng điểm ảnh.

Không có ngoại vi I2C nào trên Uno hay ESP32-C3 trong Mokxi, nên bus được điều khiển bằng phần mềm: mokxi_i2c.h kéo hai đường tín hiệu xuống thấp rồi thả ra, và điện trở kéo 4k7 của module đưa chúng trở lại mức cao. Chân nào cũng được, đó là lý do các ví dụ dùng đúng hai chân mà mọi người vẫn thường dùng.

Một khung hình đơn sắc 128x64 chiếm 1024 byte. Trên ESP32-C3 thì chẳng là gì; trên Uno thì đó là một nửa bộ nhớ của chip, và gửi toàn bộ qua bus phần mềm mất đến một phần ba giây. Vì vậy driver chỉ gửi các khối tám cột của mỗi trang đã thay đổi, và cũng vì vậy một trò chơi trên màn hình này sẽ xóa quả bóng ở vị trí cũ rồi vẽ lại ở vị trí mới thay vì vẽ lại toàn bộ.

Xem thử: Xúc xắc OLED (ESP32-C3), Pong OLED (Uno) và Pong OLED trên ESP32-C3.

Cần điều khiển

Hai chiết áp 10 k và một nút nhấn: module KY-023 và các bản sao của nó. Kéo núm đen trên khung vẽ thì cả hai trục đều di chuyển; thả ra là nó bật lại về giữa, giống như con thật. Nhấp hoặc giữ núm để đẩy cần thẳng xuống, điều này nối tắt SW xuống mass.

Mỗi trục là một mạch phân áp thật trên bất cứ gì nằm ở VCC và GND, với tổng trở của chính track nằm sau con chạy, nên một chân ADC có tải sẽ thấy đúng như trên bàn thí nghiệm.

Một cần điều khiển cần ADC, và cả hai bo mạch đều có. Của Uno là bộ chuyển đổi mười bit của ATmega328P trên A0 đến A5; của ESP32-C3 là ADC1, mười hai bit, trên GPIO 0 đến GPIO 4. Vậy là cần dùng được trên cả hai, một trục đọc từ 0 đến 1023 trên cái này và từ 0 đến 4095 trên cái kia, và mokxi_joystick.h trong thư viện firmware che đi sự khác biệt ấy.

Xem thử: OLED pong (Uno), OLED pong trên ESP32-C3, Cần điều khiển ESP32-C3 và Snake trên hai ma trận.

Encoder quay (KY-040)

Một trục đếm tiếng gạch theo cả hai chiều, với một nút nhấn bên dưới. Ba tiếp điểm xuống mass: CLK và DT là hai nửa của một encoder vuông pha, còn SW là nút nhấn. Module có điện trở kéo 10 k trên cặp vuông pha; SW thì không có, vì thế mọi sketch đều đọc chân đó bằng INPUT_PULLUP.

Ba cách để xoay nó trên khung vẽ:

  • kéo quanh núm: phương hướng của con trỏ so với trục chính là góc của trục;
  • con lăn chuột trên núm: một khấc là một điểm khấc, lăn ra xa bạn là chiều kim đồng hồ;
  • kéo lên và xuống: cho màn hình cảm ứng, và cho thao tác kéo bắt đầu ngay trên trục, nơi phương hướng không có ý nghĩa gì.

Xoay nó không làm các chân nhảy thẳng từ trạng thái này sang trạng thái kia. Một tiếng gạch là bốn bước tư, diễn ra cách nhau tám mili giây, nên firmware polling trong vòng lặp sẽ thấy đúng trình tự như trên bàn thí nghiệm. Và các tiếp điểm lại rung, mỗi bước tư một lần, vì đó chính là bài học: một sketch chỉ canh sườn xuống trên CLK sẽ đếm một tiếng gạch thành ba. Tắt hiện tượng rung trong thuộc tính khi encoder không phải là trọng tâm.

mokxi_rotary.h làm đúng cách, với bảng trạng thái mười sáu ô: mỗi chuyển dịch ghi +1, -1, hoặc không gì cả khi cặp nhảy hai trạng thái cùng lúc, trông như một cú nảy. Một tiếng gạch được báo khi bốn bước tư đã cộng đủ và trục trở lại đúng khấc.

Xem thử: Ring Simon.

Vòng và dải WS2812

Addressable RGB LEDs on one wire, with no clock: a bit is a high pulse whose length is the bit, 0.4 microseconds for a zero and 0.8 for a one, twenty-four bits an LED, green first. The part decodes those pulses off the pin's own edges with the timing tolerance a real strip has, and fifty microseconds of quiet latches the frame.

layout chọn hình vẽ. strip là một hàng, matrix rộng mười sáu LED, còn ring uốn hàng đó thành một vòng tròn, LED 0 ở vị trí mười hai giờ và các LED còn lại theo chiều kim đồng hồ, đúng cách đánh số của các vòng người ta bán. Về điện, vòng là một dải, nên dây nối và firmware không đổi gì; chỉ hình vẽ thôi.

Driver, mokxi_ws2812.h, tạo xung bằng vòng lặp đếm thay vì dùng timer, vì SYSTIMER của ESP32-C3 nhịp ở 16 MHz mà đọc nó lại lâu hơn chính xung đang đo. Đây là header cho ESP32-C3: ở 16 MHz, một Uno có hai mươi chu kỳ cho cả một bit và sáu rưỡi cho xung đầu tiên, điều mà digitalWrite không thể làm nổi nếu không viết cả trang hợp ngữ tay.

Xem thử: Ring Simon và Dải cầu vồng.

Năm trò chơi

Mở bất kỳ trò nào từ menu Examples, hoặc từ các mẫu trên trang.

Trò chơi Bo mạch Màn hình Đầu vào
OLED pong Uno SSD1306 cần điều khiển
OLED pong on an ESP32-C3 ESP32-C3 SSD1306 cần điều khiển
Snake on two matrices Uno hai MAX7219 cần điều khiển
Ring Simon ESP32-C3 vòng WS2812 encoder quay
OLED dice ESP32-C3 SSD1306 nút arcade

Hai trò pong là cùng một mạch trên hai bo mạch, đó là cách ngắn nhất để thấy bo mạch thay đổi gì và không thay đổi gì.

Mỗi trò là firmware thật được biên dịch cho đúng bo mạch mang tên nó, chạy trên cùng một nhân với mọi thứ khác ở đây. Nhấn Chạy, rồi điều khiển đầu vào bằng con trỏ: kéo núm của cần, xoay núm của encoder, giữ nút nhấn.

There is a sixth, Stacker, on two MAX7219 matrices with one button, and it plays itself until you press something.