Assembly and setup

Desk Buddy build guide

This guide consolidates hardware assembly, electrical wiring, software setup, and troubleshooting into one production workflow.

Wiring references

Use these schematics before stage execution to validate pin mapping and avoid rework.

Desk Buddy internal wiring layout reference — Reference wire routing layout for stable service loops and airflow clearance.

Troubleshooting cards

Blank OLED output

Verify I2C is enabled and run i2cdetect -y 1. Confirm SDA/SCL are not swapped and module address responds.

No speaker output

Check I2S overlay and amplifier power rail stability. Re-test with speaker-test -t wav -c 2.

Microphone hiss/high floor

Shorten ground path and route mic leads away from power and speaker lines.

LED instability

Ensure shared ground between Pi and LED, and limit brightness during boot testing.