Skip to the content
2 layers45.7 × 138.2 mmLayouts, the printed circuit board in 3D

A PC (And Rolling Door) Control System using ESP32 S3 and a custom PCB

Size
45.7 × 138.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
31
Nets
56
Pads
132
Tracks, vias
300, 7
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
29 Sep 2026
Updated
6 Nov 2026

Overview

Layouts is an open-source printed circuit board by lnminh1411, from the lnminh1411/ESP32-PC-Control-System repository on GitHub. It is a 2-layer board of 45.7 × 138.2 mm with 31 parts on 56 nets, routed with 300 tracks and 7 vias.

Its parts include 13 resistors, 7 connectors, 5 ICs and 1 diode.

README

README.md

ESP32 PC Control System

Why would I put myself through the suffering

I needed my PC online at all time, because sometime at school or work I need to remote control the PC back at home. And as I measured, the idle time alone costs me ~40KWh (~7usd) per month. So, I built this for 30usd instead of buying a boring and expensive IP KVM, while adding a tons more features to fit my over-engineering stuffs hobby.

Carrier PCB, rev 3.1: top silkscreen over F.Cu

An ESP32-S3 carrier board that lives inside a PC case. It drives three 2.4" displays, turns the PC on and off, presses the motherboard's reset line and works a 4-button door remote, all from one ESP32-S3-N16R8 module on a custom 2-layer PCB. A Windows helper feeds it the PC's stats and carries its commands back to the PC.

Companion projects

This is the main project; the others work with it.

ProjectRole for this board
PC Hardware Control Service (PcHwCtl)Windows service the helper calls over the PcHwCtl pipe: sensor feed, fans and RGB, monitors, power actions, Process Lasso night config, webcam presence and screenshots
Local LLM stackLocal AI stack. Its status shows on the panels, and the Discord Local Agent tab controls it through the helper's !ai relay
ESP32 Human Presence RadarAdd-on presence board (mmWave radar and ToF) for the presence rules (AFK, away, intruder lock, night). New; the link to this board is in development

All screen faces, captured from the board

Every face, captured from the board with shot. The stats are made up; the layout is real. What each panel shows and when: docs/screens.md.

What it does

  • Three status panels: PC stats, media with cover art, Claude and Antigravity quota and the local AI while the PC is on; a GIF, the weather and a clock while it is off.
  • Power control: Wake-on-LAN and USB wake, sleep / hibernate / restart / shutdown / lock through PcHwCtl on the PC, and a hardware reset for a hung PC.
  • Discord bot: a control panel for the door, the PC, its RGB, fans, monitors and local AI agent, and the board itself; PC, weather and log channels, copied to Pushover.
  • Weather: rain nowcast and warnings (Drizzle to Typhoon) that follow your phone through OwnTracks, OpenWeather minute rain and GDACS typhoons.
  • Night mode: dims everything, parks background processes on E-cores, sleeps the PC after an idle hour at night and hibernates it when you leave home.
  • Door remote: four opto-isolated keyfob buttons.

Parts

  • Board: rev 3.1 carrier, 45.7 x 138.2 mm, 3 ST7789 panels on one SPI bus, 5 optocouplers, a 12 V boost (docs/hardware.md).
  • Firmware: ESP-IDF 5.5.6 with LovyanGFX, in firmware/ (docs/firmware.md).
  • PC helper: ESP32-Helper.exe, a .NET 10 Windows service with a user-session half, in host/pc_stats/ (docs/helper.md).
  • PcHwCtl: a separate repo on the PC that owns sensors, power actions, RGB, fans, monitors, Process Lasso rules, the desk camera check and screenshots; the helper talks to it over its named pipe.
  • LocalAIHost: a separate repo on the PC that hosts the local language model; the helper relays the board's local AI commands to it and polls its status hub.
  • Case: a 3D-printed block, lid and display mask in enclosure/.

Quick start

  1. Copy firmware/main/settings_example.h to settings.h and fill in the secrets (docs/settings.md).

  2. Build and flash over USB (docs/build-and-flash.md):

    bash
    firmware/idf.cmd build
    python scripts/idf_flash.py --no-build
  3. Build and install the PC helper from an elevated shell (docs/helper.md):

    bash
    host/pc_stats/build.cmd
    powershell -ExecutionPolicy Bypass -File host/pc_stats/install.ps1
  4. Set the BIOS and Windows up for Wake-on-LAN (docs/power-and-night.md), then set a home with weather home <lat>,<lon> on the console (docs/console.md).

Documentation

PageCovers
screens.mdThe faces, warnings on them, PC usage warnings
hardware.mdThe board, pin map, assembly, the eFuse fix, bring-up findings, building the PCB
firmware.mdModules, display pipeline, tasks, ESP-IDF options, PSRAM hardening
console.mdEvery console command
power-and-night.mdPower control, Wake-on-LAN setup, night and low power mode, the power-on brownout
discord.mdChannels, the control panel, Pushover, screenshots
weather.mdWeather sources, nowcast, warnings, OwnTracks, Pushover, call budgets
helper.mdThe PC helper; full reference in host/pc_stats/README.md
settings.mdsettings.h, the secrets, and every other key
build-and-flash.mdBuilding, flashing, uploads, screenshots, CI
layouts.mdJSON dashboard layouts
benchmark.mdMemory and speed measurements
security.mdAccepted risks, where secrets live, what to check if an attack is suspected
pc-power-detection.md, recovery-and-physical-access.mdDesign notes
documentations_summary.mdEvery doc in the repo in one list

Repository layout

PathContents
firmware/The board's firmware
host/pc_stats/The PC helper (README)
pcb/atopile netlist, KiCad board, footprints (README)
scripts/PCB build chain, flashing, uploads, screenshots (README)
enclosure/CadQuery model of the case (README)
docs/The pages above

Status

Rev 3.1 is fabricated and assembled, and the firmware runs on it: all three panels, PC power detection, the stats link, Wi-Fi, Wake PC, the Discord bot, live weather with OwnTracks and Pushover, and night mode are in daily use. Still to do: test the door buttons B1-B4 on the real keyfob, and build the firmware in CI.

Parts

31
QtyValueFootprintReferences
6270RR_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR1, R2, R3, R4, R5, R6
510kR_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR7, R10, R11, R12, R13
5main.ato:OptocouplerDIP-4_W7.62mmU1, U2, U3, U4, U5
4MountingHole_2.7mm_M2.5MountingHole_2.7mm_M2.5MH1, MH2, MH3, MH4
3main.ato:DisplaySocketPinSocket_1x08_P2.54mm_HorizontalJ3, J4, J5
233RR_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR8, R9
2main.ato:Header1x22PinSocket_1x22_P2.54mm_VerticalJ1, J2
1main.ato:BoostModuleBS01Boost_CKCS_BS01PS1
1main.ato:IsolatedPairPinSocket_1x02_P2.54mm_HorizontalJ6
1main.ato:KeyfobSocketPinSocket_1x06_P2.54mm_HorizontalJ7
1main.ato:StatusLEDLED_D5.0mmD1

Similar boards

  • 2 layers44.5 × 46.9 mmOSO SWAT B1-jig, the printed circuit board in 3D

    OSO SWAT B1-jig

    joeycastillo/Sensor-Watch

    A board replacement for the classic Casio F-91W wristwatch

    31 parts2.1k
  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    31 parts1kGPL-3.0
  • 2 layers191 × 98.5 mmMacroKeypad, the printed circuit board in 3D

    MacroKeypad

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    31 parts915
  • 2 layers39 × 45.2 mmCH32V003F4P6-R0-1v1, the printed circuit board in 3D

    CH32V003F4P6-R0-1v1

    openwch/ch32v003

    CH32V003 is an ultra-cheap RISC-V MCU with 2KB SRAM, 16KB flash, and up to 18 GPIOs that sells for under $0.10

    31 parts599
  • 2 layers26.7 × 27.9 mmBreakout board, the printed circuit board in 3D

    Breakout board

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    31 parts546MIT
  • 2 layers100 × 50 mmPixelix, the printed circuit board in 3D

    Pixelix

    BlueAndi/Pixelix

    Full RGB LED matrix, based on an ESP32 and WS2812B LEDs or emulated LEDs on TFT.

    31 parts447MIT
  • 2 layers77.2 × 69.8 mmCubesatsim solar, the printed circuit board in 3D

    Cubesatsim solar

    alanbjohnston/CubeSatSim

    CubeSatSim, the AMSAT CubeSat Simulator

    31 parts419GPL-3.0
  • 2 layers103 × 55 mmTd neck-294, the printed circuit board in 3D

    Td neck-294

    tdaede/td-crt

    tubes

    31 parts373

Questions

How big is the Layouts PCB?

It measures 45.7 × 138.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Layouts use?

31 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Layouts KiCad files?

From the lnminh1411/ESP32-PC-Control-System repository on GitHub, at the commit this page was made from: the board is pcb/layouts/default/default.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Layouts design in my own project?

Its repository states no licence, so its author keeps all rights: ask lnminh1411 before reusing the design.