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

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

데브카페
편집 요약 없음
편집 요약 없음
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) 정도입니다.

2026년 6월 9일 (화) 16:16 판

ZMK의 Behavior 전체 목록

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

🔑 Key Press Behaviors (키 입력)

캡션 텍스트
바인딩 Behavior 설명
`&kp` Key Press
`&mt` Mod Tap
`&kt` Key Toggle
`&sk` Sticky Key
`&gresc` Grave Escape
`&caps_word` Caps Word
`&key_repeat` Key Repeat

🔀 Miscellaneous Behaviors

캡션 텍스트
바인딩 설명
`&trans`
`&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`

💡 Lighting Behaviors

캡션 텍스트
바인딩 설명
`&rgb_ug`
`&bl`

⚡ Power Management Behaviors

캡션 텍스트
바인딩 설명
`&ext_power`
`&soft_off`

🔓 ZMK Studio Behaviors

캡션 텍스트
바인딩 설명
`&studio_unlock`

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

캡션 텍스트
Behavior 설명
**Macros**
**Hold-Tap**
**Tap Dance**
**Mod-Morph**
**Sensor Rotation**

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

Comments