πŸ“ Description

The project folder contains everything you need to build 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

1
2
3
4
5
6
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.

πŸ‘¨πŸ»β€πŸ’» Installation

Clone the repository

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

Go to the project folder and then to the application folder

1
cd src

Finally, execute:

1
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.

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.

You can find the STL files in the media sub-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!