Windy 💨

---

📝 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

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
• Build the device
• Components
• Case Printing
• How to use
• Authors

👨🏻‍💻 Installation

Clone the repository

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

Go to the project folder and then to the application folder

cd src

Finally, execute:

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.