Team Airwise

This is the repository the AIRWISE device, which is an entry to the PA PI Raspberry Pi competition. Team AIRWISE consists of two pupils at Tynecastle High School, Akshith Bhimanere and Dylan Hill.

The Airwise device

The AIRWISE device's purpose is to meticulously measure the air quality of a room/indoor area, and to correct humidity levels. This is achieved by using a Kitronik Air quality control hat, and reading the air quality values through it. This is an open-source project encouraging others to further build on this project, see the code behind it, and build an AIRWISE themselves

Functions of the AIRWISE device:

• Air quality measurement
• Humidity correction
• CO2 and Air quality buzzer alarm (Email/push notifications coming soon)
• Oled values display
• Locally hosted website to view values
• Water level alert (coming soon)

Instructions to Build the AIRWISE device

Parts List:

• Raspberry Pi
• Kitronik Air Quality Control Hat for Pi
• LED indicator (optional)
• Peltier module (9V)*
• Heat-sink x2*
• Box fan (9V)*
• Micro limit switch
• Jumper wires
• Ribbon cable for GPIO
• Ultrasonic water atomiser/vaporiser
• Double Relay module
• Parts for case made according to 3D model provided (Recommended to 3D print with PLA filament)

*Could be scrapped from a mini dehumidifier

Software Required:

• Pi Imager
• MobaXterm

Step 1: Preparing the Main Modules

1. Assembling the Dehumidifier Unit:

   • Apply thermal paste to one side of the Peltier module and attach the heat-sink, repeat for the other side.
   • Mount the 9V fan to one heat-sink, ensuring proper orientation and airflow direction.

   Alternative: Utilize the internals of a mini dehumidifier.

2. Attaching the Pi to the Air Quality Control Hat:

   • Attach the ribbon cable to the Pi and fold it at a 45-degree angle.
   • Connect the Hat to the ribbon cable.
   • Solder header pins onto the hat for water level functionality.
   • Insert a TF card flashed with Raspberry Pi OS (not Lite) pre-configured for WiFi and SSH.

Preparing and Assembling the Humidifier Unit:

• Solder wires to the buttons of the ultrasonic atomiser control board.

Building the Body/Structure:

• Utilize provided 3D models for fabrication.
• Print/fabricate parts and assemble them together.
• Slide in the mid plate for mounting electronics.
• Insert reservoir, then the wick of the atomiser.

Mounting and Connecting Electronics:

• Mount the limit switch into the midplate.
• Use M2.5 nuts and bolts to secure the relay and Raspberry Pi on the midplate.
• Friction fit 9v power socket
• Connect wiring according to the pictures:

Your AIRWISE device should now be finished in terms of hardware and ready for software configuration.

Software:

1. Connect via SSH:

   • Plug in your Pi.
   • Wait for a minute for the Pi to boot up and connect to the internet, as configured earlier.
   • Open MobaXterm on your computer.
   • Double-click session.
   • Click SSH.
   • Tick specify username, and enter pi as the username. In the box marked Remote Host, enter AIRWISE.local
   • Press OK to start session.

2. Enable Serial:

   • Open terminal on your Raspberry Pi or via SSH.
   • Run sudo raspi-config.
   • Navigate to 'Interface Options'.
   • Select 'Serial Port'.
   • Choose 'Yes' to enable the serial port.
   • Reboot your Pi for changes to take effect.

3. Clone our code:

   • Run sudo git clone https://github.com/Team-AIRWISE/AIRWISE.

4. Last but not least, Run the code

   • Run sudo python3 AIRWISE/main.py.

Your AIRWISE device is now all set up! Enjoy a breath of fresh air!