Hướng dẫn sử dụng
bàn phím Bluetooth ZMK

Bài hướng dẫn này áp dụng cho các bàn phím Split Bluetooth được phân phối bởi KiwiKey, bao gồm Sofle, Corne.

Các nội dung có thể sai lệch, thiếu ý hoặc không rõ ràng. Nếu bạn thấy có chỗ cần chỉnh sửa hoặc bổ sung, vui lòng nhắn cho mình (info ở cuối trang). Chân thành cảm ơn bạn.

Setup

Khởi động và kết nối phím​

Màn hình hiển thị

OLED, ePaper

Keymap phím

Cài đặt các nút, macro,...

LED RGB

Núm xoay

Firmware

Cách tải và nạp Firmware

  • Một số lưu ý trước khi sử dụng​

– Phím có 2 trạng thái tiết kiệm pin:

  • Sau 30 giây không sử dụng, phím sẽ vào trạng thái nghỉ (idle) -> vẫn sử dụng như bình thường
  • Sau 15 phút không sử dụng, phím chuyển sang chế độ ngủ sâu (deep sleep) -> nhấn nút bất kỳ để “đánh thức” phím, đợi khoảng 2 giây để sử dụng tiếp

– Khi cắm cáp USB kết nối bàn phím với máy tính, phím tự chuyển sang chế độ cắm dây. Người dùng vẫn có thể chuyển sang chế bộ Bluetooth bằng phím tắt, lúc này cổng USB chỉ có chức năng sạc pin.

– Luôn tắt hẳn phím (bằng công tắc gạt ON/OFF) trước khi tháo lắp, thay thế hoặc sửa chữa mạch.

– Không nạp các bản firmware không rõ nguồn gốc, có thể dẫn đến hỏng mạch.

Xem thêm: 

Khởi động và kết nối phím

Các bước này chỉ cần cài đặt 1 lần, những lần sau bàn phím và máy tính sẽ tự động kết nối.

  1. Khởi động phím bằng cách gạt công tắc ON/OFF, thường nằm cạnh cổng USB
  2. Dò tìm thiết bị Bluetooth trên máy tính, chọn phím cần kết nối (“Sofle_OLED“, “Corne_OLED“, hoặc tên khác tùy mẫu phím)
  3. Nhập 6 chữ số bảo mật và nhấn Enter (xem keymap mặc định)
  4. Máy tính sử dụng MacOS có thể có thêm một số bước cài đặt, tuy nhiên không cần thiết và không ảnh hưởng đến quá trình sử dụng phím.
Kết nối & chuyển đổi giữa nhiều thiết bị

Bàn phím chạy ZMK có thể kết nối tối đa 5 thiết bị cùng lúc, và chuyển đổi giữa 5 thiết bị bằng phím tắt, việc chuyển đổi không có thời gian trễ (delay).

Các phím tắt:

  • BT1, BT2,… BT5 : chuyển đổi giữa các thiết bị
  • BT_CLR : xóa cài đặt Bluetooth của thiết bị hiện tại

Các bước cài đặt ban đầu:

  1. Kết nối với thiết bị đầu tiên, mặc định thiết bị này được đánh số BT1
  2. Nhấn nút BT2 để chuyển sang thiết bị 2. Thực hiện kết nối với thiết bị này như bình thường.
  3. Lặp lại với các thiết bị số BT3, BT4, BT5 (nếu có).

Sau khi cài đặt xong, trong quá trình sử dụng nếu cần chuyển sang thiết bị nào, chỉ cần nhấn phím BT1, BT2,… tương ứng.

Lưu ý:

  • Tất cả các phím trên bàn phím, bao gồm các phím điều khiển Bluetooth (BT_CLR, BT1, BT2,…), và các phím layer (LOWER, RAISE,…) đều có thể cài qua vị trí khác tùy ý, thông qua ZMK Studio.

Màn hình hiển thị (OLED & ePaper)

Bàn phím ZMK có thể được trang bị màn hình để hiển thị các thông tin của phím (tình trạng kết nối, % pin, layer) hoặc hình ảnh, logo,…

Đối với phím split 2 mảnh (Sofle, Corne,…) mỗi mảnh có 1 màn hình OLED 0.91inch. Mặc định, màn hình hiển thị các thông tin:

Source: https://github.com/mctechnology17/zmk-nice-oled

bt_unbonded

Chưa cài đặt Bluetooth

bt

Đã kết nối thiết bị

bt_no_signal

Mất kết nối với thiết bị

usb

Phím đang kết nối qua USB

bolt

Đang cắm sạc

luna_sit1

Nó ngồi ngó bạn gõ phím và đánh giá bạn

Để tùy biến nội dung hiển thị, cần phải chỉnh code và nạp firmware mới. Hiện tại chưa có app trực tiếp chỉnh nội dung màn hình.

Màn hình OLED không tiết kiệm pin, tuy nhiên với giá thành rẻ và dễ mua, đây vẫn là lựa chọn tốt khi sử dụng với phím Bluetooth.

Màn hình ePaper, phổ biến nhất là “nice!view”, có mức tiêu thụ điện năng cực kỳ thấp giúp kéo dài thời lượng sử dụng phím. Tuy nhiên giá thành rất cao (dao động từ 300k đến 600k) và khó tìm mua ở Việt Nam.

Ví dụ: bàn phím Sofle có pin 700mAh, xài màn OLED 0.91″ chỉ chạy được 1 tuần, trong khi xài màn nice!view sẽ chạy được 2 tháng (ước lượng).

Một điểm khác nhau nữa, là màn OLED “phát sáng”, tức trong bóng tối vẫn có thể nhìn được. Trong khi đó màn ePaper hoàn toàn không phát sáng, ban đêm không thấy gì, và ban ngày cũng tương đối khó nhìn.

-> Hiện tại shop KiwiKey chỉ sử dụng màn hình OLED cho phím Bluetooth.

Chỉnh keymap

Có 3 layer, được đặt tên lần lượt là

  • BASE: gồm các chữ cái, chữ số, phím chức năng cơ bản, và 2 nút LOWER và RAISE để chuyển sang layer tương ứng
  • LOWER: hàng F1, F2,… F12 và một số ký tự bổ sung
  • RAISE: các phím điều khiển Bluetooth, cụm mũi tên, một số phím chức năng đặc biệt

Việc chỉnh keymap được thực hiện thông qua phần mềm ZMK Studio, có 2 cách:

  1. Cài đặt vào máy tính: https://zmk.studio/download
  2. Chạy trên web: https://zmk.studio/ (bắt buộc cắm dây USB khi keymap)
– Sau khi chỉnh xong, nhớ nhấn nút Save ở góc trên bên phải để lưu lại cài đặt.
– Phần mềm ZMK Studio đôi khi bị lỗi không load hoặc không chỉnh được phím. Bạn tắt và mở lại app để thử lại.
– Hiện tại, ZMK Studio chỉ cài đặt được các ký tự thông dụng (chữ cái, chữ số, dấu,…) và các lệnh điều khiển phím, chưa hỗ trợ macro, combo, hi vọng các bản update tiếp theo sẽ bổ sung thêm các chức năng này.

Trước khi có ZMK Studio, mỗi khi muốn thay đổi keymap, người dùng phải sử dụng Github, chỉnh mã nguồn (code) của phím, từ đó tạo ra file firmware, sau đó nạp vào bàn phím. Cách này rất bất tiện, mất thời gian, và không phù hợp với phần lớn người dùng.

Sự ra đời của ZMK Studio giúp việc chỉnh keymap nhanh và dễ dàng, tương tự như VIA của QMK Firmware. Mọi cài đặt đều có hiệu lực ngay lập tức và không cần kiến thức/kỹ năng phức tạp.

Tuy nhiên, một số chức năng nâng cao vẫn yêu cầu người dùng phải chỉnh trong code. Hi vọng trong tương lai các chức năng này sẽ được cập nhật dần vào ZMK Studio.

LED RGB

LED RGB ít được sử dụng với phím Bluetooth do tính chất “ngốn điện” của nó. Tuy nhiên, các mạch phím split (Sofle, Corne) được phân phối bởi KiwiKey có sẵn các chân trên mạch để hàn dây LED WS2812.

Để được hỗ trợ, vui lòng liên hệ riêng.

Núm xoay - Rotary Encoder

Bàn phím có hỗ trợ: Sofle V1, Sofle V2.

Chức năng mặc định: núm bên trái chỉnh âm lượng, núm bên phải cuộn trang (Page up / Page down)

Đối với mạch phím split phân phối bởi KiwiKey, những vị trí có núm xoay có thể đổi sang nút nhấn thường.

Nạp Firmware ZMK

Tương tự như phím QMK (và phần lớn các mạch điện tử nói chung), bạn cần đưa bàn phím vào chế độ “Bootloader” để có thể nạp firmware.

Các bàn phím split 2 mảnh sẽ có 2 file firmware khác nhau cho mỗi bên. Ví dụ:

  • sofle_left_oled.uf2 -> nạp cho phím Sofle, mảnh bên trái
  • sofle_right_oled.uf2 -> nạp cho phím Sofle, mảnh bên phải 

Đối với các bàn phím split được phân phối bởi KiwiKey, bạn có thể làm theo các bước sau:

  1. Nhấn nút Reset trên mạch 2 lần liên tục (nếu không muốn tháo rời mạch, có thể dùng que chọc vào lỗ nhỏ ở mặt dưới phím)
  2. Trên máy tính sẽ hiện một ổ đĩa mới tên NICENANO (tương tự như khi cắm ổ USB vào máy tính)
  3. Copy file firmware cần nạp vào ổ đĩa trên
  4. Lặp lại các bước trên với mảnh còn lại (nhớ chọn đúng file)
Quá trình copy có thể xảy ra báo lỗi, thật ra nếu ổ đĩa NICENANO được ngắt kết nối tức là đã nạp firmware thành công, bạn có thể bỏ qua thông báo lỗi này.
Trong một số trường hợp sau khi nạp firmware mới (hoặc khi cài đặt Bluetooth lần đầu gặp trục trặc), máy tính và bàn phím không thể kết nối được nữa dù vẫn tìm thấy thiết bị (máy liên tục báo “Unable to connect”).
 

Lý do: bàn phím đã nạp cài đặt mới, nhưng máy tính vẫn còn lưu cài đặt cũ.

 
Với bàn phím ZMK:
  • Nạp file zmk_settings_reset.uf2 cho cả 2 mảnh trái và phải
  • Nạp firmware mới tương ứng cho từng mảnh
Với máy tính: vào cài đặt Bluetooth của máy tính và chọn “Remove device” để xóa hoàn toàn thiết bị cũ
 
Việc nạp file settings_reset không phải lúc nào cũng bắt buộc, đôi khi bất tiện vì sau đó bạn phải setup bàn phím lại từ đầu.
  • Nếu firmware mới có những thay đổi liên quan đến Bluetooth -> phải nạp file zmk_settings_reset
  • Nếu chỉ update các chức năng khác (màn hình, núm xoay, LED,…) -> không cần nạp file zmk_settings_reset

FAQ

  • Cắm sạc cho bàn phím như thế nào?
  • Cắm cáp vào cổng USB-C của bàn phím, từng mảnh riêng biệt.
    Có thể sử dụng cổng USB máy tính, củ sạc điện thoại và cả pin sạc dự phòng (nên sử dụng hàng chất lượng tốt để đảm bảo quá trình sạc ổn định).
  • Có cần phải tắt bàn phím (gạt công tắc ON/OFF) mỗi khi không sử dụng?
  • Không cần thiết. Khi không sử dụng trong thời gian dài, bàn phím tự vào chế độ tiết kiệm pin (deep sleep) và hầu như không tốn pin. Tuy nhiên nếu cần di chuyển, bỏ phím vào balo, túi xách thì nên tắt phím. Việc va đập, lắc lư có thể vô tình nhấn phím và kích hoạt phím liên tục, khi đó sẽ tốn pin.

Các lỗi thường gặp và cách xử lý

  • Máy tính quét tìm thấy bàn phím nhưng không thể kết nối?
  • Máy tính đã kết nối với phím, nhưng không gõ được?
  • Xóa toàn bộ kết nối trước đó và thực hiện lại từ đầu: xem "Clean flashing"
  • Mảnh bên trái xài bình thường, nhưng mảnh bên phải không gõ được và hiện biểu tượng "Bluetooth mất kết nối"
  • Thường do nạp firmware mới nhưng chỉ nạp cho mảnh bên trái, khiến 2 mảnh mất kết nối với nhau. Bạn cần nạp setting_reset sau đó lại firmware mới cho cả 2 mảnh.
  • Lúc cắm sạc, pin luôn hiện 100% là lỗi gì?
  • Do hạn chế về phần cứng của mạch NRFMicro (được thiết kế để thay thế Arduino Pro Micro chạy QMK), mạch không thể phân biệt điện áp của pin và của cổng USB khi được cắm điện. Lỗi này không thể tránh khỏi, mong bạn thông cảm bỏ qua. KiwiKey sẽ có giải pháp cho việc này trong tương lai.
Facebook-f Youtube Envelope Phone-alt Shopping-cart