# uct-engineers-without-borders/isondlo-garden-project architecture

> Architecture diagram of the GitHub repository uct-engineers-without-borders/isondlo-garden-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/uct-engineers-without-borders/isondlo-garden-project
- Repository: https://github.com/uct-engineers-without-borders/isondlo-garden-project

## Overview

##### Project type and purpose
- This is an embedded-IoT prototype (“iSondlo-Garden‐Project”) built around an Arduino Uno R3.
- It collects environmental data (temperature, humidity, soil moisture, light), displays locally, logs to SD, and pushes data via GSM/GPRS.
- The goal is to manage an Arduino-based electronic garden powered by solar PV modules.

##### File structure
- Top-level folder `ewb_isondlo_prototype` contains:
- `control_schematic/` (KiCad files showing the PCB/sensor layout)
- `datasheets/` (PDFs for each sensor, relay, SIM module, etc.)
- `prototypeV1/`
– `Inc/` (header files: one Config.h per sensor/module)
– `Src/main/` (multiple `.ino` sketches: main, screendisplay, soilmoisture, temperature)
- `project_admin/` holds planning docs, meeting minutes, vendor quotations (secondary to architecture)
- `project_details/` holds reference images and system parameter specs (used for context but not core blocks)

##### README
- Confirms Arduino-based embedded system with IoT features.
- Lists key subsystems: solar PV power, sensors, internet connectivity.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Hardware Design Reference
    subgraph "Hardware Design Reference"
        PowerSubsystem["Power Subsystem"] 
    end

    %% MCU Core
    Arduino["Arduino Uno (MCU Core)"]

    %% Sensor Modules
    subgraph "Sensor Modules"
        Temperature["Temperature Sensor (DS18B20)"]
        Humidity["Humidity Sensor Board"]
        SoilMoisture["Soil Moisture Sensor"]
        LightSensor["Light Sensor"]
    end

    %% Actuator Module
    Actuator["Actuator Module (Relay & Solenoid Valve)"]

    %% Storage Module
    Storage["Storage Module\nSD-card Driver"]

    %% Communication Module
    Comm["Communication Module\nSIM900 GSM/GPRS Shield"]

    %% Display Module
    Display["Display Module\nLocal Screen"]

    %% External Cloud
    Cloud["External Cloud/Server"]

    %% Connections
    PowerSubsystem -->|"5 V supply"| Arduino
    Temperature -->|"sensor readings"| Arduino
    Humidity -->|"sensor readings"| Arduino
    SoilMoisture -->|"sensor readings"| Arduino
    LightSensor -->|"sensor readings"| Arduino
    Arduino -->|"control signal"| Actuator
    Arduino -->|"log CSV/JSON"| Storage
    Arduino -->|"UI update"| Display
    Arduino -->|"HTTP/MQTT push"| Comm
    Comm -->|"data to cloud"| Cloud

    %% Click Events
    click PowerSubsystem "https://github.com/uct-engineers-without-borders/isondlo-garden-project/tree/main/ewb_isondlo_prototype/control_schematic/"
    click Arduino "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Src/main/main.ino"
    click Temperature "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/TemperatureSensorConfig.h"
    click Humidity "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/HumiditySensorConfig.h"
    click SoilMoisture "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/SoilMoistureSensorConfig.h"
    click LightSensor "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/LightSensorConfig.h"
    click Actuator "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/RelaySwitchConfig.h"
    click Storage "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/MemoryModuleConfig.h"
    click Comm "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Inc/RemoteConnectionConfig.h"
    click Display "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/ewb_isondlo_prototype/prototypeV1/Src/main/screendisplay.ino"
    click Cloud "https://github.com/uct-engineers-without-borders/isondlo-garden-project/blob/main/README.md"

    %% Styles
    classDef power fill:#f9d5b3,stroke:#333,stroke-width:1px
    classDef sensors fill:#b3f9b3,stroke:#333,stroke-width:1px
    classDef actuators fill:#f9b3b3,stroke:#333,stroke-width:1px
    classDef storage fill:#b3d0f9,stroke:#333,stroke-width:1px
    classDef communication fill:#d0b3f9,stroke:#333,stroke-width:1px
    classDef mcu fill:#cccccc,stroke:#333,stroke-width:1px
    classDef external fill:#e0e0e0,stroke:#333,stroke-width:1px

    class PowerSubsystem power
    class Temperature,Humidity,SoilMoisture,LightSensor sensors
    class Actuator actuators
    class Storage storage
    class Comm communication
    class Arduino mcu
    class Display storage
    class Cloud external
```
