Skip to the content
2 layers75 × 90 mmWeather station, the printed circuit board in 3D

Reads temperature, humidity, and pressure via a BME280 over I2C, monitors air quality with a PMS5003 over UART, and displays everything on an SH1106 OLED. A few diagnostic LEDs signal hardware faults on startup.

Size
75 × 90 mm
Copper layers
2
Thickness
1.6 mm
Parts
20
Nets
35
Pads
71
Tracks, vias
93, 14
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
25 Apr 2026
Updated
14 May 2026

Overview

Weather station is an open-source printed circuit board by maxr777, from the maxr777/weather-station repository on GitHub. It is a 2-layer board of 75 × 90 mm with 20 parts on 35 nets, routed with 93 tracks and 14 vias.

It is built around the PMS5003 and BME280. Its parts include 6 resistors, 6 connectors and 4 diodes. It belongs with the home automation and IoT boards and the ESP32 boards of this library.

Main components

2

README

README.md

Weather Station

ESP32-based weather station built with ESP-IDF, no third-party sensor libraries. A handmade rewrite of an earlier Arduino IDE version that relied on libraries. Also taken further: soldered onto a perfboard with a 3D printed enclosure instead of a breadboard.

Reads temperature, humidity, and pressure via a BME280 over I2C, monitors air quality with a PMS5003 over UART, and displays everything on an SH1106 OLED. A few diagnostic LEDs signal hardware faults on startup.

All sensor drivers written from scratch against the datasheets. Structured as pure header-only libraries — an experiment after building projects with both the classic .h/.c split and unity builds. Uses Raylib naming conventions - I'd use Tiger Style if starting it today. Font by petabyt. Startup logo generated with Claude.

Demo

Low res thumbnails — click to watch on YouTube

Breadboard demo

Perfboard build

Schematic

Schematic

Build

idf.py build flash monitor (run from the root directory, not main/)

Notes

  • Enum names ended up too verbose - need to be more conservative with it
  • Tiger Style's big-endian naming is so much better (BME280_setup() over setup_BME280()) - it reads better and works great with autocomplete
  • camelCase is harder to read and is a headache sometimes (e.g. 0 followed by O, or GetLEDGPIO) - definitely use snake_case

Parts

20
QtyValueFootprintReferences
41KResistor_SMD:R_0805_2012MetricR1, R2, R3, R4
4MountingHole_3.2mm_M3MountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4
24.7KResistor_SMD:R_0805_2012MetricR5, R6
1BME280Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_VerticalJ3
1ESP32_leftConnector_PinHeader_2.54mm:PinHeader_1x15_P2.54mm_VerticalJ1
1ESP32_rightConnector_PinHeader_2.54mm:PinHeader_1x15_P2.54mm_VerticalJ2
1LED_BLUELED_SMD:LED_0805_2012MetricD2
1LED_GREENLED_SMD:LED_0805_2012MetricD4
1LED_REDLED_SMD:LED_0805_2012MetricD3
1LED_WHITELED_SMD:LED_0805_2012MetricD1
1PMS5003Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ4
1SH1106Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ6
1logic_analyzerConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ5

Similar boards

  • 2 layers56 × 58 mmWeather station, the printed circuit board in 3D

    Weather station

    Dhruv2212-star/weather-station

    A Complete working model of a small but usefull weather station made at home with custom PCB and Casings to give it a unique look!

    22 parts
  • 2 layers65 × 64 mmPms5003, the printed circuit board in 3D

    Pms5003

    ayoy/kicad-projects

    34 parts2
  • 4 layers74 × 56 mmAtmos, the printed circuit board in 3D

    Atmos

    HearnChristian/atmos-sense

    ESP32-based atmospheric sensing node: BME280 environmental sensing and AS3935 lightning detection over I2C, designed for drone integration. KiCad hardware plus firmware.

    73 parts1MIT
  • 2 layers85.5 × 79 mmHl project1, the printed circuit board in 3D

    Hl project1

    CarterJack-VA/hackclub-halflife

    12 partsUnlicense
  • 2 layers45 × 30 mmAqm sensor, the printed circuit board in 3D

    Aqm sensor

    cehbz/aqm-sensor

    ESP32-C3 air quality monitor sensor board (KiCad 9 + ESP-IDF)

    19 parts
  • 2 layers37.4 × 54.6 mmAirAware, the printed circuit board in 3D

    AirAware

    evanloi/air-aware

    AirAware is a portable air quality monitor built with an ESP32-C3 and PMS5003 to measure particulate matter and support hands-on air quality education.

    16 partsMIT
  • 2 layers60 × 90 mmPluggable, the printed circuit board in 3D

    Pluggable

    hannesweisbach/sensorbox

    26 parts
  • 2 layers38.6 × 26.7 mmCanary, the printed circuit board in 3D

    Canary

    JpTan/Canary

    A sensor network of compact indoor air quality monitors

    12 partsGPL-3.0

Questions

How big is the Weather station PCB?

It measures 75 × 90 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Weather station use?

20 parts, built around the PMS5003 and BME280. 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 Weather station KiCad files?

From the maxr777/weather-station repository on GitHub, at the commit this page was made from: the board is kicad/weather_station.kicad_pcb and its schematic kicad/weather_station.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Weather station design in my own project?

Its repository states no licence, so its author keeps all rights: ask maxr777 before reusing the design.