Pearl Boards Pearl Layout Addition (#20765)

* add matrix_diagram.md

* info.json: apply friendly formatting

* add LAYOUT_625u_space

2 files changed, 114 insertions, 44 deletions

diff --git a/keyboards/pearlboards/pearl/info.json b/keyboards/pearlboards/pearl/info.json
index af1eeae994..c14c6685b3 100644
--- a/keyboards/pearlboards/pearl/info.json
+++ b/keyboards/pearlboards/pearl/info.json
@@ -28,53 +28,102 @@
     "layouts": {
         "LAYOUT_all": {
             "layout": [
-                {"matrix": [0, 0], "x": 0, "y": 0},
-                {"matrix": [0, 1], "x": 1, "y": 0},
-                {"matrix": [0, 2], "x": 2, "y": 0},
-                {"matrix": [0, 3], "x": 3, "y": 0},
-                {"matrix": [0, 4], "x": 4, "y": 0},
-                {"matrix": [0, 5], "x": 5, "y": 0},
-                {"matrix": [0, 6], "x": 6, "y": 0},
-                {"matrix": [0, 7], "x": 7, "y": 0},
-                {"matrix": [0, 8], "x": 8, "y": 0},
-                {"matrix": [0, 9], "x": 9, "y": 0},
-                {"matrix": [0, 10], "x": 10, "y": 0},
-                {"matrix": [0, 11], "x": 11, "y": 0},
-                {"matrix": [0, 12], "x": 12, "y": 0},
+                {"label": "Esc", "matrix": [0, 0], "x": 0, "y": 0},
+                {"label": "Q", "matrix": [0, 1], "x": 1, "y": 0},
+                {"label": "W", "matrix": [0, 2], "x": 2, "y": 0},
+                {"label": "E", "matrix": [0, 3], "x": 3, "y": 0},
+                {"label": "R", "matrix": [0, 4], "x": 4, "y": 0},
+                {"label": "T", "matrix": [0, 5], "x": 5, "y": 0},
+                {"label": "Y", "matrix": [0, 6], "x": 6, "y": 0},
+                {"label": "U", "matrix": [0, 7], "x": 7, "y": 0},
+                {"label": "I", "matrix": [0, 8], "x": 8, "y": 0},
+                {"label": "O", "matrix": [0, 9], "x": 9, "y": 0},
+                {"label": "P", "matrix": [0, 10], "x": 10, "y": 0},
+                {"label": "-", "matrix": [0, 11], "x": 11, "y": 0},
+                {"label": "Backspace", "matrix": [0, 12], "x": 12, "y": 0},
 
-                {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
-                {"matrix": [1, 1], "x": 1.5, "y": 1},
-                {"matrix": [1, 2], "x": 2.5, "y": 1},
-                {"matrix": [1, 3], "x": 3.5, "y": 1},
-                {"matrix": [1, 4], "x": 4.5, "y": 1},
-                {"matrix": [1, 5], "x": 5.5, "y": 1},
-                {"matrix": [1, 6], "x": 6.5, "y": 1},
-                {"matrix": [1, 7], "x": 7.5, "y": 1},
-                {"matrix": [1, 8], "x": 8.5, "y": 1},
-                {"matrix": [1, 9], "x": 9.5, "y": 1},
-                {"matrix": [1, 10], "x": 10.5, "y": 1},
-                {"matrix": [1, 11], "x": 11.5, "y": 1, "w": 1.5},
+                {"label": "Tab", "matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+                {"label": "A", "matrix": [1, 1], "x": 1.5, "y": 1},
+                {"label": "S", "matrix": [1, 2], "x": 2.5, "y": 1},
+                {"label": "D", "matrix": [1, 3], "x": 3.5, "y": 1},
+                {"label": "F", "matrix": [1, 4], "x": 4.5, "y": 1},
+                {"label": "G", "matrix": [1, 5], "x": 5.5, "y": 1},
+                {"label": "H", "matrix": [1, 6], "x": 6.5, "y": 1},
+                {"label": "J", "matrix": [1, 7], "x": 7.5, "y": 1},
+                {"label": "K", "matrix": [1, 8], "x": 8.5, "y": 1},
+                {"label": "L", "matrix": [1, 9], "x": 9.5, "y": 1},
+                {"label": ";", "matrix": [1, 10], "x": 10.5, "y": 1},
+                {"label": "Enter", "matrix": [1, 11], "x": 11.5, "y": 1, "w": 1.5},
 
-                {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
-                {"matrix": [2, 1], "x": 1.75, "y": 2},
-                {"matrix": [2, 2], "x": 2.75, "y": 2},
-                {"matrix": [2, 3], "x": 3.75, "y": 2},
-                {"matrix": [2, 4], "x": 4.75, "y": 2},
-                {"matrix": [2, 5], "x": 5.75, "y": 2},
-                {"matrix": [2, 6], "x": 6.75, "y": 2},
-                {"matrix": [2, 7], "x": 7.75, "y": 2},
-                {"matrix": [2, 8], "x": 8.75, "y": 2},
-                {"matrix": [2, 9], "x": 9.75, "y": 2},
-                {"matrix": [2, 10], "x": 10.75, "y": 2},
-                {"matrix": [2, 11], "x": 11.75, "y": 2, "w": 1.25},
+                {"label": "Caps Lock", "matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+                {"label": "Z", "matrix": [2, 1], "x": 1.75, "y": 2},
+                {"label": "X", "matrix": [2, 2], "x": 2.75, "y": 2},
+                {"label": "C", "matrix": [2, 3], "x": 3.75, "y": 2},
+                {"label": "V", "matrix": [2, 4], "x": 4.75, "y": 2},
+                {"label": "B", "matrix": [2, 5], "x": 5.75, "y": 2},
+                {"label": "N", "matrix": [2, 6], "x": 6.75, "y": 2},
+                {"label": "M", "matrix": [2, 7], "x": 7.75, "y": 2},
+                {"label": ",", "matrix": [2, 8], "x": 8.75, "y": 2},
+                {"label": ".", "matrix": [2, 9], "x": 9.75, "y": 2},
+                {"label": "/", "matrix": [2, 10], "x": 10.75, "y": 2},
+                {"label": "Shift", "matrix": [2, 11], "x": 11.75, "y": 2, "w": 1.25},
 
-                {"matrix": [3, 0], "x": 1.125, "y": 3},
-                {"matrix": [3, 1], "x": 2.125, "y": 3, "w": 1.25},
-                {"matrix": [3, 2], "x": 3.38, "y": 3, "w": 1.25},
-                {"matrix": [3, 3], "x": 4.625, "y": 3, "w": 2.25},
-                {"matrix": [3, 4], "x": 6.875, "y": 3, "w": 2.75},
-                {"matrix": [3, 5], "x": 9.625, "y": 3, "w": 1.25},
-                {"matrix": [3, 6], "x": 10.875, "y": 3}
+                {"label": "Ctrl", "matrix": [3, 0], "x": 1.125, "y": 3},
+                {"label": "Alt", "matrix": [3, 1], "x": 2.125, "y": 3, "w": 1.25},
+                {"label": "GUI", "matrix": [3, 2], "x": 3.375, "y": 3, "w": 1.25},
+                {"label": "Space", "matrix": [3, 3], "x": 4.625, "y": 3, "w": 2.25},
+                {"label": "Backspace", "matrix": [3, 4], "x": 6.875, "y": 3, "w": 2.75},
+                {"label": "Menu", "matrix": [3, 5], "x": 9.625, "y": 3, "w": 1.25},
+                {"label": "Fn", "matrix": [3, 6], "x": 10.875, "y": 3}
+            ]
+        },
+        "LAYOUT_625u_space": {
+            "layout": [
+                {"label": "Esc", "matrix": [0, 0], "x": 0, "y": 0},
+                {"label": "Q", "matrix": [0, 1], "x": 1, "y": 0},
+                {"label": "W", "matrix": [0, 2], "x": 2, "y": 0},
+                {"label": "E", "matrix": [0, 3], "x": 3, "y": 0},
+                {"label": "R", "matrix": [0, 4], "x": 4, "y": 0},
+                {"label": "T", "matrix": [0, 5], "x": 5, "y": 0},
+                {"label": "Y", "matrix": [0, 6], "x": 6, "y": 0},
+                {"label": "U", "matrix": [0, 7], "x": 7, "y": 0},
+                {"label": "I", "matrix": [0, 8], "x": 8, "y": 0},
+                {"label": "O", "matrix": [0, 9], "x": 9, "y": 0},
+                {"label": "P", "matrix": [0, 10], "x": 10, "y": 0},
+                {"label": "-", "matrix": [0, 11], "x": 11, "y": 0},
+                {"label": "Backspace", "matrix": [0, 12], "x": 12, "y": 0},
+
+                {"label": "Tab", "matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+                {"label": "A", "matrix": [1, 1], "x": 1.5, "y": 1},
+                {"label": "S", "matrix": [1, 2], "x": 2.5, "y": 1},
+                {"label": "D", "matrix": [1, 3], "x": 3.5, "y": 1},
+                {"label": "F", "matrix": [1, 4], "x": 4.5, "y": 1},
+                {"label": "G", "matrix": [1, 5], "x": 5.5, "y": 1},
+                {"label": "H", "matrix": [1, 6], "x": 6.5, "y": 1},
+                {"label": "J", "matrix": [1, 7], "x": 7.5, "y": 1},
+                {"label": "K", "matrix": [1, 8], "x": 8.5, "y": 1},
+                {"label": "L", "matrix": [1, 9], "x": 9.5, "y": 1},
+                {"label": ";", "matrix": [1, 10], "x": 10.5, "y": 1},
+                {"label": "Enter", "matrix": [1, 11], "x": 11.5, "y": 1, "w": 1.5},
+
+                {"label": "Caps Lock", "matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+                {"label": "Z", "matrix": [2, 1], "x": 1.75, "y": 2},
+                {"label": "X", "matrix": [2, 2], "x": 2.75, "y": 2},
+                {"label": "C", "matrix": [2, 3], "x": 3.75, "y": 2},
+                {"label": "V", "matrix": [2, 4], "x": 4.75, "y": 2},
+                {"label": "B", "matrix": [2, 5], "x": 5.75, "y": 2},
+                {"label": "N", "matrix": [2, 6], "x": 6.75, "y": 2},
+                {"label": "M", "matrix": [2, 7], "x": 7.75, "y": 2},
+                {"label": ",", "matrix": [2, 8], "x": 8.75, "y": 2},
+                {"label": ".", "matrix": [2, 9], "x": 9.75, "y": 2},
+                {"label": "/", "matrix": [2, 10], "x": 10.75, "y": 2},
+                {"label": "Shift", "matrix": [2, 11], "x": 11.75, "y": 2, "w": 1.25},
+
+                {"label": "Ctrl", "matrix": [3, 0], "x": 1.125, "y": 3},
+                {"label": "Alt", "matrix": [3, 1], "x": 2.125, "y": 3, "w": 1.25},
+                {"label": "Space", "matrix": [3, 3], "x": 3.375, "y": 3, "w": 6.25},
+                {"label": "Menu", "matrix": [3, 5], "x": 9.625, "y": 3, "w": 1.25},
+                {"label": "Fn", "matrix": [3, 6], "x": 10.875, "y": 3}
             ]
         }
     }
diff --git a/keyboards/pearlboards/pearl/matrix_diagram.md b/keyboards/pearlboards/pearl/matrix_diagram.md
new file mode 100644
index 0000000000..ebcc43466b
--- /dev/null
+++ b/keyboards/pearlboards/pearl/matrix_diagram.md
@@ -0,0 +1,21 @@
+# Matrix Diagram for Pearl Boards Pearl
+
+```
+┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐   ┌───────┐
+│00 │01 │02 │03 │04 │05 │06 │07 │08 │09 │0A │0B │0C │   │0C     │ 2u Backspace
+├───┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴───┤   └───────┘
+│10  │11 │12 │13 │14 │15 │16 │17 │18 │19 │1A │1B    │
+├────┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬────┤   ┌────────┐
+│20    │21 │22 │23 │24 │25 │26 │27 │28 │29 │2A │2B  │   │2A      │ 2.25u RShift
+└────┬─┴─┬─┴──┬┴───┼───┴───┴┬──┴───┴───┼───┴┬──┴┬───┘   └────────┘
+     │30 │31  │32  │33      │34        │35  │36 │
+     └───┴────┴────┴────────┴──────────┴────┴───┘
+              ┌─ Alternate Split ──────┐
+     ┌────┬───┬──────────┬────────┬────┬───┬────┐
+     │30  │31 │32        │33      │34  │35 │36  │
+     └────┴───┴──────────┴────────┴────┴───┴────┘
+              ┌─ 6.25u Spacebar ───────┐
+              ┌────────────────────────┐
+              │33                      │
+              └────────────────────────┘
+```