Qmk Toolbox

펌웨어 플래싱

QMK Toolbox는 다양한 부트로더를 통해 키보드에 펌웨어를 플래시할 수 있습니다. 지원되는 부트로더에는 ARM DFU, Atmel/LUFA/QMK DFU, Atmel SAM-BA, BootloadHID, Caterina, HalfKay, LUFA/QMK HID, WB32 DFU 및 LUFA Mass Storage가 포함됩니다. 또한 AVRISP, USBasp, USBTiny와 같은 ISP 플래셔도 지원합니다.

HID 콘솔

이 도구는 사용 페이지 0xFF31과 사용법 0x0074에서의 HID 메시지를 수신하여 PJRC의 hid_listen과 호환됩니다. 키보드의 rules.mk에 CONSOLE_ENABLE = yes가 설정되어 있다면, xprintf() 함수를 통해 디버깅 메시지를 콘솔에 출력할 수 있습니다.

자동 드라이버 설치

Windows에서 처음 실행 시, 지원되는 모든 부트로더에 필요한 드라이버를 자동으로 설치하도록 프롬프트가 표시됩니다. 장치가 인식되지 않는 경우, Zadig를 사용하여 드라이버 문제를 해결할 수 있습니다.

키 테스터

펌웨어를 플래시한 후, 새로 플래시된 키보드가 정상적으로 작동하는지 확인할 수 있는 내장 키 테스터 기능을 제공합니다.

다운로드 및 설치 방법

Windows 사용자는 GitHub 릴리스 페이지에서 standalone 실행 파일(qmk_toolbox.exe) 또는 설치 프로그램(qmk_toolbox_install.exe)을 다운로드할 수 있습니다. 다운로드 후 실행 파일을 더블 클릭하여 설치하거나 실행할 수 있습니다. macOS 사용자는 standalone 앱(QMK.Toolbox.app.zip) 또는 설치 패키지(QMK.Toolbox.pkg)를 다운로드할 수 있습니다. Homebrew를 사용하는 경우, brew install qmk-toolbox 명령어로 설치할 수 있습니다.

기본 사용법

프로그램을 실행하면 자동으로 연결된 키보드를 감지합니다. 플래시할 펌웨어 파일(.hex 또는 .bin)을 선택하고, ‘Flash’ 버튼을 클릭하면 펌웨어가 키보드에 쓰여집니다. 플래싱 과정 중에는 진행 상황을 실시간으로 확인할 수 있습니다. HID 콘솔을 사용하려면, 키보드 펌웨어에서 콘솔 기능을 활성화한 후, 도구 내에서 콘솔 창을 열어 디버깅 메시지를 확인할 수 있습니다.

이런 경우에 유용합니다

키보드 애호가나 개발자가 직접 키보드 펌웨어를 커스터마이징하고 테스트해야 할 때 유용합니다. 특히 QMK 펌웨어를 기반으로 한 커스텀 키보드를 사용하거나 제작하는 경우, 펌웨어 업데이트 및 디버깅 과정을 간편하게 처리할 수 있습니다. 초보자도 자동 드라이버 설치 및 직관적인 인터페이스를 통해 쉽게 펌웨어를 플래시할 수 있습니다.

지원 환경·시스템 요구사항

Windows 10 May 2020 Update(20H1) 이상 또는 macOS 12(Monterey) 이상에서 실행됩니다. Windows에서는 초기 실행 시 필요한 드라이버 설치를 위한 프롬프트가 나타납니다.

최신 버전·업데이트

현재 버전은 0.3.4이며, 최신 업데이트 내역은 GitHub 릴리스 노트에서 확인할 수 있습니다. 주요 업데이트로는 새로운 부트로더 지원, 플래셔 바이너리 업데이트, 키 테스터 추가, HID 콘솔 개선, UI 개선 및 버그 수정이 포함됩니다.