<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ko">
	<id>https://devcafe.co.kr/w/index.php?action=history&amp;feed=atom&amp;title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95</id>
	<title>Zmk 키보드 펌웨어 설치 및 키매핑 수정 - 편집 역사</title>
	<link rel="self" type="application/atom+xml" href="https://devcafe.co.kr/w/index.php?action=history&amp;feed=atom&amp;title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95"/>
	<link rel="alternate" type="text/html" href="https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;action=history"/>
	<updated>2026-07-01T21:36:51Z</updated>
	<subtitle>이 문서의 편집 역사</subtitle>
	<generator>MediaWiki 1.42.1</generator>
	<entry>
		<id>https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;diff=2478&amp;oldid=prev</id>
		<title>Devcafe: /* ZMK 키매핑(온라인,https://zmk.studio/) */</title>
		<link rel="alternate" type="text/html" href="https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;diff=2478&amp;oldid=prev"/>
		<updated>2026-06-09T06:59:10Z</updated>

		<summary type="html">&lt;p&gt;&lt;span dir=&quot;auto&quot;&gt;&lt;span class=&quot;autocomment&quot;&gt;ZMK 키매핑(온라인,https://zmk.studio/)&lt;/span&gt;&lt;/span&gt;&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;ko&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← 이전 판&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;2026년 6월 9일 (화) 15:59 판&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l65&quot;&gt;65번째 줄:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;65번째 줄:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 블루투스 연결이 불안정할 경우 부트와 리셋 버튼을 동시에 눌러 페어링을 초기화합니다.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 블루투스 연결이 불안정할 경우 부트와 리셋 버튼을 동시에 눌러 페어링을 초기화합니다.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 기존 QMK 사용자라면 유사한 키맵 구조를 그대로 활용할 수 있습니다.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 기존 QMK 사용자라면 유사한 키맵 구조를 그대로 활용할 수 있습니다.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;=== ZMK 키매핑(온라인,https://zmk.studio/) ===&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;=== &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;[[&lt;/ins&gt;ZMK 키매핑(온라인,https://zmk.studio/)&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;]] &lt;/ins&gt;===&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>Devcafe</name></author>
	</entry>
	<entry>
		<id>https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;diff=2477&amp;oldid=prev</id>
		<title>Devcafe: /* ZMK 활용 팁 */</title>
		<link rel="alternate" type="text/html" href="https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;diff=2477&amp;oldid=prev"/>
		<updated>2026-06-09T06:58:57Z</updated>

		<summary type="html">&lt;p&gt;&lt;span dir=&quot;auto&quot;&gt;&lt;span class=&quot;autocomment&quot;&gt;ZMK 활용 팁&lt;/span&gt;&lt;/span&gt;&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;ko&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← 이전 판&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;2026년 6월 9일 (화) 15:58 판&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l65&quot;&gt;65번째 줄:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;65번째 줄:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 블루투스 연결이 불안정할 경우 부트와 리셋 버튼을 동시에 눌러 페어링을 초기화합니다.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 블루투스 연결이 불안정할 경우 부트와 리셋 버튼을 동시에 눌러 페어링을 초기화합니다.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 기존 QMK 사용자라면 유사한 키맵 구조를 그대로 활용할 수 있습니다.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* 기존 QMK 사용자라면 유사한 키맵 구조를 그대로 활용할 수 있습니다.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;=== ZMK 키매핑(온라인,https://zmk.studio/) ===&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>Devcafe</name></author>
	</entry>
	<entry>
		<id>https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;diff=2473&amp;oldid=prev</id>
		<title>Devcafe: 새 문서: === 개요 === * ZMK는 Zephyr Mechanical Keyboard의 약자로, Zephyr RTOS를 기반으로 한 오픈소스 키보드 펌웨어입니다.  * QMK보다 가볍고 무선 연결을 지원한다는 장점이 있습니다.  * 블루투스 기반 키보드 제작, 저전력 펌웨어 구성 등에 적합하며 Windows, macOS, Linux 환경에서 모두 사용할 수 있습니다.  === ZMK 특징 === * 블루투스 무선 연결 지원 * QMK와 유사한 키맵 구조 * 오픈소스...</title>
		<link rel="alternate" type="text/html" href="https://devcafe.co.kr/w/index.php?title=Zmk_%ED%82%A4%EB%B3%B4%EB%93%9C_%ED%8E%8C%EC%9B%A8%EC%96%B4_%EC%84%A4%EC%B9%98_%EB%B0%8F_%ED%82%A4%EB%A7%A4%ED%95%91_%EC%88%98%EC%A0%95&amp;diff=2473&amp;oldid=prev"/>
		<updated>2026-06-04T07:14:28Z</updated>

		<summary type="html">&lt;p&gt;새 문서: === 개요 === * ZMK는 Zephyr Mechanical Keyboard의 약자로, Zephyr RTOS를 기반으로 한 오픈소스 키보드 펌웨어입니다.  * QMK보다 가볍고 무선 연결을 지원한다는 장점이 있습니다.  * 블루투스 기반 키보드 제작, 저전력 펌웨어 구성 등에 적합하며 Windows, macOS, Linux 환경에서 모두 사용할 수 있습니다.  === ZMK 특징 === * 블루투스 무선 연결 지원 * QMK와 유사한 키맵 구조 * 오픈소스...&lt;/p&gt;
&lt;p&gt;&lt;b&gt;새 문서&lt;/b&gt;&lt;/p&gt;&lt;div&gt;=== 개요 ===&lt;br /&gt;
* ZMK는 Zephyr Mechanical Keyboard의 약자로, Zephyr RTOS를 기반으로 한 오픈소스 키보드 펌웨어입니다. &lt;br /&gt;
* QMK보다 가볍고 무선 연결을 지원한다는 장점이 있습니다. &lt;br /&gt;
* 블루투스 기반 키보드 제작, 저전력 펌웨어 구성 등에 적합하며 Windows, macOS, Linux 환경에서 모두 사용할 수 있습니다.&lt;br /&gt;
&lt;br /&gt;
=== ZMK 특징 ===&lt;br /&gt;
* 블루투스 무선 연결 지원&lt;br /&gt;
* QMK와 유사한 키맵 구조&lt;br /&gt;
* 오픈소스 무료 사용 가능&lt;br /&gt;
* GitHub을 통한 자동 빌드 지원&lt;br /&gt;
* 다중 레이어와 매크로 기능 지원&lt;br /&gt;
* Zephyr OS 기반의 안정적인 구조&lt;br /&gt;
&lt;br /&gt;
=== ZMK 다운로드 방법 ===&lt;br /&gt;
* ZMK는 GitHub 저장소에서 직접 내려받을 수 있습니다.&lt;br /&gt;
# 인터넷 브라우저에서 ZMK Firmware GitHub을 검색합니다.&lt;br /&gt;
# github.com/zmkfirmware/zmk 페이지에 접속합니다.&lt;br /&gt;
# Code 버튼을 누르고 Download ZIP을 선택합니다.&lt;br /&gt;
# 또는 명령 프롬프트에서 아래 명령어를 입력합니다.&lt;br /&gt;
# 압축 파일을 해제하면 app, config, boards 폴더가 포함되어 있습니다.&lt;br /&gt;
&lt;br /&gt;
=== ZMK 설치 환경 구성 ===&lt;br /&gt;
# ZMK는 Zephyr SDK와 West 빌드 시스템을 기반으로 작동합니다. Python이 필요하므로 먼저 설치해야 합니다.&lt;br /&gt;
# Python 3.8 이상을 설치하고 환경변수에 추가합니다.&lt;br /&gt;
# West 빌드 툴을 설치합니다.&lt;br /&gt;
# pip install west&lt;br /&gt;
# Zephyr SDK를 설치합니다. Zephyr 공식 사이트에서 운영체제에 맞는 버전을 선택합니다.&lt;br /&gt;
# 설치 후 환경 변수 ZEPHYR_BASE를 설정합니다.&lt;br /&gt;
# 아래 명령으로 프로젝트를 초기화합니다.&lt;br /&gt;
#:&amp;lt;source code=python&amp;gt;&lt;br /&gt;
west init -l app&lt;br /&gt;
west update&lt;br /&gt;
west zephyr-export&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ZMK 펌웨어 빌드 방법 ===&lt;br /&gt;
# config 폴더 안에 키보드 설정 파일을 준비합니다.&lt;br /&gt;
# 아래 명령어를 입력해 빌드합니다.&lt;br /&gt;
#:&amp;lt;source code=python&amp;gt;&lt;br /&gt;
west build -b nrf52840dk_nrf52840 -- -DSHIELD=splitkb_left&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
# 빌드가 완료되면 build 폴더 안에 zmk.uf2 또는 zmk.hex 파일이 생성됩니다.&lt;br /&gt;
#: - 이 파일이 실제 키보드에 업로드할 펌웨어입니다.&lt;br /&gt;
&lt;br /&gt;
=== 펌웨어 업로드 방법 ===&lt;br /&gt;
# 키보드를 부트로더 모드로 전환합니다.&lt;br /&gt;
#: - 리셋 버튼이 있으면 두 번 눌러 진입합니다.&lt;br /&gt;
#: - (Nice Nano V2 칩셋인경우 RST+GND를 더블쇼트(핀셋으로 칩셋을 2번 건드림) )&lt;br /&gt;
# PC에 연결하면 USB 드라이브 형태로 인식됩니다.&lt;br /&gt;
# 생성된 zmk.uf2 파일을 해당 드라이브에 복사합니다.&lt;br /&gt;
# 복사가 끝나면 키보드가 자동 재부팅되고 펌웨어가 적용됩니다.&lt;br /&gt;
&lt;br /&gt;
=== 키맵 수정 및 재빌드 ===&lt;br /&gt;
# config 폴더의 keymap.keymap 파일을 열어 수정합니다.&lt;br /&gt;
# 키 설정, 매크로, 조합키를 원하는 대로 변경합니다.&lt;br /&gt;
# 다시 빌드 명령을 실행합니다.&lt;br /&gt;
#:&amp;lt;source lang=python&amp;gt;&lt;br /&gt;
west build -t clean&lt;br /&gt;
west build -b nrf52840dk_nrf52840 -- -DSHIELD=splitkb_left&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
# 새로 생성된 펌웨어를 다시 업로드하면 변경사항이 적용됩니다.&lt;br /&gt;
&lt;br /&gt;
=== ZMK 활용 팁 ===&lt;br /&gt;
* GitHub Actions를 이용하면 자동으로 펌웨어를 빌드할 수 있습니다.&lt;br /&gt;
* 블루투스 연결이 불안정할 경우 부트와 리셋 버튼을 동시에 눌러 페어링을 초기화합니다.&lt;br /&gt;
* 기존 QMK 사용자라면 유사한 키맵 구조를 그대로 활용할 수 있습니다.&lt;/div&gt;</summary>
		<author><name>Devcafe</name></author>
	</entry>
</feed>