메뉴 여닫기
개인 메뉴 토글
로그인하지 않음
만약 지금 편집한다면 당신의 IP 주소가 공개될 수 있습니다.

ZMK 키매핑(온라인,https://zmk.studio/): 두 판 사이의 차이

데브카페
편집 요약 없음
편집 요약 없음
 
(같은 사용자의 중간 판 3개는 보이지 않습니다)
6번째 줄: 6번째 줄:


=== 🔑 Key Press Behaviors (키 입력)===
=== 🔑 Key Press Behaviors (키 입력)===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | Behavior | 설명 |
|+ 캡션 텍스트
|--------|----------|------|
|-
| `&kp` | Key Press | 키 눌렀을 때 호스트로 키코드 전송 |
! 바인딩 !! Behavior !! 설명  
| `&mt` | Mod Tap | 홀드/탭에 따라 다른 키코드 전송 |
|-
| `&kt` | Key Toggle | 키 토글 (누른 상태 유지/해제) |
| `&kp` || Key Press || 키 눌렀을 때 호스트로 키코드 전송  
| `&sk` | Sticky Key | 다음 키 입력 시까지 유지 (Shift 원핸드 입력 등) |
|-
| `&gresc` | Grave Escape | Shift/GUI 홀드 시 `` ` ``, 아닐 때 ESC |
| `&mt` || Mod Tap || 홀드/탭에 따라 다른 키코드 전송  
| `&caps_word` | Caps Word | Caps Lock 유사하지만 특정 키 누르면 자동 해제 |
|-
| `&key_repeat` | Key Repeat | 직전에 보낸 키코드 재전송 |
| `&kt` || Key Toggle || 키 토글 (누른 상태 유지/해제)  
</SOURCE>
|-
| `&sk` || Sticky Key || 다음 키 입력 시까지 유지 (Shift 원핸드 입력 등)  
|-
| `&gresc` || Grave Escape || Shift/GUI 홀드 시 `` ` ``, 아닐 때 ESC  
|-
| `&caps_word` || Caps Word || Caps Lock 유사하지만 특정 키 누르면 자동 해제  
|-
| `&key_repeat` || Key Repeat || 직전에 보낸 키코드 재전송  
|}
----
----
## 🔀 Miscellaneous Behaviors
=== 🔀 Miscellaneous Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&trans` | Transparent — 하위 활성 레이어로 키 전달 |
! 바인딩 !! 설명
| `&none` | None — 키 입력 완전 차단 |
|-
</SOURCE>
| `&trans` || Transparent — 하위 활성 레이어로 키 전달  
|-
| `&none` || None — 키 입력 완전 차단  
|}
----
----


## 🗂️ Layer Navigation Behaviors
=== 🗂️ Layer Navigation Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | Behavior | 설명 |
|+ 캡션 텍스트
|--------|----------|------|
|-
| `&mo` | Momentary Layer | 누르는 동안 레이어 활성화 |
! 바인딩 !! Behavior !! 설명
| `&lt` | Layer-tap | 홀드 시 레이어, 탭 시 키코드 |
|-
| `&to` | To Layer | 해당 레이어만 활성화, 나머지 비활성 |
| `&mo` || Momentary Layer || 누르는 동안 레이어 활성화  
| `&tog` | Toggle Layer | 수동으로 끌 때까지 레이어 유지 |
|-
| `&sl` | Sticky Layer | 다음 키 누를 때까지 레이어 활성 |
| `&lt` || Layer-tap || 홀드 시 레이어, 탭 시 키코드  
</SOURCE>
|-
| `&to` || To Layer || 해당 레이어만 활성화, 나머지 비활성  
|-
| `&tog` || Toggle Layer || 수동으로 끌 때까지 레이어 유지  
|-
| `&sl` || Sticky Layer || 다음 키 누를 때까지 레이어 활성  
|-
|}
----
----


## 🖱️ Mouse Emulation Behaviors
=== 🖱️ Mouse Emulation Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&mkp` | 마우스 버튼 클릭 |
!바인딩 !! 설명
| `&mmv` | 마우스 커서 이동 |
|-
| `&msc` | 마우스 스크롤 |
| `&mkp` || 마우스 버튼 클릭  
</SOURCE>
|-
| `&mmv` || 마우스 커서 이동  
|-
| `&msc` || 마우스 스크롤  
|}
----
----


## 🔄 Reset Behaviors
=== 🔄 Reset Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&sys_reset` | 펌웨어 재시작 |
!바인딩!! 설명
| `&bootloader` | 부트로더 모드 진입 (펌웨어 플래싱용) |
|-
</SOURCE>
| `&sys_reset` || 펌웨어 재시작  
|-
| `&bootloader` || 부트로더 모드 진입 (펌웨어 플래싱용)  
|}
----
----


## 📡 Output Selection Behaviors
=== 📡 Output Selection Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&bt` | 블루투스 동작 (기기 전환 등) |
! 바인딩 !! 설명
| `&out` | USB / BLE 출력 선택 |
|-
</SOURCE>
| `&bt` || 블루투스 동작 (기기 전환 등)  
|-
| `&out` || USB / BLE 출력 선택  
|}
----
----


## 💡 Lighting Behaviors
=== 💡 Lighting Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&rgb_ug` | RGB 언더글로우 제어 |
! 바인딩 !! 설명
| `&bl` | 백라이트 제어 |
|-
</SOURCE>
| `&rgb_ug` || RGB 언더글로우 제어  
|-
| `&bl` || 백라이트 제어  
|}
----
----


## ⚡ Power Management Behaviors
=== ⚡ Power Management Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&ext_power` | VCC 전원 출력 ON/OFF (절전) |
! 바인딩 !! 설명  
| `&soft_off` | 키보드 전원 끄기 |
|-
</SOURCE>
| `&ext_power` || VCC 전원 출력 ON/OFF (절전)  
|-
| `&soft_off` || 키보드 전원 끄기  
|}
----
----


## 🔓 ZMK Studio Behaviors
=== 🔓 ZMK Studio Behaviors===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| 바인딩 | 설명 |
|+ 캡션 텍스트
|--------|------|
|-
| `&studio_unlock` | ZMK Studio UI에서 키맵 변경 허용 잠금 해제 |
! 바인딩 !! 설명
</SOURCE>
|-
| `&studio_unlock` || ZMK Studio UI에서 키맵 변경 허용 잠금 해제  
|}
----
----


## 🛠️ User-Defined Behaviors (사용자 정의)
=== 🛠️ User-Defined Behaviors (사용자 정의)===
<SOURCE LANG=PYTHON>
{| class="wikitable"
| Behavior | 설명 |
|+ 캡션 텍스트
|----------|------|
|-
| **Macros** | 키 누름/뗌 시 여러 Behavior 순서대로 실행 |
! Behavior !! 설명
| **Hold-Tap** | 홀드/탭 시간이나 인터럽트 키에 따라 다른 Behavior |
|-
| **Tap Dance** | 탭 횟수에 따라 다른 Behavior 실행 |
| **Macros** || 키 누름/뗌 시 여러 Behavior 순서대로 실행  
| **Mod-Morph** | 특정 Modifier 홀드 여부에 따라 다른 Behavior |
|-
| **Sensor Rotation** | 엔코더 CW/CCW 회전에 따라 다른 Behavior |
| **Hold-Tap** || 홀드/탭 시간이나 인터럽트 키에 따라 다른 Behavior  
</SOURCE>
|-
| **Tap Dance** || 탭 횟수에 따라 다른 Behavior 실행  
|-
| **Mod-Morph** || 특정 Modifier 홀드 여부에 따라 다른 Behavior  
|-
| **Sensor Rotation** || 엔코더 CW/CCW 회전에 따라 다른 Behavior  
|}


----
----


Sputnik Corne 키보드에서 자주 쓰이는 것은 `&mt` (Mod-Tap), `&lt` (Layer-Tap), `&mo`, `&sk`, `&td` (Tap-Dance) 정도입니다.  
Sputnik Corne 키보드에서 자주 쓰이는 것은 `&mt` (Mod-Tap), `&lt` (Layer-Tap), `&mo`, `&sk`, `&td` (Tap-Dance) 정도입니다.
특정 Behavior 상세 설정이 궁금하시면 말씀해 주세요!

2026년 6월 9일 (화) 16:18 기준 최신판

ZMK의 Behavior 전체 목록

  • Behavior는 키맵 레이어의 키 위치, 센서(엔코더), 콤보에 할당되어 키를 누르거나 뗄 때 발생하는 동작을 정의합니다.
  • 다른 Behavior(예: 매크로)에서 재귀적으로 호출될 수도 있습니다.

🔑 Key Press Behaviors (키 입력)

캡션 텍스트
바인딩 Behavior 설명
`&kp` Key Press 키 눌렀을 때 호스트로 키코드 전송
`&mt` Mod Tap 홀드/탭에 따라 다른 키코드 전송
`&kt` Key Toggle 키 토글 (누른 상태 유지/해제)
`&sk` Sticky Key 다음 키 입력 시까지 유지 (Shift 원핸드 입력 등)
`&gresc` Grave Escape Shift/GUI 홀드 시 `` ` ``, 아닐 때 ESC
`&caps_word` Caps Word Caps Lock 유사하지만 특정 키 누르면 자동 해제
`&key_repeat` Key Repeat 직전에 보낸 키코드 재전송

🔀 Miscellaneous Behaviors

캡션 텍스트
바인딩 설명
`&trans` Transparent — 하위 활성 레이어로 키 전달
`&none` None — 키 입력 완전 차단

🗂️ Layer Navigation Behaviors

캡션 텍스트
바인딩 Behavior 설명
`&mo` Momentary Layer 누르는 동안 레이어 활성화
`&lt` Layer-tap 홀드 시 레이어, 탭 시 키코드
`&to` To Layer 해당 레이어만 활성화, 나머지 비활성
`&tog` Toggle Layer 수동으로 끌 때까지 레이어 유지
`&sl` Sticky Layer 다음 키 누를 때까지 레이어 활성

🖱️ Mouse Emulation Behaviors

캡션 텍스트
바인딩 설명
`&mkp` 마우스 버튼 클릭
`&mmv` 마우스 커서 이동
`&msc` 마우스 스크롤

🔄 Reset Behaviors

캡션 텍스트
바인딩 설명
`&sys_reset` 펌웨어 재시작
`&bootloader` 부트로더 모드 진입 (펌웨어 플래싱용)

📡 Output Selection Behaviors

캡션 텍스트
바인딩 설명
`&bt` 블루투스 동작 (기기 전환 등)
`&out` USB / BLE 출력 선택

💡 Lighting Behaviors

캡션 텍스트
바인딩 설명
`&rgb_ug` RGB 언더글로우 제어
`&bl` 백라이트 제어

⚡ Power Management Behaviors

캡션 텍스트
바인딩 설명
`&ext_power` VCC 전원 출력 ON/OFF (절전)
`&soft_off` 키보드 전원 끄기

🔓 ZMK Studio Behaviors

캡션 텍스트
바인딩 설명
`&studio_unlock` ZMK Studio UI에서 키맵 변경 허용 잠금 해제

🛠️ User-Defined Behaviors (사용자 정의)

캡션 텍스트
Behavior 설명
**Macros** 키 누름/뗌 시 여러 Behavior 순서대로 실행
**Hold-Tap** 홀드/탭 시간이나 인터럽트 키에 따라 다른 Behavior
**Tap Dance** 탭 횟수에 따라 다른 Behavior 실행
**Mod-Morph** 특정 Modifier 홀드 여부에 따라 다른 Behavior
**Sensor Rotation** 엔코더 CW/CCW 회전에 따라 다른 Behavior

Sputnik Corne 키보드에서 자주 쓰이는 것은 `&mt` (Mod-Tap), `&lt` (Layer-Tap), `&mo`, `&sk`, `&td` (Tap-Dance) 정도입니다.

Comments