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
Licence
MIT — see LICENSE.
