Hardware accessory

Door contact puck

Magnetic reed or button contact that POSTs door open/closed to ThermalTrace. Feeds drafty-bay moods and optional custom alerts — not a freeze probe.

DevicesAdding devices Sketch ↗

What it is

  • Does: POSTs { "door1": true } (open) / false (closed) to your push ingest URL about once a minute or on change.
  • Does not: Measure °F. Pair with a DS18B20 on the same or another device for freeze alerts. Bay mood uses door-open as drafty when wired into the bay sensors.

Parts

Door contact puck parts
Part Why Buy
ESP32 DevKit Wi‑Fi HTTPS POST (same as freeze kit). Adafruit ESP32
Magnetic reed switch Garage / man-door. Wire to GPIO4 + GND (internal pull-up). Adafruit reed · Amazon search

Setup

  1. Create a push device on Devices (or reuse an existing garage device key).
  2. Download or copy sketches/arduino/door_contact_ingest/, set Wi‑Fi + INGEST_URL, flash.
  3. Open/close the door once; Serial 115200 should show POST 200. Rename door1 on Devices.
  4. Optional: add a custom alert rule under Alerts for prolonged open, or rely on Bay Buddy drafty mood.

Amazon buy links may include an Associates tag. Adafruit and other vendor links are direct (Adafruit does not run an affiliate program). ThermalTrace may earn a commission from qualifying Amazon purchases at no extra cost to you.

Related accessories

  • Claim puck — USB presence key: claim a bay with a button press, then show freeze and flood moods on an RP2040-Zero LED.
  • Alert beacon — Desk or hallway mood light that mirrors Bay Buddy freeze/flood moods. Not a temperature probe.
  • Leak contact puck — Water-contact pads that POST wet/dry flood sensors. ThermalTrace auto-alerts when wet once alerts are on.
  • Power outage nudge — USB-mains or UPS sense contact that POSTs power lost/restored so you know when the bay went dark.
  • Kit QR & NFC labels — Printable QR stickers and optional NFC tags encoding your push ingest URL for onboarding without typing keys.
  • Probe mount kit — Zip-ties, pipe clips, adhesive pads, 4.7k pull-up, and waterproof DS18B20 mounting notes for a reliable freeze probe.
  • Claim puck case — Enclosure, button, and optional LED diffuser for the RP2040-Zero claim puck — productize the bare board build.

All accessories · Claim puck · ESP32 freeze kit

Door contact puck FAQ

What it does, what it does not replace, and how it fits ThermalTrace.

What does the door contact puck post?

JSON like {"door1":true} when open. Sketch: sketches/arduino/door_contact_ingest. Guide: thermaltrace.dev/door-puck.

Will an open door trigger freeze SMS by itself?

No. Door sensors feed drafty mood and optional custom alert rules. Freeze SMS still comes from temperature thresholds on a probe.

Which MCU does the sample use?

ESP32 with Wi‑Fi HTTPS POST, same path as the freeze kit. Wire a magnetic reed to GPIO4 with the board’s pull-up.