How juldebidour/airpure_project works
Project type and purpose
• From the README and file names, this is an embedded/IoT “air‐quality” monitoring project (“Airpure_Project”) built around an Arduino (or compatible) microcontroller and at least one gas sensor (MQ135). It reads sensor data, processes it, and outputs or transmits air‐quality measurements.
File structure
• Top‐level directories:
• BIBLIOTHÈQUES UTILES CAPTEURS: contains the MQ135 sensor library (source, headers, examples).
• CODES: holds the Arduino sketches (“.ino” files) that implement the firmware.
• Documentation PDFs: project brief, CDC (specifications), presentation slides.
• No separate “backend” or “frontend” directories—this is a single‐board embedded system.
• Key build/dependency files: library.properties, MQ135CODE.ino, keywords.txt.
README for additional insights
• It simply identifies the project as a group deliverable for Transpromotion 2023/24.
• No high-level architecture details are provided there, so we infer from the code and libraries.
a. Main components
• Sensors: MQ135 gas sensor (optionally combined with DHTxx for temperature/humidity)
• Microcontroller board: Arduino UNO/compatible
• Sensor library module: MQ135-1.1.1 (C++ source + headers)
• Firmware: the two sketches (MQ_Fonctionne.ino, TranspromoMQ.ino)
• I/O interfaces: Serial port (USB) and/or wireless module (if used)
• Power supply: USB or battery (implicitly required)
• (If applicable) Data consumer: PC, logger, or cloud service reading serial data
b. Relationships and interactions
1. Hardware: the MQ135 sensor outputs an analog voltage → routed into the MCU’s ADC input.
2. Firmware: on power‐up, the MCU loads TranspromoMQ.ino; it invokes the MQ135 library to sample and convert to PPM.
3. Data processing: raw ADC values → library functions → calibrated concentration values.
4. Output: processed data → sent over Serial (USB) or to a connected logger/display or wireless module.
5. (Optional) A host PC reads serial data, logs it, or displays it in real time.
c. Architectural patterns or principles
• Layered design:
Layer 1: Hardware (sensors, power, MCU)
Layer 2: Hardware‐abstraction (MQ135 library, ADC wrapper)
Layer 3: Application logic (Arduino sketch, control loops, data formatting)
Layer 4: I/O interface (Serial or network transport)
• Reuse of open‐source sensor library for abstraction and calibration logic.
d. Key technologies/frameworks
• Arduino C++ toolchain (avr-gcc under the hood)
• MQ135-1.1.1 library (C++ .cpp/.h, configured by library.properties)
• Possibly DHTxx sensor example code (bundled in the library’s examples)
• Serial (USB) communication protocol