Keycode는 어떻게 인식될까?
물리 키 위치가 QMK 키코드와 USB HID 입력으로 바뀌는 과정
- 키보드는 키캡에 적힌 문자보다 먼저 스위치가 연결된 행과 열 위치를 감지합니다.
- QMK는 감지된 매트릭스 좌표를 현재 활성화된 레이어의 Keycode로 변환합니다.
- KC_A 같은 기본 Keycode는 일반적으로 USB HID Usage ID와 연결됩니다.
- 레이어 전환, Mod-Tap, 매크로처럼 복합 기능을 가진 Keycode는 QMK 내부에서 추가 처리를 거칩니다.
- 최종적으로 만들어진 HID 리포트를 운영체제가 해석해 문자 입력이나 단축키 동작을 실행합니다.
키보드에서 A 키를 누르면 컴퓨터 화면에 곧바로 알파벳 A가 나타나는 것처럼 보입니다. 하지만 키보드 내부에서는 스위치가 눌린 순간부터 운영체제가 문자를 표시하기까지 여러 단계의 변환이 일어납니다. 그 중심에 있는 값이 바로 Keycode입니다.
Keycode는 단순히 특정 문자를 의미하는 이름이 아닙니다. 펌웨어가 감지한 물리적인 키 위치에 어떤 기능을 부여할지 결정하는 숫자 값에 가깝습니다. 같은 스위치라도 기본 레이어에서는 A가 될 수 있고, Fn 레이어에서는 볼륨 조절이나 방향키가 될 수 있습니다. 따라서 키보드가 인식하는 것은 처음부터 문자가 아니라 매트릭스 좌표와 그 좌표에 배정된 기능 값입니다.
특히 QMK Firmware에서는 기본 문자 키뿐 아니라 레이어 전환, Ctrl 조합, Tap-Hold, 매크로, 마우스 이동, 미디어 제어까지 다양한 동작을 Keycode 형태로 관리합니다. 이번 글에서는 스위치가 눌린 뒤 Keycode가 선택되고, QMK 내부 처리 과정을 거쳐 USB HID 리포트로 전달되는 흐름을 순서대로 살펴보겠습니다.
1. Keycode는 키캡에 적힌 문자가 아니다
Keycode를 이해할 때 가장 먼저 구분해야 하는 것은 물리 키, Keycode, 실제 입력 문자가 서로 다른 개념이라는 점입니다. 키캡에 A가 인쇄되어 있어도 키보드 회로와 펌웨어가 그 글자를 직접 읽는 것은 아닙니다.
스위치를 누르면 전기적으로 특정 행과 열이 연결됩니다. MCU는 키보드 매트릭스를 반복해서 스캔하면서 이전 상태와 현재 상태가 달라진 지점을 찾습니다. 예를 들어 2번 행과 4번 열의 스위치가 새롭게 연결되었다면 펌웨어는 먼저 “2행 4열 키가 눌렸다”라는 사실을 알아냅니다.
그다음 QMK는 현재 활성화된 레이어의 키맵에서 해당 좌표를 조회합니다. 2행 4열에 KC_A가 저장되어 있다면 그제야 이 물리 입력은 KC_A라는 Keycode로 변환됩니다. 같은 좌표에 KC_LEFT가 배치되어 있다면 방향키 왼쪽으로 처리되고, MO(1)가 배치되어 있다면 레이어를 일시적으로 활성화하는 키가 됩니다.
특정 키가 예상과 다른 문자를 입력한다고 해서 항상 스위치나 PCB 문제인 것은 아닙니다. 키맵의 Keycode 배정과 운영체제의 키보드 언어 배열을 먼저 확인하는 것이 좋습니다.
QMK의 언어별 Keycode 별칭은 운영체제의 언어 설정을 직접 변경하지 않습니다. 예를 들어 특정 국가 배열을 위한 별칭을 사용해도 실제 출력 문자는 호스트 운영체제에 선택된 키보드 레이아웃에 따라 결정됩니다. Keycode는 문자 자체보다 키보드 위치와 기능을 전달하는 식별자에 가깝습니다.
2. 키를 누르면 먼저 매트릭스 좌표가 발견된다
대부분의 기계식 키보드는 각 스위치를 MCU 핀에 하나씩 직접 연결하지 않고 행과 열로 구성된 매트릭스를 사용합니다. 예를 들어 5개의 행과 15개의 열을 조합하면 비교적 적은 수의 MCU 핀으로 많은 스위치를 검사할 수 있습니다.
MCU는 한쪽 라인을 순서대로 활성화하고 반대쪽 라인의 전기 상태를 읽는 방식으로 전체 키를 스캔합니다. 특정 행을 활성화했을 때 특정 열에서 신호 변화가 감지되면 그 교차점에 있는 스위치가 눌린 것으로 판단합니다. 이때 얻는 정보는 아직 KC_A나 KC_ENTER가 아니라 행 번호와 열 번호입니다.
스위치는 접점이 맞닿는 순간 짧은 시간 동안 신호가 여러 번 흔들릴 수 있습니다. 펌웨어는 디바운스 처리를 통해 이 흔들림을 하나의 정상적인 입력으로 정리합니다. 안정된 상태 변화가 확인되면 QMK는 해당 좌표의 키 이벤트를 생성하며, 눌림과 떼어짐을 각각 구분합니다.
- MCU가 매트릭스의 행과 열을 반복해서 스캔합니다.
- 이전 스캔과 현재 스캔의 상태를 비교합니다.
- 디바운스 처리를 거쳐 실제 눌림인지 판단합니다.
- 변화가 발생한 행과 열 좌표를 확인합니다.
- 눌림 또는 떼어짐 상태가 포함된 키 이벤트를 생성합니다.
- 활성 레이어의 키맵에서 해당 좌표의 Keycode를 조회합니다.
이 구조 덕분에 물리 키의 위치와 기능을 분리할 수 있습니다. PCB의 스위치 위치는 그대로 두고 펌웨어의 키맵만 변경해도 완전히 다른 배열을 만들 수 있는 이유입니다. QWERTY 배열을 Colemak이나 Dvorak으로 바꾸거나, Caps Lock 위치에 Ctrl을 배치하는 것도 같은 원리입니다.
3. QMK는 활성 레이어에서 Keycode를 찾는다
매트릭스 좌표가 확인되면 QMK는 keymaps 배열에서 해당 위치의 값을 조회합니다. QMK 키맵은 일반적으로 레이어, 행, 열로 구성된 다차원 구조를 사용하며 각 위치에는 16비트 형태의 액션 코드가 저장됩니다.
기본 레이어가 활성화된 상태에서 A 위치를 누르면 Layer 0의 해당 좌표를 확인합니다. 그러나 Fn 키로 Layer 1이 활성화되어 있다면 같은 물리 위치에서도 Layer 1의 값을 먼저 확인합니다. Layer 1에 KC_F1이 배치되어 있다면 A가 아니라 F1 기능으로 처리됩니다.
상위 레이어의 해당 위치가 KC_TRNS로 설정되어 있으면 QMK는 그 키를 투명한 위치로 판단합니다. 즉 현재 레이어에서 기능을 확정하지 않고 아래쪽 레이어로 내려가 실제 Keycode를 찾습니다. 반대로 KC_NO가 배치되어 있으면 해당 위치는 아무 동작도 하지 않습니다.
레이어는 각각 독립된 키보드가 겹쳐 있는 구조에 가깝습니다. QMK는 활성화된 레이어 가운데 우선순위가 높은 레이어부터 좌표를 확인하고, 투명 키를 만나면 아래 레이어로 내려갑니다. 따라서 레이어가 활성화되었다고 해서 모든 키가 반드시 바뀌는 것은 아닙니다.
4. KC_A는 내부적으로 숫자 값으로 처리된다
QMK의 키맵 파일을 보면 KC_A, KC_ENTER, KC_LCTRL 같은 이름이 사용됩니다. 사람이 보기에는 문자와 기능 이름이지만 컴파일 과정이 끝난 펌웨어에서는 숫자 값으로 처리됩니다. 이 이름들은 개발자가 키맵을 읽고 수정하기 쉽게 만든 기호입니다.
QMK 공식 문서에 따르면 Quantum Keycode는 일정한 숫자 범위 안에서 관리됩니다. 기본 키에 해당하는 표준 Keycode는 낮은 범위를 사용하고, 레이어 전환이나 Mod-Tap처럼 추가 정보가 필요한 기능은 다른 비트 영역을 활용합니다. 겉으로는 함수처럼 보이는 Keycode도 전처리와 컴파일 과정을 거치면 펌웨어가 해석할 수 있는 값으로 변환됩니다.
예를 들어 KC_A는 일반적인 키보드 입력을 나타내는 기본 Keycode입니다. 반면 LCTL(KC_C)는 Ctrl과 C를 함께 보내는 조합을 표현하며, LT(1, KC_SPC)는 짧게 누르면 Space를 보내고 길게 누르면 Layer 1을 활성화하도록 구성됩니다. 이 값들은 모두 같은 방식으로 처리되지 않고 Keycode의 종류에 따라 서로 다른 QMK 처리 루틴으로 전달됩니다.
QMK Keycode 이름과 USB HID Usage ID를 완전히 같은 개념으로 보면 안 됩니다. 기본 Keycode는 HID 값과 직접 연결되는 경우가 많지만, 레이어 전환이나 매크로 같은 QMK 전용 Keycode는 호스트로 그대로 전송되지 않고 펌웨어 내부 동작으로 먼저 해석됩니다.
5. 기본 Keycode와 QMK 전용 Keycode의 차이
모든 Keycode가 컴퓨터로 곧바로 전송되는 것은 아닙니다. KC_A나 KC_ENTER 같은 기본 Keycode는 최종적으로 USB HID 키보드 리포트에 반영될 수 있지만, MO(1), TG(2), QK_BOOT 같은 QMK 전용 Keycode는 키보드 내부 상태를 변경하기 위해 사용됩니다.
MO(1)을 누르면 운영체제에 “MO(1) 키가 눌렸다”라는 값이 전달되는 것이 아닙니다. QMK가 해당 Keycode를 먼저 가로채 Layer 1을 활성화하고, 이후 다른 키가 눌렸을 때 Layer 1의 키맵을 조회하도록 내부 상태를 변경합니다. 키를 떼면 해당 레이어를 다시 비활성화합니다.
Mod-Tap과 Layer-Tap처럼 하나의 키에 두 가지 기능이 들어 있는 Keycode는 눌린 시간, 다른 키의 입력 여부, 탭 횟수 같은 추가 조건도 확인합니다. 따라서 같은 키를 눌러도 짧게 누른 경우와 길게 누른 경우의 결과가 달라질 수 있습니다.
- 스위치가 눌리면서 매트릭스의 전기 상태가 변합니다.
- MCU가 행과 열 좌표의 변화를 발견합니다.
- 디바운스 후 눌림 또는 떼어짐 이벤트가 확정됩니다.
- 활성 레이어의 키맵에서 16비트 Keycode를 찾습니다.
- QMK가 Keycode 종류와 추가 조건을 분석합니다.
- 내부 기능이면 레이어나 펌웨어 상태를 변경합니다.
- 일반 입력이면 HID 리포트에 키 상태를 반영합니다.
- 운영체제가 HID 입력을 현재 언어 배열에 맞게 해석합니다.
Keycode 인식은 키캡의 문자를 읽는 과정이 아니라 매트릭스 좌표를 찾고, 활성 레이어의 키맵에서 기능 값을 조회하는 과정입니다. 기본 Keycode는 HID 입력으로 이어질 수 있지만 레이어, Tap-Hold, 매크로 같은 QMK 전용 Keycode는 펌웨어 내부에서 먼저 해석됩니다. 다음 내용에서는 process_record 처리 과정, HID 리포트 생성, 운영체제가 최종 문자를 결정하는 원리와 Keycode 오류를 확인하는 방법을 이어서 살펴보겠습니다.
6. QMK는 Keycode를 어떤 순서로 처리할까?
활성 레이어에서 Keycode를 찾았다고 해서 곧바로 PC에 전송되는 것은 아닙니다. QMK는 조회된 Keycode를 여러 처리 단계에 통과시킨 뒤, 최종적으로 어떤 입력을 전송할지 결정합니다.
이 과정이 필요한 이유는 QMK의 Keycode가 단순한 문자 입력만 표현하지 않기 때문입니다. 일반 키보드의 A 키처럼 바로 전송할 수 있는 입력도 있지만, 레이어 전환, 탭과 홀드 구분, 매크로, 모드 전환처럼 펌웨어 내부에서 먼저 해석해야 하는 기능도 있습니다.
- 키보드 매트릭스에서 눌린 위치를 확인합니다.
- 현재 활성화된 레이어를 확인합니다.
- 키맵에서 해당 위치의 Keycode를 조회합니다.
- QMK 내부 기능이 먼저 Keycode를 검사합니다.
- 사용자 정의 처리 함수가 입력을 확인합니다.
- 전송 가능한 HID 입력으로 변환합니다.
- USB 또는 무선 연결을 통해 PC로 전달합니다.
예를 들어 키맵에서 조회된 값이 KC_A라면 비교적 단순합니다. QMK는 A 키가 눌렸다는 정보를 HID 리포트에 추가할 수 있습니다. 하지만 조회된 값이 MO(1)이라면 PC에 MO(1)이라는 키를 보내는 것이 아닙니다.
MO(1)은 QMK 내부에서만 의미가 있는 레이어 기능입니다. 이 Keycode가 눌리는 동안 QMK는 1번 레이어를 활성화하고, 키를 놓으면 다시 비활성화합니다. 즉 일부 Keycode는 운영체제로 전송되는 입력이고, 일부는 펌웨어의 상태를 바꾸는 명령입니다.
모든 Keycode가 PC로 그대로 전송되는 것은 아닙니다. 기본 키는 HID 입력으로 변환되지만, 레이어·매크로·탭홀드 같은 기능 키는 QMK 내부에서 먼저 처리됩니다.
7. process_record_user는 어떤 역할을 할까?
QMK에서 사용자 정의 Keycode를 만들거나 특정 키의 동작을 변경할 때 자주 사용하는 함수가 process_record_user입니다. 이 함수는 Keycode가 최종 처리되기 전에 사용자가 입력을 직접 확인하고 필요한 동작을 추가할 수 있게 해줍니다.
함수에는 현재 인식된 Keycode와 키가 눌렸는지 또는 놓였는지를 나타내는 기록이 전달됩니다. 사용자는 이 값을 기준으로 특정 Keycode가 눌렸을 때 문자열을 입력하거나, 다른 키 조합을 실행하거나, 펌웨어 상태를 변경할 수 있습니다.
- 사용자 정의 Keycode 동작 실행
- 특정 키를 다른 키 조합으로 변환
- 문자열이나 단축키 전송
- 키가 눌릴 때와 놓일 때의 동작 분리
- 조건에 따라 기본 Keycode 처리 차단
이 함수의 반환값도 중요합니다. 일반적으로 true를 반환하면 QMK가 해당 Keycode의 기본 처리를 계속 진행합니다. 반대로 false를 반환하면 이후 기본 처리를 중단할 수 있습니다.
예를 들어 사용자 정의 Keycode가 눌렸을 때 이미 원하는 매크로를 실행했다면 false를 반환해 동일한 입력이 추가로 처리되지 않도록 만들 수 있습니다. 반면 단순히 입력 상태만 확인하고 원래 Keycode도 정상적으로 동작하게 하려면 true를 반환합니다.
process_record_user는 Keycode를 새로 만드는 기능이라기보다, 이미 인식된 Keycode가 어떤 동작을 해야 하는지 사용자가 개입할 수 있는 지점이라고 이해하면 쉽습니다.
8. Keycode는 HID 리포트로 어떻게 변환될까?
QMK 내부 처리가 끝난 기본 Keycode는 USB HID 규격에 맞는 입력 정보로 변환됩니다. 이때 키보드는 문자 자체를 보내는 것이 아니라, 현재 어떤 키들이 눌려 있는지를 담은 HID 리포트를 전송합니다.
예를 들어 사용자가 A 키를 누르면 키보드는 PC에 영문 소문자 a라는 글자를 직접 전송하지 않습니다. 대신 키보드 사용 페이지에서 A 위치에 해당하는 HID Usage 정보를 리포트에 기록합니다.
이후 운영체제가 현재 키보드 배열, Shift 키 상태, Caps Lock 상태, 입력 언어를 확인해 실제 화면에 어떤 문자를 표시할지 결정합니다.
Keycode와 화면에 표시되는 문자는 같은 개념이 아닙니다. 같은 KC_A 입력이라도 키보드 배열과 입력 언어에 따라 운영체제가 다르게 해석할 수 있습니다.
9. Shift·Ctrl·Alt는 일반 키와 무엇이 다를까?
Shift, Ctrl, Alt, GUI 키는 일반 문자 키와 함께 조합되는 수식 키입니다. HID 키보드 리포트에서는 이러한 키의 상태가 일반 키와 구분되어 관리되는 경우가 많습니다.
예를 들어 Ctrl+C를 입력하면 QMK는 Ctrl이 눌린 상태와 C가 눌린 상태를 함께 리포트에 반영합니다. 운영체제는 이 조합을 문자 입력이 아니라 복사 명령으로 해석합니다.
QMK에서는 LCTL(KC_C)처럼 하나의 표현 안에 수식 키와 기본 Keycode를 조합할 수도 있습니다. 이렇게 작성된 Keycode는 눌리는 순간 Ctrl과 C가 함께 활성화되고, 키를 놓으면 함께 해제되는 방식으로 처리됩니다.
- KC_LSFT — 왼쪽 Shift
- KC_LCTL — 왼쪽 Ctrl
- KC_LALT — 왼쪽 Alt
- KC_LGUI — Windows 키 또는 Command 키
- LCTL(KC_C) — Ctrl+C 조합
이 구조 덕분에 키 하나로 여러 키의 조합을 실행할 수 있습니다. 다만 운영체제마다 단축키 체계가 다르므로, Windows와 macOS에서 같은 Keycode 조합이 서로 다른 기능으로 동작할 수 있습니다.
10. 탭홀드 Keycode는 어떻게 구분할까?
QMK의 강력한 기능 중 하나는 키를 짧게 눌렀을 때와 길게 누르고 있을 때 서로 다른 동작을 실행하는 탭홀드 기능입니다.
예를 들어 LT(1, KC_SPC)는 짧게 누르면 Space로 동작하고, 누른 채 유지하면 1번 레이어를 활성화합니다. 하나의 물리 키가 두 가지 역할을 가지는 것입니다.
이 경우 QMK는 키가 눌린 순간 바로 Space를 전송하기 어렵습니다. 사용자가 짧게 누를지, 계속 누르고 있을지 아직 알 수 없기 때문입니다. 따라서 설정된 탭 판정 시간과 이후 입력을 확인해 탭인지 홀드인지 결정합니다.
일반 Keycode는 눌린 즉시 처리할 수 있지만, 탭홀드 Keycode는 입력 시간과 다른 키의 입력 여부까지 확인해야 최종 동작을 결정할 수 있습니다.
이 때문에 탭홀드 설정에서는 타이핑 습관이 중요합니다. 판정 시간이 너무 짧으면 의도하지 않은 홀드가 발생할 수 있고, 너무 길면 레이어 전환이나 수식 키 동작이 늦게 느껴질 수 있습니다.
11. Keycode를 눌렀는데 다른 문자가 나오는 이유
QMK 키맵에서 KC_A를 지정했는데 예상과 다른 문자가 입력된다면, 펌웨어가 Keycode를 잘못 인식했다고 단정하기는 어렵습니다. 키보드는 정상적인 HID 위치 정보를 보냈지만 운영체제의 키보드 배열이 다르게 설정되어 있을 수 있기 때문입니다.
특히 ANSI와 ISO 배열, 영문과 한글 입력기, 미국식과 유럽식 키보드 레이아웃 사이에는 같은 물리 위치를 다르게 해석하는 경우가 있습니다.
- 현재 활성화된 QMK 레이어가 맞는지 확인
- VIA 또는 키맵에서 지정한 Keycode 확인
- Windows 또는 macOS의 키보드 배열 확인
- 입력 언어와 한영 전환 상태 확인
- Shift, Ctrl, Alt 같은 수식 키가 남아 있지 않은지 확인
- 탭홀드 판정이 의도대로 작동하는지 확인
Keycode는 키보드 펌웨어와 운영체제 사이의 약속입니다. 따라서 문제를 확인할 때는 물리 스위치, QMK 키맵, HID 전송, 운영체제 배열을 각각 나누어 살펴보는 것이 좋습니다.
12. Keycode 동작을 확인하는 방법
사용자 정의 키맵을 수정한 뒤에는 실제로 어떤 Keycode가 인식되는지 확인하는 과정이 필요합니다. 화면에 입력되는 문자만 보면 펌웨어에서 어떤 단계가 잘못되었는지 구분하기 어렵기 때문입니다.
기본적인 확인 방법은 키보드 테스트 도구를 사용해 눌린 키를 확인하는 것입니다. 더 깊게 확인하려면 QMK의 콘솔과 디버깅 기능을 이용해 매트릭스 좌표, Keycode, 키 이벤트가 어떻게 처리되는지 살펴볼 수 있습니다.
- 키 입력 자체가 감지되지 않으면 매트릭스 또는 하드웨어 확인
- 다른 Keycode가 조회되면 레이어와 키맵 확인
- Keycode는 맞지만 기능이 다르면 사용자 정의 함수 확인
- HID 입력은 맞지만 문자가 다르면 운영체제 배열 확인
QMK 콘솔을 사용하려면 펌웨어에서 콘솔 기능을 활성화해야 하며, 키보드와 MCU에 따라 지원 방식이 다를 수 있습니다. 일반 사용자는 먼저 VIA 키 테스터와 운영체제의 키보드 뷰어를 확인하고, 펌웨어를 직접 개발할 때 콘솔 디버깅을 사용하는 것이 효율적입니다.
13. Keycode를 이해할 때 자주 하는 실수
Keycode는 이름만 보면 단순해 보이지만, 실제로는 펌웨어 기능과 HID 규격, 운영체제 해석이 연결된 개념입니다. 아래와 같은 부분에서 혼동이 자주 발생합니다.
- Keycode를 화면에 표시되는 문자와 동일하게 생각하는 것
- 모든 QMK Keycode가 PC로 직접 전송된다고 생각하는 것
- 물리 키 위치와 Keycode가 항상 고정되어 있다고 생각하는 것
- 레이어가 바뀌어도 같은 키가 같은 기능을 한다고 생각하는 것
- 펌웨어 문제와 운영체제 키보드 배열 문제를 구분하지 않는 것
가장 중요한 기준은 물리 위치 → 활성 레이어 → Keycode → QMK 내부 처리 → HID 리포트 → 운영체제 해석의 순서입니다. 입력 문제가 생겼을 때 이 순서를 따라가면 어느 단계에서 예상과 달라졌는지 찾기 쉬워집니다.
QMK의 Keycode는 단순한 키 이름이 아니라 펌웨어가 실행할 동작을 표현하는 명령 값입니다. 일부는 HID 입력이 되고, 일부는 레이어나 매크로처럼 키보드 내부 상태를 바꿉니다.
14. 자주 묻는 질문
아닙니다. 키보드는 A 키 위치에 해당하는 HID 입력 정보를 보내고, 운영체제가 현재 언어와 키보드 배열을 기준으로 최종 문자를 결정합니다.
가능합니다. 레이어마다 서로 다른 Keycode를 배치할 수 있으며, 탭홀드 기능을 사용하면 짧게 누를 때와 길게 누를 때의 동작도 나눌 수 있습니다.
MO(1)은 QMK 내부에서 레이어를 활성화하는 기능입니다. 일반 문자 키처럼 운영체제로 그대로 전송되는 값은 아닙니다.
일반적으로 사용자 정의 Keycode 값을 선언한 뒤 process_record_user 함수에서 해당 값이 눌렸을 때 실행할 동작을 작성합니다.
대부분의 경우 숫자를 외울 필요는 없습니다. KC_A, KC_ENT, MO(1)처럼 QMK가 제공하는 이름을 사용하면 컴파일 과정에서 실제 값으로 변환됩니다.
가능합니다. 운영체제에 설정된 키보드 언어와 배열이 다르면 동일한 HID 입력도 다른 문자로 해석될 수 있습니다.
📚 함께 보면 좋은 글
Keycode가 인식되는 전체 흐름을 이해했다면 펌웨어, 저장 공간, MCU 구조까지 함께 살펴보세요. 각각의 개념이 연결되면 키보드가 입력을 처리하는 과정이 더 명확해집니다.
🔗 공식 자료
📖 출처
- QMK Firmware 공식 문서 — Keycodes
- QMK Firmware 공식 문서 — Keymap Overview
- QMK Firmware 공식 문서 — Quantum Keycodes
- QMK Firmware 공식 문서 — Custom Quantum Functions
- QMK Firmware 공식 문서 — Tap-Hold Configuration
- USB Implementers Forum HID Usage Tables
Keycode는 키캡에 적힌 문자가 아니라, 매트릭스 위치와 활성 레이어를 바탕으로 QMK가 찾아낸 동작 값입니다. 이 값은 펌웨어 내부 기능으로 처리되거나 HID 리포트로 변환된 뒤 운영체제에서 최종 입력으로 해석됩니다.
