Skip to the content
PCBKitNew board
2 layers100 × 100 mmGarage controller esp8266, the printed circuit board in 3D

Garage controller esp8266

SonicTS/garage-project

A project that contains code and bash commands for creating a mitm attack on an android app

Size
100 × 100 mm
Copper layers
2
Thickness
1.6 mm
Parts
39
Nets
57
Pads
133
Tracks, vias
249, 0
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
9 Nov 2025
Updated
15 Jun 2026

Overview

Garage controller esp8266 is an open-source printed circuit board by SonicTS, from the SonicTS/garage-project repository on GitHub. It is a 2-layer board of 100 × 100 mm with 39 parts on 57 nets, routed with 249 tracks and 0 vias.

It is built around the LTV-817 and SP0502BAJTG. Its parts include 20 resistors, 7 capacitors, 4 diodes, 3 ICs and 3 transistors. It belongs with the ESP8266 boards of this library.

Main components

2

README

README.md

blaulicht-garage-proxy (MQTT)

A DIY setup that routes the HTTPS traffic of one Android app ("Blaulicht") through a self-hosted mitmproxy. When a specific flow pattern is detected, the mitmproxy addon publishes an MQTT command to a local Mosquitto broker (TLS + auth). An ESP8266 subscribed to that topic pulses a relay to open the garage.

This repo includes: Android per-app VPN client, a mitmproxy addon with MQTT publishing, ESP8266 RTOS-based firmware with MQTT over TLS, and infrastructure templates (systemd, firewall, MQTT broker hardening). Intended for experimentation and learning.

Data flow (MQTT)

text
[Blaulicht app]
      |
      v
Android per-app VPN (VpnService + tun2socks) → SOCKS5 → mitmproxy --(MQTT/TLS publish)--> Mosquitto → ESP8266 → relay
      ^                                 TLS intercept (trusted CA)                 ^ TLS + auth            (garage door)

Components

  • Android per-app VPN client
    • VpnService-based app that forwards only the target app’s traffic via a SOCKS5 proxy (mitmproxy) using a tun2socks AAR.
  • mitmproxy addon
    • Detects the flow trigger and publishes open to garage/cmd over TLS to Mosquitto on 8883.
    • Configurable via environment variables (MQTT_HOST, MQTT_USER/PASS, TRIGGER_*). See infra/systemd/mitmproxy.service.
  • Mosquitto broker
    • TLS 1.2+, per-user passwords in /etc/mosquitto/passwd, and minimal permissions. See docs/setup-mqtt-broker.md.
  • ESP8266 firmware
    • Connects to Wi‑Fi and MQTT over TLS, subscribes to garage/cmd, and publishes garage/status. Embed the CA in lib/mqtt/src/mqtt.c.

Quickstart

  1. Server (Ubuntu)
  • Install Mosquitto and set up TLS + users: docs/setup-mqtt-broker.md.
  • Deploy mitmproxy addon and set MQTT env: docs/setup-server-ubuntu.md.
  1. Android
  • Build and install the per-app VPN client (Android Studio). Point it to the server’s SOCKS5 port. Install the mitmproxy CA on the device.
  1. ESP8266
  • Open esp8266/Garage-Controller in PlatformIO. Set Wi‑Fi + MQTT config (including CA). Build and flash.

Security note: Use strong per-client credentials. Keep the broker LAN-only or restricted. Self-signed CA is fine for local deployments; keep the private key secure.

Parts

39
QtyValueFootprintReferences
610kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR6, R7, R8, R9, R10, R12
6330RResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR11, R14, R15, R17, R19, R20
5100nFCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC2, C4, C5, C6, C7
3100kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR13, R16, R18
31kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR1, R2, R3
32N7002Package_TO_SOT_SMD:SOT-23Q1, Q2, Q3
2SP0502BAJTPackage_TO_SOT_SMD:SOT-323_SC-70D3, D4
10Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR4
110uFCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC1
11N5819Diode_SMD:D_SOD-123D2
1220uFCapacitor_SMD:CP_Elec_10x12.5C3
13k3Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR5
1Conn_01x03_SocketConnector_PinSocket_2.54mm:PinSocket_1x03_P2.54mm_VerticalJ2
1ConnectionsConnector_PinSocket_2.54mm:PinSocket_1x09_P2.54mm_VerticalJ1
1LEDLED_SMD:LED_0805_2012Metric_Pad1.15x1.40mm_HandSolderD1
1LTV-817Package_DIP:DIP-4_W7.62mmU3
1MCP23017_SOPackage_SO:SOIC-28W_7.5x17.9mm_P1.27mmU2
1Wemos D1 mini connectorLibrary:Wemos D1 mini connectortU1

Questions

How big is the Garage controller esp8266 PCB?

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

What parts does the Garage controller esp8266 use?

39 parts, built around the LTV-817 and SP0502BAJTG. 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 Garage controller esp8266 KiCad files?

From the SonicTS/garage-project repository on GitHub, at the commit this page was made from: the board is pcb/garage_controller_esp8266/garage_controller_esp8266.kicad_pcb and its schematic pcb/garage_controller_esp8266/garage_controller_esp8266.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Garage controller esp8266 design in my own project?

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

Similar boards

  • 2 layers62 × 100 mmESP32-S3-HUB75-Driver, the printed circuit board in 3D

    ESP32-S3-HUB75-Driver

    wszeto9/ESP32-S3-HUB75-Driver

    This board serves as the Matrix Display driver for MIT's 2.007 gameboards in Spring 2024 and Spring 2025. The board can take 4 button inputs, Stemma-QT I2C sensors, and breaks out 8 GPIO pins for future use.

    137 parts3MIT
  • 4 layers70.7 × 56.9 mmHEI Shift Light, the printed circuit board in 3D

    HEI Shift Light

    drewsum/HEI_Shift_Light

    An automotive shift light meant to integrate into the TACH signal from an HEI distributor, to be embedded in a dashboard

    112 parts
  • 2 layers100 × 100 mmPcb schematic main EFU, the printed circuit board in 3D

    Pcb schematic main EFU

    HydrogreenPollub/legacy-pcb-energy-flow-unit

    New Energy Flow pcb with step down CC CV converter

    177 partsMIT
  • 2 layers288.2 × 185.9 mmStencil 4 plytki, the printed circuit board in 3D

    Stencil 4 plytki

    HydrogreenPollub/legacy-pcb-fuel-cell-control-unit

    548 partsMIT
  • 2 layers100 × 99.9 mmPcb schematic main HCU, the printed circuit board in 3D

    Pcb schematic main HCU

    HydrogreenPollub/legacy-pcb-hydrogen-cylinder

    PCB for Ecson motor driver

    123 partsMIT
  • 4 layers30 × 46.1 mmSoM V2, the printed circuit board in 3D

    SoM V2

    robotique-udes/Exo_Electric

    This repo contains all the information about the PCB and electrical schematics of Biogenius.

    52 parts1GPL-2.0