Web Interface manual

1.1. About this document

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

This manual refers to the Software version 4.0.0 released in May 2022. Please check that the software version of WE111 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 WE111, 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

WE111 is a mini IoT module. It’s user-friendly and can manage every single function of the system through its integrated Web Interface. Thanks to the I/O on board (1 configurable input and 1 relay digital output), WE111 allows to read, monitor and control signals coming from connected machines or sensors. Through the supported protocol MQTT, it can communicate with any further compatible device.

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 6. 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 6.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: associated to the input on board, selectable only if configured as analog input. Further information available on paragraph 2.3. Variable Analog Input (AI).
• Digital input: associated to the input on board and selectable only if configured as digital input. Further information available on paragraph 2.4. Variable Digital Input (DI).
• Digital output: associated to the digital output (relay) of WE111. Further information available on paragraph 2.5. Variable Digital Output (DO).
• 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. Variable Analog Input (AI)

In order to create a variable type AI, it’s first of all necessary to configure the input properly (see 11.1. Input configuration). Once configured the input as Analog Input, 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.

The field Mode allows to set the type of analog input, selecting one of the following options: 0-5V, 0-20mA, 4-20mA or NTC. It’s then necessary to define a measurement unit (on the field Measurement unit) this will be displayed on graphs and on Status -> Variables. Through the fields Minimum value and Maximum value, it’s possible to scale a variable. The minimum value of tension or current will be associated to the value set as Minimum value likewise it will be set the maximum value.

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 WE111, keeping any possible configured threshold under control.

2.4. Variable Digital Input (DI)

In order to create a varible type DI, it’s first of all necessary to configure the input properly (see 11.1. Input configuration). Once configured the input as Digital Input, 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.

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 WE111, 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 5.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, WE111 starts counts the time
• The input changes from closed to open
• The input changes from open to closed after 20 seconds
• WE111 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.
• WE111 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, WE111 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. Variable 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, 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 WE111 manage the status or the value coming from a measurement, made by a different device (Nethix or not, through MQTT 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 3.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 WE111 would then be “25”.

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

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

WE111 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. Variable 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. Events

The events allow the WE111 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 4. 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 WE111 will execute the associated actions and send to portal a string, containing the name of the event and further relevant information.

3.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.

3.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 7. 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.

3.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.

3.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 8. Connectivity and 10.3. Ping).
• The selected user/s must be enabled to receive notification emails and shall have confirmed a valid email address (see section 7. Users).
• The mail service shall be properly configured (see section 8.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.

3.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 7.1. Create a new user).
• The SMS service must be properly configured (see section 8.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.

3.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 7.1. Create a new user).
• The Chat service must be properly configured (see section 8.4. Chat).
• The device must be connected to the internet (see sections 8. Connectivity and 10.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.

3.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

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

• Variables type DI
• Variables type AI

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.

3.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 6.3. HTTP/S).

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

In this case the delivery won’t be immediate, but according to the timing set by the user.

3.2.6. Action Reboot

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

3.2.7. Action Poweroff

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

---

4.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 WE111 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.

4.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.

4.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.

5.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 and virtual). In case of DO variables, will be entered the defined status (for example “open” “closed”), that can be clicked to change the status of the variable. For the virtual variables it’s instead possible to enter a numeric value and confirm the setting by clicking set.
• Status: In case of DI and DO 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.

5.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

5.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 3.1.2. Incoming data) and create some actions type Execute a command (see 3.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 3.2.2. Action Send SMS, 3.2.3. Action Send Chat and 3.2.1. Action Send Email), it’s possible to define the message, that WE111 will have to send to the configured users.

6.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.

6.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, 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 WE111:

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.

6.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 WE111 will use to authenticate at the server.
• Device ID: ID of the device (useful for managing more than one WE111 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 WE111.

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: WE111 waits for commands coming from the server, every time it has to execute a data delivery.

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

6.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 WE111.
• 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

6.5. MQTT/S Report

MQTT report example:

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

6.6. Email report

From the tab Email report it’s possible to configure the delivery of the data collected by WE111 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 WE111 (8.3. Email) and have enabled the option Receive report by email on the configuration of the users who are supposed to receive the email (7. Users).

7.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 WE111. 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 7. 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 WE111. 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 WE111, if previously configured.
  • Receive alarms by email If enabled, it allows the user to receive alarms via email from the WE111, 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. (6.6. Email report).
  • Send commands by SMS If enabled, it allows the user to send commands to WE111 via SMS.
  • Send commands by email If enabled, it allows the user to send commands to WE111 via email.
  • Send commands by chat If enabled, it allows the user to send commands to WE111 via chat.
  • Receive remote command If enabled in case of emails sent by WE111 to the user won’t show on the subject the name assigned to the device. This allows to send Set/Get commands between devices (5.2. Set/Get commands via SMS/Email/Chat).

7.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)
• WE111 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.

8.1. Network interfaces

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

In case of WE111 the only option is Modem.

8.1.1. Data connection and SMS

WE111 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 WE111 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 (9. 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, WE111 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 WE111 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 (10.3. Ping).

Further information about the connection status are available at page Diagnostics → Networking (10.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 WE111).
• 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) (3. 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), WE111 will try to send an SMS having the following text ” Test message from WE111 “.

To make sure that the SMS service is working properly, and lets the users communicate with WE111 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 (7. Users) and that at least one valid telephone number is available.
• Create one or more events having Send SMS as action (see 3. 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 WE111 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 WE111. 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 WE111).

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 WE111.:

• 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.

8.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

8.3. Email

Before proceeding with the configuration of the WE111, 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 WE111, 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 WE111 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 WE111. This will be the address visualized by the users, who will receive emails from the device.
• Username Username of the mail account associated to WE111.
• Password Password of the mail account associated to the WE111.
• 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 WE111. This is the address visualized by the users, who will receive emails form the device.
• Username Username of the mail account associated to the WE111.
• Password Password of the mail account associated to the WE111.
• SSL-TLS Encryption.

A properly configured mail service will allow the WE111 to send notification mails to the configured users (see 3.2.1. Action Send Email), to receive commands from registered users (see 5.2. Set/Get commands via SMS/Email/Chat and 9. System commands), to send/receive commands to/from other devices and to send scheduled reports (see 6.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 WE111. 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 WE111.
• 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 WE111).

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 WE111:

• 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 WE111.
• 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.

8.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 WE111, 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 WE111 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 WE111. The device will send and receive messages using this name.
• Device password The user password to be associated to the WE111.
• 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 WE111 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 WE111).

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 WE111 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.

8.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 WE111, 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 WE111 to authenticate in the selected VPN server.
• VPN Service password: the password associated with the username.

8.6. DDNS

WE111 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.

10.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 WE111 at every start/reboot.

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

10.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 WE111 could not establish the connection.
• MAC address It shows the MAC address of the network interface of WE111.
• 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 WE111 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 WE111.
• 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 WE111 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.

10.3. Ping

In case of failures in the communication, as for instance during the data delivery to a Portal, mail or any other operation, WE111 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.

11.1. Input configuration

WE111 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.

11.2. Configuration overview

WE111 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.

11.3. System settings

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

11.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.

11.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, WE111 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.

11.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.

11.4. System information

On page System → Info there are some additional information regarding WE111. 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 WE111.
• Device Supply The power supply of the device (V).
• Memory usage The Ram memory status.

11.5. Configuration Backup/Restore

WE111 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 WE111 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 WE111 to another, it’s necessary that both devices have the same version. Differently please contact Nethix support.

11.6. Logs reset

The internal memory of WE111 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.

11.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 WE111 will reboot and be again available via USB.

11.8. Device upgrade

WE111 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 WE111. Once downloaded the required version, WE111 reboots and then install it. This operation may require about three minutes.

When WE111 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 WE111 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 WE111. Once downloaded the required version, WE111 reboots and then install it. This operation may require about three minutes.

When WE111 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).

11.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.

11.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 WE111, 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.