Skip to content
  • There are no suggestions because the search field is empty.

Understanding the CATCH.AI data model

What are properties and devices and how are they configured in the CATCH.AI data model?

CATCH.AI uses a normalized data model where devices and properties are decoupled from each other to have only one representation of the same property across different devices.


This means that once a property has been created, any device can report values for the given property to CATCH.AI. When a value for a property is reported, CATCH.AI will store the value in the database together with the Device ID of the device that reported the value.

 

The data model is a representation of the data that is used in a system. It is used to define the data structure, the relationships between different data elements, and the rules that govern the data.

 

What is a device?

A device refers to any unit providing data to CATCH.AI. A device can have multiple sub-devices. This allows you to structure the system better if you have a device that consists of multiple devices.

For example, if you have a device with two temperature sensors, instead of creating one device and two properties, "Temperature 1" and "Temperature 2", you create a single "Temperature" property and one device for each sensor.

 

What is a property?

A property describes a data point that devices can report to the system.

This could be measurement values like temperature, pressure, or humidity, as well as device-specific information like device type, firmware version, or similar.

All continual measurements should be reported as property values.

 

Example: Properties and devices

In the example below there are two devices containing different sensors that can report the following values:

Devices and properties

Device A

  • Temperature
  • Humidity
  • Frequency

Device B

  • Temperature
  • Fuel level 

 

Even though both devices report a temperature measurement, only one temperature property needs to be created in CATCH.AI. So, to make CATCH.AI store measurement values from these devices the following must be configured:

 

A property for each measurement type:

  • Temperature
  • Humidity
  • Frequency
  • Fuel level

Two devices with, as minimum, the following information:

  • Unique device ID
  • Device name

 

Once that is done, CATCH.AI is ready to receive measurements from the devices and will store them in the database together with the device ID that reported a measurement value related to the given property.