서버를 이용한 빌드 방식인 깃 워크플로우 방식의 빌드는 아래 링크를 참고
https://zmk.dev/docs/user-setup
Installing ZMK | ZMK Firmware
Unlike other keyboard firmwares, ZMK Firmware has been built from the ground up to allow users to manage
zmk.dev
로컬 빌드를 위한 zmk 가져오기
먼저 https://github.com/zmkfirmware/zmk 를 클론해서 저장소를 가져온다.
zmk의 로컬 빌드는 zmk//app에서 전부 일어난다고 봐도 좋다.
공식 지원하는 보드와 쉴드를 빌드한다면 `-DKEYMAP_FILE ` 옵션을 사용해 키맵 파일만 추가하거나 `board\shield\<키보드 쉴드>` 에 키맵 파일을 교체해주고 바로 빌드해주면 된다.
공식 지원 하드웨어 리스트
Supported Hardware | ZMK Firmware
With the solid technical foundation of Zephyr™ RTOS, ZMK can support a wide diversity of hardware targets.
zmk.dev
새로운 키보드의 로컬 빌드
- app\boards\shields 에 직접 키보드 폴더를 추가하자
- app\boards\shields\chippy 디렉토리 생성
- chippy에 필요한 파일 생성
- *.conf, *.dtsi, Kconfig.shield, Kconfig.defconfig, *.overlay ...
- 스플릿 키보드의 경우 left,right 두가지의 설정 파일이 필요하다.
여기서는 공유되어 있는 파일을 사용해서 빌드를 해보겠다.
https://github.com/JonMuller/gerbers/tree/main/corne-choc-xiao/zmk_starter/OLED
gerbers/corne-choc-xiao/zmk_starter/OLED at main · JonMuller/gerbers
Place to store keyboard gerbers. Contribute to JonMuller/gerbers development by creating an account on GitHub.
github.com
거버파일과 감사하게 설정 파일도 있어서 쉽게 진행할 수 있었다.
oled를 사용하지 않기 때문에 파일에서 oled 설정을 지우고 키맵 파일을 수정한뒤 빌드를 하였다.
*app/build를 삭제하고 새롭게 left부터 빌드
Remove-Item -Recurse -Force build; west build -b seeeduino_xiao_ble -- -DSHIELD=chippy_left
아래 경로에 빌드파일이 생성된다
build/zephyr/zmk.uf2
참고
https://zmk.dev/docs/development/new-shield
New Keyboard Shield | ZMK Firmware
Overview
zmk.dev