Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Add full product BOM and assembly/PCB photos

Hardware00142ad7ec41442
diff --git a/devices/harness-device/hardware/BOM.csv b/devices/harness-device/hardware/BOM.csv
new file mode 100644
index 000000000..df425864a
--- /dev/null
+++ b/devices/harness-device/hardware/BOM.csv
@@ -0,0 +1,12 @@
+#,Component,Qty,Link
+1,Speaker 2415 8Ω 1W (2-pin SH1.0 connector),1,https://www.aliexpress.us/item/3256813022741238.html
+2,MX1.25 4-pin connector cable,1,https://www.aliexpress.us/item/3256812670096395.html
+3,1.75" 466x466 round AMOLED display (DXQ0175Y003AMT003),1,https://www.alibaba.com/product-detail/DXQ-1-75-Inch-466-466_1601834013691.html
+4,USB Type-C female PCB,1,https://www.aliexpress.us/item/3256809703885548.html
+5,PCBA - Harness_1.75_AMOLED (main board, assembled),1,https://jlcpcb.com/
+6,Self-adhesive rubber foot pad (round),1,https://www.aliexpress.us/item/3256806493767498.html
+7,M2x5 screw,4,https://www.aliexpress.us/item/3256808488953951.html
+8,Housing (3D printed),1,see hardware/3d/step/Housing.step
+9,Button (3D printed),1,see hardware/3d/step/Button.step
+10,USB clamp (3D printed),1,see hardware/3d/step/USB_clamp.step
+11,Iron base (laser-cut from 3mm steel),1,see hardware/3d/step/Iron_base.step
diff --git a/devices/harness-device/hardware/README.md b/devices/harness-device/hardware/README.md
index 59ba8ee08..f9800edd7 100644
--- a/devices/harness-device/hardware/README.md
+++ b/devices/harness-device/hardware/README.md
@@ -1,6 +1,43 @@
# Harness device hardware
-Mechanical and electrical design files for the harness-device.
+Mechanical and electrical design files for the harness-device: a round USB companion with a
+466×466 AMOLED touchscreen, dual microphones, and a speaker, built around a Waveshare
+ESP32-S3-Touch-AMOLED-1.75C-compatible display module.
+
+## Photos
+
+| | |
+|---|---|
+| ![Assembled harness, front view](images/Harness-assembled-1.png) **Assembled device — front**<br>The round AMOLED display sits flush in the housing; the side button is visible on the right edge. | ![Assembled harness, rear cutaway](images/Harness-assembled-2.png) **Assembled device — rear (cutaway)**<br>Looking into the base: the USB-C clamp holds the port PCB in place, exposing the USB power/data pads (`V`, `-D`, `+D`, `G`). |
+| ![Empty 3D-printed housing](images/Housing-3D-print.png) **Housing — empty shell**<br>The 3D-printed housing on its own, before the board is installed: mounting bosses, screw holes, and the USB-C cutout. | ![Housing with PCB installed](images/Housing-with-PCB.png) **Housing — with PCB installed**<br>The main board seated in the housing: USB-C connector, display FPC connector, ESP32-S3 module, and supporting components. |
+| ![PCB front/top layer](images/PCB-1.png) **PCB — front (top layer)**<br>Rev 2.0 board render: display FPC connector, dual microphones (green outlines), USB-C connector, and the ESP32-S3 and audio codec ICs. | ![PCB back layer with silkscreen labels](images/PCB-2.png) **PCB — back (bottom layer)**<br>ESP32-S3-WROOM module (with printed antenna trace), speaker connector (`SPK`), USB connector (`USB`), and the expansion FPC connector (`EXP`). |
+
+## Bill of Materials
+
+[`BOM.csv`](BOM.csv) lists every part needed to build one complete device — bought components and
+3D/laser-cut parts alike — each with a sourcing link or a pointer to the design file that makes it.
+This is the **full product BOM**; for just the PCB's own SMD components, see
+`pcb/production/BOM_Harness_1.75_AMOLED_PCB_Harness_1.75.xlsx` below.
+
+| # | Component | Qty | Source |
+|---|---|---|---|
+| 1 | Speaker, 2415 8Ω 1W (2-pin SH1.0 connector) | 1 | [AliExpress](https://www.aliexpress.us/item/3256813022741238.html) |
+| 2 | MX1.25 4-pin connector cable | 1 | [AliExpress](https://www.aliexpress.us/item/3256812670096395.html) |
+| 3 | 1.75″ 466×466 round AMOLED display (DXQ0175Y003AMT003) | 1 | [Alibaba](https://www.alibaba.com/product-detail/DXQ-1-75-Inch-466-466_1601834013691.html) |
+| 4 | USB Type-C female PCB connector | 1 | [AliExpress](https://www.aliexpress.us/item/3256809703885548.html) |
+| 5 | PCBA — Harness_1.75_AMOLED (main board, assembled) | 1 | [JLCPCB](https://jlcpcb.com/) — build from `pcb/` |
+| 6 | Self-adhesive rubber foot pad (round) | 1 | [AliExpress](https://www.aliexpress.us/item/3256806493767498.html) |
+| 7 | M2×5 screw | 4 | [AliExpress](https://www.aliexpress.us/item/3256808488953951.html) |
+| 8 | Housing — 3D printed | 1 | `3d/step/Housing.step` |
+| 9 | Button — 3D printed | 1 | `3d/step/Button.step` |
+| 10 | USB clamp — 3D printed | 1 | `3d/step/USB_clamp.step` |
+| 11 | Iron base — laser-cut, 3 mm steel | 1 | `3d/step/Iron_base.step` |
+
+> The display module's silkscreen/BOM calls out a CST9217 touch controller, but the units actually
+> sourced under this listing carry a CST816S instead (same footprint/form factor, different
+> touch IC). The firmware auto-detects both — see the variant table in
+> [`../firmware/README.md`](../firmware/README.md#supported-hardware) if you're bringing up a new
+> board and the touchscreen doesn't respond.
## PCB (`pcb/`)
@@ -11,7 +48,7 @@ Designed in EasyEDA Pro.
| `ProPrj_Harness_1.75_AMOLED.epro2` | EasyEDA Pro project (schematic + PCB layout source) |
| `SCH_SCH_Harness_1.75.pdf` | Schematic export (PDF) |
| `production/Gerber_PCB_Harness/` | Gerbers + drill files for fabrication (RS-274X / Excellon) |
-| `production/BOM_Harness_1.75_AMOLED_PCB_Harness_1.75.xlsx` | Bill of materials |
+| `production/BOM_Harness_1.75_AMOLED_PCB_Harness_1.75.xlsx` | PCB assembly BOM (SMD components only) |
| `production/PickAndPlace_PCB_Harness.xlsx` | Pick-and-place (CPL) data for assembly |
Open the `.epro2` project in [EasyEDA Pro](https://pro.easyeda.com/) to edit the schematic/layout.
@@ -28,6 +65,6 @@ Each part is provided in two formats, one per subfolder:
|---|---|---|
| Full assembled harness | `step/Harness_assembly.step` | `stl/Harness_assembly.stl` |
| Main enclosure housing | `step/Housing.step` | `stl/Housing.stl` |
-| Iron counterweight block (keeps the device from tipping/sliding on a desk) | `step/Iron_base.step` | `stl/Iron_base.stl` |
+| Iron counterweight block (keeps the device from tipping/sliding on a desk) — laser-cut from 3 mm iron sheet | `step/Iron_base.step` | `stl/Iron_base.stl` |
| Clamp that holds the USB-C port PCB in place | `step/USB_clamp.step` | `stl/USB_clamp.stl` |
| Physical button cap/actuator | `step/Button.step` | `stl/Button.stl` |
diff --git a/devices/harness-device/hardware/images/Harness-assembled-1.png b/devices/harness-device/hardware/images/Harness-assembled-1.png
new file mode 100644
index 000000000..45912e72b
Binary files /dev/null and b/devices/harness-device/hardware/images/Harness-assembled-1.png differ
diff --git a/devices/harness-device/hardware/images/Harness-assembled-2.png b/devices/harness-device/hardware/images/Harness-assembled-2.png
new file mode 100644
index 000000000..e750d0b5a
Binary files /dev/null and b/devices/harness-device/hardware/images/Harness-assembled-2.png differ
diff --git a/devices/harness-device/hardware/images/Housing-3D-print.png b/devices/harness-device/hardware/images/Housing-3D-print.png
new file mode 100644
index 000000000..101add07c
Binary files /dev/null and b/devices/harness-device/hardware/images/Housing-3D-print.png differ
diff --git a/devices/harness-device/hardware/images/Housing-with-PCB.png b/devices/harness-device/hardware/images/Housing-with-PCB.png
new file mode 100644
index 000000000..9c441afb9
Binary files /dev/null and b/devices/harness-device/hardware/images/Housing-with-PCB.png differ
diff --git a/devices/harness-device/hardware/images/PCB-1.png b/devices/harness-device/hardware/images/PCB-1.png
new file mode 100644
index 000000000..ff89e34df
Binary files /dev/null and b/devices/harness-device/hardware/images/PCB-1.png differ
diff --git a/devices/harness-device/hardware/images/PCB-2.png b/devices/harness-device/hardware/images/PCB-2.png
new file mode 100644
index 000000000..ca54eb69a
Binary files /dev/null and b/devices/harness-device/hardware/images/PCB-2.png differ