Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/lin775533/dualdash-iot-monitor

Last synced: about 2 months ago
JSON representation
Host: GitHub
URL: https://github.com/lin775533/dualdash-iot-monitor
Owner: Lin775533
License: mit
Created: 2024-11-20T07:41:57.000Z (2 months ago)
Default Branch: master
Last Pushed: 2024-11-20T09:03:11.000Z (2 months ago)
Last Synced: 2024-11-20T09:04:10.596Z (2 months ago)
Language: JavaScript
Size: 1.41 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

        # Smart Environment Monitor

[![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org/)

[![MongoDB](https://img.shields.io/badge/MongoDB-%3E%3D4.4-green)](https://www.mongodb.com/)

[![ESP8266](https://img.shields.io/badge/ESP8266-NodeMCU-blue)](https://www.espressif.com/)

[![AWS IoT Core](https://img.shields.io/badge/AWS-IoT%20Core-orange)](https://aws.amazon.com/iot-core/)

[![AWS SNS](https://img.shields.io/badge/AWS-SNS-green)](https://aws.amazon.com/sns/)

[![AWS Lambda](https://img.shields.io/badge/AWS-Lambda-orange)](https://aws.amazon.com/lambda/)

> A professional IoT solution for real-time environmental monitoring, featuring multi-sensor data collection, instant alerts, and comprehensive data visualization through a modern web dashboard.

## 📑 Table of Contents

- [Overview](#-overview)

- [Features](#-features)

- [System Architecture](#-system-architecture)

- [Technical Implementation](#-technical-implementation)

- [Getting Started](#-getting-started)

- [AWS Integration](#-aws-integration)

- [Demo Showcase](#-demo-showcase)

- [Acknowledgments](#acknowledgments)

## 🔍 Overview

Smart Environment Monitor is an enterprise-grade IoT system that combines hardware sensors, cloud connectivity, and data analytics to provide comprehensive environmental monitoring. The system utilizes ESP8266 microcontrollers and various sensors to capture real-time environmental data, process it through a robust backend infrastructure, and present actionable insights through an intuitive web interface.

### Key Capabilities

- Real-time environmental data monitoring

- Instant alert notifications

- Historical data analysis

- Cloud-based data storage

- Mobile-responsive dashboard

## ⭐ Features

### Hardware Integration

- LCD Display for real-time readings

- Ambient Light (LDR) sensing

- Motion Detection (MPU6050)

- Visual & Audio Alerts

### Software Capabilities

- Real-time data analysis

- Customizable alert thresholds

- Historical trend analysis

- Data export functionality

### System Features

- MQTT-based communication

- REST API endpoints

- MongoDB data storage

- AWS IoT Core integration

### Security & Reliability

- Automated data backup

- Error handling & recovery

- Comprehensive logging

- Access control

## 🏗 System Architecture

```mermaid

graph LR

    %% Increase size and spacing

    linkStyle default stroke-width:2px

    subgraph Hardware[" Hardware "]

        style Hardware fill:#f5f5f5,stroke:#333,stroke-width:2px

        LDR[LDR Sensor] -->|Light Data| ESP[ESP8266]

        MPU[MPU6050] -->|Movement Data| ESP

        ESP -->|Display| LCD[LCD Display]

    end

    subgraph Local["Local Processing"]

        style Local fill:#e6e6e6,stroke:#333,stroke-width:2px

        ESP -->|Process & Format| MQTT[MQTT Client]

        ESP -->|Check| TH[Thresholds]

    end

    subgraph Cloud["Cloud Services"]

        style Cloud fill:#f0f0f0,stroke:#333,stroke-width:2px

        MQTT -->|Publish| NODE[Node.js Server]

        NODE -->|Store Data| DB[(MongoDB)]

        NODE -->|Process| ALERT[Alert System]

        ALERT -->|Notifications| NOTIFY[Email/SMS]

    end

    subgraph Viz["Data Visualization"]

        style Viz fill:#e8e8e8,stroke:#333,stroke-width:2px

        DB <-->|Query| API[REST API]

        API -->|Read Data| VDASH[Visualization Dashboard]

        VDASH -->|View Data| USER1[User]

    end

    subgraph Control["Threshold Control"]

        style Control fill:#f2f2f2,stroke:#333,stroke-width:2px

        TDASH[Threshold Dashboard] -->|Update| TH

        USER2[User] -->|Adjust Thresholds| TDASH

    end

    %% Node Styles with better contrast

    style ESP fill:#d4e6f1,stroke:#333,stroke-width:3px

    style DB fill:#d5f5e3,stroke:#333,stroke-width:3px

    style VDASH fill:#fad7a0,stroke:#333,stroke-width:3px

    style TDASH fill:#d7bde2,stroke:#333,stroke-width:3px

    

    %% Make all text black for better readability

    classDef default fill:#fff,stroke:#333,stroke-width:2px,color:#000

    classDef emphasis fill:#e8e8e8,stroke:#333,stroke-width:3px,color:#000

```

## System Demo



  



## 📑 Table of Contents

- [Overview](#-overview)

- [Application Scenarios](#-application-scenarios)

- [Features](#-features)

- [System Architecture](#-system-architecture)

- [Technical Implementation](#-technical-implementation)

- [Getting Started](#-getting-started)

- [AWS Integration](#-aws-integration)

- [Development](#-development)

- [License](#-license)

- [Acknowledgments](#-acknowledgments)

## 🔍 Overview

Smart Environment Monitor is an enterprise-grade IoT system that combines hardware sensors, cloud connectivity, and data analytics to provide comprehensive environmental monitoring. The system utilizes ESP8266 microcontrollers and various sensors to capture real-time environmental data, process it through a robust backend infrastructure, and present actionable insights through an intuitive web interface.

### Key Capabilities

- Real-time environmental data monitoring

- Instant alert notifications

- Historical data analysis

- Cloud-based data storage

- Mobile-responsive dashboard

## 🎯 Application Scenarios



  

    

      

        


        Smart Agriculture


        Optimize crop growth with automated climate control

      

      

        


        Industrial


        Monitor inventory conditions & security

      

      

        


        Data Centers


        Protect IT equipment & optimize power

      

    

    

      

        


        Laboratory


        Maintain precise research conditions

      

      

        


        Smart Buildings


        Enhance comfort & energy efficiency

      

      

        


        Cold Chain


        Track conditions during transport

      

    

  



### Key Benefits

- 🌡️ 24/7 Environmental Monitoring

- ⚡ Real-time Alerts & Response

- 📊 Data Analytics & Reporting

- 🔐 Compliance & Documentation

- ⚙️ Automation & Integration

## 🛠 Technical Implementation

### Hardware Configuration

| Component | Connection | Purpose |

|-----------|------------|----------|

| DHT11 | GPIO4 (D2) | Temperature & Humidity |

| LDR | ADC (A0) | Light Level |

| MPU6050 | I2C (D1/D2) | Movement Detection |

| LED | GPIO12 (D6) | Visual Alerts |

| Buzzer | GPIO14 (D5) | Audio Alerts |

### Communication Layer (MQTT)

The MQTT protocol enables real-time communication between IoT devices and the server.

#### Broker & Topics

- **Broker**: test.mosquitto.org (Public MQTT Broker)

- **Topic Structure**:

  ```plaintext

  envmonitor/

  ├── data           # Real-time sensor readings

  ├── alerts         # System alerts and notifications

  └── device/status  # Device health monitoring

  ```

#### Implementation Details

- Node.js MQTT client (v4.3.7) for server

- PubSubClient for ESP8266

- Real-time data transmission

- Automatic connection recovery



  

  MQTT Communication Demo



### Data Layer (MongoDB)

MongoDB manages our data persistence with optimized storage and retrieval capabilities.

#### Database Structure

```plaintext

smart_environment_db/

├── sensor_data/  # Environmental measurements

├── alerts/       # Alert records

├── device_logs/  # System operation logs

└── thresholds/   # Alert threshold configurations

```

#### Key Features

- Time-series optimization

- Automated data archiving

- Optimized indexing

- Advanced aggregation

### Application Server (Node.js)

Our Express.js server handles API requests and business logic with robust security measures.

#### Core Features

- RESTful API endpoints

- Real-time WebSocket support

- JWT authentication

- Rate limiting & CORS protection



  

  Data Retrieval Demo



#### API Endpoints

```plaintext

Endpoint                 Method  Description

────────────────────────────────────────────────────────

/api/v1/data            GET     Fetch sensor readings

/api/v1/threshold       POST    Modify alert thresholds

/api/v1/alerts          GET     Retrieve alert history

/api/v1/device          POST    Update device settings

```

## 🚀 Getting Started

### Prerequisites

- Node.js ≥ 14.0.0

- MongoDB ≥ 4.4

- Arduino IDE with ESP8266 support

- AWS Account (optional)

### Quick Start

1. Clone the repository

2. Configure environment variables

3. Install dependencies

4. Deploy hardware components

5. Start the application

## 🌩 AWS Integration

### AWS Services Used

- **AWS IoT Core**: For secure MQTT communication

- **AWS SNS**: For alert notifications

- **AWS DynamoDB**: For data storage (optional)

### AWS SNS Example



  

  AWS SNS Integration Demo



## 📸 Demo Showcase

### Hardware Setup



  

  



ESP8266 Hardware Setup and WiFi Connection


### Threshold Management



  

  Threshold Adjustment Dashboard



## Acknowledgments

- MQTT Broker: test.mosquitto.org

- Chart.js for data visualization

- Bootstrap for UI components

- ESP8266 Community