mipi-weather-station 🌦️

Open-source software for the Oracle Raspberry Pi Weather Station kit — a father-son build in Dublin, Ireland. Rewritten from scratch to replace the (now defunct) official Oracle/Raspberry Pi Foundation stack.

Live at weather.dermotdooley.com (a dedicated domain may follow).

Screenshots

Dashboard — "Now in detail"	History — 24h / 7d / 30d / All time

Real readings from the station in Skerries, Co. Dublin — the hero updates every 45s, and a new reading reaches the site about 5s after the Pi records it.

What it does

• Reads the full Oracle kit sensor set on a Raspberry Pi (see docs/sensors.md for the verified chip-level reference):
  • DS18B20 probe — air temperature (1-Wire; the onboard chips self-heat next to the Pi, so the probe on its lead is the real thermometer)
  • BMP085/BMP180 + HTU21D — pressure and humidity (I2C)
  • Anemometer — wind speed & gust (GPIO pulse counting)
  • Rain gauge — tipping bucket (GPIO pulse counting)
  • Wind vane — direction (MCP342X ADC over I2C)
  • TGS2600 — relative air-quality index (the kit's snap-off gas-sensor board)
• Logs every archive record to a local SQLite buffer first (source of truth), so nothing is lost during network or power outages — uploaders replay the backlog automatically (store-and-forward).
• Pushes readings to a Supabase (Postgres) cloud database that powers the website.
• Publishes to Weather Underground, Windy (Stations API v2), CWOP (NOAA MADIS), WOW-BE (wow.meteo.be) and WOW / WOW-IE (wow.met.ie) via pluggable uploader modules — all live from this station. WOW-IE runs until the Met Office shuts WOW down late 2026.
• An Astro front end (on Vercel) renders live conditions, history charts, a forecast, tides, rain radar and bathing-water quality. Installable as an app.
• Alerting: the Pi pings an external watcher on every reading (a dead man's switch), and a GitHub Actions watchdog checks the cloud data — see docs/alerting.md.

Architecture

┌─────────────── Raspberry Pi ───────────────┐
│  sensors/ ──▶ core/sampler ──▶ store/      │
│  (BMP085/HTU21D, wind, rain)  (SQLite)     │
│                                  │         │
│                              upload/       │──▶ Supabase (Postgres)
│               (supabase, wunderground,     │──▶ Weather Underground
│                windy, cwop, wowbe, wow)    │──▶ Windy
│                                            │──▶ CWOP / NOAA MADIS (APRS-IS)
│                                            │──▶ WOW-BE (wow.meteo.be)
│                                            │──▶ WOW / WOW-IE (until late 2026)
└────────────────────────────────────────────┘
                                                   │
                              Astro site on Vercel ┘
                              (server island: live panel,
                               API route + ECharts: history)

Repo layout

pi/     Python collector package (runs on the Pi)
web/    Astro + shadcn/ui site — the full standalone dashboard project
docs/   Wiring, setup, architecture

Quick start (Pi)

# On the Pi (Raspberry Pi OS, I2C + SPI + 1-Wire enabled via raspi-config)
git clone https://github.com/ddools/mipi-weather-station.git
cd mipi-weather-station/pi
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[pi]"
cp config.example.yaml config.yaml   # edit pins, station metadata
cp .env.example .env                 # add Supabase / WU / Windy keys
weatherstation                        # run in foreground to test

Run on boot:

sudo cp systemd/weatherstation.service /etc/systemd/system/
sudo systemctl enable --now weatherstation

No Pi handy? The collector runs anywhere with mock sensors:

pip install -e ".[dev]"
WS_MOCK_SENSORS=1 weatherstation

Configuration

• config.yaml — station metadata (lat/lon/elevation), GPIO pins, calibration constants, sample/archive intervals, which uploaders are enabled.
• .env — secrets only (Supabase service key, WU station key, Windy password, CWOP passcode, WOW-BE auth key, WOW auth key) plus the optional HEARTBEAT_URL. Never committed; see .env.example.

Roadmap

• Repo scaffold, package structure
• Sensor bring-up & calibration (air sensor → wind → rain → vane)
• SQLite buffer + Supabase uploader (store-and-forward)
• Astro site on Vercel (shadcn/ui): server-island live panel + history charts — live at weather.dermotdooley.com
• Weather Underground upload
• Windy Stations API v2 upload
• Wind rose, dark mode, installable PWA
• CWOP (APRS) upload — live; id GW7965 (MADIS G7965), registered 2026-08-31 and activated 2026-09-08 (docs/cwop.md)
• WOW-BE (wow.meteo.be) upload — live since 2026-09-07 (docs/wowbe.md)
• WOW / WOW-IE (wow.met.ie) upload — live until WOW is decommissioned late 2026 (docs/wow-ie.md)
• TGS2600 air quality — on the dashboard since 2026-08-28
• Offline alerting — heartbeat + GitHub watchdog (docs/alerting.md)
• Store-and-forward soak test — 10-minute network outage, full backfill, no gaps (2026-09-26)

Licence

MIT — see LICENSE.