Panel

AeroMet V1 — Solid-State Roof Weather & Air-Quality Station

Open-source rooftop weather and air-quality station with no moving parts (Ø 96 × 235 mm, UV-stabilised ASA): ultrasonic wind, acoustic rain and hail, UV / sunlight / night-sky brightness, temperature, humidity, pressure, lightning, PM1 / PM2.5 / PM10, VOC / NOx and true CO₂. It runs from 12–32 V DC, talks Wi-Fi and RS-485, serves its own web dashboard and appears in Home Assistant by itself.

What it measures · Hardware · Web UI · Build one · Firmware · Development

What it measures

Full sensor, enclosure and board reference: docs/hardware.md.

Hardware

Cutaway	Exploded	Six boards on one breakaway panel
radiation shield, probe cartridge, base bay	13 printed parts, bayonet and threaded joints	crown, main, probe, power, dome, reflector (4-layer, 140.6 × 63.2 mm)

More renders: inside view, every printed part, board plots

Inside	Base	Pagoda	Wind tunnel
Crown base	Crown lid	Struts	Probe sleeve

Board plots (top / bottom SVG): crown · main · probe · power · dome · reflector · panel

Web UI

The station serves its dashboard over Wi-Fi (no cloud, no app). Every value is computed by the firmware; the page only displays it.

Now	Trends
live readings, forecast, sun & moon, air quality, lightning	any metrics from 1 hour to 6 months, wind rose, records, CSV export
Calibration	Setup
station health, home calibration with household items	Wi-Fi, MQTT / Home Assistant, RS-485 monitor, firmware update

Also: MQTT with Home Assistant auto-discovery, and an RS-485 poll / response protocol (CRC-16 frames with every sensor) for wired loggers.

Build one

1. Order the boards with assembly: ODB++ for AISLER, Gerbers + MPN BOM + CPL for PCBWay / Eurocircuits, or the JLCPCB files for the breakaway panel (hardware/releases/v1/; which file goes where: docs/building.md).
2. Print the enclosure: 8 print plates in enclosure/print/ (MJF / SLS nylon or ASA), plus standard O-rings and a turned PTFE dome.
3. Assemble and seal: harnesses, conformal coating and sealing in docs/building.md.
4. Flash the station once over USB, then bring it up and calibrate it at home: CALIBRATION.md.

Open design questions and acceptance checks: REVIEW_CHECKLIST.md.

Firmware

Download from Releases: each release carries the firmware and the complete hardware package (aeromet-hardware-v1.zip: Gerbers, BOM, CPL, STL / STEP print plates, drawings, build and calibration guides). Every commit to main that passes CI is released, named after its UTC commit time (2026.10.24.0040); the firmware reports the same version.

The version is the UTC commit time, yyyy.mm.dd.hhmm. Local build: python3 station/scripts/release_firmware.py → station/build/firmware/.

Development

python3 hardware/scripts/build.py                     # everything: hardware, CAD, release, firmware, tests
docker compose --profile lint run --rm -T cpp-lint "pio test -d station -e native"   # firmware unit tests
python3 station/scripts/mock_webui_server.py          # Web UI on the simulator: http://127.0.0.1:8765
docker compose --profile lint run --rm lint check .   # lint
python3 docs/render_readme_images.py                  # refresh the README screenshots and PCB render

Architecture, conventions and every command: AGENTS.md.