addw5 WIP

jacobgkau · jacobgkau · commit f085e0d6b6ca · 2025-09-11T21:54:33.000-06:00
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
@@ -2,6 +2,8 @@
 
 - [Current Models](README.md)
     - [Adder WS (addw5)](models/addw5/README.md)
+        - [External Overview](models/addw5/external-overview.md)
+        - [Internal Overview](models/addw5/internal-overview.md)
         - [Parts & Repairs](models/addw5/repairs.md)
     - [Bonobo WS (bonw16)](models/bonw16/README.md)
         - [External Overview](models/bonw16/external-overview.md)
diff --git a/src/models/addw5/README.md b/src/models/addw5/README.md
@@ -10,7 +10,7 @@ The System76 Adder WS is a laptop with the following specifications:
 - Chipset
     - [Intel HM870](https://www.intel.com/content/www/us/en/products/sku/240123/intel-hm870-chipset/specifications.html)
 - BIOS
-    - Macronix MX25U25671GZ4I4G flash chip
+    - Puya PY25F256LC4L1TS1A flash chip (or equivalent)
         - WSON-8 form factor
     - Programmed with System76 firmware (non-open)
 - EC
@@ -30,7 +30,7 @@ The System76 Adder WS is a laptop with the following specifications:
                     - sRGB: 100%
                 - sRGB color coverage: 100
         - 17" 1920x1080@144Hz LCD
-            - LCD panel: Innolux N173HCE-G33 (or other equivalent)
+            - LCD panel: Innolux N173HCE-G33 (or equivalent)
                 - Brightness: 300 nits (cd/m²)
                 - Color coverage:
                     - DCI-P3: 74%
diff --git a/src/models/addw5/external-overview.md b/src/models/addw5/external-overview.md
@@ -0,0 +1,92 @@
+# Adder WS (External Overview)
+
+## Left side:
+
+![Left Ports (17")](./img/ports-left-17.webp)
+
+## Right side:
+
+![Right Ports](./img/ports-right-17.webp)
+
+## Front side:
+
+![Front Ports](./img/ports-front.webp)
+
+## Back side:
+
+![Back Ports](./img/ports-back.webp)
+
+## Keyboard & touchpad:
+
+### 15" model:
+
+![Keyboard & Touchpad (15")](./img/keyboard-touchpad-15.webp)
+
+### 17" model:
+
+![Keyboard & Touchpad (17")](./img/keyboard-touchpad-17.webp)
+
+## Lid:
+
+![Lid](./img/lid.webp)
+
+## Materials:
+
+### 15" model:
+
+|Part                              |Material |Part Number    |
+|----------------------------------|---------|---------------|
+|LCD back cover (lid)              |Aluminum |6-39-V3501-022 |
+|LCD front cover (bezel)           |Plastic  |6-39-V3501-012 |
+|Top case (palm rests/port covers) |Plastic  |6-39-V3502-012 |
+|Bottom panel                      |Plastic  |6-39-V35W3-011 |
+
+### 17" model:
+
+|Part                              |Material |Part Number    |
+|----------------------------------|---------|---------------|
+|LCD back cover (lid)              |Aluminum |6-39-V37S1-022 |
+|LCD front cover (bezel)           |Plastic  |6-39-V37S1-012 |
+|Top case (palm rests/port covers) |Plastic  |6-39-V37S2-N11 |
+|Bottom panel                      |Plastic  |6-39-V37W3-011 |
+
+## LED indicators
+
+The Adder WS has the following LED indicators:
+
+|Icon                                    |Color          |Description                      |
+|----------------------------------------|---------------|---------------------------------|
+|![Power LED](./img/led-power.png)       |Orange         |Powered off, DC power plugged in |
+|                                        |Green          |Powered on                       |
+|                                        |Blinking green |Sleeping (suspended)             |
+|![Battery LED](./img/led-battery.png)   |Orange         |Battery charging                 |
+|                                        |Green          |Battery fully charged            |
+|                                        |Blinking orange|Battery critically low           |
+|![Storage LED](./img/led-storage.png)   |Green          |Storage drive activity           |
+
+## Keyboard Shortcuts
+
+The Adder WS has the following actions available using the Fn and Function keys:
+
+|Key                        |Shortcut|Action                             |
+|---------------------------|--------|-----------------------------------|
+|![Fn-F1](./img/fn-f1.png)  |Fn+F1   |Toggle trackpad                    |
+|![Fn-F2](./img/fn-f2.png)  |Fn+F2   |Mute/unmute microphone             |
+|![Fn-F3](./img/fn-f3.png)  |Fn+F3   |Mute/unmute speakers               |
+|![Fn-F5](./img/fn-f5.png)  |Fn+F5   |Volume down                        |
+|![Fn-F6](./img/fn-f6.png)  |Fn+F6   |Volume up                          |
+|![Fn-F7](./img/fn-f7.png)  |Fn+F7   |Toggle displays                    |
+|![Fn-F8](./img/fn-f8.png)  |Fn+F8   |Screen brightness down             |
+|![Fn-F9](./img/fn-f9.png)  |Fn+F9   |Screen brightness up               |
+|![Fn-F10](./img/fn-f10.png)|Fn+F10  |Toggle webcam                      |
+|![Fn-F11](./img/fn-f11.png)|Fn+F11  |Toggle airplane mode               |
+|![Fn-F12](./img/fn-f12.png)|Fn+F12  |Suspend                            |
+|![Fn-F12](./img/fn-dia.jpg)|Fn+`    |Play/Pause                         |
+|![Fn-*](./img/fn-star.png) |Fn+*    |Toggle keyboard backlight          |
+|![Fn-/](./img/fn-slash.png)|Fn+/    |Cycle keyboard color               |
+|![Fn--](./img/fn-minus.png)|Fn+-    |Decrease keyboard brightness       |
+|![Fn-+](./img/fn-plus.png) |Fn++    |Increase keyboard brightness       |
+|1                          |Fn+1    |Toggle fan between max/automatic   |
+
+
+
diff --git a/src/models/addw5/img/battery.webp b/src/models/addw5/img/battery.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4e494c088b2ad1848870266ac1bf9adcb75a50c25916ecc4e20f2b643f037a1e
+size 652516
diff --git a/src/models/addw5/img/bottom-panel-screws-15.webp b/src/models/addw5/img/bottom-panel-screws-15.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:508d0d652fb48f1f12e900a0319e2c4dfb48da85792619884e1eba68c8f9c96a
+size 986620
diff --git a/src/models/addw5/img/bottom-panel-screws-17.webp b/src/models/addw5/img/bottom-panel-screws-17.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5fd99ed23ea3b6384a8f81d3e629ab804fc56b39c6c2726ad52e4ffaeb5a1382
+size 817230
diff --git a/src/models/addw5/img/cmos-battery.webp b/src/models/addw5/img/cmos-battery.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b5210f311b80539ee4c9838956756b30826ce37a6127aab47f175719d3dadf6b
+size 529792
diff --git a/src/models/addw5/img/components-highlighted.webp b/src/models/addw5/img/components-highlighted.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3be5c7f46182088dfba92d29bf8c2f358449c404cc7db7cadb9c41f03c98bf6d
+size 923746
diff --git a/src/models/addw5/img/keyboard-mount-points-15.webp b/src/models/addw5/img/keyboard-mount-points-15.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:96bba1feba063baca7bf27e373d30e4fd81632f8473d84ff28c74e581b585312
+size 912196
diff --git a/src/models/addw5/img/keyboard-mount-points-17.webp b/src/models/addw5/img/keyboard-mount-points-17.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e51c21551e3d0edff4c95de74141a85d811ae260ef357edf0d5bac7690b39f71
+size 815286
diff --git a/src/models/addw5/img/keyboard-push-point.webp b/src/models/addw5/img/keyboard-push-point.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e67483144f2a73e639a31077dc09b05620634dbf097d52104049d240a9f6e675
+size 371306
diff --git a/src/models/addw5/img/keyboard-ribbons.webp b/src/models/addw5/img/keyboard-ribbons.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a35081af6aba8dccdb1d0fcbef43f87dc43696647c98b307462eb7bad9c0ffff
+size 491146
diff --git a/src/models/addw5/img/keyboard-touchpad-15.webp b/src/models/addw5/img/keyboard-touchpad-15.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0a7bfdda54826aa819f3a1bdf1e56d34ac13a818675b223d4f534c12d23dbe24
+size 899076
diff --git a/src/models/addw5/img/keyboard-touchpad-17.webp b/src/models/addw5/img/keyboard-touchpad-17.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c492a35dc090379969cb0aafd74fa6bec353458fd783181d0b670bb86b894b06
+size 328294
diff --git a/src/models/addw5/img/m2-slots.webp b/src/models/addw5/img/m2-slots.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ade2c5b2194c43ca185673e1f6bfa507612238f61b604e562fddca92d50d6784
+size 918130
diff --git a/src/models/addw5/img/ports-left-17.webp b/src/models/addw5/img/ports-left-17.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d537f83cf0d942fcd44e8415e3016349e8279a883a71f1c11a62da73ad0cd2f0
+size 167354
diff --git a/src/models/addw5/img/ports-right-17.webp b/src/models/addw5/img/ports-right-17.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c1245e3e16b8e982d777d5785b4c5ac7370c88994243829789cafa8af921cf94
+size 150418
diff --git a/src/models/addw5/img/ram-slots.webp b/src/models/addw5/img/ram-slots.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cb3d8a949b978fcf25090cc897830ae9be8bdf0faa5b036efb4a9f3267d58c83
+size 868942
diff --git a/src/models/addw5/img/speakers.webp b/src/models/addw5/img/speakers.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:049b93ddf240c4cac05217ef3afd688cc43060168eb690351d26e6ee878a3373
+size 956568
diff --git a/src/models/addw5/img/thermal-paste-application.webp b/src/models/addw5/img/thermal-paste-application.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:07c5c033b93045a15d5d18d6570c1c7dbf8d91f4fa62ff11926a2c809a2e2748
+size 879364
diff --git a/src/models/addw5/img/thermal-paste-removal.webp b/src/models/addw5/img/thermal-paste-removal.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e82c48262f6c3e677d2af90981d5d92e7343579d340e9a135eea9e383e9ad776
+size 979696
diff --git a/src/models/addw5/img/thermal-screws.webp b/src/models/addw5/img/thermal-screws.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f56d0fe7e4339037925ed38404a29ce2db7f6b8206dcdbc450f575a1f1f2c12f
+size 958234
diff --git a/src/models/addw5/img/under-keyboard.webp b/src/models/addw5/img/under-keyboard.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b2c1a0743e67cc22b088870d3ece80b65462af28acb99585975c39ceb7cd14a8
+size 994922
diff --git a/src/models/addw5/img/wireless-card-antennas.webp b/src/models/addw5/img/wireless-card-antennas.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:891b78602edbf08c5dfd53866276d46e036d1e3bfa622fc222cbf77ff260a4be
+size 638168
diff --git a/src/models/addw5/img/wireless-card-screw.webp b/src/models/addw5/img/wireless-card-screw.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:73049d52b781202c3df7243d167644ea5a03c215101eae5ccab972710cb4d0db
+size 907324
diff --git a/src/models/addw5/internal-overview.md b/src/models/addw5/internal-overview.md
@@ -0,0 +1,33 @@
+# Adder WS (Internal Overview)
+
+## Bottom components and connectors:
+
+![Internal Components and Connectors](./img/components-highlighted.webp)
+
+- LCD panel connector (under the heatsink) is highlighted in light green
+- Keyboard adhesive access point is highlighted in pink
+- RAM slots are highlighted in maroon
+- M.2 SSDs are highlighted in navy
+    - All slots support PCIe NVMe Gen 4
+- Fan connectors are highlighted in red
+    - Left fan connector (on the right) is below SSD slot #3
+- Speaker connectors are highlighted in yellow
+    - Right speaker connector (on the left) is below SSD slot #2
+- Webcam/microphone connector is highlighted in cyan
+- Wireless card is highlighted in purple
+    - Wireless card is below SSD slot #1
+- CMOS battery connector is highlighted in blue
+    - CMOS battery is under the main battery
+- Touchpad connector is highlighted in white
+- Main battery connector is highlighted in orange
+- BIOS flash chip (U62) is highlighted in black
+    - BIOS chip is underneath the middle fan
+
+## Under-keyboard components and connectors:
+
+![Under-Keyboard Connectors](./img/under-keyboard.webp)
+
+- Keyboard adhesive strip access point is highlighted in cyan
+- Keyboard connector is highlighted in green
+- Keyboard backlight connector is highlighted in yellow
+- Power button/LED connector is highlighted in red
diff --git a/src/models/addw5/repairs.md b/src/models/addw5/repairs.md
