# Device simulator

> The Device Simulator App simulates data input into BuildingPro Suites.

#### Overview

This guide provides instructions on how to configure, install, and use the Device Simulator App.

#### Installation

Install the Device Simulator App via the BuildingPro Suites App Store.

#### Configuration

The Device Simulator App requires configuration via the BuildingPro Suites settings. The general steps and details for configuring the app are listed below.

#### Configure the Device Simulator App

Generators can be created in BuildingPro Suites under `Apps > Device Simulator > Settings`, which opens the app's [Generic Frontend](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps). Here you can use the `/generators` endpoint with the POST method. Each generator requires the following data:

| Attribute          | Description                                                                                                                                                                                                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `asset_id`         | ID of the simulated asset.                                                                                                                                                                                             |
| `attribute`        | Attribute name of the generated data.                                                                                                                                                                                  |
| `subtype`          | Subtype of the generated data (e.g., "input").                                                                                                                                                                         |
| `function_type`    | Function type for data generation (e.g., "sin\_wave", "random", "sawtooth\_wave").                                                                                                                                     |
| `min_value`        | Minimum value for the generated data.                                                                                                                                                                                  |
| `max_value`        | Maximum value for the generated data.                                                                                                                                                                                  |
| `integer`          | Specifies whether the generated value should be an integer or a float (`true` for integer, `false` for float).                                                                                                         |
| `interval_seconds` | Interval in seconds for data generation. (Sampling rate) (How often should new data be generated?)                                                                                                                     |
| `frequency`        | Frequency in Hz for wave functions. (How often should the function reach the original value per second?) (typically less than 1) (May not be higher than 1/(2\*Interval\_seconds) to avoid aliasing/Nyquist frequency) |

Example generator JSON:

```json
{
  "asset_id": 17202,
  "attribute": "power",
  "subtype": "input",
  "function_type": "sin_wave",
  "min_value": 10.5,
  "max_value": 75.2,
  "integer": false,
  "interval_seconds": 1,
  "frequency": 0.05
}
```