Widgets for controlling the functions of IoT devices in the 2Smart Cloud mobile app

Platform vendors have access to an extensive library of widgets that can be utilized to customize the mobile app’s interface. In many cases, you can manage the same device function with several widgets. We recommend that you compare similar-functioning options and select the most suitable one for your product.

Timepicker

Allows setting up event time.

Sensors: compatible with any sensor transmitting string values.

Sensor Attributes:

• Data Types: string.
• Settable: true.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: selecting the time of day to automatically start updating the device firmware, turn on/off watering, lighting, etc.

Widgets with similar functionality: none.

Video stream

Watch streaming video.

Sensors: compatible with any sensor transmitting string values, designed for use with RTSP video protocol.

Sensor Attributes:

• Data Types: string
• Settable: true, false
• Retained: true, false

Advanced settings: entering an RTSP link to the video stream source.

Usage scenarios: viewing video from surveillance cameras in security systems, viewing video from the camera of a mobile robot.

Widgets with similar functionality: none.

Number

Displays the sensor’s numeric values. Prevents the user from changing values. Allows viewing historical data graphs.

Sensors: compatible with any sensor transmitting numerical values.

Sensor Attributes:

• Data Types: integer, float.
• Settable: true, false.
• Retained: true, false.

Advanced settings: the option to choose the unit of measure. When selecting the “Graph” checkbox in the mobile app, historical data graphs will be available and the vendor will be able to define the Y scale’s minimum and maximum values.

Usage scenarios: users can track historical data in cases when it’s available. For example, when monitoring the temperature and humidity of the air in a greenhouse.

Widgets with similar functionality: none.

Gauge

Displays numerical values using a semicircular scale with an arrow.

Sensors: compatible with any sensor transmitting numerical values.

Sensor Attributes:

• Data Types: integer, float.
• Settable: true, false.
• Retained: true, false.

Advanced settings: the option to set the minimum and maximum value on the scale, as well as the unit of measure.

Usage scenarios: checking any numerical data (Wi-Fi signal strength, temperature, humidity, etc.)

Widgets with similar functionality: Signal lvl, Battery, Progress bar.

Signal lvl

Displays the sensor signal’s level in percentage terms and in a scale.

Sensors: compatible with any sensor transmitting numerical values.

Sensor Attributes:

• Data Types: integer, float, string.
• Settable: true, false.
• Retained: true, false.

Advanced settings: the option to choose the minimum and maximum values used to calculate the signal level as a percentage.

Usage scenarios: checking Wi-Fi signal strength.

Widgets with similar functionality: Gauge, Battery, Progress bar.

Battery

Displays the sensor signal’s level in percentage terms and visually as a battery.

Sensors: compatible with any sensor transmitting numerical values.

Sensor Attributes:

• Data Types: integer, float, string.
• Settable: true, false.
• Retained: true, false.

Advanced settings: the option to set the minimum and maximum values used to calculate the percentage value.

Usage scenarios: monitoring the device’s battery charge level.

Widgets with similar functionality: Signal lvl, Gauge, Progress bar.

Progress bar

Displays the level of the sensor signal in the specified units and visually as a progress bar.

Sensors: compatible with any sensor transmitting numerical values.

Sensor Attributes:

• Data Types: integer, float, string.
• Settable: true, false.
• Retained: true, false.

Advanced settings: the option to set the minimum and maximum value on the scale, as well as the unit of measure.

Usage scenarios: checking any numerical data (Wi-Fi signal strength, temperature, humidity, etc.)

Widgets with similar functionality: Signal lvl, Gauge, Battery.

Thermostat

Displays the sensor’s numeric values. Allows changing numeric values using the “+” and “-” buttons within the configured range.

Sensors: compatible with any sensor transmitting numerical values that can be changed manually.

Sensor Attributes:

• Data Types: integer, float.
• Settable: true.
• Retained: true, false.

Advanced settings: the option to set up the unit of measure and to set the range of sensor values that the user will be able to adjust, as well as the step in which changes will be made.

Usage scenarios: controlling the heating system, underfloor heating, and other systems for which a limited range of sensor values is appropriate.

Widgets with similar functionality: Slider.

Slider

The slider for changing the numerical value of the sensor.

Sensors: compatible with any sensor transmitting numerical values that can be changed manually.

Sensor Attributes:

• Data Types: integer, float.
• Settable: true.
• Retained: true, false.

Advanced settings: the option to set up the unit of measure and to set the range of sensor values that the user will be able to adjust, as well as the step in which changes will be made.

Usage scenarios: adjusting the brightness of a lamp or LED strip.

Widgets with similar functionality: Thermostat.

Dimmer control

Displays the sensor’s numeric values. Allows changing numeric values within the configured range using the slider-light regulator, which opens in the form of a modal window.

Sensors: compatible with any sensor transmitting numerical values that can be changed manually.

Sensor Attributes:

• Data Types: integer, float.
• Settable: true.
• Retained: true, false.

Advanced settings: the option to set up the unit of measure and to set the range of sensor values that the user will be able to adjust, as well as the step in which changes will be made.

Usage scenarios: adjusting the brightness of a lamp or LED strip.

Widgets with similar functionality: Thermostat, Slider.

Input

Displays the sensor’s numeric or text values. If the transmitted data is changeable, the user of the mobile application can utilize the sensor to set an arbitrary value.

Sensors: compatible with any sensor transmitting numeric or text values.

Sensor Attributes:

• Data Types: integer, float, string.
• Settable: true, false.
• Retained: true, false.

Advanced settings: the option to set up the unit of measure.

Usage scenarios: checking any numerical or textual data: battery level, Wi-Fi signal, temperature, etc., adjusting the sensor value, such as the brightness of the LED.

Widgets with similar functionality: none.

Range

Setting a range of sensor values instead of a specific value. For the widget to work correctly, specify two sensors of the same physical sensor in the firmware – to control the minimum and maximum values.

Sensors: compatible with any sensor transmitting numeric values.

Sensor Attributes:

• Data Types: integer, float
• Settable: true
• Retained: true, false

Advanced settings:  the option to set up the unit of measure and to set the range of sensor values that the user will be able to adjust, as well as the step in which changes will be made.

Usage scenarios: monitoring the air temperature in the greenhouse and sending a notification to the user if the value has gone beyond the specified range.

Widgets with similar functionality: none.

Text

Displays sensor’s text and numeric values. Allows quickly copying the value by clicking on the widget.

Sensors: compatible with any sensor transmitting text or numeric values that cannot be changed manually.

Sensor Attributes:

• Data Types: integer, float, string, boolean, enum.
• Settable: false.
• Retained: true.

Advanced settings: the option to set up the unit of measure.

Usage scenarios: In-app display of data that can need to be copied quickly, such as the device’s serial number.

Widgets with similar functionality: none.

List

Drop-down list with values to choose from.

Sensors: compatible with any sensor transmitting numeric, text, or logical (on/off) values.

Sensor Attributes:

• Data Types: enum.
• Settable: true, false.
• Retained: true, false.

Advanced settings: setting the unit of measure.

Usage scenarios: selecting one of the configured modes of operation of the device.

Widgets with similar functionality: Switcher.

Switcher

The switch with the ability to quickly select one of the values.

Sensors: compatible with any sensor transmitting numeric, text, or logical (on/off) values.

Sensor Attributes:

• Data Types: enum.
• Settable: true, false.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: selecting one of the device operating modes.

Widgets with similar functionality: List.

Bulb

Allows turning the lamp on and off, as well as adjusting its brightness (if there is a brightness sensor).

Sensors: compatible with any lamps and LEDs.

Sensor Attributes:

• Data Types: integer, float, boolean.
• Settable: true, false.
• Retained: true, false.

Advanced settings:  the option to set up the unit of measure and specify the range within which the user can adjust the brightness, as well as the increment by which adjustments are made (relevant only if there is a brightness sensor).

Usage scenarios: сontrolling main functions of the LED lamp.

Widgets with similar functionality: none

Toggle

The switcher for activating/deactivating the sensor.

Sensors: compatible with any sensor having two logical values — on and off.

Sensor Attributes:

• Data Types: boolean.
• Settable: true, false.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: turning on/off the device or its specific function.

Widgets with similar functionality: Door, Tumbler, Two-way button.

Two-way button

Standard-looking button for turning the sensor on and off: green (ON) and orange (OFF).

Sensors: compatible with any sensor having two logical values — on and off.

Sensor Attributes:

• Data Types: boolean.
• Settable: true, false.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: turning on/off the device or its specific function.

Widgets with similar functionality: Door, Toggle, Tumbler.

Tumbler

Standard tumbler for turning the sensor on and off: I-O.

Sensors: compatible with any sensor having two logical values — on and off.

Sensor Attributes:

• Data Types: boolean.
• Settable: true, false.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: turning on/ off the device or its specific function.

Widgets with similar functionality: Door, Toggle, Two-way button.

Door

Standard-looking button for turning the sensor on and off: the green one with the word “Open” and image of a closed padlock, and red with the word “Close” and an image of an open padlock.

Sensors: compatible with any sensor having two logical values — on and off.

Sensor Attributes:

• Data Types: boolean.
• Settable: true.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: controlling electric locks, barriers, electric smart curtains.

Widgets with similar functionality: Toggle, Tumbler, Two-way button.

LED

Indicates whether the sensor is on or off. Does not allow to toggle the value.

Sensors: compatible with any sensor having two logical values — on and off.

Sensor Attributes:

• Data Types: boolean.
• Settable: true, false.
• Retained: true, false.

Advanced settings: selecting a widget design from one of five available colors.

Usage scenarios: controlling the status of any device — whether it’s on or off.

Widgets with similar functionality: Motion sensor.

Motion sensor

Displays the sensor’s state — whether it’s on or off — as a moving or standing man. Does not allow to toggle the value.

Sensors: compatible with any sensor having two logical values — on and off.

Sensor Attributes:

• Data Types: boolean.
• Settable: true, false.
• Retained: true, false.

Advanced settings: none.

Usage scenarios: monitoring the state of a moving device (for example, a robot) — whether it’s active or not.

Widgets with similar functionality: LED.

Push button

Sensor activation button.

Sensors: compatible with any sensor that runs once and doesn’t require shutdown.

Sensor Attributes:

• Data Types: boolean.
• Settable: true.
• Retained: false.

Advanced settings: none.

Usage scenarios: starting the device firmware update manually.

Widgets with similar functionality: Firmware update.

Firmware update

The widget for the manual firmware update. It has a modern interface that accompanies the update delivery process.

Sensors: compatible with the following types of sensors responsible for updating the device firmware:

• boolean – to update the firmware,
• string – to send a message about the current update status

Sensor Attributes:

• Data Types: boolean, string.
• Settable: true.
• Retained: false.

Advanced settings: setting up custom notifications that accompany the firmware update process:

• failed to check message;
• updates available message;
• up-to-date message;
• update failed message;
• successfully updated message.

Usage scenarios: manual updating of the device firmware by the end-user.

Widgets with similar functionality: Push button.

Color

Palette to set the desired color.

Sensors: compatible with any sensor accepting a color value in RGB or HSV format (for example, LED lamps or garlands).

Sensor Attributes:

• Data Types: color
• Settable true
• Retained: true

Advanced settings: the option to set up the unit of measure.

Usage scenarios: setting the glow color of the LED lamp.

Widgets with similar functionality: none.