← All writing
· 6 min read · hardware, embedded, 3d-printing, forge

Showerboard: building a battery e-Paper transit display that never lies

Morning transit anxiety is weirdly specific: you are halfway through getting ready, your hands are wet, and you just want to know one thing — do I have five minutes, or do I need to leave right now?

Checking a phone breaks the calm (and immediately pulls you into notifications). So I built Showerboard: a small, battery-powered e-Paper display that sits by the shower and shows the time, weather, battery percentage, and the exact minutes left before I have to walk out the door.

The single design rule: never lie on e-Paper

An e-Paper display keeps showing the last frame even after power drops or Wi-Fi fails. That property is amazing for battery life and dangerous for a countdown: a stale "5 min" on a frozen screen is worse than no screen at all.

So every rule in the display logic is built around honesty:

  • Floor to the worst moment before the next refresh. Remaining time is departure (with live delay) - now - walk_min - prep_min, evaluated at valid_until (the next scheduled refresh) and floored. If the screen says 5 min, you are guaranteed at least five minutes until the screen updates.
  • Urgency vs. already missed. Under two minutes flips the row to solid black (LEAVE!). If a train hasn’t departed yet but there is less than walking time left, it is explicitly flagged LATE and paired with the next catchable departure underneath.
  • Refuse stale numbers. Cancelled trips are dropped. If the transit API is unreachable or the last successful response is older than 180 seconds, the countdown is wiped and replaced with STALE DATA rather than showing an old minute count.
  • Hide the clock during sleep. Outside configured morning hours the board goes into deep sleep and hides the clock completely — a frozen clock on e-Paper looks broken.
Four 250x122 e-Paper UI states: active countdown with LEAVE alert, LATE train indicator, STALE DATA warning, and SLEEP mode
The four core 250×122 1-bit e-Paper states (generic transit labels). Every state is rendered and unit-tested on a laptop before flashing the Pico.

Embedded quirks worth solving cleanly

Two small details made the firmware noticeably nicer to live with:

  1. Reading battery voltage on a Pico W without fighting Wi-Fi. On the Pico W, the VSYS/3 voltage divider sits on GPIO29 (ADC3), which is shared with the CYW43 Wi-Fi chip’s SPI clock line (with GPIO25 as chip select). Reading ADC while Wi-Fi is active returns garbage. The fix is to measure only while the radio is off, temporarily release the pin, discard the first sample, average eight readings, and hand the pin back:
from machine import ADC, Pin

def read_vsys(samples=8):
    Pin(25, Pin.OUT, value=1)   # deselect CYW43 Wi-Fi chip
    Pin(29, Pin.IN, pull=None)  # switch GPIO29 to analog input
    adc = ADC(3)
    adc.read_u16()              # discard first reading
    total = sum(adc.read_u16() for _ in range(samples))
    v = total / samples * 3.3 * 3 / 65535
    Pin(29, Pin.ALT, pull=Pin.PULL_DOWN, alt=7)  # return to Wi-Fi
    Pin(25, Pin.OUT, value=0)
    return v
  1. Phone setup via captive portal + QR code. Hardcoding Wi-Fi credentials or transit stop IDs gets old fast. Holding the physical side button switches the Pico into an access point and draws a QR code directly on the e-Paper screen; scanning it opens a tiny local web form to configure Wi-Fi, active hours, and stop settings without touching a USB cable.
Power 1000 mAh LiPo HW-373 (TP4056) USB-C charging VSYS Raspberry Pi Pico W MicroPython + watchdog Wi-Fi burst + ADC3 read Captive portal + QR 2.13" e-Paper (SPI) 250 × 122 · zero idle draw 12×12 Tactile Button Wake / refresh / setup
fig 1. All electronics, battery, and switch sit inside a 4-part, screwless, support-free PLA enclosure designed with Forge.

Designing the screwless 3D enclosure with Forge

Getting the electronics working on a desk takes a weekend; turning a stack of a Pico W, an e-Paper hat, a 1000 mAh LiPo pouch, a TP4056 USB-C charger board, and a 12×12 mm tactile button into a clean enclosure is where most DIY projects stall.

This project is actually what pushed me to build Forge (github.com/mskasal/forge). Instead of eyeballing dimensions in a GUI CAD tool or letting an AI guess board sizes, every physical component went into code with caliper measurements (EPD_W = 65.11 mm, BATT_T = 10.44 mm, HW-373 = 27.93 × 17.12 mm, BTN = 12.0 × 7.3 mm).

Three habits from the Forge workflow saved hours of wasted plastic:

  • Print tiny fit coupons before the full shell. Before printing the full housing, I generated two 15-minute test slices: one solely for the slide-in USB-C charger pocket (usbc_test) and one for the 12×12 tactile switch pocket and U-lock (btn_test). Once both clicked cleanly in hand, those exact parametric dimensions dropped straight into the main body.
  • Four screwless, support-free parts. The final enclosure prints flat on the bed with zero supports:
    1. Front body — recessed window for the active e-Paper area, ribbed sides, a 15° desk/ledge stand, a horizontal teardrop cutout for the switch shaft, and a USB-C slot.
    2. Back cover — holds the LiPo pouch, the slide-in USB-C charger module, four internal standoffs that gently press the e-Paper flush against the bezel, and two tiny pinholes aligned over the charging status LEDs.
    3. Button U-lock — slides into internal rails behind the tactile switch to eliminate vertical play without a single screw.
    4. Accent button cap — printed separately in a contrasting color with a tight press-fit socket onto the switch stem.
  • Inspect in 3D before slicing. Every revision ran through Forge’s layer printability scan (print_scan) and pushed straight to the 3D web/Apple TV preview so I could orbit internal clearances and check wall thickness before ever sending a .gcode.3mf to the printer.

Showerboard is still a personal build rather than a packaged product, but building it taught me two things that directly shaped everything I’ve worked on since: small, single-purpose physical displays feel much calmer than phones, and giving an AI agent a strict parametric CAD loop (Forge) turns custom hardware enclosures from a chore into a fast evening iteration.