Skip to content

Update EXAMPLES.md #183

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update EXAMPLES.md #183

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f3560af
Update EXAMPLES.md
rs-gh-asdf Jun 27, 2025
af23ae7
Update EXAMPLES.md
rs-gh-asdf Jun 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
146 changes: 126 additions & 20 deletions EXAMPLES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -512,39 +512,145 @@ Stylus Battery Strength: 77%

## Remap keyboard

Note that the keyboard matrix on Framework 12 and Framework 13 are
different.
The scancodes are the same.
The below information should be correct for all current (as of 06/2025) Intel and AMD Framework 13's.

- Left-Ctrl 0x0014
- Left-Alt 0x0014
- Tab 0x0058
For the Framework 16, use [VIA](https://keyboard.frame.work).

### Framework 12
For the Framework 12, there is a different keyboard matrix, but the scancodes are the same.

### General Instructions

To remap keys on your keyboard, you will run the command:

```
# Remap capslock key as left-ctrl
> framework_tool --remap-key 6 15 0x0014
sudo framework_tool --remap-key [Y] [X] [SCANCODE]
```

- **Y** is the row of the keyboard matrix for the key that you want to remap
- **X** is the column of the keyboard matrix for the key that you want to remap
- **SCANCODE** is the scancode that you want the key to send

# Swap left-ctrl and alt
> framework_tool --remap-key 1 14 0x0011
> framework_tool --remap-key 6 13 0x0014
### Specific Examples

#### FW13

Set **Caps Lock** to be **Esc**:

```
> sudo framework_tool --remap-key 4 4 0x0076
```

### Framework 13
Set **Enter** to be **Enter** (for example to fix it if you broke it):

```
# Remap capslock key as left-ctrl
> framework_tool --remap-key 4 4 0x0014
> sudo framework_tool --remap-key 1 14 0x005a
```

Swap **L_Alt** and **L_Control**:

```
> sudo framework_tool --remap-key 1 12 0x0011
> sudo framework_tool --remap-key 1 3 0x0014
```

#### FW12

set **Caps Lock** to be **Esc**:

# Swap left-ctrl and alt
> framework_tool --remap-key 1 12 0x0011
> framework_tool --remap-key 1 3 0x0014
```
> sudo framework_tool --remap-key 6 15 0x0076
```

Swap **L_Alt** and **L_Control**:

```
> sudo framework_tool --remap-key 1 14 0x0011
> sudo framework_tool --remap-key 6 13 0x0014
```

### Finding Keycodes and Matrix Addresses

- Mr. Howett put together a wonderul [map of the matrix](https://www.howett.net/data/framework_matrix/) for the FW13 here.
- The actual embedded controller source code contains a table that looks just the same to the matrix (albiet rotated). It can be found [here](https://github.com/FrameworkComputer/EmbeddedController/blob/f6620a8200e8d1b349078710b271540b5b8a1a18/board/hx30/keyboard_customization.c#L25).
- Some scancodes can be found in the embedded controller [source code](https://github.com/FrameworkComputer/EmbeddedController/blob/f6620a8200e8d1b349078710b271540b5b8a1a18/include/keyboard_8042_sharedlib.h#L106) and some can be found in [the original list from the kernel](http://kbd-project.org/docs/scancodes/scancodes-10.html#ss10.6).
- A full breakdown of all possible scancodes is [available](http://kbd-project.org/docs/scancodes/scancodes-1.html) but won't be useful to most users.

#### Scancodes

|ScanCode | Key | ScanCode | Key | ScanCode | Key | ScanCode | Key |
|----------|------------|-----------|--------------|----------------|---------------------|-----------|----------------------|
|0x000e | ` ~ |0x004b | L | 0x0075 | KP-8 / Up | 0x0017 | F14 |
|0x0016 | 1 ! | 0x004c | ; : | 0x0073 | KP-5 | 0x001f | F15 |
|0x001e | 2 @ | 0x0052 | ' " | 0x0072 | KP-2 / Down | 0xe038 | BACK |
|0x0026 | 3 # | 0x0000 | non-US-1 | 0x0070 | KP-0 / Ins | 0xe020 | REFRESH |
|0x0025 | 4 $ | 0x005a | Enter | 0x007c | KP-* | 0xe030 | FORWARD |
|0x002e | 5 % | 0x0012 | LShift | 0x007d | KP-9 / PgUp | 0xe01d | FULLSCREEN |
|0x0036 | 6 ^ | 0x001a | Z | 0x0074 | KP-6 / Right | 0xe024 | OVERVIEW |
|0x003d | 7 & | 0x0022 | X | 0x007a | KP-3 / PgDn | 0xe02d | SNAPSHOT |
|0x003e | 8 * | 0x0021 | C | 0x0071 | KP-. / Del | 0xe02c | BRIGHTNESS_DOWN |
|0x0046 | 9 ( | 0x002a | V | 0x007b | KP-- | 0xe035 | BRIGHTNESS_UP |
|0x0045 | 0 ) | 0x0032 | B | 0x0079 | KP-+ | 0xe03c | PRIVACY_SCRN_TOGGLE |
|0x004e | - _ |0x0031 | N | 0x00e0-5a | KP-Enter | 0xe023 | VOLUME_MUTE |
|0x0055 | = + | 0x003a | M | 0x0076 | Esc | 0xe021 | VOLUME_DOWN |
|0x0066 | Backspace | 0x0041 | , < | 0x0005 | F1 | 0xe032 | VOLUME_UP |
|0x000d | Tab | 0x0049 | . > | 0x0006 | F2 | 0xe043 | KBD_BKLIGHT_DOWN |
|0x0015 | Q | 0x004a | / ? | 0x0004 | F3 | 0xe044 | KBD_BKLIGHT_UP |
|0x001d | W | 0x0059 | RShift | 0x000c | F4 | 0xe04d | NEXT_TRACK |
|0x0024 | E | 0x0014 | LCtrl | 0x0003 | F5 | 0xe015 | PREV_TRACK |
|0x002d | R | 0x0011 | LAlt | 0x000b | F6 | 0xe054 | PLAY_PAUSE |
|0x002c | T | 0x0029 | space | 0x0083 | F7 | 0xe075 | UP |
|0x0035 | Y | 0x00e0-11| RAlt | 0x000a | F8 | 0xe072 | DOWN |
|0x003c | U | 0x00e0-14| RCtrl | 0x0001 | F9 | 0xe06b | LEFT |
|0x0043 | I | e0-70 | Insert | 0x0009 | F10 | 0xe074 | RIGHT |
|0x0044 | O | e0-71 | Delete | 0x0078 | F11 | 0x0014 | LEFT_CTRL |
|0x004d | P | e0-6c | Home | 0x0007 | F12 | 0xe014 | RIGHT_CTRL |
|0x0054 | [ { | e0-69 | End | 0x00e0-7c | PrtScr | 0x0011 | LEFT_ALT |
|0x005b | ] } | e0-7d | PgUp | 0x0084 | Alt+SysRq | 0xe011 | RIGHT_ALT |
|0x005d | \ \| | e0-7a | PgDn | 0x007e | ScrollLock | 0xe01f | LEFT_WIN |
|0x0058 | CapsLock | e0-6b | Left | 0x00e1-14-77 | Pause | 0xe027 | RIGHT_WIN |
|0x001c | A | e0-75 | Up | 0x00e0-7e | Ctrl+Break | 0xe02f | MENU |
|0x001b | S | e0-72 | Down | 0x00e0-1f | LWin (USB: LGUI) | 0xe037 | POWER |
|0x0023 | D | e0-74 | Right | 0x00e0-27 | RWin (USB: RGUI) | 0x0077 | NUMLOCK |
|0x002b | F | 0x0077 | NumLock | 0x00e0-2f | Menu | 0x0058 | CAPSLOCK |
|0x0034 | G | 0x006c | KP-7 / Home| 0x00e0-3f | Sleep | 0x007e | SCROLL_LOCK |
|0x0033 | H | 0x006b | KP-4 / Left| 0x00e0-37 | Power | 0xe07e | CTRL_BREAK |
|0x003b | J | 0x0069 | KP-1 / End | e0-5e | Wake | 0xe076 | RECOVERY |
|0x0042 | K | 0x00e0-4a| KP-/ | 0x000f | F13

#### Wiring Matrix

##### FrameWork 13

> Matrix w/ keys

| | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 |
|---|-----|----------|----------|------|---------------|--------------|---|---|-------------|--------|-----------------|-------------------|-------|---------------|----------------|----------------|
| 0 | c | Delete | q | RAlt | KP Enter | x |v |m | . | RShift | Comma | Katakana Hiragana | RCtrl | / | ' | Yen |
| 1 | KP- | KP Ins | KP0 | LAlt | Space | z |b |n | Down | LShift | KP* | Henkan |LCtrl | Up | Enter |Bright. Up F8 |
| 2 | KP+ | KP9 | Fn | | e | Vol. Down F2 |g |h | \ | |Bright. Down F7 | KP8 | | - |Scan Code e016 | Right |
| 3 | KP2 | LMeta | Tab | | Audio Prev F4 | Mute F1 |t |y | o | | Audio Next F6 | Project F9 | | Framework F12 | End | Scan Code e01a |
| 4 | KP3 | KP7 | ` | | Caps Lock | s |5 |6 | RF Kill F10 | | Play Pause F5 | Ro Kana | | 0 | + = | |
| 5 | KP. | Home | 1 | | 3 | 2 |4 |7 | 9 | | 8 | 102nd | | p | BS | KP4 |
| 6 | KP1 | Page Up | Muhenkan | | Vol. Up F3 | w |r |u | PrtScr F11 | | i | Left | | [ | ] | KP5 |
| 7 | KP/ | Num Lock | a | | Page Down | Escape |f |j | l | | k | Menu | | ; | d | KP6 |

> Matrix w/ scancodes

### Framework 16
| | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 |
| ---|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
| 0 | 0x0021 | 0xe071 | 0x0015 | 0xe011 | 0xe05a | 0x0022 | 0x002A | 0x003a | 0x0049 | 0x0059 | 0x0041 | 0x0013 | 0xe014 | 0x004a | 0x0052 | 0x006a |
| 1 | 0x007B | 0xe070 | 0x0070 | 0x0011 | 0x0029 | 0x001a | 0x0032 | 0x0031 | 0xe072 | 0x0012 | 0x007c | 0x0064 | 0x0014 | 0xe075 | 0x005a | 0x000a |
| 2 | 0x0079 | 0x007D | 0x00ff | 0x0000 | 0x0024 | 0x0006 | 0x0034 | 0x0033 | 0x005d | 0x0000 | 0x0083 | 0x0075 | 0x0000 | 0x004e | 0xe03c | 0xe074 |
| 3 | 0x0072 | 0xe01f | 0x000D | 0x0000 | 0x000c | 0x0005 | 0x002c | 0x0035 | 0x0044 | 0x0000 | 0x000b | 0x0001 | 0x0000 | 0x0007 | 0xe069 | 0xe054 |
| 4 | 0x007A | 0x006c | 0x000E | 0x0000 | 0x0058 | 0x001b | 0x002e | 0x0036 | 0x0009 | 0x0000 | 0x0003 | 0x0051 | 0x0000 | 0x0045 | 0x0055 | 0x0000 |
| 5 | 0x0071 | 0xe06c | 0x0016 | 0x0000 | 0x0026 | 0x001e | 0x0025 | 0x003d | 0x0046 | 0x0000 | 0x003e | 0x0061 | 0x0000 | 0x004d | 0x0066 | 0x006b |
| 6 | 0x0069 | 0xe07d | 0x0067 | 0x0000 | 0x0004 | 0x001d | 0x002d | 0x003c | 0x0078 | 0x0000 | 0x0043 | 0xe06b | 0x0000 | 0x0054 | 0x005b | 0x0073 |
| 7 | 0xe04A | 0x0077 | 0x001c | 0x0000 | 0xe07a | 0x0076 | 0x002b | 0x003b | 0x004b | 0x0000 | 0x0042 | 0xe02f | 0x0000 | 0x004c | 0x0023 | 0x0074 |

##### FrameWork 12

If anyone can find the source code with the FW12 matrix please let me know and I'll add info about that to this page. I don't have an FW12 so all my testing was done on an FW13.
Copy link
Member

@JohnAZoidberg JohnAZoidberg Jun 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I published it here, let's just link to it.
I think it's more useful to present the table with entries that are human readable, so the reader can know which key is in which row/col.
https://github.com/FrameworkComputer/Framework-Laptop-12/tree/main/InputCover#keyboard-matrix


It's not controlled by the EC, use https://keyboard.frame.work.

## Advanced commands

Expand Down