Cách cài firmware bàn phím cơ: Hướng dẫn theo từng loại

Bài hướng dẫn này tổng hợp các phương thức phổ biến đang được dùng trên thị trường, từ QMK, UF2, ZMK đến firmware receiver 2.4G. Mỗi phần đều có điều kiện áp dụng, thao tác, dấu hiệu hoàn tất và cách xử lý khi cập nhật lỗi. Đây là hướng dẫn chọn đúng quy trình, không thay thế manual riêng của từng model.

Firmware bàn phím là gì?

Firmware là chương trình chạy bên trong controller của bàn phím. Nó xử lý ma trận phím, layer, debounce, đèn, kết nối USB, Bluetooth, 2.4G và các tính năng riêng như Rapid Trigger hoặc knob. Khi bạn nhấn một switch, firmware quyết định tín hiệu nào được gửi tới máy tính.

Firmware khác với driver cài trong hệ điều hành và cũng khác file JSON của VIA. VIA definition JSON mô tả layout, matrix và thông tin nhận diện để ứng dụng hiển thị đúng bàn phím. Load JSON không ghi lại chương trình đang chạy trong controller, còn flash firmware là thao tác thay đổi trực tiếp vùng nhớ của phần cứng.

Nếu cần tìm gói cài đặt cho một model cụ thể, bạn có thể tra cứu tại kho firmware và driver bàn phím cơ của Levi Modding. Luôn đọc phần mô tả model, revision và loại PCB trước khi tải.

Khi nào nên cập nhật firmware?

• Changelog của hãng sửa đúng lỗi bạn đang gặp, chẳng hạn mất kết nối, chatter do debounce, lỗi sleep hoặc lỗi nhận VIA.
• Hãng yêu cầu firmware tối thiểu để dùng một tính năng, configurator hoặc module mới.
• Bạn cần khôi phục firmware gốc sau khi flash nhầm hoặc bàn phím không khởi động bình thường.
• Bạn đang chủ động build keymap QMK/ZMK và hiểu rõ target phần cứng.
• Bộ phận hỗ trợ xác nhận đúng gói firmware cho serial hoặc revision của bạn.

Nếu bàn phím đang hoạt động ổn định và bản cập nhật không giải quyết nhu cầu cụ thể, không nhất thiết phải flash. Nhiều trang hỗ trợ chính hãng cũng khuyến cáo không cập nhật chỉ vì thấy có file mới. Mỗi lần ghi firmware đều có rủi ro nếu chọn sai revision hoặc làm gián đoạn nguồn.

Nhận biết loại file và phương thức cài đặt

File hoặc gói	Phương thức thường gặp	Điểm cần kiểm tra
.hex	QMK Toolbox, DFU tool hoặc CLI	MCU, bootloader, PCB solder/hotswap và revision
.bin	QMK Toolbox, updater hãng hoặc copy vào ổ USB ảo	Không suy luận công cụ chỉ từ đuôi file, phải đọc manual
.uf2	Kéo thả vào ổ USB xuất hiện khi controller ở bootloader	Đúng board, đúng nửa left/right nếu là split
.exe, .app	Updater/DFU tool do hãng cung cấp	Đúng model, hệ điều hành và thứ tự update
.zip, .rar	Gói chứa firmware, updater, changelog hoặc nhiều module	Giải nén và đọc toàn bộ hướng dẫn trước khi chạy
.json	Thường là VIA definition, keymap hoặc dữ liệu cấu hình	Không mặc định xem là firmware

Đuôi file chỉ là tín hiệu ban đầu. Cùng là .bin, một model có thể flash bằng QMK Toolbox, model khác lại yêu cầu updater riêng hoặc chép file vào ổ USB ảo. Hướng dẫn của đúng model luôn có ưu tiên cao hơn một bài hướng dẫn chung.

Checklist trước khi flash firmware

1. Khoá đúng model và revision

Đừng dừng ở tên thương mại. Hãy xác định thêm ANSI hay ISO, PCB wired hay tri-mode, hotswap hay solder, có knob/màn hình hay không và revision in trên PCB. Một bộ vỏ có thể được bán với nhiều mạch khác nhau. Nếu chưa rõ cấu trúc, bài PCB bàn phím là gì sẽ giúp bạn nhận biết controller, socket, cổng USB và các thành phần chính.

2. Tải file từ nguồn phù hợp

• Ưu tiên trang support, firmware hub hoặc repository chính thức.
• Đọc changelog và ngày phát hành. Không giả định số phiên bản cao hơn luôn phù hợp.
• Nếu hãng công bố checksum, hãy kiểm tra hash trước khi flash.
• Giữ lại firmware gốc hoặc bản đang hoạt động để phục hồi khi cần.
• Không dùng file được đổi tên, re-upload không rõ nguồn hoặc lấy từ model gần giống.

3. Chuẩn bị kết nối ổn định

• Dùng cáp USB có truyền data và cắm trực tiếp vào máy tính.
• Tránh hub lỏng, dock không ổn định hoặc cổng USB chập chờn.
• Với laptop, đảm bảo pin đủ và không để máy sleep giữa quá trình.
• Đóng VIA, web driver hoặc phần mềm khác đang giữ kết nối với thiết bị, trừ khi chính phần mềm đó thực hiện update.
• Lưu lại keymap, macro và profile nếu công cụ hỗ trợ export.

4. Biết cách vào bootloader và recovery

Bootloader là chế độ đặc biệt cho phép ghi firmware. Khi ở chế độ này, bàn phím thường không gõ được. Cách kích hoạt có thể là phím Reset trên PCB, tổ hợp phím do hãng quy định, giữ Esc hoặc phím góc trên trái khi cắm cáp, hay nhấn Reset hai lần với một số controller UF2. Không lấy hotkey của model khác để thử.

Cách 1: Cài firmware bằng QMK Toolbox

QMK Toolbox là phương thức quen thuộc cho nhiều PCB QMK dùng file .hex hoặc .bin. Công cụ chính thức hiện có bản cho Windows và macOS. Bạn nên tải từ trang phát hành QMK Toolbox, không tải bản đóng gói lại từ nguồn lạ.

Quy trình QMK Toolbox từng bước

1. Cài và mở QMK Toolbox. Trên Windows, chỉ cài driver hoặc chạy Administrator khi tài liệu của model/công cụ yêu cầu.
2. Nhấn Open và chọn đúng file firmware. Kiểm tra lại tên model, revision và keymap trong tên file.
3. Chuyển bàn phím sang wired mode nếu manual yêu cầu, sau đó đưa thiết bị vào bootloader theo đúng hướng dẫn model.
4. Quan sát console của QMK Toolbox. Khi bootloader được nhận, thường sẽ có dòng thông báo thiết bị kết nối và nút Flash khả dụng.
5. Nhấn Flash một lần. Không rút cáp, không đóng ứng dụng và không để máy sleep.
6. Chờ console hiển thị quá trình ghi, kiểm tra và thông báo thành công. Bootloader thường ngắt kết nối sau khi controller khởi động lại.
7. Rút cắm lại nếu manual yêu cầu, mở Key Tester và kiểm tra toàn bộ phím, layer, knob cùng đèn.

Thông báo màu vàng chỉ cho biết một bootloader được phát hiện, chưa chứng minh file đã đúng. Trước khi nhấn Flash, bạn vẫn phải đối chiếu target phần cứng. Nếu Toolbox không thấy thiết bị, đừng nhấn Reset liên tục; kiểm tra cáp, driver và cách vào bootloader trước.

QMK Toolbox không áp dụng cho trường hợp nào?

• Controller RP2040 hoặc board khác được nhà sản xuất hướng dẫn flash bằng UF2 mass storage.
• Firmware tri-mode chỉ được đóng gói trong updater riêng.
• Bàn phím có web launcher tự nhận model và quản lý update.
• File .bin cần copy vào ổ USB ảo thay vì gửi qua DFU.

Cách 2: Cài firmware UF2 bằng kéo thả

UF2 được thiết kế để việc flash giống thao tác chép file. Khi controller vào bootloader, hệ điều hành nhận nó như một ổ USB. Bạn copy file .uf2 vào thư mục gốc của ổ này, controller ghi firmware rồi tự khởi động lại.

1. Tải và giải nén đúng file UF2 của board hoặc nửa bàn phím cần cập nhật.
2. Vào bootloader theo manual. Một số controller dùng double-tap Reset, nhưng không xem đây là quy tắc chung.
3. Chờ một ổ USB mới xuất hiện trong File Explorer hoặc Finder.
4. Copy file .uf2 vào thư mục gốc của ổ vừa xuất hiện.
5. Chờ controller tự unmount ổ USB và khởi động lại. Việc ổ biến mất sau khi copy thường là dấu hiệu bình thường.
6. Kiểm tra bàn phím qua USB trước, sau đó mới thử Bluetooth hoặc kết nối split.

Không format ổ bootloader và không chép nhiều firmware cùng lúc. Tên ổ có thể khác theo controller, vì vậy hãy đối chiếu thời điểm ổ xuất hiện thay vì chỉ nhìn tên.

Cách 3: Cập nhật bằng web launcher chính hãng

Nhiều hãng dùng web configurator để nhận thiết bị, tải firmware phù hợp và hướng dẫn vào chế độ update ngay trong trình duyệt. Quy trình này có thể dùng WebHID, WebUSB hoặc cơ chế riêng. Chrome, Edge và Opera thường được các hãng chọn cho loại launcher này.

1. Mở đúng URL launcher từ website hãng, không vào trang có tên miền gần giống.
2. Kết nối bàn phím bằng cáp data và chọn đúng thiết bị trong cửa sổ cấp quyền.
3. Mở mục Firmware Update, đọc version hiện tại, version mới và cảnh báo.
4. Làm theo trình tự đưa thiết bị vào bootloader. Một số launcher yêu cầu giữ Esc khi rút và cắm lại cáp, sau đó chọn Match Device.
5. Nhấn Flash/Update khi launcher đã nhận đúng bootloader.
6. Giữ nguyên kết nối tới khi xuất hiện thông báo update thành công.

Web launcher tiện vì giảm nguy cơ chọn nhầm công cụ, nhưng không tự loại bỏ rủi ro sai model. Nếu trang yêu cầu tải một Toolbox hoặc driver phụ, chỉ dùng liên kết nằm trong tài liệu chính hãng và kiểm tra hệ điều hành được hỗ trợ.

Cách 4: Updater hoặc DFU tool riêng của hãng

Một số bàn phím đi kèm chương trình .exe hoặc .app có nút Start, Update, Manual Download hoặc Upgrade. Tool có thể chứa sẵn firmware, nhận một file rời, cài driver bootloader hoặc cập nhật nhiều thành phần theo thứ tự.

1. Giải nén toàn bộ gói vào một thư mục, không chạy updater trực tiếp bên trong file nén.
2. Đọc README, hình hướng dẫn và changelog trước khi mở chương trình.
3. Chuyển bàn phím về wired mode, tắt pin hoặc giữ một phím khi cắm cáp nếu manual yêu cầu.
4. Mở updater. Chỉ dùng quyền Administrator hoặc cài driver khi tài liệu ghi rõ.
5. Chọn đúng firmware nếu tool không tự đóng gói file.
6. Nhấn Start/Update một lần và chờ tới PASS, SUCCESS hoặc 100%.
7. Đóng tool, rút cắm lại bàn phím và kiểm tra version mới.

Không lấy updater của một model khác chỉ vì giao diện giống nhau. Hai chương trình cùng hãng vẫn có thể nhắm tới controller, VID/PID hoặc protocol khác.

Cách 5: Firmware cho bàn phím tri-mode và receiver 2.4G

Bàn phím tri-mode có thể chứa firmware riêng cho mainboard, mạch RF, receiver 2.4G, màn hình hoặc module phụ. Một số gói update yêu cầu xử lý cả keyboard và dongle rồi ghép lại. Một số model khác chỉ cần main firmware. Không có thứ tự chung cho toàn thị trường.

Quy trình an toàn cho gói nhiều thành phần

1. Kiểm kê toàn bộ file trong gói: keyboard, dongle/receiver, RF program, screen/module và tài liệu.
2. Xác định thành phần nào bắt buộc cập nhật, thành phần nào chỉ dùng cho một revision.
3. Thực hiện đúng thứ tự của hãng. Không tự đảo keyboard và dongle.
4. Chờ PASS hoặc 100% ở từng phần trước khi chuyển sang phần tiếp theo.
5. Sau khi hoàn tất, làm lại quy trình pairing 2.4G nếu hướng dẫn yêu cầu.
6. Kiểm tra lần lượt wired, 2.4G và Bluetooth. Đừng kiểm tra tất cả cùng lúc khi chưa biết phần nào lỗi.

WOBKEY là một ví dụ cho thấy khác biệt theo model: có gói tách updater của bàn phím và updater dongle, trong khi một model khác còn yêu cầu chạy RF tool rồi copy file .bin vào ổ USB mới xuất hiện. Đây là lý do không nên biến một quy trình tri-mode thành hướng dẫn dùng chung cho mọi bàn phím.

Cách 6: Cài firmware ZMK cho bàn phím split

ZMK thường được dùng trên bàn phím split không dây. Gói build có thể chứa file riêng cho nửa trái và nửa phải, chẳng hạn tên kết thúc bằng left.uf2 và right.uf2. Mỗi file phải được flash vào đúng controller tương ứng.

1. Tải archive firmware từ workflow hoặc nguồn chính thức của keyboard.
2. Giải nén và xác nhận đủ file left/right, dongle hoặc settings reset nếu cấu hình có dùng.
3. Đưa từng nửa vào bootloader và copy đúng file UF2 vào đúng controller.
4. Nếu build xuất file .hex, dùng DFU/QMK Toolbox theo tài liệu phần cứng thay vì kéo thả.
5. Sau khi flash cả hai nửa, cấp nguồn và reset chúng gần cùng thời điểm để ghép lại.
6. Kiểm tra nửa central trước, sau đó kiểm tra peripheral và kết nối Bluetooth.

Tài liệu ZMK chính thức lưu ý rằng split keyboard tạo firmware khác nhau cho từng phần. Chép nhầm left sang right hoặc chỉ cập nhật một nửa có thể khiến hai bên không kết nối dù mỗi controller vẫn khởi động.

Cách 7: Flash QMK bằng dòng lệnh

Người tự build firmware từ source có thể dùng QMK CLI. Khi keyboard và keymap đã được cấu hình, lệnh cơ bản là:

qmk flash -kb <keyboard> -km <keymap>

QMK sẽ compile, đọc thông tin bootloader trong target và gọi phương thức flash phù hợp khi được hỗ trợ. Đây không phải đường tắt để flash một file không rõ nguồn. Nếu target khai báo sai bootloader hoặc không hỗ trợ flash command, hãy dừng ở lỗi thay vì ép dùng một protocol khác.

Sau khi cài firmware cần kiểm tra gì?

• Bàn phím khởi động và được hệ điều hành nhận đúng tên.
• Mọi phím gửi tín hiệu, không có hàng/cột bị mất.
• Layer, Fn, knob, macro và đèn hoạt động đúng.
• Wired, 2.4G và Bluetooth hoạt động nếu model hỗ trợ.
• Receiver đã ghép lại nếu gói update yêu cầu.
• VIA/Vial hoặc configurator nhận đúng thiết bị.
• Với bàn phím HE, chạy calibration sau update nếu manual yêu cầu.

Nếu sau update chỉ xuất hiện double click hoặc chatter, chưa chắc firmware là nguyên nhân. Hãy tách lỗi debounce, switch, socket và mối hàn theo bài cách xử lý double click bàn phím cơ trước khi tiếp tục flash.

Xử lý lỗi cài firmware

QMK Toolbox hoặc updater không thấy thiết bị

• Xác nhận bàn phím thật sự ở bootloader, không chỉ đang ở wired mode.
• Đổi cáp data và cổng USB, ưu tiên kết nối trực tiếp.
• Kiểm tra console, Device Manager hoặc System Information xem bootloader có xuất hiện không.
• Đóng các ứng dụng đang chiếm thiết bị.
• Cài driver bootloader chỉ theo tài liệu của tool hoặc hãng.

Quá trình dừng giữa chừng

Không nhấn Flash liên tục và không đổi sang firmware khác để thử. Ghi lại log hoặc error ID, giữ nguyên file đã dùng và mở hướng dẫn recovery của đúng model. Nếu controller vẫn vào được bootloader, thường có thể flash lại stock firmware, nhưng thứ tự phục hồi vẫn phụ thuộc bootloader.

Tool báo Success nhưng bàn phím không gõ

• Chờ vài giây, rút cắm lại và thử cổng USB khác.
• Kiểm tra firmware có đúng revision và đúng biến thể layout không.
• Thực hiện factory reset hoặc calibration chỉ khi manual yêu cầu sau flash.
• Nếu sai file, dùng bootloader/recovery để trở về stock firmware chính xác.

2.4G mất kết nối sau khi update

Kiểm tra gói firmware có file dongle riêng và bước re-pair hay không. Keyboard firmware mới có thể không ghép với receiver đang ở version cũ. Chỉ cập nhật receiver nếu tài liệu model nêu rõ; không dùng dongle updater của bàn phím khác.

Những lỗi cần tránh

• Flash theo tên vỏ bàn phím mà không kiểm tra PCB/revision.
• Nhầm VIA JSON, keymap backup hoặc driver thành firmware.
• Cho rằng mọi file .bin đều dùng QMK Toolbox.
• Rút cáp khi thanh tiến trình chưa hoàn tất.
• Cập nhật dongle, màn hình hoặc module bằng file của mainboard.
• Dùng một hotkey bootloader chung cho mọi model.
• Flash firmware chỉ để thử sửa lỗi phần cứng.

Câu hỏi thường gặp

Cài firmware có làm mất keymap không?

Có thể. Điều này phụ thuộc firmware, vùng EEPROM và updater. Hãy export keymap/profile trước khi cập nhật nếu công cụ cho phép, đồng thời chụp lại các layer quan trọng.

Có cần update lên phiên bản mới nhất không?

Không bắt buộc. Chỉ nên cập nhật khi changelog có thay đổi bạn cần, hãng khuyến nghị hoặc bạn đang xử lý một lỗi cụ thể. Một bàn phím đang ổn không tự nhiên tốt hơn chỉ vì số firmware cao hơn.

File JSON có phải firmware không?

Thông thường không. JSON có thể là VIA definition, keymap hoặc cấu hình. Hãy đọc tên file và tài liệu đi kèm, không đưa JSON vào công cụ flash trừ khi chính hệ thống của hãng mô tả đó là firmware.

Flash sai firmware có cứu được không?

Nếu bootloader còn hoạt động, nhiều trường hợp có thể phục hồi bằng stock firmware đúng revision. Nếu bootloader không xuất hiện hoặc model dùng tool recovery riêng, hãy dừng thử nghiệm và liên hệ hãng, nơi bán hoặc kỹ thuật viên có đúng tài liệu phần cứng.

Checklist hoàn tất

• Đúng model, revision và loại PCB.
• Đúng file, đúng công cụ và đúng thứ tự.
• Đã thấy PASS, SUCCESS hoặc Flash Complete.
• Đã kiểm tra toàn bộ phím và layer.
• Đã kiểm tra wired, 2.4G, Bluetooth nếu có.
• Đã lưu lại file firmware cùng version vừa cài.

Nếu chưa chắc bàn phím dùng QMK Toolbox, UF2 hay updater riêng, hãy dừng trước bước bootloader. Ghi lại tên model, revision PCB, loại kết nối, tên file và ảnh nhãn trên mạch. Chỉ cần xác định đúng năm dữ liệu này, phần lớn rủi ro flash nhầm đã được loại bỏ.