hawkbit/examples/hawkbit-device-simulator/README.md

# hawkBit Device Simulator

The device simulator handles software update commands from the update server.

## Run
```
java -jar examples/hawkbit-device-simulator/target/hawkbit-device-simulator-*-SNAPSHOT.jar
```
Or:
```
run org.eclipse.hawkbit.simulator.DeviceSimulator
```

## Notes

The simulator has user authentication enabled by default. Default credentials:
*  username : admin
*  passwd : admin

This can be configured/disabled by spring boot properties

## Usage

### Graphical User Interface
The device simulator comes with a graphical user interface which makes it very easy to generate dummy devices handled by the device simulator.
The status and the update progress of the simulated device are shown in the UI.
The UI can be accessed via the URL:
```
http://localhost:8083
```

`Basic Authentication Credentials are admin / admin`

 ![](src/main/images/generateScreenshot.png)
 
 ![](src/main/images/updateProcessScreenshot.png)
 
 ![](src/main/images/updateResultOverviewScreenshot.png)


### REST API
The device simulator exposes an REST-API which can be used to trigger device creation.

Optional parameters:
* name : name prefix simulated devices (default: "dmfSimulated"), followed by counter
* amount : number of simulated devices (default: 20, capped at: 4000)
* tenant : in a multi-tenenat ready hawkBit installation (default: "DEFAULT")


Example: for 20 simulated devices (default)
```
http://localhost:8083/start
```

Example: for 10 simulated devices that start with the name prefix "activeSim": 
```
http://localhost:8083/start?amount=10&name=activeSim
```