Ambiance is an air quality monitoring system developed by PUP Hygears for the Polytechnic University of the Philippines. It boasts a user-friendly interface tailored to operate seamlessly on a Raspberry Pi 4. Utilizing Lorawan technologies, data from ESP32-connected sensors is efficiently transmitted for comprehensive analysis and real-time monitoring.

1. Adafruit BME680

   • Temperature
   • Pressure
   • Humidity
   • Biogenic Volatile Organic Compound (Gas Sensor)

2. Adafruit SGP30

   • Total Volatile Organic Compound
   • ECO₂

3. Plantower PMS7003

   • PM 1.0
   • PM 2.5
   • PM 10.0

1. Clone the project repository from GitHub:

   git clone https://github.com/marvinjameserosa/ambiance.git  
   

2. Navigate to the project folder:

   cd \Ambiance
   

3. Install python (Note: Python v11 was used for development):

   https://www.python.org/downloads
   

4. Install project dependencies:

   For web app interface:

   pip install flask
   

   For recieving the data:

   pip install pyserial
   

5. Start the development server:

   python3 web.py
   

1. Clone the project repository from GitHub:

   git clone https://github.com/marvinjameserosa/ambiance.git  
   

2. Navigate to sketch-files folder:

   For all the sensors:

   cd \Ambiance\sketch-files\all-sensors
   

   For the Adafruit BME680 sensor:

   cd \Ambiance\sketch-files\adafruit-bme680
   

   For the Adafruit SGP30 sensor:

   cd \Ambiance\sketch-files\adafruit-sgp30
   

   For the Plantower PMS7003sensor:

   cd \Ambiance\sketch-files\plantower-pms7003
   

3. Open the .ino file for the chosen sensor:

   cd \Ambiance\sketch-files\
   

4. Install project dependencies using Library Manager:

   Sensor	Library Name	Author
   Adafruit BME680	Adafruit BME680 Library	Adafruit
   Adafruit SGP30	Adafruit SGP30 Sensor	Adafruit
   Plantower PMS 7003	PMS Library	Mariusz

5. Connect the pins to the board. (Note: Ambiance was designed for the ESP32, so the pin configurations may differ for your specific board.):

   Sensor	Pin Label (I2C)	Pin Number (Default)
   Adafruit BME680	VCC	VIN
   	GND	GND
   	SCK	22
   	SDI	21
   Adafruit SGP30	VCC	VIN
   	GND	GND
   	SCL	22
   	SDA	21
   Plantower PMS 7003	VCC	VIN
   	GND	GND
   	RX	TX
   	TX	RX

6. Upload the chosen code on to the board.

1. Clone the project repository from GitHub:

   git clone https://github.com/marvinjameserosa/ambiance.git  
   

2. Navigate to sketch-files folder:

   cd \Ambiance\sketch-files
   

3. Open the .ino file for both sender and receiver.

   For Sender:

   cd \Ambiance\sketch-files\lora-sender
   

   For Receiver:

   cd \Ambiance\sketch-files\lora-receiver
   

4. Install project dependencies using Library Manager

   LoRa by Sandeep Mistry
   

5. Connect the pins to the board. Pins are same for both Sender and Receiver. (Note: Ambiance was designed for the ESP32, so the pin configurations may differ for your specific board.):

   Pin Label (SPI)	Pin Number (Default)
   VCC	VIN
   GND	GND
   MISO	19
   MOSI	21
   SCK	18
   CS	17 (any pin can be used)
   RESET	14 (any pin can be used)
   CS	26 (any pin can be used)

6. Upload both the sender and receiver to their respective board.