5x5 매크로 키보드 만들기 - 편집 역사

Devcafe: /* {:west로 로컬 직접 컴파일} */

2026-08-19T06:53:24Z

{:west로 로컬 직접 컴파일}

← 이전 판		2026년 8월 19일 (수) 15:53 판
445번째 줄:		445번째 줄:


	=={:west로 로컬 직접 컴파일}==		{{:west로 로컬 직접 컴파일}}

Devcafe: /* {{:west로 로컬 직접 컴파일}} */

2026-08-19T06:52:58Z

← 이전 판		2026년 8월 19일 (수) 15:52 판
445번째 줄:		445번째 줄:


	=={{:west로 로컬 직접 컴파일}}==		=={:west로 로컬 직접 컴파일}==

Devcafe: /* west로 로컬 직접 컴파일 */

2026-08-19T05:49:50Z

west로 로컬 직접 컴파일

← 이전 판		2026년 8월 19일 (수) 14:49 판
445번째 줄:		445번째 줄:


	== west로 로컬 직접 컴파일 ==		=={{:west로 로컬 직접 컴파일}}==
	~~=== 툴체인 준비 (최초 1회) ====~~

	~~<source lang=bash>~~
	~~pip install west --break-system-packages~~
	~~# Zephyr SDK 설치 필요 (없으면):~~
	~~# https://docs.zephyrproject.org/latest/develop/getting_started/index.html 참고~~
	~~<source lang=sql>~~

	~~=== west workspace 초기화 ===~~

	~~config/west.yml이 매니페스트이므로, 그걸 기준으로 west workspace를 초기화합니다.~~

	~~<source lang=bash>~~
	~~cd shortkey_firmware ## 펌웨어 대상 루트디렉토리로 이동~~
	~~west init -l config~~
	~~west update~~
	~~west zephyr-export~~
	~~pip install -r zephyr/requirements-base.txt --break-system-packages~~
	~~</source>~~

	~~=== 빌드 ===~~

	* boards/shields/shortkey가 루트의 zephyr/module.yml을 통해 모듈로 인식되게 하려면,
	* 빌드 시 ZEPHYR_EXTRA_MODULES로 이 저장소 루트를 명시적으로 넘겨줘야 합니다.
	* 그리고 config/ 안의 keymap/conf/overlay(예: config/boards/arm/nice_nano_v2.overlay)를 적용하려면 ZMK_CONFIG로 config 경로를 지정합니다.

	~~<source lang=bash>~~
	~~west build -p -b nice_nano_v2 -- \~~
	~~-DSHIELD=shortkey \~~
	~~-DZMK_CONFIG=$(pwd)/config \~~
	~~-DZEPHYR_EXTRA_MODULES=$(pwd)~~
	~~-p : pristine build (처음 또는 구조 바꿀 때마다 권장)~~
	~~-DSHIELD=shortkey : boards/shields/shortkey 사용~~
	~~-DZMK_CONFIG=.../config : config/shortkey.conf, config/boards/arm/nice_nano_v2.overlay 등 반영~~
	~~-DZEPHYR_EXTRA_MODULES=.../shortkey_firmware : 루트의 zephyr/module.yml을 모듈로 인식시켜 boards/shields/shortkey 탐색 가능하게 함~~
	~~</source>~~

	~~=== 펌웨어 결과물 ===~~
	~~<source lang=bash>~~
	~~ls build/zephyr/zmk.uf2~~
	~~</source>~~

	~~이 파일을 부트로더 모드 진입한 보드 드라이브에 드래그 앤 드롭하면 됩니다.~~

	~~=== 재빌드 시 ===~~

	~~설정만 바꿨다면 -p 없이:~~

	~~<source lang=bash>~~
	~~west build~~
	~~</source>~~

	~~shield/board 자체를 바꾸면 다시 -p(pristine)로 빌드하세요.~~

Devcafe: /* 로컬 빌드(west)로 하고 싶다면 */

2026-08-19T05:48:15Z

로컬 빌드(west)로 하고 싶다면

@@ 433번째 줄: / 433번째 줄: @@
 ==  로컬 빌드(west)로 하고 싶다면 ==
 <source lang=bash>
 pip install west --break-system-packages
@@ 444번째 줄: / 443번째 줄: @@
 * 결과물은 build/zephyr/zmk.uf2에 생성됩니다.
 ** Zephyr SDK(nRF 툴체인) 설치가 선행되어야 해서, 처음이라면 GitHub Actions 방식 추천.

2026년 8월 10일 (월) 15:44에 Devcafe님의 편집

2026-08-10T15:44:18Z

← 이전 판		2026년 8월 11일 (화) 00:44 판
431번째 줄:		431번째 줄:

	</source>		</source>

			== 로컬 빌드(west)로 하고 싶다면 ==
			* 클라우드 빌드가 막힐 경우를 위해 로컬 빌드도 가능합니다.
			<source lang=bash>
			pip install west --break-system-packages
			west init -l config
			west update
			west zephyr-export
			west build -p -b seeeduino_xiao_ble -- -DSHIELD=fn5x5
			</source>

			* 결과물은 build/zephyr/zmk.uf2에 생성됩니다.
			** Zephyr SDK(nRF 툴체인) 설치가 선행되어야 해서, 처음이라면 GitHub Actions 방식 추천.

Devcafe: /* 납땜 순서 요약 */

2026-08-10T15:42:19Z

납땜 순서 요약

@@ 360번째 줄: / 360번째 줄: @@
 === config/west.yml ,  zephyr/module.yml 은 수정하지 않고 템플릿 그대로 사용한다. ===
 ----
 == 납땜 순서 요약 ==

Devcafe: /* 6️⃣ `build.yml` */

2026-08-10T15:36:43Z

6️⃣ `build.yml`

← 이전 판		2026년 8월 11일 (화) 00:36 판
357번째 줄:		357번째 줄:
	shield: fn25key		shield: fn25key
	</source>		</source>
			----
	* config/west.yml , zephyr/module.yml 은 수정하지 않고 템플릿 그대로 사용한다.		=== config/west.yml , zephyr/module.yml 은 수정하지 않고 템플릿 그대로 사용한다. ===
	----		----

Devcafe: /* 6️⃣ `build.yml` */

2026-08-10T15:36:18Z

6️⃣ `build.yml`

← 이전 판		2026년 8월 11일 (화) 00:36 판
358번째 줄:		358번째 줄:
	</source>		</source>

			* config/west.yml , zephyr/module.yml 은 수정하지 않고 템플릿 그대로 사용한다.
	----		----

Devcafe: /* 6️⃣ `build.yml` */

2026-08-10T15:34:55Z

6️⃣ `build.yml`

← 이전 판		2026년 8월 11일 (화) 00:34 판
331번째 줄:		331번째 줄:

	=== 6️⃣ `build.yml` ===		=== 6️⃣ `build.yml` ===
			/build.yml
	<source lang=bash>		<source lang=bash>
	# This file generates the GitHub Actions matrix.		# This file generates the GitHub Actions matrix.

Devcafe: /* 5️⃣ `Kconfig.defconfig` */

2026-08-10T15:34:33Z

5️⃣ `Kconfig.defconfig`

← 이전 판		2026년 8월 11일 (화) 00:34 판
315번째 줄:		315번째 줄:

	=== 5️⃣ `Kconfig.defconfig` ===		=== 5️⃣ `Kconfig.defconfig` ===
			boards\shields\Kconfig.defconfig

	<source lang=bash>		<source lang=bash>
	if SHIELD_FN5X5		if SHIELD_FN5X5