📒 Table of Contents

• About the Project
  • Screenshots
• Using the simulator
• Development
• Environment Variables
• Contact
• Contributing
• Acknowledgements

✨ About the Project

• IoTSensorsOPCUA is an IoT sensor data simulator that allows you to realistically simulate multiple IoT sensors with great flexibility and minimal configuration.

Sample of the data generated by the simulator :

Configuration file for the previous result :

{
    "SET_DELAY_BETWEEN_MESSAGES" : 5,
    "RANDOMIZE_DELAY_BETWEEN_MESSAGES" : "true",
    "SIMULATORS": [
        {
            "Name" : "Temperature",
            "Mean" : 50.0,
            "StandardDeviation" : 3.0
        },
        {
            "Name" : "Pressure",
            "Mean" : 80.0,
            "StandardDeviation" : 9.0
        },
        {
            "Name" : "Humidity",
            "Mean" : 40.0,
            "StandardDeviation" : 3.0
        },
        {
            "Name" : "Air Quality",
            "Mean" : 15.0,
            "StandardDeviation" : 5.0
        }
    ]
}

The simulator generates data based on the mean and standard deviation of the actual sensor data.

📷 Screenshots

IoTSensorsOPCUA microservice:

UaExpert OPCUA Client connected to IoTSensorsOPCUA server:

📎 Using the simulator

Check out a scenario of using the simulator :

• Docker is the recommended way to use the simulator.

  A Docker image of the simulator is available : docker pull amineamaach/sensors-opcua.

To run this example (Using Docker):

1. Clone this repository :

  git clone git@github.com:amine-amaach/simulators.git && cd examples/ioTSensorsOPCUA/

1. Run 🏃

  docker compose up

💻 Development

Make sure you have GO installed (1.18+)

1. Clone this repository :

  git clone git@github.com:amine-amaach/simulators.git && cd ioTSensorsOPCUA

1. Run 🏃

  go run cmd/main.go

And Happy Coding

⚙️ Configuration

The application is configured using the following variables:

SET_DELAY_BETWEEN_MESSAGES

• Allows you to set the delay between data points in seconds.

RANDOMIZE_DELAY_BETWEEN_MESSAGES

• Allows you to randomize the duration between data points, when set to false SET_DELAY_BETWEEN_MESSAGES is used as fixed duration.

SIMULATORS

• Allows you to define simulators with their parameters.

  Name : The sensor's name.

  Mean : The data mean of the actual sensor.

  StandardDeviation : The data Standard Deviation of the actual sensor.

USERIDs

• Allows you to add users to the OPCUA server for authenticated connections.

Config Sample

{
    "SET_DELAY_BETWEEN_MESSAGES" : 5,
    "RANDOMIZE_DELAY_BETWEEN_MESSAGES" : "true",
    "SIMULATORS": [
        {
            "Name" : "Temperature",
            "Mean" : 50.0,
            "StandardDeviation" : 3.0
        },
        {
            "Name" : "Pressure",
            "Mean" : 80.0,
            "StandardDeviation" : 9.0
        }
    ],
    "USERIDs": [
        {
            "Username" : "root",
            "Password" : "secret"
        }
    ]
}

🤝 Contact

Amine Amaach - LinkedIn - Email

Project Link: https://github.com/amine-amaach/simulators.git

👋 Contributing

Every bit helps! If you come across any bugs, please send a bug report, or if you feel inclined to fix it yourself, submit a pull request.

💎 Acknowledgements

• awcullen/opcua
• Viper
• bitperfect