SRGBmods QMK Firmware

Unduhan Firmware

Berkat tim moderator kami, sebagian besar keyboard yang didukung oleh QMK kini tersedia untuk komunitas sebagai firmware yang sudah dikompilasi. (Dukungan RGB Matrix QMK diperlukan agar keyboard dapat didukung). Kode sumber GPL untuk membuat firmware ini dapat ditemukan di sini.

File firmware dapat ditemukan di sini.

Kami merekomendasikan Anda mencoba versi VIA terlebih dahulu karena itu akan memungkinkan Anda memperbaiki masalah key mapping apa pun.

(Pastikan untuk mencadangkan layout Anda saat ini dengan VIA sebelum flashing agar Anda dapat memulihkannya setelahnya!)

Petunjuk untuk mem-flash firmware biasanya disediakan oleh produsen keyboard Anda. Jika petunjuk melibatkan penggunaan QMK Toolbox, pastikan untuk menjalankan QMK Toolbox sebagai admin dan untuk menginstal driver di dalam QMK Toolbox!

Anda juga dapat meminta bantuan di channel QMK pada Discord ini. (Harap hanya tanya di Discord yang tertaut, bertanya di Discord QMK utama akan membuat Anda mendapat respons untuk bertanya kepada kami! - Yang jelas membuat frustrasi…)

Setelah Anda selesai mem-flash keyboard, baca panduan di bawah untuk memulai membuat plugin keyboard.

Repositori Add-on Plugin QMK SRGBmods

Berkat SignalRGB 2.3.20 dan yang lebih baru, repositori add-on Plugin QMK diaktifkan secara default. Oleh karena itu ada beberapa cabang dalam pengaturan add-on ini yang mungkin mengaktifkan dukungan untuk keyboard Anda. Di dalam SignalRGB pergi ke pengaturan / Add-on Settings / QMK-Plugins:

Main dipilih secara default dan mencakup plugin yang diketahui berfungsi dengan baik; sisanya menjelaskan apa adanya… Jika Anda tidak dapat membuat keyboard berfungsi setelah memilih salah satu cabang, Anda mungkin perlu membuat plugin pengguna. Petunjuknya ada di bawah:

Pembuatan Plugin Pengguna

Setelah mem-flash keyboard Anda, Anda perlu memodifikasi plugin keyboard di bawah ini agar SignalRGB berfungsi dengan keyboard Anda.

Contoh Plugin Keyboard dapat diunduh di sini: QMK_Keyboard_Example.js
Template Plugin tambahan dapat diunduh (Full, TKL, 96%, 75%, 65%, 64%, 60%, dll) di sini.
Setelah mengunduh plugin keyboard dari salah satu di atas, buka di editor teks.

export function Name() { return "QMK Keyboard"; }
export function VendorId() { return 0x0000; }
export function ProductId() { return 0x0000; }
export function Publisher() { return "WhirlwindFX"; }
export function Size() { return [21, 6]; }
export function DefaultPosition(){return [10, 100]; }
export function DefaultScale(){return 8.0}
export function ControllableParameters() {
  return [
    {"property":"shutdownColor", "group":"lighting", "label":"Shutdown Color", "min":"0", "max":"360", "type":"color", "default":"009bde"},
    {"property":"LightingMode", "group":"lighting", "label":"Lighting Mode", "type":"combobox", "values":["Canvas", "Forced"], "default":"Canvas"},
    {"property":"forcedColor", "group":"lighting", "label":"Forced Color", "min":"0", "max":"360", "type":"color", "default":"009bde"},
  ];
}

Setelah membuka plugin keyboard, Anda akan disajikan dengan layar yang mirip dengan yang di atas.

Anda perlu mengisi beberapa field ini, dimulai dengan field Name.
Field name perlu diisi dengan nama keyboard yang Anda kembangkan firmware-nya.

export function Name() { return "Massdrop CTRL QMK Keyboard"; }

Selanjutnya, kita perlu mengisi VendorId untuk keyboard. (Cuplikan layar berikut dua yang terakhir dapat dilewati dengan tautan ini.)

Untuk menemukan VendorId keyboard, buka SignalRGB.
Kemudian klik roda gigi pengaturan di sudut kiri bawah.

Kemudian, klik Device Information.

Temukan keyboard Anda dan catat VendorID dan ProductID-nya.

Sekarang isi field VendorId dan ProductId dengan nilai-nilai ini.

export function Name() { return "Massdrop CTRL QMK Keyboard"; }
export function VendorId() { return 0x04d8; }
export function ProductId() { return 0xEED2; }

Field berikutnya yang perlu diisi adalah field Publisher. Di field publisher, Anda dapat memasukkan nama, username, atau handle Anda.

export function Name() { return "Massdrop CTRL QMK Keyboard"; }
export function VendorId() { return 0x04d8; }
export function ProductId() { return 0xEED2; }
export function Publisher() { return "WhirlwindFX"; }

Sekarang, kami selesai mengisi field, dan beralih ke array.

Ada 3 array yang perlu dimodifikasi: vKeys, vKeynames, dan vKeyPositions

Array vKeys memetakan setiap tombol keyboard ke posisinya dalam Data RGB yang dikirim ke keyboard.
Array vKeyNames memberi tahu kami tombol mana yang sesuai dengan setiap vKey dan vKeyPosition.
Array vKeyPositions memberi tahu SignalRGB di mana setiap tombol pada keyboard berada dari segi posisi.
Pertama, ubah array vKeyNames untuk mencerminkan keyboard Anda.
Ini berarti Anda perlu mengatur ulang vKeyNames agar sesuai dengan keyboard Anda.
- Dalam kasus kami, kami harus menghapus tombol dan mengatur ulang yang tersisa karena board kami adalah board TKL.

Kemudian perbarui array vKeyPositions dengan cara yang sama seperti array vKeyNames diperbarui.

Akhirnya, perbarui array vKeys agar sesuai dengan array vKeyNames dan vKeysPositions.

Sekarang, simpan file plugin Anda ke %userprofile%/Documents/WhirlwindFX/plugins, kemudian restart SignalRGB.

Keyboard Anda seharusnya mulai menyala dan bereaksi dengan SignalRGB.

Jika Keyboard Tidak Menyala atau Tidak Bereaksi dengan Benar terhadap SignalRGB:

Pergi ke halaman Devices di SignalRGB.

Selanjutnya, pergi ke keyboard Anda, kemudian klik pada roda gigi pengaturan.

Kemudian, klik toggle Show Console.

Seharusnya ada Device Total LED Count di konsol. Bandingkan Device Total LED Count tersebut dengan jumlah LED yang telah Anda tetapkan.
- Dalam kasus kami, ada 119 Total LED.

Jika Jumlah LED Cocok dengan Jumlah vKeys yang Anda Miliki:

Pastikan bahwa field size plugin Anda lebih besar 1 di setiap arah dari Koordinat LED tertinggi Anda:
- Dalam kasus kami, LED paling jauh ada di posisi [17,6], oleh karena itu field Size kami harus [18,7].

export function Size() { return [18, 7]; }

Jika Jumlah LED Tidak Cocok dengan Jumlah vKeys yang Anda Miliki:

Anda perlu menambahkan vKeys, vKeyPositions, dan vKeyNames agar sesuai dengan jumlah Total LED.
- Dalam kasus kami, perangkat memiliki 119 LED, jadi kami perlu menambahkan 32 LED untuk underglow keyboard.

Jika jumlah vKeys cocok dengan jumlah Total LED dan perangkat berukuran dengan benar, tetapi LED dipetakan dengan tidak benar:
Bergabunglah dengan discord dan minta bantuan di channel QMK.