User Tools

Site Tools


level2:how_to_connect_webhmi_to_level2

This is an old revision of the document!


Connecting WebHMI to Level2

The information in this section relates to the hardware WebHMI & Virtual box version. The cloud running version is connected automatically during creation phase.


The “connection” means getting API key from Level2 system, which then WebHMI uses for data sending to the cloud. Other part of the connection is the WebHMI VPN client connection to the Level2 VPN server which facilitates remote accessing to the WebHMI using HTTP proxy service.

Depending on the fw version, there are 2 ways how to setup the connection:

  1. For the fw versions starting from 3.5, the connection (both VPN and data sending) can be made right from the WebHMI project setup, and further adjusted in the Level2 system. You must have valid Level2 account or you will be prompted1) to do this during the setup.
  2. For the older versions, the setup is made a bit different:
    1. A node condiguration is created on the Level2, which generates API key and VPN client credentials
    2. On the WebHMI, you enter this API key and VPN credentials to get connected.

Connecting from WebHMI project setup menu, newer method (#1)

You can connect WebHMI to Level2 following Setup / Level2 link from side bar menu:

Then you have several options how to proceed:

  • if you don't have any Level2 account, you can follow Register now link and create new account
  • if you have Level2 account, you can Sign-in and use step-by-step procedure right from this page.
  • if you already have an account and some node created there in advance, you can just input API key from this node following Enter API key directly

As of 3.6 fw version, Level2 setup link resides in the popup setup menu

Registering in Level2 system

You may follow the above mentioned Register now link or use this URL - level2.webhmi.com.ua.

  1. Enter e-mail you want to use as a login for Level2
  2. Enter password
  3. Choose currency to use in Level2 tarriffs, reports, billing etc.
  4. Starts registration process ( confirmation e-mail will be sent to the e-mail indicated as login )
  5. To Enter into existing account with login and password provided
  6. Recover password link
  7. Language selection for Level2 interface

Adding a node to Level2 using WebHMI sign-in option

With this method you can add WebHMI node into Level2 system right from Setup / Level2 menu. Pressing Sign-in button will lead to this step where you can create a new node or choose an existing one:

After successful creation, this page is displayed which indicates, that the node with title “webhmi” was added to Level2 account “myLevel2account@gmail.com”. You can remove node from here by clicking “Disconnect” or setup some basic Level2 services:

  • VPN
  • data storage
  • real-time data storage and visualization
  • weather forecast

After WebHMI and its node settings in Level2 were tied together, you can enable basic Level2 services right from the WebHMI.

VPN setup from WebHMI Level2 menu


There is a simple way to setup VPN connection for WebHMI to Level2 right from this page - turn the switch button on and press Save.

Then a new L2TP connection will be created on the WebHMI with settings that match Level2 network setting for this node.

The VPN account settings were automatically created in Level2 node settings and applied to VPN network interface in WebHMI:

If VPN option is turned on, HTTP proxy service also can be turned on:

Another powerful feauture based on Level2 VPN is a Virtual IP. With this feature you can remotely access other devices in WebHMI local network using Virtual IPs set in these settings:

Connecting using old method, #2 (for fw below 3.5)

First, create a node in the Level2 node list:

Turn on VPN and Http proxy services:

In the Information tab of the nodes properties, copy the following:

  1. API key for sending data
  2. VPN credentials

Then in the WebHMI project setup enter the API key from the node's properties and set respective checkbox.

For the VPN setup please refer to this page.

The Level2 node setup is given in more details in the following section.

Level2 node setup

Basic settings

  • Title - node's title
  • Type - WebHMI (HW or Virtual Box) or PC VPN.
  • Serial - serial number of the hw device
  • Description - extra detail on this node
  • Category - category makes node selection in large lists easier
  • City/Address - goes without saying
  • Total object area, Commercial object area - this values participates as the specific cost per square meter in the resource consumption analytics

Services

  • VPN - if you turn this check box on, an vpn client account will be added to the Level2 server configuration, so that you can connect the WebHMI to the Leve2 using the credendtials provided in the 'Information' tab. Note that the service is synced two ways starting from fw version 3.5, i.e. you can either check/uncheck it from Level2 or right from the WebHMI. See more details on this page
  • HTTP Proxy - this service is free, and means you'll get Level2's sub-domain name to access your node with the convinient URL name, like my-node-url.webhmicloud.com

You can also follow this link right from the Level2 pages: From the node list:

From the map (provided the map with the node was created):

  • Archive storage - see more here
  • Reception and storage of current values of registers - Required to display the status of the node and its other realtime data on the map

When this option is enabled, the node can accept real-time data from WebHMI and show them in its tile (see more in the Map tab description):

  • Provision of current weather data and weather forecasting - with this option the WebHMI connected to the Level2 is able to request weather data for the node's location and use it for advanced control algorithms based on weather conditions (see more).
  • Project backup storage - with this option the latest backup of your project will be automatically sent to Level2 for more safety of your data. You can then download the backup right from the Level2 node list:

Map

In this tab you define the node's location on the map, and what data will be displayed on its tile on the map and in the nodes overview. The tile is able to reflect the status of the node depending on the status register value (normal, warning, alert, disconnnected), and display some important values from the node in the tile.

Location

Just click in the desired node location. You can drag the map over with main mouse button pressed.

GPS

Means what values are used to show the node's location. The default values are taken from the map, but you can override them selecting particular registers (with the coordinates), provided they have the “send data to cloud” attribut set on the WebHMI.

Register with status

See the explanation on this page.

1)
if you don't have one
level2/how_to_connect_webhmi_to_level2.1642501140.txt.gz · Last modified: 2022/01/18 10:19 by emozolyak

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki