Belajar

Buat prototipe matriks keyboard kustom-mu sebelum kamu menyolder

Mahir

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Pro Micro: matriks 4 x 3 dengan diodalive0.000 s 0.00x
Tekan Jalankan, lalu klik tombolnya
Klik tombolnya, tahan tombol kiri bawah untuk NAV, putar knopnya. Serial Monitor menampilkan setiap laporan [Keyboard] dan [Mouse].

Setiap keyboard kustom, dari macropad tiga tombol sampai board ergonomis split, dimulai dari rangkaian yang sama: kisi saklar, sebuah dioda di tiap saklar, dan controller yang memindai kisi itu ratusan kali per detik. Kalau matriksnya benar, sisanya hanya urusan konfigurasi. Kalau satu dioda terbalik atau satu baris salah pin, kamu baru tahu setelah seharian menyolder.

Numpad di atas adalah matriks lengkap untuk mencobanya: dua belas saklar dalam empat baris dan tiga kolom, satu 1N4148 di setiap tombol, satu rotary encoder, strip LED RGB per tombol, dan sebuah Pro Micro. Tekan tombolnya saat berjalan dan Serial Monitor menampilkan apa yang akan diketik keyboard itu, layer demi layer.

Dua hal yang perlu kamu tahu. Mokxi tidak mensimulasikan koneksi USB ke komputer, jadi library Keyboard mencetak setiap laporan sebagai baris [Keyboard], bukan mengetik. Dan firmware-nya adalah sketch yang mudah dibaca, bukan QMK atau KMK. Ia melakukan pekerjaan inti yang sama, pemindaian, debounce, layer, encoder, dan pencahayaan, jadi kamu bisa menguji layout dan rencana kabel, lalu membawanya ke firmware yang benar-benar akan kamu flash.

Mau versi langkah demi langkah? Pelajaran "Baris, kolom, dan pemindaian" membahas ini lengkap dengan checkpoint.

Buka pelajaran

Kenapa keyboard berupa matriks

Satu pin per tombol cepat habis: board ortholinear 48 tombol butuh 48 pin, padahal Pro Micro cuma punya 18. Matriks menempatkan setiap tombol di tempat kabel baris bersilangan dengan kabel kolom, jadi pin yang dibutuhkan adalah baris ditambah kolom. Empat baris kali tiga kolom berarti 12 tombol di 7 pin; empat kali dua belas berarti 48 tombol di 16 pin.

Untuk membacanya, firmware menggerakkan satu baris ke LOW, membiarkan baris lain mengambang, dan membaca setiap kolom dengan pull-up aktif. Kolom yang terbaca LOW berarti ada tombol yang ditekan di baris itu. Lalu ia pindah ke baris berikutnya, dan satu putaran penuh grid selesai jauh di bawah satu milidetik.

Ghosting, dan dioda di setiap tombol

Tanpa dioda, tahan tiga tombol di sudut sebuah persegi panjang dan sudut keempat akan terbaca seolah ditekan juga: arus menemukan jalan memutar melalui tiga saklar yang tertutup. Itulah ghosting. Pelajarannya ada keypad membran tanpa dioda di mana kamu bisa membuat hal ini terjadi, dan melihat bahwa firmware tidak bisa membedakan ghost dari tekanan sungguhan.

Dioda yang dipasang seri dengan tiap tombol memblokir jalur balik, jadi setiap tombol terbaca benar berapa pun banyaknya yang ditahan. Arahnya penting. Dengan baris diberi LOW dan kolom dipull-up, arus mengalir dari kolom ke baris, jadi pita dioda, katoda, menghadap baris. QMK menyebut ini COL2ROW, dan dokumentasinya mengatakan hal yang sama: tanda hitam menghadap baris, di antara saklar dan baris.

Dengan dioda, matriks itu sendiri tidak punya batas rollover. Laporan USB bisa punya: laporan keyboard boot standar, yang dikirim library Keyboard Arduino, hanya menampung enam tombol sekaligus.

Merangkai matriks di breadboard

Template memakai satu breadboard setengah ukuran per baris tombol, ditumpuk seperti barisan keyboard. Setiap saklar mengangkangi jalur tengah breadboard-nya, jadi kaki kirinya menghubungkan strip di atas jalur ke strip di bawahnya: sepasang strip itulah kolom tombol, dan jumper membawanya turun ke board berikutnya. Kaki kanan saklar lewat dioda ke strip baris, dan jumper pendek menyatukan strip baris sebuah board menjadi satu baris. Kolom terbaca sebagai garis lurus ke bawah tumpukan dan baris sebagai garis di sepanjang tiap board.

Pada rakitan handwired, rangkaian yang sama berupa kabel telanjang: kabel kolom di satu kaki tiap saklar, dan kaki dioda ditekuk sepanjang tiap baris membentuk kabel baris.

Layer, encoder, dan RGB per tombol

Keymap adalah tabel per layer, disusun sesuai posisi tombolnya. MO(NAV) menahan sebuah layer selama tombolnya ditekan, TG mengubah statusnya, dan tombol transparan jatuh ke layer di bawahnya, dengan layer aktif tertinggi yang menang, sama seperti cara QMK menyelesaikan layer. Sketch menentukan setiap tombol saat ditekan dan mempertahankannya sampai dilepas, jadi melepas tombol layer lebih dulu tidak akan membuat tombol lain nyangkut.

Encoder melakukan hal berbeda di tiap layer: roda mouse di layer dasar, panah di NAV, undo dan redo di EDIT, seperti encoder map di QMK. LED-nya satu WS2812B per tombol sesuai urutan baca, masing-masing berwarna layer-nya, berkedip saat tombolnya ditekan.

Sebuah layer, dari template
{  // NAV, held on the bottom-left key
  {KEY_HOME, KEY_UP_ARROW, KEY_PAGE_UP},
  {KEY_LEFT_ARROW, KEY_ESC, KEY_RIGHT_ARROW},
  {KEY_END, KEY_DOWN_ARROW, KEY_PAGE_DOWN},
  {____, KEY_BACKSPACE, TG(EDIT)},
},

Melanjutkan ke QMK, KMK, dan board split

Saat layout dan kabelnya sudah beres di sini, tuliskan ke firmware yang akan kamu flash. QMK ditulis dalam C dan berjalan di banyak mikrokontroler, termasuk ATmega32U4 di Pro Micro; KMK ditulis dalam CircuitPython untuk board seperti RP2040. Keduanya meminta fakta yang sama dengan yang baru kamu uji: pin baris dan kolom, arah dioda, layer, dan fungsi encoder.

Keyboard split adalah dua matriks, satu per sisi, dengan kedua sisi berkomunikasi lewat link serial atau I2C di kabel TRRS. Dokumentasi QMK memperingatkan untuk mencabut USB sebelum menyambung atau melepas kabel itu. Matriks tiap sisi persis rangkaian di halaman ini.

Buka rangkaian ini di editor. Pro Micro: matriks 4 x 3 dengan dioda, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah satu komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Apakah saya perlu dioda di setiap tombol?

Untuk keyboard yang beberapa tombolnya ditahan bersamaan, ya: tanpa dioda, tiga tombol di sudut persegi panjang menghasilkan ghost keempat. Macropad kecil yang hanya satu tombol ditekan dalam satu waktu boleh melewatkannya, tapi kebanyakan rakitan tetap memasangnya.

Ke arah mana dioda dipasang?

Untuk COL2ROW, yang dipakai template ini, pita (katoda) menghadap baris, di antara saklar dan kabel baris. Firmware harus diatur sesuai arah pemasangan dioda.

Apakah ini QMK?

Bukan. Ini sketch Arduino yang mudah dibaca dan melakukan pekerjaan inti yang sama: pemindaian, debounce, layer, encoder, dan pencahayaan. Pakai untuk membuktikan matriks dan layoutnya, lalu konfigurasikan QMK atau KMK untuk rakitan sungguhan.

Apakah Mokxi mengetik ke komputer saya?

Tidak. Koneksi USB tidak disimulasikan, jadi library Keyboard dan Mouse mencetak setiap laporan ke Serial Monitor. Flash sketch ke Pro Micro sungguhan dan laporan yang sama akan dikirim lewat USB.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.