Device Simulation

This service allows to manage a pool of simulated devices, to test the end-to-end flow of device-to-cloud (D2C) telemetry, invoking cloud-to-device (C2D) commands, methods, etc.

The microservice provides a RESTful endpoint to set the simulation details, to start and stop the simulation, to add and remove virtual devices. The simulation is composed by a set of virtual devices, of different types, each sending telemetry and replying to method calls.

• Device Simulation Wiki
• Development setup, scripts and tools
• How to contribute to the project

How to use the microservice

Quick demo using the public Docker image

After cloning the repository, follow these steps:

1. Install Docker Compose: https://docs.docker.com/compose/install
2. Create an instance of Azure IoT Hub
3. Store the "IoT Hub Connection string" in the env-vars-setup script. For more information about environment variables, see the development notes.
4. Using an HTTP client like Postman, use the RESTful API to create a simulation.

By default, Docker Compose will start the service using the sample device types defined in sample-volume:

• to load device types definitions from a different folder, edit the docker-compose.yml
• to add your custom simulations, add the JSON and Javascript files into the folder and restart the service. See the wiki for more information about device types and the API.

Working with Visual Studio

After cloning the repository, follow these steps:

1. Install Docker: https://docs.docker.com/engine/installation

2. Create an instance of Azure IoT Hub

3. Open the solution in Visual Studio

4. Either in Visual Studio or in your system, define the following environment variable:

   1. PCS_IOTHUB_CONNSTRING = {your Azure IoT Hub connection string}

   For more information about environment variables, see the development notes.

5. In Visual Studio, start the WebService project

6. In Visual Studio, Start the SimulationAgent project

7. Using an HTTP client like Postman, use the RESTful API to create a simulation.