Skip to the content
2 layers54 × 52 mmPDX Hackerspace Exit Poll, the printed circuit board in 3D

PDX Hackerspace Exit Poll

romkey/pdxhackerspace-exit-poll1

ESPHome/Home Assistant-based exit dashboard used at PDX Hackerspace

Size
54 × 52 mm
Copper layers
2
Thickness
1.6 mm
Parts
19
Nets
28
Pads
78
Tracks, vias
159, 17
Pours
2
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
20 Jul 2024
Updated
6 Nov 2026

Overview

PDX Hackerspace Exit Poll is an open-source printed circuit board by romkey, from the romkey/pdxhackerspace-exit-poll repository on GitHub, published under the MIT licence. It is a 2-layer board of 54 × 52 mm with 19 parts on 28 nets, routed with 159 tracks and 17 vias.

It is built around the SFR03EZPF4701, RVT1E101M0607 and RS-06K4750FT, with the S4B-PH-KL(LF)(SN), YLED1206R and BM04B-SRSS-TB(LF)(SN) among its other parts. Its parts include 4 connectors, 3 resistors, 2 ICs, 1 capacitor and 1 diode. It belongs with the home automation and IoT boards of this library.

Main components

6

README

README.md

PDX Hackerspace Exit Poll

CI Lint ESPHome License: MIT

All goodAttention!

Exit Poll is a display next to the door that shows, from Home Assistant, whether anything in the space needs attention before the last person leaves: open doors, unlocked doors, running water and AV equipment left on. At PDX Hackerspace the last person out checks the space's physical security and turns off equipment; member Kenny M had the idea of putting a dashboard by the door so departing members can see at a glance whether anything needs doing. The repo also holds a sibling project, an appliance countdown display (washer, dryer, dishwasher, oven, 3D printer), built from the same parts.

AI disclosure: This project was written by AI under human oversight, following these rules.

What's here

PathWhat it is
packages/exit-poll.yamlReads the 16 per-section counts from Home Assistant, totals them and publishes a System Status (0 good … 4 urgent)
packages/exit-poll-leds.yamlLED strip showing the status as a color, with switches and buttons to override it
packages/exit-poll-lcars-320x480.yamlLCARS-style screen for a 320x480 SPI panel (mipi_spi)
packages/exit-poll-lvgl-480x800.yamlLCARS-style LVGL screen for a 480x800 (portrait) panel
packages/appliances.yamlReads appliance remaining-time sensors from Home Assistant
packages/appliances-grid-480x320.yaml3x2 grid of five appliances plus a clock, 480x320 SPI panel
packages/appliances-2-line-480x320.yamlClock plus washer and dryer in two large rows, 480x320 SPI panel
packages/assets/Fonts and LCARS images the display packages use
examples/tinys3.yamlExit Poll on a TinyS3 (ESP32-S3) and the Exit Poll PCB, ILI9488 panel
examples/hosyond-4in-cyd.yamlExit Poll on a Hosyond 4" ESP32 display (ESP32, ST7796)
examples/guition-8048s550.yamlExit Poll on a Guition 5" ESP32-S3 display, LVGL
examples/tinypico-appliances.yamlAppliance grid on a TinyPICO (ESP32)
examples/hosyond-4in-cyd-appliances.yamlTwo-line appliance display on the Hosyond 4" board
examples/common/Settings shared by all examples, and the Hosyond board
docs/configuration.mdEvery package's requirements and substitutions
pcb/KiCad files for the TinyS3 carrier PCB
case/OpenSCAD and STL files for the 4" case
lcars/Source art for the LCARS images

The examples cover ESP32 and ESP32-S3. There is no ESP32-C3 example: none of the boards this project runs on uses one.

Technical details

How it works

Home Assistant runs the space's security sensors. For each of four sections of the space it provides four counts, sensor.total_section_N_doors_open, ..._doors_unlocked, ..._av_on and ..._water_running, which Exit Poll mirrors (the entity ids are substitutions; see docs/configuration.md). The display shows each count green when zero, red when not, gray when unknown. The LED strip shows the worst state:

StatusMeaningLED color
0All goodgreen
1No Wi-Fiorange
2No Home Assistant connectionblue
3AV on or water runningyellow
4A door open or unlockedred

Hardware

We use a cheap 320x480 SPI TFT display connected to Unexpected Maker's TinyS3 on a custom PCB, but you can use virtually any ESP32 board that's fast enough with enough storage and RAM for your needs. We use displays with touch support - the PCB wires the touch pins to the CPU but the SPI firmware doesn't use touch yet. The Hosyond and Guition boards are all-in-one ESP32 displays that need no PCB.

If you want to use a different resolution display you'll need a new display package.

TinyS3 + Exit Poll PCB wiring (examples/tinys3.yaml):

SignalGPIO
SPI CLK9
SPI MOSI36
SPI MISO8
Display CS2
Display DC4
Display reset3
LED strip data7
I2C SDA (Qwiic)21
I2C SCL (Qwiic)5

The other boards' pins are in their examples, with links to the board documentation they come from. There are no I2C devices on the SPI boards (the bus goes to the Qwiic connector); the Guition board's GT911 touch controller is at 0x5D.

The PCB is available at OSHPark.

PCB frontPCB back

Assembly

Most of the components on the board are optional.

C1 is entirely optional. It's intended to smooth power to the LED strip, if you use one. In practice with just a few LEDs it's unnecessary. We will probably drop it if we update the PCB again.

If you don't want the power indicator, omit D1 and R3.

If you don't want external I2C support via the Qwiic/Stemma QT connector, omit R1, R2 and J3.

Although the board shows a female header strip for the connections on the right hand side, ignore it if you're not using those for expansion or wire them however is convenient for you if you are. You might for instance wire in buttons for reset and programming (BOOT).

The bare minimum assembly is to solder the TinyS3 to the front of PCB and then solder the display to the back. Be sure that the pinout of the display you're using matches the pinout of the holes for its pins. If it doesn't, you'll need to figure out how to wire it.

Case

The repo includes OpenSCAD files for a minimal case for a 4" display that mounts the display on a frame that snaps into a box that can be mounted on a wall, with a hole in the bottom for the USB power cable. If you use a different size display you will need to redesign the case. It also includes the .stl files.

To print the case, load the .stl file into the slicer you use with your 3D printer and follow your printer's instructions to slice and print the case. PLA and PETG are good materials for the case.

Case

Building and using

Requires Docker.

bash
cp examples/secrets.yaml.example examples/secrets.yaml   # then edit it
docker compose run --rm validate
docker compose run --rm build
docker compose run --rm lint

The first build downloads the toolchains into a Docker volume; later builds reuse them and only recompile what changed. docker compose up dashboard runs the ESPHome dashboard on http://localhost:6052.

For your own device, copy an example to examples/local-<something>.yaml (gitignored) and override what you need; it can include the example and change only a few substitutions:

yaml
substitutions:
  name: exit-poll
  friendly_name: Exit Poll

packages:
  device: !include hosyond-4in-cyd.yaml

Flash it with docker compose run --rm esphome run examples/local-<something>.yaml. Docker Desktop on macOS can't pass USB through: flash the first time with https://web.esphome.io and use OTA after that.

Using the packages from your own config

yaml
substitutions:
  exit_poll_assets: assets   # a copy of packages/assets/ next to your config

packages:
  exit_poll: github://romkey/pdxhackerspace-exit-poll/packages/exit-poll.yaml@v0.4.0
  exit_poll_leds: github://romkey/pdxhackerspace-exit-poll/packages/exit-poll-leds.yaml@v0.4.0
  exit_poll_lcars: github://romkey/pdxhackerspace-exit-poll/packages/exit-poll-lcars-320x480.yaml@v0.4.0

ESPHome resolves font and image paths relative to your config, so copy packages/assets/ next to it. Your config must provide the ids and pins each package lists in docs/configuration.md.

License

MIT

Parts

19
QtyValueFootprintReferences
24.7KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR1, R2
1100µFCapacitor_SMD:CP_Elec_6.3x7.7C1
1475Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR3
1Conn_01x04_SocketConnector_JST:JST_PH_S4B-PH-K_1x04_P2.00mm_HorizontalJ2
1Conn_01x15_SocketConnector_PinSocket_2.54mm:PinSocket_1x15_P2.54mm_VerticalJ4
1LEDLED_SMD:LED_1206_3216Metric_Pad1.42x1.75mm_HandSolderD1
1LOGOLOGOG**
1~Jumper:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mmU3
1~1myFootprints:SPI_TFT_TOUCHJ1
1~footprint:CONN-SMD_BM04B-SRSS-TBJ3
1~1myFootprints:TinyS3U1

The 12 most common of 19 parts.

More from romkey/pdxhackerspace-exit-poll

1
  • 2 layers50.8 × 53.3 mmPDX Hackerspace Exit Poll, the printed circuit board in 3D

    PDX Hackerspace Exit Poll

    romkey/pdxhackerspace-exit-poll

    ESPHome/Home Assistant-based exit dashboard used at PDX Hackerspace

    14 parts1MIT

Similar boards

  • 4 layers145 × 57 mmX1-expander, the printed circuit board in 3D

    X1-expander

    jwise/x1-expander

    Expander board for Bambu Lab X1 Carbon

    150 parts50
  • 6 layers203 × 151.8 mmPDNode Baseboard, the printed circuit board in 3D

    PDNode Baseboard

    DvidMakesThings/HW_PDNode-600-Pro

    The PDNode-600 is a professional-grade, 600W USB Power Delivery Unit designed specifically for compact 10-inch rack systems, targeting embedded developers, homelab enthusiasts, test benches, and smart infrastructure.

    236 parts86AGPL-3.0
  • 2 layers82.5 × 85.3 mmBSPD-27, the printed circuit board in 3D

    BSPD-27

    Full-Blue-Racing/BSPD-27

    BSPD for the fbr27 car

    108 parts
  • 4 layers37 × 34.3 mmReadout 60pin, the printed circuit board in 3D

    Readout 60pin

    opentac/opentac

    OpenTac: open tools to design, fabricate, read and simulate flex-PCB tactile skins that sense normal and shear force, for any robot surface.

    55 parts92MIT
  • 6 layers100 × 70 mmSa800u baseboard hw, the printed circuit board in 3D

    Sa800u baseboard hw

    antmicro/snapdragon-845-baseboard

    https://antmicro.com/blog/2022/04/open-source-snapdragon-845-baseboard/

    616 parts70Apache-2.0
  • 10 layers120 × 120 mmK410t devboard, the printed circuit board in 3D

    K410t devboard

    antmicro/kintex-410t-devboard

    This repository contains open hardware design files for a devkit created for AMD-Xilinx Kintex-7 K410T FPGA.

    1,020 parts46Apache-2.0
  • 12 layers165 × 102.7 mmData center rdimm ddr5-tester, the printed circuit board in 3D

    Data center rdimm ddr5-tester

    antmicro/rdimm-ddr5-tester

    FPGA-based DRAM tester supporting RDIMM DDR5 memories

    797 parts44Apache-2.0

Questions

How big is the PDX Hackerspace Exit Poll PCB?

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

What parts does the PDX Hackerspace Exit Poll use?

19 parts, built around the SFR03EZPF4701, RVT1E101M0607, RS-06K4750FT and S4B-PH-KL(LF)(SN). 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 PDX Hackerspace Exit Poll KiCad files?

From the romkey/pdxhackerspace-exit-poll repository on GitHub, at the commit this page was made from: the board is pcb/0.7/PDX Hackerspace Exit Poll.kicad_pcb and its schematic pcb/0.4/PDX Hackerspace Exit Poll.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the PDX Hackerspace Exit Poll design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).