Skip to content

Clarify input deck board ID handling #27

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

Merged
kiram9 merged 1 commit into from
Feb 1, 2026
+42 −22
Merged

Clarify input deck board ID handling #27

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
64 changes: 42 additions & 22 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,28 +109,33 @@ Viewed from top:

![image](https://user-images.githubusercontent.com/28994301/223607129-ab8e1dcf-dd1f-49f1-9e67-03e9ca072348.png)

### BOARD_ID values

| Module Type | ID | Pulldown Resistor (on module) |
|--------------------------|----|-------------------------------|
| Short | 0 | NA |
| Reserved | 1 | 10000 |
| Reserved | 2 | 18000 |
| Reserved | 3 | 27000 |
| Reserved | 4 | 39000 |
| Reserved | 5 | 56000 |
| Generic Full Width | 6 | 68000 |
| Reserved | 7 | 82000 |
| Generic A size | 8 | 120000 |
| Generic B size | 9 | 150000 |
| Generic C size | 10 | 180000 |
| Numpad/Macropad (B size) | 11 | 270000 |
| Keyboard (A size) | 12 | 330000 |
| Touchpad | 13 | 560000 |
| Reserved | 14 | 820000 |
| Not installed | 15 | NA |

The LED matrix and plastic spacers are both C size.
### Module Type Detection

Embedded Controller firmware detects location, type and size of modules by
measuring the value of a pull down resistor on each connector.
This detection is only used for diagnostics and power sequencing (see below).
USB functionality is enabled on any connector no matter the module type or presence.

| ID | Row | Module Type | Size | Module Pulldown Resistor |
|----|--------|----------------------|------|--------------------------|
| 0 | | Short | | NA |
| 1 | | Reserved | | 10000 |
| 2 | | Reserved | | 18000 |
| 3 | | Reserved | | 27000 |
| 4 | | Reserved | | 39000 |
| 5 | | Reserved | | 56000 |
| 6 | Top | Generic Full Width | Full | 68000 |
| 7 | | Reserved | | 82000 |
| 8 | Top | Generic A size | A | 120000 |
| 9 | Top | Generic B size | B | 150000 |
| 10 | Top | Generic C size | C | 180000 |
| 11 | Top | Numpad/Macropad | B | 270000 |
| 12 | Top | Keyboard | A | 330000 |
| 13 | Bottom | Touchpad | B | 560000 |
| 14 | | Reserved | | 820000 |
| 15 | Both | Not installed | | NA |

The LED matrix and plastic spacers are both "Generic C size".

### Power

Expand All @@ -144,6 +149,21 @@ ID, is at the very left of the module. It uses this assumption to calculate
size and position of modules and detect if the input deck is fully populated
and all pogo pins are covered.

The following top-row combinations are accepted by firmware:

| Conn 1 | Conn 2 | Conn 3 | Conn 4 | Conn 5 |
|--------|--------|--------|--------|--------|
| Full | | | | |
| | Full | | | |
| | | Full | | |
| | | | Full | |
| | | | | Full |
| A | | | B | |
| A | | | C | C |
| C | A | | | C |
| B | | A | | |
| C | C | A | | |

#### `SLEEP#` pin behavior

| Platform | BIOS | `SLEEP#` |
Expand Down