A cloud based IoT solution
IotHub provides an abstract solution of any IoT infrastructure including Broker system, API management, Authentication, Agent management system, so that it can be extended to any preferable IoT solution like home automation system, supply chain management.
Solution Structure
-
IotHub.Agent
A .NET web project to establish the channel between
MQTTbroker andSignalRbroker. This agent will publish allMQTTbroker messages toSignalRclients (dashboard, control panel) and send all commands fromSignalRclients toMQTTclients. Agent is using MQTTnetmanaged clientto connect withMQTTbroker. -
IotHub.API
A .NET web API project to provide and manage all data sources of the solution. This project use.
-
IotHub.Broker
A .NET web project to establish a MQTT broker server. Broker is using MQTTnet
server. -
IotHub.Common
A .NET classlib project to provide all common models, enums, exceptions and other stuffs.
-
IotHub.DataTransferObject
A .NET classlib project, using to transfer data from service layer to service, controller and other service consumers.
-
IotHub.DB
A .NET classlib project, to provide all database context and settings. Solution is using
MongoDBas primary database. -
IotHub.DomianModels
A .NET classlib project, to provide domain level models.
-
IotHub.Repositories
A .NET classlib project, to communicate with database or data source and response in domain level. Only
IotHub.Serviceshave the access to use repository to provide a security level to access domain models. -
IotHub.Services
A .NET classlib project, to provide all common services e.g authentication service, user management service, profile management services.
Solution Architecture
Broker Architecture
How to use (development)
Very first clone the project using git clone https://github.com/rafiulgits/IotHub.git or download the project by clicking on download button.
Required Environments
- .NET Core 3.1 or later
- MongoDB
Execution
- Build the solution by
dotnet build - Go to
src/IotHub.APIand fromappsettings.jsonset your internal custom credential and use this credential create some new users (including agent one) and profiles - Run the
src/IotHub.Brokerdevelopment server bydotnet watch run - Go to
src/IotHub.Agent, set agent credentials that you created earlier and run the development server bydotnet watch run
Development environment is ready to use!
For testing with MQTT clients, MQTT fx is a good solution. iothub-dashboard is a Reactive example dashboard that will help to find out how to use IotHub solution.
Full Documentations
License
This repository is licensed with the MIT license.