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

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 방식 추천.

2026-08-10T15:42:19Z

납땜 순서 요약

@@ 360번째 줄: / 360번째 줄: @@
 === config/west.yml ,  zephyr/module.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 은 수정하지 않고 템플릿 그대로 사용한다. ===
	----		----

2026-08-10T15:36:18Z

6️⃣ `build.yml`

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

			* config/west.yml , zephyr/module.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.

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

2026-08-10T15:34:20Z

4️⃣ `Kconfig.shield`

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

	=== 4️⃣ `Kconfig.shield` ===		=== 4️⃣ `Kconfig.shield` ===
			boards\shields\Kconfig.shield

	<source lang=bash>		<source lang=bash>
	config SHIELD_FN5X5		config SHIELD_FN5X5

2026-08-10T15:33:59Z

3️⃣ `fn25key.conf`

2026-08-10T15:33:42Z

2️⃣ `fn25key.keymap`

2026-08-10T15:33:08Z

6️⃣ `.github/workflows/build.yml`

← 이전 판		2026년 8월 11일 (화) 00:33 판
324번째 줄:		324번째 줄:
	---		---

	=== 6️⃣ `~~.github/workflows/~~build.yml` ===		=== 6️⃣ `build.yml` ===
	<source lang=bash>		<source lang=bash>
	~~yaml~~		# This file generates the GitHub Actions matrix.
	name: ~~Build ZMK Firmware~~		# For simple board + shield combinations, add them to the top level board and
			# shield arrays, for more control, add individual board + shield combinations
	on:		# to the `include` property. You can also use the `cmake-args` property to
	~~push~~:		# pass flags to the build command, `snippet` to add a Zephyr snippet, and
	~~pull_request~~:		# `artifact-name` to assign a name to distinguish build outputs from each other:
	~~workflow_dispatch~~:		#
			# board: [ "nice_nano" ]
	~~jobs~~:		# shield: [ "corne_left", "corne_right" ]
	~~build~~:		# include:
	~~uses~~: ~~zmkfirmware/zmk/.github/workflows/build~~-~~user~~-~~config.yml@main~~		# - board: bdn9_rev2
			# - board: nice_nano
			# shield: reviung41
			# - board: nice_nano
			# shield: corne_left
			# snippet: studio-rpc-usb-uart
			# cmake-args: -DCONFIG_ZMK_STUDIO=y
			# artifact-name: corne_left_with_studio
			#
			---
			include:
			- board: nice_nano_v2
			shield: fn25key
	</source>		</source>