Skip to the content
2 layers60 × 60 mmAir PCB, the printed circuit board in 3D

This folder contains all you need to build our air quality device!

Size
60 × 60 mm
Copper layers
2
Thickness
1.6 mm
Parts
18
Nets
26
Pads
55
Tracks, vias
111, 5
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
10 Apr 2025
Updated
13 Apr 2025

Overview

Air PCB is an open-source printed circuit board by alexzilligmm, from the alexzilligmm/windy repository on GitHub, published under the MIT licence. It is a 2-layer board of 60 × 60 mm with 18 parts on 26 nets, routed with 111 tracks and 5 vias.

Its parts include 7 resistors, 4 diodes, 1 IC and 1 switch. It belongs with the sensors and measurement boards and the ESP32 boards of this library.

README

README.md

Windy 💨

iOS Android Flutter ESP32 License Status

Windy Device Preview


📝 Description

This folder contains everything you need to produce your own Windy, our smart air quality monitor.
The project includes:

📱 A cross-platform companion app

⚙️ The physical device with PCB and case

📚 Full technical documentation doc pdf

md
Windy
├── firmware        
├── media        
├── PCB       
├── src        
└── doc   

🔥 Current capabilities

📐 Measures CO2 and TVOC levels passively when connected to the phone

📊 Measures CO2 and TVOC on demand via the app or the device itself

📉 Provides a detailed history and trend of past measures

💡 Provides tips to improve air quality based on your situation

❤️‍🩹 Known Issues

Unfortunately, not all features we intended to implement function correctly. We list here all known issues:

  • The device collects data only while it is connected to the phone.
  • The application experiences connection issues in everyday use, especially when the application is killed and the device is powered off and on in different combinations.

⭐️ Future work

We plan to insert a new card in the home describing the device status and 3D model, for those install the app without knowing about it.

📋 Table of Contents

👨🏻‍💻 Installation

Clone the repository

bash
https://github.com/alexzilligmm/windy.git

Go to the project folder and then to the application folder

bash
cd src

Finally, execute:

bash
flutter run

Make sure to have flutter installed as well as suitable platform for testing. Use the official page in case you need it flutter.

👷🏻 Building the device

To build the prototype, we welded some commercial components onto a custom PCB board that we designed to enhance ease of assembly and overall elegance. The PCB project files are included in the PCB folder. To design the board, we used KiCad. A custom 3D-printed shell protects the system, providing durability and aesthetic appeal. We publish the STL file in the media folder.

🔗 Components and Links:

We provide links to the components we bought for our prototypes.

  1. Microcontroller: ESP32
  2. Sensor: CJMCU-811
  3. Battery: Lithium battery
  4. PCB: website for pcb printing

A detailed schema of assembly is provided in the report, including resistors details.

🖨️ Case Printing

The case has been designed by Daniel Maroni, a talented designer from Rome.

To build the physical enclosure for Windy, you can 3D print the case using the provided STL files.

📽️ Watch the 3D printing process

You can find the STL files in the media folder:

  • case.stl
  • case_3d_print.mp4 (video demonstration)

A special thanks to Alessandro Vitali for his help and for printing the case.

🚀 How to use it

Once the app is installed and the device ready, switch the device on using the switch on the side. Hold the main button to put the device on pairing mode.

🛜 You should see it on the app now. Click to pair.

📏 It is now measuring the air quality! You can tune the frequency of the measurements in the settings.

📸 If you need a snapshot of the current air quality, press the main button again!

Authors

Barreto Diego, Palmieri Simone, Piarulli Lorenzo, Marincione Davide, Zirilli Alessandro

👨🏻‍🎨 designed by Daniel Maroni

Special thanks to Prof. Emanuele Panizzi for his helpful advice.

Parts

18
QtyValueFootprintReferences
7RResistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P5.08mm_HorizontalR1, R2, R3, R4, R5, R6, R7
4LEDLED_THT:LED_D1.8mm_W3.3mm_H2.4mmD1, D2, D3, D4
2Conn_01x01_PinTestPoint:TestPoint_Pad_D1.5mm-1, +1
1Conn_01x02_SocketConnector_JST:JST_XH_S2B-XH-A_1x02_P2.50mm_HorizontalBATTERY
1Conn_01x03_SocketConnector_JST:JST_XH_S3B-XH-A_1x03_P2.50mm_HorizontalSWITCH
1SW_Push_Open_DualButton_Switch_THT:SW_PUSH-12mm_Wuerth-430476085716SW1
1XIAO Connector/DNPSeeed Studio XIAO Series Library:XIAO-Generic-Thruhole-14P-2.54-21X17.8MMM1
1module_CJMCUCCS811usini_sensors:module_adxl345U1

Similar boards

  • 2 layers27.9 × 16.5 mmPowerSSO-24 breakout, the printed circuit board in 3D

    PowerSSO-24 breakout

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    18 parts1.2k
  • 2 layers42.7 × 13.7 mmStm32-mini12864, the printed circuit board in 3D

    Stm32-mini12864

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    18 parts1.1kGPL-3.0
  • 2 layers41.2 × 46.6 mmThumb cluster left, the printed circuit board in 3D

    Thumb cluster left

    JesusFreke/lalboard

    A 3D-printed keyboard inspired by the DataHand

    18 parts993
  • 2 layers44 × 51.3 mm4272MAVcoder R4, the printed circuit board in 3D

    4272MAVcoder R4

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    18 parts915
  • 2 layers28.3 × 14.3 mmTap Photosensor PCB, the printed circuit board in 3D

    Tap Photosensor PCB

    VoronDesign/Voron-Tap

    Tap is a nozzle-based z-probe for the V2 and Trident printer designs. The entire toolhead moves to trigger an optical switch. Tap offers many advantages:

    18 parts716GPL-3.0
  • 2 layers20.3 × 15.2 mmL0 stepper driver, the printed circuit board in 3D

    L0 stepper driver

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    18 parts546MIT
  • 2 layersMooltipass, the printed circuit board in 3D

    Mooltipass

    limpkin/mooltipass

    Github repository dedicated to the mooltipass project

    18 parts531
  • 2 layers42.5 × 28.8 mmC5VRX JACK DIY V2, the printed circuit board in 3D

    C5VRX JACK DIY V2

    Twotoz/C5VRX

    Ultra-minimal, zero-CPU 5.8 GHz analog FPV video receiver using ESP32-C5 Wi-Fi 6 PHY MODEM_DIAG, BitScrambler WBFM demodulation & resistor DAC CVBS

    18 parts515GPL-3.0

Questions

How big is the Air PCB PCB?

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

What parts does the Air PCB use?

18 parts. 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 Air PCB KiCad files?

From the alexzilligmm/windy repository on GitHub, at the commit this page was made from: the board is PCB/v2.0/Air_PCB/Air_PCB.kicad_pcb and its schematic PCB/v2.0/Air_PCB/Air_PCB.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

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