📡 Smart Sensor Hub

Real-Time IoT Telemetry & Device Control Dashboard

Smart Sensor Hub is a real-time IoT monitoring platform built with ASP.NET Core, MQTT, SignalR, Entity Framework Core, SQLite, and Python.

It ingests sensor telemetry asynchronously, persists readings, evaluates threshold-based alerts, and streams live updates to a reactive command-center dashboard — without page refreshes or polling.

---

⚡ What It Does

IoT Device
    │
    │ MQTT
    ▼
MQTT Broker
    │
    ▼
ASP.NET Core
    │
    ├── Process
    ├── Validate
    ├── Persist
    └── Evaluate Alerts
    │
    ▼
SignalR / WebSocket
    │
    ▼
Live Dashboard

Core capabilities

• 📡 Real-time MQTT ingestion
• ⚙️ Asynchronous background processing
• 🔍 Automatic sensor discovery
• 📊 Live telemetry charts & sparklines
• 🚨 Normal / Warning / Critical alerts
• 🎛️ Bidirectional device ON/OFF control
• 💾 Historical telemetry persistence
• 📁 CSV data export
• ⚡ SignalR-powered live updates
• 🌙 Responsive dark command-center UI

---

🏗️ Architecture

┌──────────────────────┐
│  Python Simulator    │
│     paho-mqtt        │
└──────────┬───────────┘
           │
           │ MQTT Publish
           ▼
┌──────────────────────┐
│    HiveMQ Broker     │
│ smarthub/sensors/#   │
└──────────┬───────────┘
           │
           │ MQTT Subscribe
           ▼
┌────────────────────────────────┐
│        ASP.NET Core            │
│                                │
│  MqttListenerService           │
│          │                     │
│          ├── JSON Processing    │
│          ├── Threshold Engine  │
│          └── EF Core           │
│                │               │
│                ▼               │
│             SQLite             │
│                                │
│          SignalR               │
└──────────────┬─────────────────┘
               │
               │ WebSocket
               ▼
┌────────────────────────────────┐
│        Web Dashboard            │
│                                │
│  KPI Cards  │  Charts          │
│  Sparklines │  Alerts          │
│  History    │  Device Control  │
└────────────────────────────────┘

---

🔄 Real-Time Data Flow

1. Publish

The simulator publishes sensor telemetry through MQTT:

{
  "sensorId": "Machine-A1",
  "temp": 72.5
}

2. Ingest

MqttListenerService runs as an ASP.NET Core BackgroundService and subscribes to:

smarthub/sensors/#

3. Process

The backend:

• Parses incoming JSON
• Detects sensors dynamically
• Calculates sensor status
• Persists telemetry
• Broadcasts updates

4. Stream

SignalR pushes the processed telemetry directly to connected browsers.

5. Render

The frontend instantly updates:

KPI → Sparkline → Chart → Status → Alert

No polling. No refresh.

---

🚨 Smart Threshold Monitoring

Sensor health is determined from configurable temperature thresholds.

const WARN_TEMP = 75;
const CRIT_TEMP = 85;

Temperature	Status
< 75°C	🟢 Normal
75°C – 84.9°C	🟡 Warning
≥ 85°C	🔴 Critical

Critical events are reflected immediately across the dashboard and global alert ticker.

---

🎛️ Bidirectional Device Control

Smart Sensor Hub supports both telemetry ingestion and device commands.

Dashboard
    │
    │ ON / OFF
    ▼
ASP.NET Core
    │
    │ MQTT Publish
    ▼
MQTT Broker
    │
    ▼
IoT Device

Example command:

{
  "sensorId": "Machine-A1",
  "command": "ON"
}

---

📊 Dashboard

The command-center interface provides:

┌───────────────────────────────────────┐
│ MACHINE-A1                            │
│                                       │
│ 🌡 72.5°C        🟢 NORMAL            │
│                                       │
│ ▁▂▃▄▅▄▆▇▆▇                            │
│                                       │
│ Power              [ ON ]             │
└───────────────────────────────────────┘

Dashboard includes

• Live sensor KPI cards
• Temperature trends
• Animated values
• Real-time Chart.js graphs
• Sensor status indicators
• Global alert ticker
• Device power controls
• Historical data modal
• CSV export

---

🛠️ Tech Stack

Backend

• ASP.NET Core MVC
• .NET 8
• Entity Framework Core
• SQLite
• SignalR
• MQTTnet
• BackgroundService

Frontend

• HTML5
• CSS3
• Vanilla JavaScript
• Chart.js
• SignalR JavaScript Client
• JetBrains Mono
• IBM Plex Sans

Simulator

• Python 3
• paho-mqtt

---

📁 Project Structure

Smart-Sensor-Hub/
│
├── Controllers/
│   └── SensorApiController.cs
│
├── Services/
│   └── MqttListenerService.cs
│
├── Models/
│   └── SensorReading.cs
│
├── Data/
│   └── ApplicationDbContext.cs
│
├── Hubs/
│   └── SensorHub.cs
│
├── Views/
│
├── wwwroot/
│   ├── css/
│   └── js/
│
├── SensorSimulator/
│   └── sensor.py
│
├── Program.cs
├── appsettings.json
└── README.md

---

🚀 Getting Started

Prerequisites

• .NET 10 SDK
• Python 3.x
• Git

1. Clone

git clone https://github.com/MSSOhan/Smart-Sensor-Hub.git
cd Smart-Sensor-Hub

2. Start the Backend

dotnet restore
dotnet run

Open the URL shown in the terminal, typically:

http://localhost:5010

The SQLite database is created automatically on first run.

3. Start the Simulator

Open another terminal:

pip install paho-mqtt
python fake_sensor.py

The simulator will begin publishing telemetry to the MQTT broker.

4. Open the Dashboard

http://localhost:5010

Sensors should appear automatically as telemetry arrives.

---

⚙️ Configuration

MQTT

Default broker:

broker.hivemq.com

MQTT configuration is located in:

Services/MqttListenerService.cs
Controllers/SensorApiController.cs

Temperature Thresholds

Configure alert levels in the frontend JavaScript:

const WARN_TEMP = 75;
const CRIT_TEMP = 85;

---

🔐 Production Notes

The project currently uses a public MQTT broker for demonstration purposes.

For production deployments, use:

• MQTT over TLS
• Authenticated/private MQTT broker
• Secure application secrets
• Role-based access control
• Production database
• Centralized logging
• Monitoring & metrics
• Network isolation

⚠️ Do not send sensitive or production telemetry through a public MQTT broker.

---

🔮 Roadmap

• 🔐 Authentication & RBAC
• 📡 MQTT TLS & authentication
• 📊 Advanced analytics
• 🤖 Predictive maintenance
• 🔔 Email / push notifications
• 🗺️ Device location mapping
• 🐳 Docker support
• ☁️ Cloud deployment
• 📈 Prometheus / Grafana integration
• 🗄️ PostgreSQL / SQL Server support

---

🤝 Contributing

Contributions, issues, and feature requests are welcome.

git checkout -b feature/my-feature
git commit -m "Add my feature"
git push origin feature/my-feature

Then open a Pull Request.

---

📄 License

This project is licensed under the MIT License.

---

📡 Smart Sensor Hub

Sense. Process. Stream. Control.

Real-time IoT monitoring powered by

ASP.NET Core · MQTT · SignalR · EF Core · SQLite

⭐ Star the repository if you find it useful.