Skip to the content
2 layers64 × 46 mmWeatherframe, the printed circuit board in 3D

My weather station hardver

Size
64 × 46 mm
Copper layers
2
Thickness
1.6 mm
Parts
50
Nets
31
Pads
224
Tracks, vias
488, 51
Pours
3
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
13 Oct 2026
Updated
13 Oct 2026

Overview

Weatherframe is an open-source printed circuit board by amselgesang, from the amselgesang/weatherframe_v01 repository on GitHub, published under the MIT licence. It is a 2-layer board of 64 × 46 mm with 50 parts on 31 nets, routed with 488 tracks and 51 vias.

It is built around the ESP32-S3-WROOM-1-N16R8, SHT40-AD1B-R2 and TPS63001DRC, with the MCP73831T-2ACI/OT-HXY, USBLC6-2SC6 and M2.5 among its other parts. Its parts include 16 resistors, 13 capacitors, 5 ICs, 4 switches and 3 connectors. It belongs with the home automation and IoT boards and the ESP32 boards of this library.

Main components

12

README

README.md

Weather Frame

13 Oct 2026 — electronics changed. JLCPCB can only place the ESP32-S3 module with Standard assembly, and the build must need no soldering. The electronics are now a ready-made Seeed XIAO ePaper Display Board EE05, which replaces the custom PCB and the Waveshare HAT. Firmware: firmware/weatherframe_ee05.yaml. The custom PCB below is kept as an archived design. Shopping list, assembly and flashing: docs/manufacturing.md.

A wall-hung weather station in a picture frame: Waveshare 7.5" e-paper (800 × 480, 4-level grayscale), custom ESP32-S3 board with a rechargeable 1S LiPo, Wi-Fi + Open-Meteo. Wakes every 15 minutes, refreshes the display, sleeps. Charges over USB-C.

text
docs/                    design documentation + manufacturing & ordering guide (Markdown + PDF)
firmware/                ESPHome configuration (esp-idf, ESP32-S3)
hardware/kicad/          main PCB (64 × 46 mm, 2-layer) — generated from gen/design.py
hardware/kicad/.../fab/  JLCPCB upload set: Gerbers, BOM, CPL (LCSC part numbers)
hardware/mechanical/     wall frame: Fusion 360 script + CadQuery build + STEP/STL

Status (2026-10-13)

PartState
Schematic / PCBRouted. DRC: 0 errors, 0 unconnected; 4 expected silkscreen warnings (antenna overhang, USB-C at the edge) + 1 harmless local-footprint note (SHT40).
JLCPCB filesfab/weatherframe_gerbers.zip, fab/bom_jlc.csv, fab/cpl_jlc.csv — all parts in LCSC stock, basic parts where possible. Re-export after the R6/R11 change (see below) with ./build.sh fab so the CPL/Gerbers are from the same run.
FirmwareValidates with ESPHome 2026.9.1 (esphome config weatherframe.yaml). Not compiled yet — compile and flash on the Mac.
Display layoutfirmware/.esphome/snapshots/weatherframe-preview/preview.bmp (from esphome run preview.yaml).
FrameDesigned: two printed parts (bezel + back plate), 192.8 × 131.5 × 24 mm, built in Fusion (weather_station_v01, component WeatherFrame_r2) + STEP/STL. HAT geometry measured from the real Rev2.1 board. Not yet printed/verified physically.

Change in this session: R6 / R11 100 k → 150 k (C25755)

The VBUS-sense (GPIO4) and charger-STAT (GPIO15) dividers were 100 k/100 k: 5 V → 2.5 V, which sits exactly on the ESP32-S3's VIH minimum (0.75 × 3.3 V = 2.475 V) and reads undefined on a 4.75 V USB supply. With 150 k on the bottom they give 3.0 V (2.85–3.15 V over the USB range), still below the 3.6 V absolute maximum. Changed in gen/design.py, the schematic, the board and the BOM; same footprint, so the routing is unchanged.

The rest of the pin map was checked against the KiCad library symbols: every firmware GPIO matches the module pin it is wired to, the TPS63001 (FB → VOUT, VINA → VIN, PS/SYNC low = power-save), MCP73831, USBLC6, AO3401A load-sharing, SHT40 and switch wiring are all correct.

Ordering from JLCPCB

PCB + assembly: upload fab/weatherframe_gerbers.zip (2 layers, 1.6 mm, any colour), tick PCB Assembly (top side, economic), then upload bom_jlc.csv and cpl_jlc.csv. Not assembled (hand-solder): J3 (9-pin header / cable to the HAT) and the mounting holes. Check the preview that JLC's rotation of U1 (ESP32 module), J1 (USB-C) and U3 (TPS63001, pin 1 dot) matches the render in build/render_top.png — rotate in their viewer if not.

Frame (JLC3DP): upload hardware/mechanical/export/bezel.stl and back.stl. Recommended: MJF, PA12 nylon, dyed black or grey (bezel), or SLA 9000R resin for a smoother face. Both parts fit the standard build volumes. Expect about 58 cm³ + 86 cm³ of material.

Frame design

hardware/mechanical/frame_geom.py is the single source of truth (all dimensions in mm, with the panel data from the Waveshare 7.5" V2 spec sheet, section 1.4). Two ways to get geometry:

  • Fusion 360: frame_fusion360.py — Utilities ▸ Add-Ins ▸ Scripts and Add-Ins ▸ create a Python script, replace its .py with this file, Run. It builds the bodies bezel, back (print these) and ref_panel, ref_pcb, ref_hat, ref_battery (reference only). Edit the P dict and re-run to change anything. Verified: the script was executed inside Fusion through the Fusion MCP connector on 2026-10-13 and produced the same body volumes as the CadQuery build (bezel 57.7 cm³, back 86.2 cm³).
  • No Fusion needed: python3 build_cadquery.py export (pip install cadquery) regenerates the STEP/STL files; python3 render.py export writes the preview PNGs.

Layout (front view, active area centred at the origin, Z toward the viewer):

  • Bezel — 4 mm face (2.5 mm lip over the 3.5 mm panel border, 1.5 mm panel recess), window = active area + 0.8 mm, 1 mm chamfer, 14 mm rim (18 mm at the bottom for the FPC fold), 2.5 mm walls, 17 mm cavity, four M3 heat-set-insert bosses, USB-C opening in the right wall (wall thinned to 1 mm locally so the plug seats).
  • Back plate — 3 mm, M3 counterbored screws, two keyhole hangers (circle Ø8, slot up), PCB on four M2.5 standoffs (components facing the plate, USB-C to the right wall, MAINT switch reachable through a slot at the bottom edge, RESET/BOOT/REFRESH through Ø3 holes, vent slots over the SHT40 corner), four M2.5 standoffs for the e-Paper Driver HAT Rev2.1 (Pi-Zero 58 × 23 mm hole pattern; its 2×20 header sinks into a 1.5 mm pocket), battery fence for a 605080 LiPo (6 × 50 × 80 mm, ~3000 mAh ≈ 2 months per charge), and press pads that hold the glass against the lip with 1 mm foam tape.
  • HAT sits with its switches / ZIF / JST side toward the panel (2.2 mm clearance to the glass) and the 40-pin header toward the back plate; the panel FPC folds around the bottom edge of the glass into the ZIF (24 mm tail, ~21.6 mm used). HAT switches: Display Config B, Interface Config 0 (4-line SPI). Its 8-wire PH2.0 cable (BUSY RST DC CS CLK DIN GND VCC) is soldered into J3 — J3's second VCC pin stays unused.

Assembly notes: glue 1 mm foam tape on the six pads before closing; the HAT cable is soldered directly into J3 (a vertical header would not fit under the back plate — for a PCB r2 consider a right-angle JST-PH there to use the HAT's cable as-is); the battery lead reaches J2 across the top of the HAT, an 80 mm lead or an extension is needed. Screws: 4× M3×8 (back plate into heat-set inserts), 8× M2.5×5 self-tapping (PCB + HAT standoffs).

Bring-up

sh
cd firmware
cp secrets.yaml.example secrets.yaml   # fill in Wi-Fi + OTA password
esphome run weatherframe.yaml          # USB-C the first time; set MAINT on for OTA/logs later
esphome run preview.yaml               # desktop layout preview (SDL window + BMP snapshot)

Pins, intervals, location and language are substitutions at the top of weatherframe.yaml.

Regenerating the hardware

sh
cd hardware/kicad/weatherframe
./build.sh sch      # schematic from gen/design.py
./build.sh check    # ERC + DRC + render into build/
./build.sh fab      # JLCPCB files into fab/
# full re-route only if footprints/positions change: ./build.sh place -> Freerouting -> ./build.sh finish

Parts

50
QtyValueFootprintReferences
5100nFCapacitor_SMD:C_0402_1005MetricC3, C5, C9, C11, C12
4M2.5MountingHole:MountingHole_2.7mm_M2.5H1, H2, H3, H4
3100kResistor_SMD:R_0402_1005MetricR5, R10, R17
310kResistor_SMD:R_0402_1005MetricR12, R13, R14
34.7uFCapacitor_SMD:C_0603_1608MetricC1, C2, C13
2150kResistor_SMD:R_0402_1005MetricR6, R11
21MResistor_SMD:R_0402_1005MetricR8, R9
222uFCapacitor_SMD:C_0805_2012MetricC6, C7
24.7kResistor_SMD:R_0402_1005MetricR15, R16
25.1kResistor_SMD:R_0402_1005MetricR1, R2
2AO3401APackage_TO_SOT_SMD:SOT-23Q1, Q2
11.5uHInductor_SMD:L_Changjiang_FNR4030SL1
110uFCapacitor_SMD:C_0805_2012MetricC4
110uFCapacitor_SMD:C_0603_1608MetricC8
11kResistor_SMD:R_0402_1005MetricR4
11uFCapacitor_SMD:C_0402_1005MetricC10
12kResistor_SMD:R_0402_1005MetricR3
1B5819WDiode_SMD:D_SOD-123D1
1BOOTButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187ASW2
1CHGLED_SMD:LED_0603_1608MetricD2
1E-Paper HATConnector_PinHeader_2.54mm:PinHeader_1x09_P2.54mm_VerticalJ3
1ESP32-S3-WROOM-1-N16R8RF_Module:ESP32-S3-WROOM-1U1
1LiPo 1SConnector_JST:JST_PH_S2B-PH-SM4-TB_1x02-1MP_P2.00mm_HorizontalJ2
1MAINTButton_Switch_SMD:SW_SPDT_Shouhan_MSK12C02SW4
1MCP73831-2Package_TO_SOT_SMD:SOT-23-5U2
1REFRESHButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187ASW3
1RESETButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187ASW1
1SHT40-AD1BSensor_Humidity:Sensirion_DFN-4_1.5x1.5mm_P0.8mm_SHT4x_NoCentralPadU4
1TPS63001Package_SON:Texas_DRC0010JU3
1USB-CConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U5

Similar boards

  • 2 layers85.6 × 54 mmWallet dmm, the printed circuit board in 3D

    Wallet dmm

    ArgonautGit/wallet_dmm

    A multimeter the size of a credit card: DC volts, resistance, continuity and diode test, shown on a 0.91" OLED, with three buttons, an RGB LED and a piezo beeper.

    70 parts
  • 4 layers90 × 50 mmCryobelt, the printed circuit board in 3D

    Cryobelt

    michael201110/cryobelt

    100 parts1
  • 2 layers50 × 50 mmStarter, the printed circuit board in 3D

    Starter

    vaknin/PCB

    Hardware ideas to fab-ready PCBs as code: Rust pcbgen on KiCad 10, Freerouting, ESP-IDF firmware with QEMU/Wokwi simulation, CadQuery enclosures

    37 parts
  • 2 layers87.9 × 87.5 mmCreative controller, the printed circuit board in 3D

    Creative controller

    ZMGID/grokbot-home

    Grok Bot account migration home (secrets encrypted)

    59 parts
  • 6 layers84 × 98 mmFujiNet-5200-Rev0, the printed circuit board in 3D

    FujiNet-5200-Rev0

    FujiNetWIFI/fujinet-hardware

    Schematics and design files for FujiNet hardware

    145 parts142
  • 4 layers65 × 45 mmLora gps tracker rev a, the printed circuit board in 3D

    Lora gps tracker rev a

    bogdan-kovalchuk/esp32-lora-gps-tracker

    Encrypted point-to-point GPS telemetry over 433 MHz LoRa between two ESP32 boards.

    69 partsMIT
  • 2 layers72 × 72 mmTinyDyno, the printed circuit board in 3D

    TinyDyno

    kgiorgi/TinyDyno

    esp32-s3 based board for measuring time and energy of edge AI. Its main use is to compare my kernels to ESP-DL and TensorFlow Lite Micro on identical inputs.

    35 partsMIT

Questions

How big is the Weatherframe PCB?

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

What parts does the Weatherframe use?

50 parts, built around the ESP32-S3-WROOM-1-N16R8, SHT40-AD1B-R2, TPS63001DRC and MCP73831T-2ACI/OT-HXY. 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 Weatherframe KiCad files?

From the amselgesang/weatherframe_v01 repository on GitHub, at the commit this page was made from: the board is hardware/kicad/weatherframe/weatherframe.kicad_pcb and its schematic hardware/kicad/weatherframe/weatherframe.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Weatherframe 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).