Komponen

Komponen yang menyusun game

Sebuah layar, sesuatu untuk dipegang, dan lima game di galeri yang menggabungkan semuanya.

Game adalah bagian Mokxi yang terus dikunjungi orang, jadi empat komponen patut kamu kenal baik: OLED kecil, thumb stick, rotary encoder dan cincin LED addressable. Halaman ini berisi apa yang dilakukan masing-masing, apa yang harus dilakukan firmware untuk menggerakkannya, dan contoh mana yang harus dibuka untuk melihatnya bekerja.

OLED SSD1306, 128x64

Layar kecil biru-putih yang ada di setiap kit hobi. Dua kabel dan daya: ini adalah slave I2C di alamat 0x3c, dan ia juga menyetujui 0x3d kalau kamu mengatur propertinya begitu.

Komponen ini memodelkan set perintah yang benar-benar dikirim library umum (nyala dan mati tampilan, mode pengalamatan, jendela kolom dan halaman, kontras, segment remap, arah scan COM dan charge pump) serta pengalamatan halaman dan horizontal, jadi driver yang ditulis untuk panel asli bekerja di sini tanpa perubahan. Yang kamu lihat di kanvas adalah RAM grafis panel itu sendiri, digambar piksel demi piksel.

Tidak ada periferal I2C di Uno maupun ESP32-C3 di Mokxi, jadi busnya di-bit-bang: mokxi_i2c.h menarik dua jalur ke bawah dan melepaskannya, dan pull-up 4k7 milik modul menariknya naik kembali. Dua pin apa pun bisa dipakai, karena itulah contohnya memakai dua pin yang semua orang harapkan.

Satu frame monokrom 128x64 adalah 1024 byte. Di ESP32-C3 itu bukan apa-apa; di Uno itu setengah memori chip, dan mengirim semuanya lewat bus software memakan sepertiga detik. Karena itu driver hanya mengirim blok delapan kolom dari setiap halaman yang berubah, dan karena itulah game di panel ini menghapus bola di posisi lama dan menggambarnya di posisi baru alih-alih mengecat ulang.

Lihat: OLED dice (ESP32-C3), OLED pong (Uno) dan OLED pong on an ESP32-C3.

Thumb stick

Dua potensiometer 10 k dan sebuah saklar tekan: modul KY-023 dan klon-klonnya. Seret topi hitamnya di kanvas dan kedua sumbu ikut bergerak; lepaskan dan ia melenting kembali ke tengah, seperti benda aslinya. Klik atau tahan topinya untuk menekan stik lurus ke bawah, yang menyambung singkat SW ke ground.

Setiap sumbu adalah pembagi tegangan sungguhan di antara apa pun yang ada di VCC dan GND, dengan impedansi jalurnya sendiri di belakang wiper, jadi input ADC yang diberi beban akan melihat apa yang akan dilihatnya di meja kerja.

Stik jempol butuh ADC, dan kedua board punya satu. Punya Uno adalah konverter sepuluh bit milik ATmega328P pada A0 sampai A5; punya ESP32-C3 adalah ADC1, dua belas bit, pada GPIO 0 sampai GPIO 4. Jadi stik bisa dipakai di keduanya, satu sumbu terbaca 0 sampai 1023 di yang satu dan 0 sampai 4095 di yang lain, dan mokxi_joystick.h di firmware library menyembunyikan perbedaannya.

Lihat: OLED pong (Uno), OLED pong on an ESP32-C3, ESP32-C3 thumb stick dan Snake on two matrices.

Rotary encoder (KY-040)

Sebuah poros yang menghitung klik ke dua arah, dengan saklar di bawahnya. Tiga kontak ke ground: CLK dan DT adalah dua bagian dari encoder kuadratur dan SW adalah tombol tekannya. Modul ini membawa pull-up 10 k pada pasangan kuadratur; SW tidak punya, makanya setiap sketch membacanya dengan INPUT_PULLUP.

Tiga cara memutarnya di kanvas:

  • seret mengelilingi knob: arah pointer terhadap poros adalah sudut porosnya;
  • scroll wheel di atas knob: satu takik adalah satu detent, menjauh darimu searah jarum jam;
  • seret naik dan turun: untuk layar sentuh, dan untuk seretan yang dimulai di poros itu sendiri di mana arah tidak berarti apa-apa.

Memutarnya tidak melompatkan pin dari satu keadaan ke berikutnya. Satu klik adalah empat langkah seperempat, dimainkan delapan milidetik berselang, jadi firmware yang melakukan polling dalam loop melihat urutannya seperti di meja kerja. Dan kontaknya chatter, sekali per langkah seperempat, karena itulah pelajarannya: sketch yang mengawasi falling edge di CLK menghitung tiga klik untuk satu. Matikan chatter di properti kalau encodernya bukan pokok bahasannya.

mokxi_rotary.h melakukannya dengan cara yang benar, dengan tabel keadaan enam belas entri: satu transisi bernilai +1, -1, atau tidak sama sekali ketika pasangan itu melompat dua keadaan sekaligus, seperti tampilan sebuah bounce. Klik dilaporkan ketika empat langkah seperempat sudah terkumpul dan poros kembali di detent.

Lihat: Ring Simon.

Ring dan strip 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 memilih gambarnya. strip adalah satu baris, matrix selebar enam belas, dan ring melengkungkan baris jadi lingkaran, LED 0 di jam dua belas dan sisanya searah jarum jam, sesuai penomoran ring yang dijual orang. Ring secara listrik adalah strip, jadi tidak ada yang berubah soal kabel atau firmwarenya; hanya gambarnya.

Drivernya, mokxi_ws2812.h, membuat pulsa dengan loop terhitung alih-alih timer, karena SYSTIMER milik ESP32-C3 berdetak pada 16 MHz dan membacanya butuh waktu lebih lama daripada pulsa yang diukur. Ini header untuk ESP32-C3: pada 16 MHz sebuah Uno punya dua puluh siklus untuk satu bit utuh dan enam setengah untuk pulsa pertama, yang tidak bisa digitalWrite lakukan tanpa sehelaian assembly tulisan tangan.

Lihat: Ring Simon dan Strip pelangi.

Lima gim

Buka salah satunya dari menu Examples, atau dari template di situs.

Gim Board Layar Input
OLED pong Uno SSD1306 stik jempol
OLED pong on an ESP32-C3 ESP32-C3 SSD1306 stik jempol
Snake on two matrices Uno dua MAX7219 stik jempol
Ring Simon ESP32-C3 ring WS2812 rotary encoder
OLED dice ESP32-C3 SSD1306 tombol arcade

Kedua pong adalah rangkaian yang sama di dua board, cara tersingkat untuk melihat apa yang berubah dan apa yang tidak saat board berganti.

Masing-masing adalah firmware asli yang dikompilasi untuk board yang disebutkan, berjalan di core yang sama dengan semua yang lain di sini. Tekan Jalankan, lalu kendalikan inputnya dengan pointer: seret tombol atas stiknya, putar knob encodernya, tahan tombolnya.

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