Wisely configuration

Click on the desired Wisely in the device list to go to its configuration page. All relevant information about the device is displayed there.

../../_images/wisely-configuration.png

Detailed view of a Wisely

General

Device EUI

The device EUI is used to uniquely identify the device. You can also find the device EUI on the label on the back of the device.

Activation Date

The date the device was registered on the system.

Lot number

The batch number of the device.

Software Version

The current version number of the device firmware.

Last Connection

Indicates when the device last connected to the Avelon server.

Battery

Indicates the remaining battery capacity of the device.

Altitude

The altitude of the device above sea level. The system attempts to determine this information based on the gateway positions with which the sensor is in contact. If the calculated value is not correct, you can set it manually.

LoRaWAN
LoRaWAN Network Provider

Indicates which LoRaWAN network provider the device is currently registered with. To learn how to change your network provider, see LoRaWAN network provider.

Application EUI

The EUI of the application on the LoRaWAN server to which this device is assigned. Only available if the device is self-managed.

Application Key

The key of the application on the LoRaWAN server to which this device is assigned. Only available if the device is self-managed.

Application ID

The ID of the application on the LoRaWAN server to which this device is assigned.

Allow access to this device in the public web app without login

If you want to use the QR code on the device to quickly access its measurements, keep this option enabled. However, this will make the device accessible on iot.avelon.cloud to anyone who has access to the QR code. If you deactivate the option, the device and its measurements can only be accessed when you’re logged in. You can change this setting at any time.

Location

Address

The location address of the device. If you fill in this field, the device will be displayed on the map widget and in the map navigation.

GPS

If the address input above is insufficient, you can also specify the location of the device using GPS coordinates.

Configuration

Require the gateway to confirm the reception of alarms

If this option is activated, the device waits for confirmation from the LoRaWAN gateway as soon as it sends an alarm. If this confirmation is not received, the device will repeat the transmission of the alarm after a short time. This ensures that alarms are transmitted reliably, but under certain circumstances reduces the battery life of the device.

Warning

This option is only available if the Building Automation license is purchased for this device.

Note

To purchase additional licenses for the device, please click Shop, available on the Licenses card. You will then be redirected to the Avelon Shop. This function is only available on Avelon Cloud.

Measurement Interval

Only available for Wisely version 2. The time interval at which the sensor performs a measurement.

Transmission Interval

Only available for Wisely version 2. The time interval at which the sensor transmits the measurement values.

Sampling Period

Only available for Wisely version 3. The time interval in minutes at which the sensor queries the current value and decides whether to record a measurement, to trigger an alarm or to send a notification of a change of value. The actual measuring period can be a multiple of the sampling interval and is configured directly on the corresponding data point.

Cyclic Transmission

Only available for Wisely version 3. The time interval at which the sensor transmits the recorded measurement values. Must be a multiple of the sampling period. The more measurements that can be combined in a single data transmission, the less the sensor’s battery is drained, but the longer it takes for the measurement values to be displayed in the system. To avoid overburdening the battery of the device, the smallest permissible time interval is 10 minutes.

Reliability

The calculated ratio between the number of received measurements and the number of expected measurements. Low reliability means that not all measurements are being transmitted successfully. The value can only be influenced indirectly by checking the location and the battery of the sensor.

LED configuration

Warning

This configuration is only available for Wisely CarbonSense and Wisely AllSense.

For these two devices, you can set up the LED to display in different colors by assigning conditions to them. There are 7 colors that can be configured, each having a priority assigned to it, ranking from 1 to 7, 1 being the highest and 7 being the lowest. Each color can have only one condition.

To assign a condition a color, select the color that you want to be displayed, select one data point and one condition from the drop down menu and also adding the condition value. When this condition is met, the LED will be displayed in the assigned color.

You can do the same for as many colors as you wish. However, only one condition can be assigned to each color. If the same data point with the same condition value is assigned to more than one color, the color with the highest priority will be displayed. You can still assign different condition values to the same data point.

../../_images/led-configuration.webp

LED configuration on Wisely AllSense

Device access

Here you configure which user groups are allowed to access the device and its data points. If users should see data points or their recordings or live values, they need to have access to the respective device on which these data points are located.

To add a user group, click on Add User Group* and select a user group from the list. All users in that user group will get access to the device. To remove a user group, click on Remove next to the corresponding user group.

Alerting

Enable Watchdog

Activate the watchdog to be notified if the device does not report in for a longer period of time. This allows you to react in time in the event of a device defect or insufficient transmission power. Select the desired alarm chain from the dropdown.

Warning

Watchdog alarm tickets cannot be closed until the device sends an acknowledgment that the alarm is gone and that the connection with the server is reestablished. As a result, when trying to close a ticket prior to device acknowledgment, the following error message is displayed: “This ticket cannot be closed. The alarm must be acknowledged by the device first”.

Enable Battery Alarm

Activate the battery alarm to be notified if the battery falls below a certain threshold. Select the desired alarm chain from the dropdown.

Setting an alarm

You can add an alarm for any of the data points assigned to Wisely. The available data points are displayed on the Data Points card. To add an alarm for one of the data points, proceed as follows:

  1. Select the data point by clicking on Go to Data Point on the right hand side.

  2. Under Alerting, define an upper and/or lower alarm limit value.

  3. Select the alarm chain to be invoked in the event of the alarm. For information on how to set up alarm chains, see Manage alarm chains.

  4. With the value Deadband for gone alarms relative to the limits you can also set the difference relative to the alarm limit value as of which any alarm that occurs should automatically be marked as “gone” by the system. For more information on how to edit data points, see Edit data points.

  5. Save your changes by clicking on Save at the top right in the toolbar.

Warning

If you only have a free Heads-up! license on your device, only alarm chains with one user and email notification can be selected. In order to add more users to the alarm chain and to receive alarm notifications via SMS also, a paid Heads-up! license needs to be purchased.

Note

To purchase additional licenses for the device, please click Shop, available on the Licenses card. You will then be redirected to the Avelon Shop. This function is only available on Avelon Cloud.

Gateways

The LoRaWAN gateways with which the sensor was recently in contact are displayed on the map. For a gateway to be displayed correctly, the operator of the gateway must have stored the correct GPS coordinates on the device.

Download labels

You can download or print the labels, which are factory affixed to the outside of the case, at any time. Different labels are available depending on the device type. The front label contains the QR code needed to use the device in our IoT app as well as a marker used in connection with its augmented reality function. The back label contains technical information about the sensor, such as the serial number or device EUI.

You can download or print the two labels by clicking on More at the top right, then on Front Label or Back Label respectively, and then on either Download or Print.

Licenses

All licenses that are activated for the current device are displayed here. These are either enabled functions or data point packages that can be used in conjunction with this device. You can also see how many units of the respective license have already been used.

Energy Management

The number of data points that can be used for energy management, i.e. mainly in chart widgets.

Energy Reporting

The number of data points that can be used for energy reporting, i.e. as part of automatically generated PDF reports.

Heads-up!

The number of data points that can be used in the context of an alarm.

Operate

The number of data points that can be used in a control system on schematics.

SMS (this month)

The monthly quota of SMS messages that can be sent to users in the context of alarms. If this quota is exhausted, all further SMS messages will be charged additionally.

Weather Forecast

The number of forecast data points of the Avelon weather service that can be used.

Weather Readings

The number of weather readings from the Avelon weather service that can be used.

Warning

If the suffix “Free” is added to one of the data point packets, this means that this data point packet was not purchased. In this case, Avelon provides a free entry-level license so that basic functions can still be used. However, the functionality of the free licenses is limited. For example, measurement data are only stored for a few days, and the configuration options for alarms are limited.

Note

To purchase additional licenses for the device, please click Shop. You will then be redirected to the Avelon Shop. This function is only available on Avelon Cloud.

Manage LoRaWAN provider yourself

Wisely can be used outside of the Avelon ecosystem and integrated into a proprietary LoRaWAN solution. However, this requires a Wisely that comes with the “Self-managed” license.

To configure the device accordingly, click on More at the top right and then on Configure LoRaWAN Network Provider. In the following dialog, select Self-managed from the drop-down LoRaWAN Network Provider and click OK.

This will give you access to data needed to integrate the Wisely in the new system, such as Device EUI, Application EUI and Application Key. Documentation explaining how to interpret Wisely payload will also be available for download or in the main Avelon user documentation: Wisely Payload.

Once the device is successfully transferred to another network, it will be removed from the pre-configured network provider.

Warning

This process is not possible if there is still a Building Automation license assigned to the device. The process is reversible and the device can always be transferred back to Avelon Cloud afterward.

Volatile organic compounds (VOC)

Wisely AllSense has a sensor for measuring volatile organic compounds (VOC). The values are measured according to the classification of indoor air quality on the right and made available via the data point “Volatile organic compounds”.

Air Quality Index

Index

Air quality

0 - 50

excellent

51 - 100

good

101 - 150

lightly polluted

151 - 200

moderately polluted

201 - 250

heavily polluted

251 - 350

severely polluted

> 350

extremely polluted

Warning

This data point is only available on Wisely AllSense.