Skip to main content

Alarm Translators

Yggio offers a variety of different alarm translators that can be used to set up alarms to the user's liking. Through the use of alarm translators Yggio offers a number of specific pre-defined alarm functions (temperature, humidity, etc), as well as one generic alarm that is configurable for any parameter number. The alarm thresholds are set in the context map parameters that will be created by the selected alarm translator

The way they work is simple and clean; the user chooses the measurement/value for the alarm and sets the alarm's threshold. If the value of the selected field goes above the upper or below the lower alarm threshold, the alarm will show either true or false.

The built in alarms we currently offer:

  • set-alarm-battery-from-battery-level-or-voltage
  • set-alarm-custom-from-custom-field
  • set-alarm-from-custom-field-within-time-interval
  • set-alarm-mould-risk-from-temperature-and-humidity-and-time
  • set-alarm-relative-humidity-from-relative-humidity
  • set-alarm-temperature-from-average-temperature
  • set-alarm-temperature2-from-temperature

The alarm limit names are fixed and depend on which alarm translator you are using. Examples below show names for temperature and custom alarm translators.

Custom alarm translator:

  • customLowAlarm: 333
  • customHighAlarm1: 400
  • customHighAlarm2: 550
  • customSourceAlarmField: co2
  • customAlarmHysteresis: 1

Temperature alarm translator:

  • temperatureHighAlarmLevel: 25
  • temperatureLowAlarmLevel: 17
  • temperatureAlarmHysteresis: 1

Adding an alarm translator

In this section, we will demonstrate how to add an alarm translator. In this example we will use a custom alarm translator.

  1. Go to the "Translator" section of your device and add the desired alarm translator.

Translator

  1. Go to the "Contextual Parameters" section of your device and add the alarm limits, alarm field, and hysteresis. This is how they look:

ContextMap

  1. After the set-up is completed, go to the "Data" section of your device. There should be three new fields that appeared and look like this:

Do note that before the parameters can be seen in the "Data" section, the device needs to send a report first.

Result

There is also an error that will appear when the user makes a mistake during the set-up. The error will provide the user with the infrormation about what is incorrect and will be located under the "Data" section and "All" filter.

Error

Adding the alarm translators with select many

In Yggio the user can also set up the alarm translators or update existing ones for multiple devices in one go. This can be done with the select many feature. In order to smoothly do this, we prepared a simple step-by-step guide.

  1. Click on the "Select many" button in the device list and select what devices you want to add the alarm translators to.
  2. In the "Select action" drop-down menu, select "Edit translators."
  3. In the translator editor, add the desired alarm translator by clicking on the "+ Add translator."
  4. Now repeat the first step, and then in the "Select Action" drop down-menu, select "Edit."
  5. In device editor, click on the "+Add" and add contextual parameters depending on the alarm translator added.
  6. Save the changes by clicking "Save" and then "Finish."