Zmk 키보드 펌웨어 설치 및 키매핑 수정

개요

• ZMK는 Zephyr Mechanical Keyboard의 약자로, Zephyr RTOS를 기반으로 한 오픈소스 키보드 펌웨어입니다.
• QMK보다 가볍고 무선 연결을 지원한다는 장점이 있습니다.
• 블루투스 기반 키보드 제작, 저전력 펌웨어 구성 등에 적합하며 Windows, macOS, Linux 환경에서 모두 사용할 수 있습니다.

ZMK 특징

• 블루투스 무선 연결 지원
• QMK와 유사한 키맵 구조
• 오픈소스 무료 사용 가능
• GitHub을 통한 자동 빌드 지원
• 다중 레이어와 매크로 기능 지원
• Zephyr OS 기반의 안정적인 구조

ZMK 다운로드 방법

• ZMK는 GitHub 저장소에서 직접 내려받을 수 있습니다.

1. 인터넷 브라우저에서 ZMK Firmware GitHub을 검색합니다.
2. github.com/zmkfirmware/zmk 페이지에 접속합니다.
3. Code 버튼을 누르고 Download ZIP을 선택합니다.
4. 또는 명령 프롬프트에서 아래 명령어를 입력합니다.
5. 압축 파일을 해제하면 app, config, boards 폴더가 포함되어 있습니다.

ZMK 설치 환경 구성

1. ZMK는 Zephyr SDK와 West 빌드 시스템을 기반으로 작동합니다. Python이 필요하므로 먼저 설치해야 합니다.
2. Python 3.8 이상을 설치하고 환경변수에 추가합니다.
3. West 빌드 툴을 설치합니다.
4. pip install west
5. Zephyr SDK를 설치합니다. Zephyr 공식 사이트에서 운영체제에 맞는 버전을 선택합니다.
6. 설치 후 환경 변수 ZEPHYR_BASE를 설정합니다.
7. 아래 명령으로 프로젝트를 초기화합니다.

   west init -l app
   west update
   west zephyr-export

ZMK 펌웨어 빌드 방법

1. config 폴더 안에 키보드 설정 파일을 준비합니다.
2. 아래 명령어를 입력해 빌드합니다.

   west build -b nrf52840dk_nrf52840 -- -DSHIELD=splitkb_left

3. 빌드가 완료되면 build 폴더 안에 zmk.uf2 또는 zmk.hex 파일이 생성됩니다.

   - 이 파일이 실제 키보드에 업로드할 펌웨어입니다.

펌웨어 업로드 방법

1. 키보드를 부트로더 모드로 전환합니다.

   - 리셋 버튼이 있으면 두 번 눌러 진입합니다.

   - (Nice Nano V2 칩셋인경우 RST+GND를 더블쇼트(핀셋으로 칩셋을 2번 건드림) )

2. PC에 연결하면 USB 드라이브 형태로 인식됩니다.
3. 생성된 zmk.uf2 파일을 해당 드라이브에 복사합니다.
4. 복사가 끝나면 키보드가 자동 재부팅되고 펌웨어가 적용됩니다.

키맵 수정 및 재빌드

1. config 폴더의 keymap.keymap 파일을 열어 수정합니다.
2. 키 설정, 매크로, 조합키를 원하는 대로 변경합니다.
3. 다시 빌드 명령을 실행합니다.

   west build -t clean
   west build -b nrf52840dk_nrf52840 -- -DSHIELD=splitkb_left

4. 새로 생성된 펌웨어를 다시 업로드하면 변경사항이 적용됩니다.

ZMK 활용 팁

• GitHub Actions를 이용하면 자동으로 펌웨어를 빌드할 수 있습니다.
• 블루투스 연결이 불안정할 경우 부트와 리셋 버튼을 동시에 눌러 페어링을 초기화합니다.
• 기존 QMK 사용자라면 유사한 키맵 구조를 그대로 활용할 수 있습니다.