# IoT

:white\_check\_mark:Professional :white\_check\_mark:Premium :white\_check\_mark:Enterprise

The Ultimo IoT connector enables third parties to provide measurements (i.e. based on sensor data) to Ultimo. There are three different ways to connect to Ultimo:

1. [REST](https://developer.ultimo.net/api-key-templates/iot/rest)
2. [HTTP POST](https://developer.ultimo.net/api-key-templates/iot/http-post-xml) \*
3. [SOAP](https://developer.ultimo.net/api-key-templates/iot/soap-xml) \*

*\* Not available in Professional*

After importing a measurement, various validations and business rules will be executed in Ultimo.

Ultimo is not suitable for *raw sensor data*, so it is not allowed to directly connect sensors to Ultimo or send unfiltered sensor data to Ultimo. The Ultimo IoT connector is intended to connect with a server or platform that collects and filters / aggregates data from sensors.

![](https://4033746893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MZmRVbbu75Ds8MiWx_F%2F-MZmVU2bTM66TBOVmmoR%2F-MZmWkeM3bKhAvZX1PPv%2Fiot.png?alt=media\&token=d259c8b8-4f72-4ce6-9423-4d35328501e5)

To avoid an overload of sensor data, there is a maximum limit of measurements. When processing measured values, Ultimo will check if there are no more than 3 days with more than 25 measured values in the past 10 days.

It is also possible to create new measurement points with the REST interface.

## Functional details

Objects or meters can have measurement points. These can be stored on an equipment or a process function. Each measurement should refer to an existing measurement point (for an equipment or process function).

![](https://4033746893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MZmRVbbu75Ds8MiWx_F%2F-MZmVU2bTM66TBOVmmoR%2F-MZmWqwAjhlCWcigEM_U%2Fiot-flow.png?alt=media\&token=a5537a0e-0ec7-4601-b014-7781983d776d)

A measurement contains:

| Parameter                        | Description                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EquipmentId or ProcessFunctionId | <p>Use an <em>EquipmentId</em> or <em>ProcessFunctionId</em> depending on where the object is stored (internal Ultimo ID).</p><p>It is recommended to use a Meter, which is an Equipment. This property is required.</p>                                                                                                                                                                                               |
| MeasurementPointId               | The code of the measurement point (int. Ultimo ID).                                                                                                                                                                                                                                                                                                                                                                    |
| Date                             | <p>The date and time of the measurement. This property is required. Allowed formats:</p><ul><li>yyyy-MM-dd hh:mm:ss (i.e. 2018-08-21 15:21:59)</li><li>UTC: yyyy-MM-ddThh:mm:ssZ (i.e. 2018-08-20T15:17:59Z)</li></ul>                                                                                                                                                                                                 |
| Value or Delta                   | <p>Use <em>Value</em> when the measured value should be interpreted as an absolute value. Examples: a temperature or the total running hours of a machine.</p><p>Use <em>Delta</em> when the measured value is a difference relative to the previous measurement and it is desired to be cumulated in Ultimo. Example: the running hours since the last measurement.<br>Note: Delta is only available in REST-API.</p> |
| Text                             | Additional information or remarks for the measurement.                                                                                                                                                                                                                                                                                                                                                                 |

With the REST interface it is possible to create a new measurement point. When the new measurement point is the first measurement point for an equipment or process function, this will be the default measurement point.

A measurement point contains:

| Parameter                        | Description                                                                                                                                                                                   |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EquipmentId or ProcessFunctionId | Use an *EquipmentId* or *ProcessFunctionId* depending on where the object is stored (internal Ultimo ID). It is recommended to use a Meter, which is an Equipment. This property is required. |
| MeasurementPointId               | The new code of the measurement point (internal Ultimo ID). This property is required.                                                                                                        |
| Description                      | Additional description for the measurement point. This property is required.                                                                                                                  |