Web Interface manual

1.1. About this document

This instruction manual explains in details all functions of WE151, from the basic to the most advanced features and operations.

This manual refers to the Software version 4.0.1 released in July 2022. Please check that the software version of WE151 has been upgraded to the version mentioned in this manual, since some functions may differ. The Software version of the device is shown on page System → Info. It’s also displayed on the web interface of WE151, on the status-panel available on the right.

For questions or issues not covered by present document, don’t hesitate to contact Nethix Support:

Email: support@nethix.com

Phone: +39 0423 770750

Web site: nethix.com

1.2. Overview

WE151 is a programmable and expandable IIoT module. It’s user-friendly and can manage every single function of the system through its integrated Web Interface. It allows to read, monitor and control the signals coming from the connected machinessensors using the IO available on board (2 configurable analog inputs, 4 digital inputs and two digital output relays) and standard compatible communication protocols (Modbus RTU and MQTTS), that allow to communicate with several devices, even outside the Nethix range.

The device can manage the acquired signals as variables, that represent one of the most core elements of the entire system. Once defined the variable, it’s possible to configure alarm conditions (events/actions) on threshold crossing, send variables values to one or more external platforms and access directly to their status/value in different ways.

The configuration of the devices and of the operating logics is made through the integrated Web Interface, that can be reached locally or remotely. No additional Softwares/Drivers are required.

1.3. Access to the Web interface

Before start using the device, it’s necessary to access the integrated Web Interface (through any browser), and read the quick start guide for further information.

After the log-in, the following interface will be available:

Here are the main elements of the Interface:

• 1: The device name. This can be changed on page Configuration → General setup → System.
• 2: The name of the user, that has made the log in.
• 3: System icons. From the lft to the right: access to the online documentation, logout from Web Interface, reboot/power off of the device.
• 4: Nethix Logo. This can be changed with any corporate logo (from Configuration → General setup → Web Interface).
• 5: Menu of the available sections to be entered.
• 6: Main body of the page. Here are displayed the relevant information according to the selected page.
• 7: Connectivity status panel. It shows the status of all services, that allow the device to connect and communicate.
• 8: System status panel. It shows the currently available Software version of the device, the total operating time of the device from the last reboot/start-up and the current date and time.
• 9: Page Footer. This can be modified from the page Configuration → General setup → Web Interface.

2.1. Generic Settings

Several variable types are available, having different parameters. Only the section Generic Settings is valid for any type of variable. This section is composed of the following fields:

• Name: it’s the name to be assigned to the variable. All alphanumeric characters and the character ”_” are supported.
• Type: it allows to select the variable type. For each type of variable the parameters to be set are different: to this regard see chapter 2.2. Type.
• Variable status: enable/disable the variable.
• Cloud sending: it allows to enable/disable the sending of the variable value to a portal or external server. For further information regarding the datadelivery, see the dedicated section 7. Data delivery.
• Non-volatile value: it allows to save the value of the variable every X minutes and every time the device is rebooted or switched off via software. Setting the value at 0, the status of the variable won’t be restored after a reboot/poweroff.
• MQTT mode: it allows to select the way of interfacing to a broker MQTT (see section 7.4. MQTT/S for further specifications about this function).

2.2. Type

The available types of variables to be defined are the following:

• Analog input: variables associated to the analogue inputs available on the WE151. AI1 has to be selected to associate the variable with the analogue input 1 (connectors AI1 and GND) while AI2 has to be selected to associate the variable with the analogue input 2 (connectors AI2 and GND). Further information on paragraph 2.3. Variables Analog Input (AI).
• Digital input: variables associated to the digital inputs available on the device. It’s possible to choose among DI1, DI2, DI3, DI4. Further information on paragraph 2.4. Variables Digital Input (DI).
• Digital output: variables associated to the digital (relay) outputs available on the WE151. Select DOUT1 for the digital output 1 (connectors RL1A and RL1B) or DOUT2 for the digital output 2 (connectors RL2A and RL2B). Further information on paragraph 2.5. Variables Digital Output (DO).
• Modbus: variables associated to Modbus registers. Further information on paragraph 3.2. Creation of Modbus variables.
• Virtual: these are virtual variables, that can be created to manage alarms, formulas, to report the status of the system variables or other. Further information available on paragraph 2.6. Virtual Variables.

2.3. Variables Analog Input (AI)

In order to create a variable type AI, enter the page Configuration → Variables. Then click on the tab New.

Select Analog input under the position Type. Inside the section Generic Settings you can find the general settings suitable for all variable-types. The description of all the fields of this section are available at 2.1. Generic Settings.

We proceed then to the section called Analog Input: Specific Settings.

EXAMPLE: if we have a temperature probe in tension, having minimum value -20°C and maximum value 30°C, respectively at 0V and 5V, it’s possible to configure the minimum of the variable at -20, the maximum at 30 and visualize the temperature in degrees. On the field Decimals is possible to define the number of decimals to be displayed.

The input value is constantly monitored by WE151, keeping any possible configured threshold under control.

2.4. Variables Digital Input (DI)

In order to create a varible type DI, enter the page Configuration → Variables. Click then on the tab New.

Select Digital Input under the position Type. Inside the section Generic Settings you can find the general settings suitable for all variable-types. The description of all the fields of this section are available at 2.1. Generic Settings.

We proceed then to the section called Digital Input: Specific Settings.

First of all is requested to confirm the digital input to be associated to the variable. It’s possible to choose among DI1, DI2, DI3 and DI4.

From the field Input mode, select the desired modality among the following options:

• Normal
• Counter
• Flow measurement
• Time counter

According to the selection made, the following fields will have different meaning.

2.4.1. Normal

A variable type DI → Normal is a variable that allows to display the status of the digital contact. It’s therefore possible to define events/actions according to the contact changing (open>closed and viceversa)

A so called Normal digital input can be open or closed. Thanks to the fields Open label e Close label it’s possible to associate a string, that will be displayed on the page Status → Variables, in order to intuitively show to the user the current status of the input. For WE151, the input has to be considered closed when it’s bridged to GND; it’s open when there’s no connection between the input and GND. The only further field to be configured is Inverted led. This setting influences the visualization of the variable on the page Status → Variables. If the option is disabled, the input status Open shows a gray icon, while the status closed shows a green icon. If the option is enabled, the visualization will be the opposite. For further details see relevant section 6.1. Variables status.

Note

During the configuration of events/alarms, the input status Closed corresponds to value 1, while the status Open corresponds to 0.

2.4.2. Counter

A variable type DI → Counter is a variable that allows to count the pulses on a digital input.

The first field to be filled is Count start i.e. the starting point of the counter. This value will be considered only the first time. If the counter is reset, this will restart from 0.

• Counter end it’s the maximum limit to be reached to reset the counter. If this field is at 0, the counter will continuously increment and never reset.
• Count increment it’s the increment unit of the counter at every impulse. The quantity entered in this field will be added to the current value at every impulse.
• Measurement unit it’s the measurement unit assigned to the counter. It will be displayed on graphs and on the page Status → Variables.

The last setting is the Edge trigger, the edge to be considered as an impulse:

• Falling edge: the counter increments when the input gets from closed to open.
• Rising edge: the counter increments when the input gets from open to closed.
• Rising and falling edge: the counter increments at every status changing of the input.

2.4.3. Flow measurement

A variable type DI → Flow measurement is a variable that allows, for instance, to calculate the flow rate.

On the field Timeout is edited the maximum time interval (in seconds) between two pulses. After the set time has expired, the variable will be reset. It’s useful to set the timeout, in case the flow should stop. In this case, if the timeout is not set, the value of the variable would remain the one of the last received pulse, thus giving a wrong information and creating potentially contradictory logs.

Inside the field Volume is set the sample unit to be associated to a pulse.

Measurement unit allows to set a measurement unit for this variable, on the other hand on Edge trigger is possible to select the edge to be considered as a pulse:

• Falling edge if it has to be considered the switch from closed to open.
• Rising edge if it has to be considered the switch from open to closed.
• Rising and falling edge edge if both edges have to be considered.

EXAMPLE:

If we set the timeout at “600” (seconds), the Edge trigger as Rising edge, the measurement unit as L/s (i.e. liter per second) and the volume at 100, we will have the following:

• The input changes from open to closed, WE151 starts counts the time
• The input changes from closed to open
• The input changes from open to closed after 20 seconds
• WE151 divides the sample volume (100) for the time passed (20 seconds) and will display 5L/s
• The input doesn’t change its status for at least 600 seconds.
• WE151 resets the variable and waits for new pulses before starting counting again.

2.4.4. Time counter

A variable type DI → Time counter è una variabile che permette di contare il tempo (in secondi) is a variable that allows to count the time ( in seconds) of opening/closing of a contact; this application is interesting for example to get the total operating time of a machinery.

After the selection of the Edge trigger o be considered (please remind that Falling edge is the changing from closed to open, Rising edge is the contrary and Rising and falling edge both of them), it’s necessary to select the type of counter. These are the options:

• Permanent: after starting the counting, WE151 will increment the value at every second, until the user will reset it.
• Stop on opposite edge: the counting starts at the edge changing, compatible with the selection made on Edge trigger, it stops when the opposite edge is reached and will start again when the selected edge is reached.
• Reset on opposite edge: the counting is reset when it reaches the opposite edge, and will start again from 0 when the edge defined on Edge trigger is reached again.

2.5. Variables Digital Output (DO)

To create a DO variable, associated to a digital output available on board of the device, it’s first of all necessary to enter the page Configuration → Variables. Clicking on the tab New, we get to the page , where it’s possible to configure the variable.

Under the position Digital Output select Type.

Inside the section Generic Settings you can find the general settings suitable for all variable-types. The description of all the fields of this section are available at 2.1. Generic Settings.

On the section called Digital Output: Specific Settings, after the selection of the Output (between DOUT1 and DOUT2), it’s required to configure the operating modality on the field Output mode. Le opzioni disponibili sono:

• Normally open: normally open operating. Open label corresponds to the open status of the contact. Close label closes the contact.
• Normally close: normally closed operating. Open label corresponds to the open status of the contact. Close label closes the contact.
• Pulse open: pulse mode operating. Open label corresponds to the open status of the contact. Close label closes the contact. If the output is closed, it remains in this status for the time set on the field Pulse Duration and then get back to the previous open status.
• Pulse closed: pulse mode operating. Open label corresponds to the open status of the contact. Close label**closes the contact. If the output is closed, it remains in this status for the time set on the field **Pulse Duration and then get back to the previous open status.

Independently from the selected option, on the field Status change delay (s) must be entered the number of delay seconds, before the output is activated or deactivated at any impulse coming.

Please note that the option Non-volatile value can be combined with the Output mode. If the option is disabled, the status of the output at the start (after a shut down or reboot) will depend directly on the Output mode, in case the output is Normally open/Pulse open, the contact will start in open status; if the output is Normally closed/Pulse closed, the contact will start in closed status.

If, on the other hand, the Non-volatile value option is enabled, at the start up of the system it will be restored the previous output status.

The status of the digital outputs can be modified by associating them to an event, through a dedicated command via SMS, Chat, Email or directly from Status → Variables.

2.6. Virtual Variables

Virtual variables are not connected to the I/O of the device and can be of different types. The status of a virtual variable can be modified/read via SMS, Chat, Email from the page Status -> Variables or at the occurrence of an event, and its value can be given also by a mathematical formula. Some virtual variables allow to monitor the system parameters or to change remotly the threshold of an alarm/event (for example a setpoint). Others can be used to let WE151 manage the status or the value coming from a measurement, made by a different device (Nethix or not, through MQTT and Modbus protocol).

To create a variable type Virtual, it’s first of all necessary to enter the page Configuration → Variables. Clicking on the tab New, we enter the page, where it’s possible to configure the variable.

Select Virtual under the position Type.

Inside the section Generic Settings you can find the general settings suitable for all variable-types. The description of all the fields of this section are available at 2.1. Generic Settings.

On the section called Virtual variable: Specific Settings, is given the possibility to choose among the following options:

• Normal
• Math expression
• Date/time
• System variables

2.6.1. Normal

Selecting the type Normal, the Measurement unit and the Decimals numbers have to be entered on the relevant fields. The value of this type of variable can be changed manually (SMS, Email, Chat or from Status → Variables) and/or automatically (through the action execute command configurable on the page for the events creation 4.2.4. Action Execute a Command).

2.6.2. Math expression

Selecting the type Math expression , beside the Measurement unit and the Decimals numbers, it’s possible to specify also the math expression to be applied to the variable.

A Virtual variable → Math expression allows to make calculations using constants or variables as elements, and gives the possibility to use some of the most common mathematical operations such as:

• Addition (+)
• Subtraction (-)
• Multiplication (*)
• Division (/)
• Exponentiation (^)
• Square Root (sqrt)
• Logarithm (log)
• Sine (sin)
• Cosine (cos)

beside other constants as:

• e (e)
• base 2 logarithm of e (log2e)
• base 10 logarithm of e (log10e)
• square root of PI (2_sqrtpi)
• square root of 2 (sqrt)
• square root of 1/2 (sqrt1_2)

The use of round brackets is supported.

EXAMPLE 1:

“Var1” is the name of a variable of any type (not necessarily Virtual) and its value is 10. On the field Math expression we could write:

Var1^2

In this case the Virtual variable would assume value “100”.

EXAMPLE 2:

Var1 is as for previous example, Var2 is another variable of any type having value 15.

On the field Math expression we could write:

( Var1 * ( Var2 – 10 ) ) / 2

From which we get: (10 * (15-10)) / 2 → (10*5)/2 → 50 / 2 → 25

The value displayed by WE151 would then be “25”.

At every changing of one of the expression’s factors, the result is immediately recalculated by WE151.

A Virtual variable type Math expression can be used as an element inside another expression.

2.6.3. Date/time

Selecting Date/Time the variable will show the value in seconds, minutes, hours, day of the month, month, year, day of the week o day of the year.

For example, selecting Minutes [0-59] on the field Date/time mode at 12:35 the variable will show the value 35.

2.6.4. System variables

Selecting System variables it’s possible to specify the Measurement unit and the Decimals numbers, this type of variables can represent:

• GSM CSQ (signal strength of the Provider)
• CPU Load (load of the CPU)
• CPU Speed (speed of the CPU)
• CPU Temperature (temperature of the CPU)
• Free Memory (available memory)
• PCB Temperature (temperature of the PCB)
• Modem Temperature (temperature of the Modem)
• V Supply (supply tension)
• Button (status of the button: it’s possible to define an event when it’s pressed)

As for all other variables, also for the system variables it’s possible to associate one or more alarm conditions.

2.7. Bridge between variables

WE151 allows to create a bridge between variables, in order to transfer the value or the status from a variable to another. If, for example, we want to read the value of the analog input and transfer it to a virtual variable, this is the procedure:

• Create a variable Analog Input (2.3. Variables Analog Input (AI)).
• Create a variable type Virtual (2.6. Virtual Variables).
• On the creation page of the variable Analog Input, click on the link Advanced.

• Select from the Available variables menu the virtual variable previously created.

Through this procedure we will get 2 variables having the same value. At every changing of the status/value of the variable type Analog Input will correspond the changing of the value of the variable virtual.

3.1. Modbus Client

WE151 allows to create a Modbus Network on each available serial port (232 and 485).

3.2. Creation of Modbus variables

To create a variable (of any type) enter Configuration → Variables → Variables.

If some variables are already available, they will be displayed in the table with some of their main features.

To edit an existing variable click on its name, to create a new one click on New.

The name of the new variable is entered in the page for creating variables: the field Name accepts alpha-numeric characters and “_”. The space is not allowed.

Then select Modbus in the Type field.

Under the section Generic Variables all standard settings for any type of variables are available. For the description of all the fields of this section, see 2.1. Generic Settings.

According to the type of variable selected, the following section will have a specific structure:

• Modbus net: It allows to select a Modbus network to be associated with the new variable to be created. If no Modbus network is available, this field must be left blank.
• Modbus address: This field must be completed with the Server address of the device to be interrogated by the WE151.
• Memory address: This field must be completed with the memory register, to be associated with the variable.

It’s now necessary to select the Access mode, i.e. the type of Modbus variable, among the following options:

• Read only: It’s possible to read the variable value but not to change it.
• Write only: It’s possible to edit the variable value but not to read it.
• Read and write: The variable value can be read and edited.

In the field Data type is possible to select the variable number of bit.

3.2.1. Data type 1 bit

In this field is requested to specify the position of the bit inside the word (1 word = 16 bit). Inside one single word there can be up to 16 variables of 1 bit each. If the variable that we want to create, is on the first position of the word, the value “0” must be selected in the field Bit position. Alternatively if the variable, that we want to create, is on the last position of the word, the value “15” in the field Bit position must be entered.

In order to complete the creation of the variable, just set up a string for the open status (corresponding to value 0) and a string for the closed status (corresponding to value 1).

These strings will allow to display the variable status (for example Open/closed, on/off, and so on..)

3.2.2. Data type 8 bit

For the 8 bit variables is requested to specify the Bit position (it’s possible to choose only between 0 and 7, since 8 bit corresponds to half a word) and some other information available also for 16-32-32inv variables. If the variable, that we want to create, is in the first word position, the value “0” must be entered in the field Bit position. Alternatively if the variable that we want to create, is in the middle of the word, the value “7” must be entered in field Bit position.

3.2.3. Data type 16-32 bit

Selecting 16, 32 or 32inv on the field Data type, the following fields must be completed and specified:

• Measurement unit: Measurement unit selected to be assigned to the variable.
• Decimals: Quantity of decimal numbers to be displayed.
• Minimum value: Set the minimum (normally “0”) according to the type of variable.
• Maximum value: Set the maximum (for example 65535 for 16 bit variables) according to the type of variable.
• Scaled Minimum value/Scaled Maximum value: The two above mentioned fields are necessary for a correct interpretation of the read/written data by the WE151, even though they might not be relevant for the end-user. Assuming for example a 16 bit variable with min./max. values of respectively 0/65535: a user should need to measure a level from 0 to 10 meters. To this purpose it’s enough to set “0” as Scaled Minimum value and “10” as Scaled Maximum value.

3.2.4. Data type 32 bit Float

For the 32 Float/32 Float inverted variables it’s necessary to set the measurement unit and the number of decimals.

This type of variable doesn’t require any scaling.

By clicking Save the variable will be created.

Note

Information as Modbus address, Memory address, Access mode, Data type, Bit position are normally described in the data sheets of the modbus devices.

It’s important to make sure that all parameters are correct, in case of doubts contact the server device’s manufacturer or the Support at Nethix.

For further information about the use of the Modbus Protocol, visit the official site modbus.org.

The following step is to create a modbus command, suitable to interact by reading or writing with the new created variable.

In order to enter the section dedicated to the modbus commands, select Configuration → Modbus → Commands on the menu.

3.3. Creation of Modbus commands

All modbus variables need to be associated to a read and/or write command.

Under the section Configuration → Modbus → Commands all available commands (if previously created) will be displayed. In order to create a new command click on Add new command.

According to the type of created variable it’s possible to define a read/write command using one of the following functions:

• Read coils - 0x01
• Read input status - 0x02
• Read holding registers - 0x03
• Read input registers - 0x04
• Write single coil - 0x05
• Write single register - 0x06
• Write multiple registers -0x10

All functions available in WE151 respect the Modbus standard.

Once made the selection of the function to be used, the following parameters need to be set:

• Server ID (address): It’s the address of the server device, where to send all requests/writings. This address must be the same as the one entered in the field Modbus address, previously set in the variable configuration.
• Memory address: It’s the memory address associated to the command. This must be the same as the one previously entered in the field Memory address of the variable.
• Words number: It’s the number of word where to use the command. Some functions allow to enter more than one word (to be checked on server device’s documentation). Setting for example “1” as Memory address and “10” as Words number, it should be possible to use one single command to enter 10 consecutive registers.
• Interval: Interval of time for the reading function. For the write function this option is not available (the writing of a register is enabled at request). Setting for example “5”, the reading of one or more registers/words is executed every five seconds.
• Modbus Networks: If one or more Modbus networks have already been created, it’s possible to select the one to be associated with the created command.

Clicking on Save the command will be saved.

It’s important to make sure that all parameters are correct, in case of doubts contact the server device’s manufacturer or the Support at Nethix.

For further information about the use of the Modbus Protocol, visit the official site modbus.org.

Once created the command, it’s possible to proceed with the definition of the Modbus network. To enter this section, select Configuration → Modbus → Networks from the menu, click the tab Networks on the top left side or click the link Create new network on the right side of the Save button.

In this last case, when the page for the creation of Modbus networks opens, the new created command is already associated with the network.

3.4. Modbus network creation

All modbus variables and commands need to belong to a Modbus network to grant a correct functioning.

Selecting Configuration → Modbus → Networks from the menu, an overview of all available networks will be displayed.

It’s possible to create a new network clicking on Add new network.

3.5. Instant reading/writing

It’s possible to read or write one or more Modbus registers without creating a variable or a command.

Entering the page Configuration → Modbus → Raw, it’s possible to start an instant reading/writing of a given register, just by properly completing the following fields:

• Networks: Select a network among the available ones. This function is possible only if at least one network is already available.
• Function: Select the Modbus function to be used in order to read or write the register/s.
• Words number: Indicate the word number. “1” in case of 1-8-16 bit variables, and the “2” in case of 32 bit or float variables.
• Server address: Indicate the server address to be entered.
• Memory address: Indicate the memory address to be entered.

In the field Value it will be displayed the value read (in case of reading functions) and a notification message of successfully executed reading/writing will be sent by the WE151.

3.6. Modbus expansions

WE151 includes 4 digital inputs, 2 analogue inputs and 2 digital outputs. The I/O module of WE151 can nevertheless be expanded with one or more additional expansion units of the range XP500.

In order to add or edit an expansion unit is necessary to enter the page Configuration → Modbus → Expansions and click on New or select one of the previously added expansions.

Click on New to enter the wizard, that allows to install any of the available expansion modules of the range XP500.

The available models are:

• 4DI-4DO
• 8DI-8DO
• 12DI
• 4AI-I
• 4AI-V
• 8AI-I
• 8AI-V
• 4T
• Combo

For further details on the available models, refer to the specific manual XP500.

Once made the selection of the required expansion type, clicking on Next, the guided installation procedure will start.

For each single model of XP500 the wizard will explain how to enter the Init Mode, which is necessary to let the WE151 connect to the expansion, when to turn on the device and how to connect it to the WE151.

At the end of the procedure it’s required to confirm the name and the server address:

• Name: It’s the name to be assigned to the expansion. This name will be used to create a variables group, where the variables of the inputs/outputs of the expanders will be included.
• Type: It will display the selected expansion model.
• Server address: It refers to the server address to be assigned to the expander. The server address allows the expander to have a unique ID inside its Modbus network. This is a precondition, in order to let the WE151 identify the correct module, when more than one XP500 are available. It’s recommended never to set the number “1” as server address.

Once clicked on Save, WE151 will try to set the client address entered by the user inside the connected expander. Then WE151 will create automatically all variables and Modbus commands (and the network, if not already available) to communicate with the XP500.

3.7 Manage Modbus errors

• Network: The Modbus network to be monitored.
• Server ID (address): The server address to be monitored.
• Timeout (seconds): Delay in seconds. The error condition will be triggered only if it persist for longer than the time entered in this field.
• Variable: The variable to be set. Selecting None, it’s possible to avoid the setting of any variable.
• Value: The value that the variable should assume at the occurrence of the error.
• Value at recovery: The value that the variable should assume once the communication error is gone.

4.1. Events

The events allow the WE151 to get aware, when a monitored parameter has crossed a certain threshold, set by the user.

There are different types of events, and for every type there are several parameters, that allow to have high flexibility in the monitoring and control of a system.

To create an event, it’s necessary to get to the page Configuration → Events/Actions → Events/Actions and then click on the tab New.

The tab Delete allows to delete one or more selected events, while with the tab Update it’s possible to make some modifications as for instance to able/disable one or more events, or to notify them as alarms and send them to a web portal. In order to recall one or more events, it’s possible to use the field Find that allows to make a query based on name.

When an event is created, after assigning a name, it’s necessary to confirm the type of event among Variable, Incoming data or Scheduler (see 5. Scheduler).

There are a few generic options that can be enabled according to the selected event’s type: it’s possible to decide wether to enable the event from Status or not, wether to display it or not as an alarm from the field Set as alarm and wether to send it or not to a web portal from the field Send to portal.

In case the option Set as alarm is enabled, at the occurrence of the event a red “X” will appear on the page Status → Variables, near the name of the variable (on the column Alarm); this allows to see at a glanace the presence of a critical condition.

The option Send to portal allows on the other hand to send an event to a web portal. At the occurrence of the event, the WE151 will execute the associated actions and send to portal a string, containing the name of the event and further relevant information.

4.1.1. Events on variables

It’s an event that occurs when a variable reaches a certain value or a certain status.

The behaviour of this type of event is determined by the behaviour of the variables, that will be associated to it.

First of all it’s necessary to choose a variable from the field Variable.

From the drop down menu, it’s possible see all variables previously created and select the one, on which an event has to be configured.

The second parameter to be selected is the one connected to the Condition. The possible options are EQUAL, NOT EQUAL, GREATER THAN, GREATER OR EQUAL THAN, LESS THAN and LESS OR EQUAL THAN.

It’s necessary to set the value to be considered as threshold for triggering the event, on the selected variable, entering a numerical value on the field Value.

It’s possible to set a delay on the field Delay. The value is expressed in seconds and it avoids that the event is triggered immediately.

The variable Value must remain under the defined condition (Condition) for a time not shorter than the one configured in Delay, before the defined event is finally considered activated and the associated actions are executed.

It’s also possible to set that an event (and its associated actions) are ignored, if it’s found activated after a shut down/reboot of the system. This is possible enabling the option Skip action at startup.

4.1.2. Incoming data

The incoming events are those triggered by inputs coming from external sources:

• SMS
• Email
• Chat

This function gives the possibility to create customized commands to be sent to the device. The commands could be sent by users or other devices.

After the selection of the desired option from the field Data source, it has to be entered the text of the command (to be entered on the field Message).

On the field Users can be eventually selected the users or the groups of users enabled to send the command.

The actions associated to such an event will be then executed at the receipt of the text, as entered on the field Message, on condition that it’s sent by one of the selected users.

Note

The commands must be written case sensitive, as originally entered in the configuration.

Note

In order to allow a user to send commands to the device, the relevant option on the page modify/create user must be enabled (see 8. Users).

Note

In case of Emails, the command to be sent to the device must be included on the subject of the email and not in the body.

4.2. Actions

Once created an event and clicked on Save, a new section called Actions with relevant link Add action.

Clicking on the link, we enter a new page

From this page it’s possible to create an action for the just defined event. The available actions are:

• Send Email
• Send Chat
• Send SMS
• Execute a Command
• Send data to cloud
• Reboot
• Poweroff

Through the fields Execute action each and Minutes/Hours it’s also possible to configure that the action is repeated at regular time intervals untill the event remains active.

Once created an action, it’s possible to find it on the list available under the event. It’s possible to create up to 5 actions for each single alarm.

4.2.1. Action Send Email

Selecting the option Send Email, it’s possible to write the text to be sent in case the event should occur.

If previously used messages are available, it’s possible to choose among them on the field Message through the drop down menu.

On the other hand, if a new text has to be created, it’s possible to select Create new message.

To modify an existing message, enter the page Configuration → Events/Actions → Messages and select the message to be modified.

Once defined the message, it’s possible to select the receivers among the list of registered users and groups.

Beside the definition of the event and the action, that should trigger the email to a certain user, it’s necessary to consider also the following:

• The internet connection must be active (see 9. Connectivity and 11.3. Ping).
• The selected user/s must be enabled to receive notification emails and shall have confirmed a valid email address (see section 8. Users).
• The mail service shall be properly configured (see section 9.3. Email).

All the texts used for the different actions can be found on the page Configuration → Events/Actions → Messages.

From this page it’s possible to delete the messages, using the relevant tab and clicking on Delete, or edit one or more messages by clicking on them.

On the messages to be sent at the occurrence of a certain event, it’s possible to recall the value of one or more variables. For this option is necessary to write on the message the symbol $ followed by the name of the variable (respecting upper and lower case):

EXAMPLE:

If we have a variable called Var1 and we want to recall the value within the message for threshold crossing:

Text to be configured:

Alarm for high level. The level is $Var1 meters

if at the moment of the message sending the variable has a value of 5.7:

The message will be:

Alarm for high level. The level is of 5.7 meters.

Within one message is possible to recall more than one variable’s value.

4.2.2. Action Send SMS

Selecting Send SMS, it’s possible to write the text to be sent in case the event should occur.

If previously used messages are available, it’s possible to choose among them on the field Message through the drop down menu.

On the other hand, if a new text has to be created, it’s possible to select Create new message.

To modify an existing message, enter the page Configuration → Events/Actions → Messages and select the message to be modified.

Once defined the message, it’s possible to select the receivers among the list of registered users and groups.

Beside the definition of the event and the action, that should trigger the SMS to a certain user, it’s necessary to consider also the following :

• The signal coverage should be enough (displayed on the status panel on the right side of the interface).
• The user/s must be enabled to receive SMS notifications and shall be associated to a valid telephone number (see section 8.1. Create a new user).
• The SMS service must be properly configured (see section 9.1.1. Data connection and SMS).

All the texts used for the different actions can be found on the page Configuration → Events/Actions → Messages.

From this page it’s possible to delete the messages, using the relevant tab and clicking on Delete, or edit one or more messages by clicking on them.

On the messages to be sent at the occurrence of a certain event, it’s possible to recall the value of one or more variables. For this option is necessary to write on the message the symbol $ followed by the name of the variable (respecting upper and lower case)

EXAMPLE:

If we have a variable called Var1 and we want to recall the value within the message for threshold crossing:

Text to be configured:

Alarm for high level. The level is $Var1 meters

If at the moment of the message sending the variable has a value of 5.7

The message will be:

Alarm for high level. The level is of 5.7 meters

Within one message is possible to recall more than one variable’s value.

4.2.3. Action Send Chat

Selecting Send Chat, it’s possible to write the text to be sent in case the event should occur.

If previously used messages are available, it’s possible to choose among them on the field Message through the drop down menu.

On the other hand, if a new text has to be created, it’s possible to select Create new message.

To modify an existing message, enter the page Configuration → Events/Actions → Messages and select the message to be modified.

Once defined the message, it’s possible to select the receivers among the list of registered users and groups.

Beside the definition of the event and the action, that should trigger the message via Chat to a certain user, it’s necessary to consider also the following :

• The selected user/s shall be enabled to receive chat messages and shall have associated a valid chat name (see section 8.1. Create a new user).
• The Chat service must be properly configured (see section 9.4. Chat).
• The device must be connected to the internet (see sections 9. Connectivity and 11.3. Ping).

All the texts used for the different actions can be found on the page Configuration → Events/Actions → Messages.

From this page it’s possible to delete the messages, using the relevant tab and clicking on Delete, or edit one or more messages by clicking on them.

On the messages to be sent at the occurrence of a certain event, it’s possible to recall the value of one or more variables. For this option is necessary to write on the message the symbol $ followed by the name of the variable (respecting upper and lower case).

EXAMPLE:

If we have a variable called Var1 and we want to recall the value within the message for threshold crossing:

Text to be configured:

Alarm for high level. The level is $Var1 meters

If at the moment of the message sending the variable has a value of 5.7

The message will be:

Alarm for high level. The level is of 5.7 meters

Within one message is possible to recall more than one variable’s value.

4.2.4. Action Execute a Command

Selecting Execute a Command from the field Type, it’s possible to select a variable among those available in the list and define then a value on the field To.

Thus at the occurrence of the defined event, the selected variable will be set at the value entered in the field To.

Inside the drop down menu Set may not be available all the created variables, because the system automatically select the variables that may have the value changed:

• Variable type DO
• Variable type Virtual
• Variable type Modbus write
• Variable type Modbus read/write

For obvious reasons the following variables won’t appear in this list:

• Variables type DI
• Variables type AI
• Variables type Modbus read

Through an action type Execute a Command, it’s possible to create automated operations connected to the occurrence of a certain event, as for instance the closing of an output if an analog input should reach a certain threshold.

4.2.5. Action Send data to cloud

Selecting Send data to cloud on the field Type, at the occurrence of a certain event, it will be sent to the cloud the status of those variables, where the option Cloud sending is enabled (see section 2.1. Generic Settings).

The variable value will be immediately sent to the cloud, as selected on the page Configuration → Cloud → General (see section 7.3. HTTP/S).

If the data delivery by email report is enabled (see section 7.6. Email report), a new line will be generated, containing the status of the variables at the time.

In this case (and FTP too, see 7.7. FTP/S) the delivery won’t be immediate, but according to the timing set by the user.

4.2.6. Action Reboot

Selecting Reboot on the field Type, it’s possible to let the WE151 reboot at the occurrence of the associated event.

4.2.7. Action Poweroff

Selecting Poweroff on the field Type, it’s possible to let the WE151 power off at the occurrence of the associated event.

---

5.1. Execute recurrently

This option allows to enter the scheduler and configure when the action has to be executed.

• Minute: On this field is possible to set the minute in the hour (between 00 and 59), when the action has to be executed. It’s also possible to set several minutes (even all minutes).
• Hour: On this field it’s possible to set the hour of the day, when the action has to be executed (between 0 and 23). Even in this case it’s possible to configure more options (even all hours).
• Day of month: On this field it’s possible to select the day of the month, when the action has to be executed (from 1 to 31). It’s possible to select more days even all.
• Day of week: Da questo campo sarà possibile programmare l’esecuzione dell’azione selezionando il giorno della settimana in cui deve essere eseguita. Anche in questo caso sarà possibile selezionare uno o più giorni (anche tutti).
• Month: The field Month allows to define in which month the action has to be executed; it allows to choose one or more months (even all).

For instance if we want an action to be executed every 15 minutes:

On the field Minute the numbers 00, 15, 30 e 45 must be selected.

If we want this action to be executed only between the 10:00 and the 11:00:

On the field Hour it must be set the number 10.

If the action must be executed only on Monday and the last day of the month (independently from the fact that it’s Monday or not):

On the field Day of month select the number 31, while on the field Day of week it must be selected the option Mon (Monday).

Eventually if the action has to be executed only on the first and the last month of the year:

On the field Month it has to be selected the option Jan (January) and Dec (December).

The field Preview offers the possibility to check when the WE151 will execute the action. According to our example the Preview will show the following:

Execute at 10:00, 10:15, 10:30, 10:45 if the day is 10 or is Monday of January and December

The action will then be executed every Monday and every end of Month of January and February at 10:00, 10:15, 10:30 and 10:45.

5.2. Execute every

The option Execute every allows to execute an action at regular interval of time. On the field Unit is possible to select the measurement unit among Seconds, Minutes, Hours and Days.

• Seconds Entering value “N” on the field Value, the action will be executed every “N” seconds.
• Minutes entering a value “N” on the field Value, the action will be executed every “N” minutes.
• Hours Entering a value “N” on the field Value, the action will be executed every “N” hours.
• Days Entering a value “N” on the field Value, the action will be executed every “N” days.

For instance, if a certain action has to be executed every hour:

On the field Unit select Hours.

On the field Value enter 1.

Also in this case the field Preview gives the possibility to check when the action will be executed. According to the above example, the Preview will show:

Execute every hour

The action will be then executed at the beginning of every hour.

5.3. Execute only once

The option Execute only once allows to enter the Scheduler in order to define when the action has to be executed.

Clicking on the icon available at the right of the field Date, the scheduler is opened and it allows to define the hour, the day, the month and the year, when the action has to be executed. Once executed the action, the event can be deleted, since it has to be executed only once.

If, for example, it’s set to execute a certain action on the 31st of January 2023 at 12:30:00:

It’s required to scroll until the desired data, to select the day, complete the time fields and then click OK.

6.1. Variables status

The page Status → Variables collects and displays all created variables. The variables are visualized in alphabetical order and can be grouped at own discretion.

In order to create one or more groups of variables it’s required to go to page Configuration → Variables → Variables Groups:

Clicking on the tab New, a new page opens, where all created variables are available.

Flagging the field Hidden, it’s possible to decide if the group and the variables will be shown on the page Status→Variables. Eventually it’s possible to choose the variables to be included in the group, selecting them from the list Available variables.

Once confirmed, clicking on Save, we will find the new created group on the page Status → Variables.

After the creation of the first group, all the variables not included in any group, will be automatically be included in the group Others.

Back to the page Status → Variables he situation will be as follows:

As you can see, on the right of the group name are two icons

1. Cancel group: clicking on this icon, the group is deleted from the page. Nevertheless the group remains saved, and all associated variables will keep on working.
2. Hide group: clicking on this icon, the group is reduced to the name, hiding all variables. Even in this case the functioning of the variables is not affected.

It’s possible to recall again the hidden groups and restore the reduced ones by clicking

Located on the bottom right of the page.

The variables chart is divided into 7 columns:

• Name: Variable’s name
• Value: Numerical or mnemonical value of the variable
• Unit: It shows the measurement unit assigned to the variable. For the variables with no measurement unit, this field remains void
• Set: It allows to set a value (or a status) on editable variables (DO, Modbus write, Modbus read write and virtual). In case of DO and 1 bit Modbus variables, will be entered the defined status (for example “open” “closed”), that can be clicked to change the status of the variable. For the all the other types of Modbus write, Modbus read/write variables and virtual variables it’s instead possible to enter a numeric value and confirm the setting by clicking set.
• Status: In case of DI, DO and 1 bit Modbus variables, a self explanatory icon will be shown: green or gray , according to the status and the configuration of the variable.
• Alarm: There’s a column, that reports the alarm status of a variable. The icon shows that no alarms are activated. The icon shows instead the presence of an event, configured as an alarm.
• Monitor: For al the variables that have a readable status, it’s possible to click on the icon available on the column Monitor, in order to visualize a realtime-graph on a new window of the browser:

• 1: Name of the selected variable.
• 2: Icon for changing the colour of the graph area.
• 3: Icon for selecting the quantity of data to be displayed among: One minute (data referred to the last minute), One hour (last hour), One day (last 24 hours) and Full scale (by default, it shows all data available since the window has been opened).
• 4: Icon for choosing whether to apply any filter on data, to interpolate different points of the area.
• 5: Icon for restarting the data acquisition, but deleting the data previously collected.

6.2. Set/Get commands via SMS/Email/Chat

It’s possible to query or modify the status of variables by using a specific syntax via SMS, Chat or Email.

The fact that it’s possible to read or write a value, depends on the type of variable you’re interacting with.

Set VarName=Value

Set Var1=5

Set Var1=5 Var2=10 Var3=15

Get VarName

Get Var1

Get Var1 Var2 Var3

6.3. Customized commands

Using the function Incoming data t’s possible to create customized commands, both for setting the value of one or more variables and for create status messages.

In order to create a customized message to be sent as a text via SMS, Chat or Email, it’s necessary to define an event Incoming data (for further details see 4.1.2. Incoming data) and create some actions type Execute a command (see 4.2.4. Action Execute a Command).

Thus it’s possible to set the status of more variables.

On the other hand, in order to create a customized command suitable to report the value of one or more variables, it’s possible to use the character $:

Having created an event type Incoming data, and having then defined an action type Send Email, Send Chat, or Send SMS (see 4.2.2. Action Send SMS, 4.2.3. Action Send Chat and 4.2.1. Action Send Email), it’s possible to define the message, that WE151 will have to send to the configured users.

7.1. Enabling variables to data delivery

In order to send data to a portal, it’s first of all necessary to enable the variable/s to this purpose, by activating the option Cloud sending, from the page creation of a variable.

It’s possible to activate/deactivate the option of sending data to portal also from the page Configuration → Variables, by adding or deleting the flag on the column Cloud and clicking then Update.

7.2. Configuration of data delivery

After the selection of the variables to be enabled to data delivery, it’s necessary to configure all parameters, that allow the proper functioning of the system, at the page Configuration → Cloud

Some of the requested information on this page require a minimal know-how about data delivery technologies, or the support of the cloud provider.

On the first section General, some of the main settings have to be defined as for instance the service activation and the delivery frequency.

If the parameters required in this page are not defined, it’s not possible to proceed with the configuration.

• Variables sampling It enables/disables the delivery of variables value
• Sampling frequency It allows to set the time interval of the data sending
• Events sampling It allows to enable the sending of the events to a portal

Once enabled the service and set the interval of time, it’s possible to decide to enable one or more modalities and destinations among: HTTP, FTP, MQTT and Email report.

At any time it’s possible to click on Refresh in order to update the information, or Empty box in order to delete all messages available in Outbox.

Clicking on the drop down menu on top of the tab, it’s possible to pass from Outbox to Sent. In this last section are displayed some information about the already executed deliveries of the WE151:

At any time it’s possible to click on the tab Refresh in order to recall the information or Empty box in order to delete all messages available in Sent.

7.3. HTTP/S

From the tab HTTP it’s possible to enable the delivery to the Cloud offered by Nethix, or to any third party server.

Selecting Nethix API on the field Protocol, and enabling the delivery by flagging Enable, the delivery to the Portal nethix.co will be activated.

The Portal is a service offered by Nethix and grants the following options:

• To send data and get a summary of all plants.
• To visualize the detail of every single device and the logged data on a chart or tab.
• To create a synoptic, that allows to show the device’s status ina simplier and more intuitive way.
• To establish a remote access from the device to the portal, in order to be able to read and write the value of the variables, even in absence of a public IP address.
• To establish a VPN connection between a PC and a Portal. In this case, enabling the remote access, it’s possible to create a VPN network including all owned devices, avoiding any problems regarding non reachable IP addresses.

For further information, please refer to the documentation: Portal.

The default settings are:

• Server address: https://nethix.co
• Server port: 443

The correct parameters are in any case indicated by Nethix at the activation of the service.

In alternative it’s possible to enable the data delivery to an external server. In this case it has to be selected the option HTTP on the field Protocol.

On General setup the following parameters have to be defined:

• Enable: Activate/deactivate the sending.
• User agent: The user agent that WE151 will use to authenticate at the server.
• Device ID: ID of the device (useful for managing more than one WE151 in the same server).
• Server Address: Address of the server for sending the data.
• Server address: Indirizzo del server a cui mandare i dati (completo di http://).
• Server port: Port of the server.
• Send mode: Modality of data sending. It’s possible to choose between POST and GET. Before activating the option, please refer to Nethix, for getting a sample string sent by WE151.

On Data delivery it’s possible to define the path inside the server, where the script for the received data processing is available:

• Script address: Name and complete path of the script inside the remote server.
• Manage portal response: WE151 waits for commands coming from the server, every time it has to execute a data delivery.

Note: In case of data delivery type Server, WE151 will use the same frequency as set for the sampling (Configuration → Cloud → General).

7.4. MQTT/S

• Enable: Activate/deactivate the sending.
• Broker hostname: Server address where to send data.
• Broker port: Server port (default 1883).
• Username: Name of the user for authenticating at the server (if necessary).
• Password: Authentication password on server side (if necessary).
• Client ID: Reference ID for the Broker for identifying the WE151.
• Topics root: Main reference address, where the data will be saved.
• QOS (pub): Quality of Service in case the variable is with MQTT mode = Publish (default 0)
• QOS (sub): Quality of Service in case the variable is with MQTT mode = Subscribe (default 0). The QOS has range from 0 to 2, 0 the service grants the data delivery max. once (it’s not always sent), 1 the service grants the delivery of the data at least once (can be sent more than once), 2 the service grants that the data is entered correctly once.
• MQTTS: Enable/disable the use of TLS according to the server specifications.

• Publish
• Subscribe

During the creation of a variable (see 2.1. Generic Settings) it’s possible to specify which one of the two modalities has to be used.

PUBLISH

SUBSCRIBE

7.5. MQTT/S Report

MQTT report example:

{
   "Timestamp":"1650421200",
   "Temperature":"27.1",
   "Pressure":"1050",
   "Tank":"13.6",
   "Signal":"85",
}

7.6. Email report

From the tab Email report it’s possible to configure the delivery of the data collected by WE151 to one or more email addresses.

• Enable: Enable/disable the sending.
• Delivery time: Defines the time interval for sending the data to the enabled users. Please note, that the time of sampling (field Sampling frequency on tab General) and the time of sending may be different. It’s for example possible to sample a variable every minute and send the data only once a day.

To let the report be properly sent, it’s necessary to have correctly configured the email account associated to the WE151 (9.3. Email) and have enabled the option Receive report by email on the configuration of the users who are supposed to receive the email (8. Users).

7.7. FTP/S

From the tab FTP it’s possible to configure the sending of the logged data to any FTP server:

• Enable: Enable/disable the sending.
• Server hostname: Server address where to send the data.
• Server port: Server Port (default 21).
• Username: Name of the user for authenticating on the server (if necessary)
• Password: Password for authenticating on the server (if necessary)
• Destination folder: Server folder where to send the data (complete path).
• Delivery time: Define the interval of time for sending the data to server. Delivery and sampling time (field Sampling frequency on tab General) an be different. For example it will be possible to sample a variable every minute and to send data once in a day.

8.1. Create a new user

To create a new user it’s necessary to go to the page Configuration → Users → Users.

In this page are displayed some information referred to the previously created users:

• Username It’s the username for the log-in.
• Full name The complete name assigned to the user.
• Privileges It’s the level assigned to the user (SYSTEM, ADMIN or USER).
• Expire date It’s the expiry date for the user, after that date the user will be disabled (but not deleted).

From the column Delete it’s possible to select one or more users to be deleted by clicking on the tab Delete selected users.

To edit a previously created user just click on his username, in order to create a new one, just click on the tab Add new user.

The following are the parameters to be set, in order to create a user:

• Username The username used for the log- in. No empty spaces nor special characters are allowed (apart from “_”). It’s case sensitive: it’s recommended to pay attention to the use of lower and upper case.
• Password The password to be used for the log-in (to be entered twice). The password can be composed of alphanumeric and special characters. It’s also case sensitive: it’s therefore recommended to pay attention to the use of the lower and upper case.
• Full name The complete name assigned to the user. Once executed the log-in, the Full name will be reported on the top left corner, near the name assigned to the WE151. Clicking on it, the page for the user configuration will be entered.
• Privileges The level to be assigned to the client, among SYSTEM, ADMIN and USER (see 8. Users).
• Expire date It allows to define a date, after which the user won’t be able to enter the interface nor send/receive any command and notification from and to the WE151. If it’s not intended to set an expiry date for the user, the field remains void.
• Phone number The telephone number associated to the user. It’s necessary if the user wants to send/get SMS to/from the device, on the contrary it’s allowed to leave the field void. Remind that the telephone number must be entered complete with country code, in the format +nn (+39 for example for Italian numbers).
• Email address The email address associated to the user. It’s necessary if the user wants to send/get Emails to/from the device, on the contrary it’s allowed to leave the field void.
• Chat name The name used in the chat and the name of the chat server associated to the user (e.g. @john:server.chat). It’s necessary if the user wants to send/get chat messages to/from the device, on the contrary it’s allowed to leave the field void.
• Actions In this section it’s possible to enable/disable several options connected to the user:
  • Receive alarms by SMS If enabled, it allows the user to receive alarms via SMS from the WE151, if previously configured.
  • Receive alarms by email If enabled, it allows the user to receive alarms via email from the WE151, if previously configured.
  • Receive report by email If enabled, it allows the user to receive email reports from the device, according to the preconfigured settings. (7.6. Email report).
  • Send commands by SMS If enabled, it allows the user to send commands to WE151 via SMS.
  • Send commands by email If enabled, it allows the user to send commands to WE151 via email.
  • Send commands by chat If enabled, it allows the user to send commands to WE151 via chat.
  • Receive remote command If enabled in case of emails sent by WE151 to the user won’t show on the subject the name assigned to the device. This allows to send Set/Get commands between devices (6.2. Set/Get commands via SMS/Email/Chat).

8.2. Groups of users

If several users are available in the system, the management of events and actions may be complicated. In order to simplify the situation, it’s possible to define and create groups of users.

In order to create, delete and edit the groups of users, it’s necessary to go to page Configuration → Users → Groups.

On this page are available some information about the previously created groups, as:

• Group name The name assigned to the group.
• Description The description of the group.
• Users The number of users available in the group.

From the column Delete it’s instead possible to select one or more groups to be deleted by clicking Delete selected groups.

To edit an existing group, click on the name of the desired group. On the other hand, to create a new group, click on Add new group.

In order to correctly create a new group only few information are necessary:

• Group name The name to be assigned to the group.
• Description The description of the group.
• Users This field allows to select the users, that take part to this group. After selecting them with the mouse from the box Available Users, it’s enough to click > to send them inside the box Selected users or < to delete them from the group.

Clicking on Save the group will be created. Here are some comments regarding the groups of users:

• A user may not belong to any group.
• A user may belong to more than one group (even to all groups)
• WE151 can identify repeated numbers, email addresses or chat names. If a user is available in several groups, in case of alarms he will receive the alarm just once.
• If a group is deleted, the users inside that groups won’t be deleted.

9.1. Network interfaces

Clicking on Networking → Interfaces we enter the section, where it’s possible to define the modality for WE151 to enter into the internet network.

In case of WE151 the only option is Modem.

9.1.1. Data connection and SMS

WE151 allows to establish a GPRS/LTE connection in order to remotely access the Web interface of the device and send data, chat messages or email.

Selecting the option Networking → Interfaces → Modem it’s possible to set some important parameters for the correct functioning of the data connection, given by the SIM card, available on the device.

DATA CONNECTION

On the section Connection mode it’s possible to enable the service and specify, if the connection has to be on demand or always on:

• Always On WE151 will keep the connection always active. If it should fail (insufficient credit, low signal etc..), it will be restored as soon as possible.
• On demand the connection will be activated only on request of a registered user, through the sending of a Wakeup (10. System commands) message and will have a duration of 15 minutes, before the connection fails again. If services that require a connection (data delivery, email delivery, chat and so on..) will be active, WE151 will establish a temporary connection, that will automatically terminate after the operations have been executed.

If everything has been properly configured, after few minutes the connection GPRS/LTE will be activated. On the status panel, positioned on the right side of the web interface, the GPRS/LTE indicator will become green, below the connection uptime and the relevant IP address will be shown.

It’s possible to enter some advanced parameters clicking on Advanced:

• Ping enable If enabled, it allows the device to execute some pings at regular interval of time to the addresses, specified on the fields Keepalive server. This allows the system to identify possible critical issues and to restore as soon as possible the connection. The activation of this option increases the control over the connection status, but increases also the use of SIM data.
• Keepalive server 1 In this field it’s possible to specify the primary address where the device will try to send the ping to, in case the Ping enable option is active.
• Keepalive server 2 In this field it’s possible to specify a second address, in case that the primary shouldn’t be available.
• Address/Control compression It enables/disables the compression of the fields address/control during the negotiation. Except particular cases, it’s recommended not to modify the default settings (enabled).

To make sure that the GPRS/LTE connection is successfully established, it’s important that the following operations have been executed:

• Provide WE151 with a SIM (rechargeable or on contract) enabled to data traffic.
• Enter the APN on the field APN for the operators that require that.
• Screw the antenna and make sure that the GSM coverage is enough.
• Enable the service GPRS/LTE through the field Enable.

It’s possible to check the quality of the connection using the diagnostic tool Ping (11.3. Ping).

Further information about the connection status are available at page Diagnostics → Networking (11.2. Connectivity information).

From the section SIM configuration some parameters can be set, that are fundamental for a correct functioning of the SMS service, and of the GPRS/LTE connection, according to the specifications of the selected provider.

• APN The APN is the name of the access point of the GPRS/LTE network. It changes according to the operator and to the contract (in some cases this may not be necessary). It’s an important parameter for a correct functioning of the connection. In case this should not be known, it’s required to contact the provider.
• Username It’s the name of the user to be used for the GPRS/LTE connection. Except particular cases required by the provider, this field must be void.
• Password It’s the password to be used for the GPRS/LTE connection. Except particular cases required by the provider, this field must be void.
• SIM number Telephone number of the SIM inserted in the device. It’s not relevant for the functioning of the device (it’s never used by the WE151).
• SMS center Provider’s SMS service center. With some SIMs may not be necessary. In case this should not be known, it’s required to contact the provider.

SMS Service

On the section SMS configuration, it’s possible to enable/disable the SMS service (on the field Enable SMS) and choose whether to enable or not the sending of possible SMS notifications as previously configured (on the field Send events) (4. Events/Actions).

Once activated the SMS service, it’s possible to test it through the section SMS test: entering a valid telephone number preceded by the country code (for instance +39NNNNNNNN in case of an Italian number), WE151 will try to send an SMS having the following text ” Test message from WE151 “.

To make sure that the SMS service is working properly, and lets the users communicate with WE151 and the device send possible alarms notifications, it’s necessary to follow carefully these steps:

• Set the SMS service centre on the field SMS center.
• Enable the SMS service on the field Enable SMS.
• Enable the SMS sending on event (field Send events).
• Define at least one user and make sure that the options for the receiving/sending SMS are activated (8. Users) and that at least one valid telephone number is available.
• Create one or more events having Send SMS as action (see 4. Events/Actions).
• Check your SIM card balance
• Make sure that the SIM has no PIN code.
• Make sure that the antenna is correctly mounted and the signal is enough.

All sent and received SMS can be displayed on the page Status → Services → SMS. At the access, the first page to be displayed is the one containing the SMS received by the device

On the displayed tab, the following information will be shown:

• Number The number of the message sender.
• Reception date In this field are reported the data and time when the WE151 has received the message.
• Text The field where the text of the received message is shown.

At any time it’s possible to click on the tab Refresh in order to update the information, or Empty box in order to delete all messages available inside Inbox.

Clicking on the drop-down menu on top of the tab, it’s possible to pass from Inbox to Outbox.

From this tab it’s possible to visualize all outgoing messages of WE151. The visualized information are:

• Number The number of the message receiver.
• Creation date In this field are reported the data and time when the message has been created.
• Text The field where the text of the message is shown.

At any time it’s possible to click on the tab Refresh in order to update the information, or Empty box in order to delete all messages available inside Outbox (i.e. messages that won’t be sent by WE151).

Clicking on the drop-down menu on top of the tab, it’s possible to pass from Outbox to Sent. In this last tab are displayed some information regarding the SMS already sent by WE151.:

• Number The number of the message receiver.
• Send date In this field is reported the data and time when WE110 has sent the message.
• Text The field where the text of the message is shown.

At any time it’s possible to click on the tab Refresh in order to update the information, or Empty box in order to delete all messages available inside Sent.

9.2. Activable services

The section Networking→Services of the menu allows to enable some additional services, that will use the connectivity of the device:

• Email
• Chat
• VPN
• DNS

9.3. Email

Before proceeding with the configuration of the WE151, it’s necessary to do the following:

• After having defined the Provider (Gmail, Yahoo or any other..), enter its site and create a new valid email account
• On the provider’s site get informed about the parameters to be entered, in order to have a correct configuration of the mail.

Once created a new email account, it’s possible to pass to the configuration of WE151, defining whether to enable the outgoing emails, the incoming or both of them in th epage Networking→Services→Email.

The necessary parameters for the email sending from WE151 have to be defined on the section Outgoing mail setup:

• Enable outgoing mail service It enables/disables the mail services.
• Server type It allows to specify the type of mail server (currently it’s available only the option SMTP).
• Server address It’s the address of the mail server (for example smtp.gmail.com).
• Port It’s the port number to access (for instance 587).
• Email address It’s the email address associated to the WE151. This will be the address visualized by the users, who will receive emails from the device.
• Username Username of the mail account associated to WE151.
• Password Password of the mail account associated to the WE151.
• SSL-TLS Encryption.

Once clicked on Save, on the bottom of the page a new section called Outgoing mail test will appear: from this section it’s possible to send a test email to any address.

On the section Incoming mail setup it’s possible to define the necessary parameters for the reception of the emails sent by the enabled users:

• Enable incoming mail service It enables/disables the mail reception service.
• Server type It allows to select the type of mail server (currently available only POP).
• Server address The address of the mail server (for example pop.gmail.com).
• Port Number of the access port (for example 995).
• Email address The email address associated to the WE151. This is the address visualized by the users, who will receive emails form the device.
• Username Username of the mail account associated to the WE151.
• Password Password of the mail account associated to the WE151.
• SSL-TLS Encryption.

A properly configured mail service will allow the WE151 to send notification mails to the configured users (see 4.2.1. Action Send Email), to receive commands from registered users (see 6.2. Set/Get commands via SMS/Email/Chat and 10. System commands), to send/receive commands to/from other devices and to send scheduled reports (see 7.6. Email report).

All sent and received emails can be visualized on the page Status → Services → Email. At the access, the first page shows the emails received by the device

On the displayed tab, following information are shown:

• Mail address It shows the sender of the mail.
• Reception date It shows the date and time of the email receipt.
• Text This field shows the text of the received email.

Any time it’s possible to click the tab Refresh, in order to refresh all information, or Empty box in order to delete all messages available inside Inbox.

Clicking on the drop-down menu on top of the tab, it’s possible to pass from Inbox to Outbox.

On this tab it’s possible to visualize all emails not yet delivered by WE151. The displayed information are the following:

• Mail address It shows the email receiver.
• Creation date It shows the date and time of email creation.
• Attempts Delivery attempts made by WE151.
• Text This field shows the text of the email.

Any time it’s possible to click the tab Refresh, in order to refresh all information, or Empty box in order to delete all emails available inside Outbox (i.e. messages that will never be sent by WE151).

Clicking on the drop-down menu on top of the tab, it’s possible to pass from Outbox to Sent. In this last tab are displayed some information regarding the mails already sent by WE151:

• Mail address It shows the receiver of the email receiver.
• Creation date It shows the date and time of email creation.
• Attempts Delivery attempts made by WE151.
• Text This field shows the text of the email.

Any time it’s possible to click the tab Refresh, in order to refresh all information, or Empty box in order to delete all emails available inside Sent.

9.4. Chat

Once checked that the device is able to connect to the net and having created a chat user to be associated to the WE151, it’s then possible to proceed with the configuration of the service from the page Networking → Services → Chat.

On the section Chat service setup must be defined the necessary parameters for the successful functioning of the service:

• Chat enable It enables/disable the chat service.
• Chat server It allows to define the chat server, that WE151 shall connect to (for example matrix.org).
• Room name It’s the name of the chat room (for example Home).
• Device username The name of the chat user to be associated to the WE151. The device will send and receive messages using this name.
• Device password The user password to be associated to the WE151.
• Sync timeout Timeout in seconds referred to the synchronization with the server.

Once clicked on Save, at the bottom of the page a new section called Chat test will appear; from that section it’s possible to send a test message via chat to the chat room of the device.

All by the device sent and received chat messages can be visualized on the page Status → Services → Chat. At the access, on the first visualized page will show the messages received by the device via chat.

On the displayed tab the following information are available:

• Sender It shows the sender of the messages.
• Reception date It shows the date and time when the WE151 has received the message.
• Text This field shows the text of the received message.

Any time it’s possible to click the tab Refresh, in order to refresh all information, or Empty box in order to delete all emails available inside Inbox.

Clicking on the drop-down menu on top of the tab, it’s possible to pass from Inbox to Outbox.

On this tab is possible to visualize all not yet delivered messages of the chat. The available information are the following:

• Creation date It shows the date and time of message creation.
• Text This field shows the text of the message.

Any time it’s possible to click the tab Refresh, in order to refresh all information, or Empty box in order to delete all messages available inside Outbox (i.e. messages that will never be sent by WE151).

Clicking on the drop-down menu on top of the tab, it’s possible to pass from Outbox to Sent. In this last tab are shown some information about the already sent messages:

• Send date In this field are visualized date and time, when WE151 has delivered the message.
• Text This field shows the text of the email.

Any time it’s possible to click the tab Refresh, in order to refresh all information, or Empty box in order to delete all messages available inside Sent.

@my_username:matrix.org

where of course instead of my_username it must be entered the correct name.

9.5. VPN

There are two possible modalities to enable the VPN:

• Auto

• VPN Service URL: https://nethix.co
• VPN Service port: 443

To let a PC connect with Nethix VPN, in order to reach and connect to the required WE151, the following procedures are available:

• Client OpenVPN: Download the Open VPN client from the official page of the Standard (further information are available here).
• QuickTunnel: Download the free Software Quicktunnel, created by Nethix and compatible with Windows, macOS and Linux (further information available on relevant manual QuickTunnel).
• Manual

The manual VPN is used to establish a secure connection to any other server VPN, compatible with the Standard OpenVPN.

The parameters to be configured in order to enable a manual VPN are the following:

• VPN mode: in this case the modality is Manual.
• VPN configuration: it’s a configuration file released by the VPN Server provider. The files shall contain also the certificates, according to the Open VPN Standard.
• VPN Service user: the user name used by the WE151 to authenticate in the selected VPN server.
• VPN Service password: the password associated with the username.

9.6. DDNS

WE151 offers also the possibility to associate its own connection with a dynamic DNS service, choosing one of the available providers from the list on page Networking → Services → DDNS.

• Provider: On this field it’s possible to choose the Provider’s.
• Hostname: The device, once properly configured, will answer to this address (after the creation of an account on the site of the selected Provider).
• Username: Username associated with the account, created from the site of the Provider’s.
• Password: Password associated with the username.

11.1. System logs

From the page Diagnostics → Logs → System it’s possible to read the last 20 logs of the system.

On the reported tab are displayed some useful information for getting a report about the system status and identify possible errors. To update the list of the logs, click on Refresh.

In case of error notifications, double check the configuration of the device and revert to Nethix support service.

On the page Diagnostics → Logs → Boot it’s possible to read the system boot logs, i.e. all operations that are executed by WE151 at every start/reboot.

Such information can be interesting for Nethix Support service, in case of assistance.

11.2. Connectivity information

On the page Diagnostics → Networking it’s possible to read additional information regarding the status of the active connections.

The page is divided into three sections: RNDIS Interface, Modem Interface and VPN Interface (if available).

Every section shows a set of technical information regarding the relevant connection type.

RNDIS Interface:

• Status It shows up if the connection is established, down if the service is not active or if the WE151 could not establish the connection.
• MAC address It shows the MAC address of the network interface of WE151.
• IP address IP address of the connection (in this case it will always be 192.168.7.1).
• Subnet mask The mask of the sub network.
• Gateway Gateway in use.
• DNS servers Available DNS servers.
• In/Out bytes Quantity of received or used traffic during current connection.
• In/out errors Quantity of incoming/outgoing errors during current connection.
• Collisions Quantity of collisions during current connection.

Modem Interface:

• Status It shows up if the connection is established, down if the service is not active or if the WE151 could not establish the connection.
• Signal Gives the signal level in CSQ. The scale ranges from 1 to 31, where 31 is the max coverage value and 1 the minimum. To have a stable connection, it’s recommended to have a minimum signal of 15-16.
• Network operator It reports the name of the Provider, connected with the WE151.
• IP address IP address of the connection.
• In/out bytes Quantity of received or used traffic during current connection.
• In/out errors Quantity of incoming /outgoing errors during current connections.
• Collisions Quantity of collisions during current connection.

VPN Interface:

• Status It shows up if the connection is established, down if the service is not active or if the WE151 could not establish the connection.
• IP address IP address of the connection.
• Subnet mask The mask of the sub network.
• In/out bytes Quantity of received or used traffic during current connection.
• In/out errors Quantity of incoming/outgoing errors during current connection.
• Collisions Quantity of collisions during current connection.

11.3. Ping

In case of failures in the communication, as for instance during the data delivery to a Portal, mail or any other operation, WE151 gives the possibility to execute a ping towards any host, allowing to select the network interface to be used.

For this operation, enter the page Diagnostics → Ping.

• Host Enter in this field a valid Hostname, to be reached through the ping (for example www.google.com).
• Interface Network interface to be used for reaching the defined host. According to the configuration of the device or of the active services, it’s possible to choose between 4G and VPN.
• Count It allows to set the number of ping to be executed.

Once filled in above mentioned fields, clicking on Ping, the operation starts. The results will be reported on the area below, letting the user detect possible malfunctions.

12.1. Input configuration

WE151 is equipped with a software configurable input, according to customer’s requirements. To change the input configuration it’s enough to select the page Configuration → General Setup.

12.2. Configuration overview

WE151 allows to have a complete overview of the configuration made by the user, and it’s accessible in one single page in order to simplify the review of the entered information.

Entering the page Configuration → Overview is available a complete summary of the configuration made, divided into the following sections:

• Variables The list of the created variables, divided into variables groups; here it’s possible to get some fundamental information regarding their configuration. The variables, that are not associated with any group, will be displayed under No group
• Events Here are reported all events and relevant actions, associated with the links, that allow to detect immediately the connected variables and the users, that are the recipients of the actions
• Users Here is the list of users groups. Each group contains additional information regarding the users, that are part of the group. The users that are not included in any group, are displayed under No group

On the right of every position, displayed on the configuration Overview is the icon that allows to expand the contents and access to further details.

12.3. System settings

On the section Configuration → General Setup some general device settings can be defined and some additional services can be activated.

12.3.1. Information about the plant

On the page Configuration → General Setup → System, under the section System, it’s possible to personalize the contents, that will be displayed on the page Status → Site after the login. These settings have the purpose of identifying the device and are not compulsory.

• Site name The name given to the device.
• Site id Numeric ID given to the device.
• Country Region/area where the device is deployed.
• Region Regione/Area in cui si trova il dispositivo.
• Picture Enabling this option and selecting a picture by clicking on Select file, it’s possible to display a specific image after the login (for example the picture of the plant, of the company etc..). The selected picture will be displayed on the page Status -> Site.

12.3.2. Date and time

On the page Configuration → General Setup → System, under the section Time/Date, it’s possible to set the date and time of the device:

• Installation time/date It allows to specify the date and time when the plant has been installed. The purpose of this information is to identify the device, and has no influence on the functioning.
• Set time/date It allows to set manually the date and time of the device, if the option Enable NTP is disabled.
• Enable NTP It enables the service for the automatic synchronization of the time. Once a day, at every start and reboot, WE151 connects to a server, in order to get the precise and updated date and time, according to its own timezone.
• Select timezone It allows to set the timezone.

It’s also possible to specify a different NTP server as the default one, by clicking the link Advanced.

12.3.3. Web interface personalization

Some graphical customizations of the device Web Interface are possible; these are available for all the users on the page Configuration → General Setup → Web Interface.

On the section Web interface theme theme it’s possible to select the device look and feel among Dark (dark version) and Light (light version).

On the section Web interface customization it’s possible to modify some other elements of the device:

• Logo It allows to select an image to be used as Logo, replacing Nethix logo on the top left corner.
• Prevalent color The primary colour of the page (RGB hexadecimals colour e.g.: #00BC5).
• Font color Colour of the text (RGB colour hexadecimals e.g.: #00BC5).
• White icons Disabling this option, the icons of the header (help, poweroff, reboot, logout) will be displayed in black colour.
• Background color It’s the colour of the page background (RGB hexadecimals colour e.g.: #00BC5).
• Footer It allows to configure the footer at will (it’s allowed the use of HTML code).

Every field, that allows a colour, if clicked, will show a colour picker, that will allow an easy selection of the desired colour, and will set automatically the correspondent hex value.

12.4. System information

On page System → Info there are some additional information regarding WE151. On the section System information, are displayed some general information:

• Version The currently on device installed version.
• Software serial number The serial number reported on the label, positioned on the back of the device.
• Hardware serial number Hardware serial number, it’s important for the registration on the portal and for the use of the services as for example Nethix VPN.
• Modem Model The model of the internal modem.
• Modem IMEI IMEI code of the internal modem.
• Modem temperature The temperature of the internal modem.
• CPU temperature The temperature of the CPU.
• Internal temperature The internal temperature of the WE151.
• Device Supply The power supply of the device (V).
• Memory usage The Ram memory status.

12.5. Configuration Backup/Restore

WE151 offers the possibility to make a backup of the configuration made on the device in the form of an encrypted file, on the page System → Backup/Restore.

The backup includes:

• Created variables
• Associated events and actions
• Networking settings
• Created users
• Services enabling and configuration

On the other hand, these won’t be included in the back up:

• System log
• Service log
• SMS/Chat/Email/Cloud Archives

To execute the backup, click on Backup on the section Download configuration.

Once received the encrypted backup file, it’s possible to upload it on any other device, having the same hardware and software as the original one.

From the section Restore configuration, simply select the backup file and click Restore. At the end of the operation, it’s recommended to reboot the device to make the changes effective.

The Backup/restore tool can be useful also in the case, that a configuration copy should be kept as reference for future upload on the original device or for installing the same configuration in several devices.

In this last situation, i.e. to make a Restore on a different WE151 as the original one, where the back up has been created, it’s very important to know the following:

• To transfer the configuration of a WE151 to another, it’s necessary that both devices have the same version. Differently please contact Nethix support.

12.6. Logs reset

The internal memory of WE151 allows to log a high quantity of data. Nevertheless, to avoid the overload of the device, it’s possible to delete any available log from the page System → Reset Logs.

The logs that can be deleted are:

• Chat Delete all received and sent chat messages.
• Email Delete all emails available in the memory: sent, received and outgoing.
• Portal Delete all data deliveries sent to an external portal.
• Commands Delete all logs, referred to execute a command (not viewable on the Web Interface).
• SMS Delete all SMS available in the memory: sent, received and outgoing.
• 4G Delete all logs referred to the internal modem connection (not viewable on the Web Interface).
• Events Delete all logs referred to the events/actions so far occurred.

Once selected one or more positions, just click on Erase logs to delete the logs permanently from the device memory.

12.7. Factory reset

In case it should be necessary to reset the device to the factory settings, and thus delete all logged data and the configuration previously made, it’s possible to make it on the page System → Factory Reset.

After clicking on the only available tab in the page, it’s necessary to confirm the operation before proceeding. Once confirmed, the WE151 will reboot and be again available via USB.

12.8. Device upgrade

WE151 can be upgraded any time on client’s request or on notification by Nethix.

The upgrades can be made according to 2 different procedures: writing the name of the required version and downloading it from the official Nethix server (after having contacted Nethix Support Service), or in alternative uploading on the device the encrypted file, containing the upgrade (to be requested at Nethix Support Service).

Both procedures are available on page System → Ugprade.

Once received the right string, it must be entered on the field Version. Click then on Upgrade.

The download time depends on the active connection speed on the WE151. Once downloaded the required version, WE151 reboots and then install it. This operation may require about three minutes.

When WE151 is on line again, it’s suggested to enter the interface and check if the upgrade has been successfully executed (it’s enough to check it on the status panel).

On the other hand, from the section Upgrade from file it’s possible to send to the WE151 an encrypted file containing the upgrade, after having downloaded it on the PC.

The file depends on the previous version available on the device and must be required at Nethix Support Service.

The download time depends on the active connection speed on the WE151. Once downloaded the required version, WE151 reboots and then install it. This operation may require about three minutes.

When WE151 is on line again, it’s suggested to enter the interface and check if the upgrade has been successfully executed (it’s enough to check it on the status panel).

12.9. Features

The device features are some hardware and software optional functions that compose the system.

To check the enabled options on the device, go to page System → Features.

12.10. Plugins

The plugins are a set of encrypted files that allow to add or change a part of the configuration and of the available web pages.

To upload a plugin or the check the list of the currently installed plugins on a device, enter the page System → Plugins.

This interesting tool allows for instance to send a file to the WE151, in order to add a pre-set configuration according to the specifications or the requirements of the customer.

Through a plugin it’s possible to add:

• Variables
• Formulas
• Events and actions
• Customized pages or dedicated to a specific application

The main difference between loading a plugin or make a restore from a device backup , is that through the plugins some new dedicated pages can be added, and some variables, events, actions can be added to the already available (while with the restore procedure the existing configuration is simply overwritten).

For a deeper information about the available plugins or to request a customized plugin, it’s necessary to contact Nethix Support Service.