Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:sw:01-mervis:mervis-scada-project-hidden [2020/06/11 10:49]
avsetula [3.4 Assigning a table to the terminal]
en:sw:01-mervis:mervis-scada-project-hidden [2022/05/06 12:39] (current)
avsetula [4 Uploading the Mervis SCADA project definition]
Line 1: Line 1:
 +<​html><​div class="​version-switch">​
 +  <a href="#​creating_a_mervis_scada_project"><​div class="​actual-version">​IDE v2.4.0 and later</​div></​a>​
 +  <a href="/​en:​sw:​01-mervis:​mervis-scada-project-v230-hidden"><​div>​IDE v2.3.0</​div></​a>​
 +</​div></​html>​
 +
 ====== Creating a Mervis SCADA project ====== ====== Creating a Mervis SCADA project ======
 +<WRAP group>
 +<WRAP half column 81%>
 The [[05-mervis-scada|Mervis SCADA]] is a cloud application for remote control and monitoring of technologies including one or more Unipi controllers from a single control interface. The control panel is available via a web browser or app for smartphones and tablets. The [[05-mervis-scada|Mervis SCADA]] is a cloud application for remote control and monitoring of technologies including one or more Unipi controllers from a single control interface. The control panel is available via a web browser or app for smartphones and tablets.
 +</​WRAP>​
 +<WRAP half column 15%>
 +;;#
 +<​html><​span class="​dev-tag dev-patron">​Patron</​span></​html>​ \\
 +<​html><​span class="​dev-tag dev-neuron">​Neuron</​span></​html>​ \\
 +<​html><​span class="​dev-tag dev-gate">​Gate</​span></​html>​ \\
 +<​html><​span class="​dev-tag dev-unipi11">​Unipi&​nbsp1.1</​span></​html>​ \\
 +<​html><​span class="​dev-tag dev-axon">​Axon</​span></​html>​
 +;;#
 +</​WRAP>​
 +</​WRAP>​
  
 The following tutorial will show you how to create a new Mervis SCADA project, and how to use Mervis SCADA for access to an already existing Mervis IDE project. ​ The following tutorial will show you how to create a new Mervis SCADA project, and how to use Mervis SCADA for access to an already existing Mervis IDE project. ​
  
-==== Prerequisites ​==== +<WRAP center round box> 
-  * [[https://​www.unipi.technology/​axon-c20 | Unipi controllers]] with at least [[en:​files:​software:​os-images:​00-start|Mervis OS v2.2.0]] and [[en:​files:​software:​mervis:​00-start|Mervis IDE v2.3.0]]+<​html><​span class="​kbBlue-H4alt">​Prerequisites:</​span></​html>​ 
 +  * [[https://​www.unipi.technology/​axon-c20 | Unipi controllers]] with at least [[en:​files:​software:​os-images:​00-start|Mervis OS v2.2.0]] and [[en:​files:​software:​mervis:​00-start|Mervis IDE v2.4.0]]
   * Internet connection   * Internet connection
   * Valid user account and activated license on the [[https://​www.unipi.technology/​getmervis|Unipi webpage ]]   * Valid user account and activated license on the [[https://​www.unipi.technology/​getmervis|Unipi webpage ]]
 +</​WRAP>​
 +
 +
 +===== Modification after upgrade from Mervis IDE 2.3.0 =====
 +If you are upgrading project from IDE 2.3.0 version, it is necessary to set [[#​plc-history-profile|PLC history profile]] which was set in the IDE 2.3.0 version for the SCADA terminal. This history profile is now set separately for each assigned controller.
 +
 +It is also necessary, in the table of data points, to mark the data points for which you store history in the database and then select the item "​Assigned history profiles"​ in the right column. More is described in the chapter [[#​adding_data_points_into_the_mervis_db|3.3 Adding data points into the Mervis DB]].
 +
  
 ===== 1 Introduction into the Mervis SCADA ===== ===== 1 Introduction into the Mervis SCADA =====
Line 43: Line 70:
 ==== 1.2 Creating a SCADA project ==== ==== 1.2 Creating a SCADA project ====
 The first step of connecting your PLC into the Mervis SCADA is to create a SCADA project using the [[https://​www.unipi.technology/​customer/​scada/​|Customer portal]]. Log in using the account you purchased the PLC with. The first step of connecting your PLC into the Mervis SCADA is to create a SCADA project using the [[https://​www.unipi.technology/​customer/​scada/​|Customer portal]]. Log in using the account you purchased the PLC with.
 +
 +<WRAP center round info 95%>
 +If you do not have our customer account, you need to register to create one on the [[https://​www.unipi.technology/​customer/​registration/​|Unipi technology]] website.
 +</​WRAP>​
  
 <​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​01-mervis-scada-project-en.png)">​ <​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​01-mervis-scada-project-en.png)">​
Line 79: Line 110:
 Any PLC we want to connect to the SCADA project must be connected to the Mervis Proxy service. You can configure Mervis Proxy using the Proxy Parameters section located in the PLC properties. All the needed parameters are available in your [[https://​www.unipi.technology/​getmervis|Customer portal]]. Use a unique Proxy ID for each PLC. A more detailed description is available in the [[connecting-to-unipi-via-mervis-proxy-hidden|Connecting to Unipi via Mervis Proxy]] tutorial. Any PLC we want to connect to the SCADA project must be connected to the Mervis Proxy service. You can configure Mervis Proxy using the Proxy Parameters section located in the PLC properties. All the needed parameters are available in your [[https://​www.unipi.technology/​getmervis|Customer portal]]. Use a unique Proxy ID for each PLC. A more detailed description is available in the [[connecting-to-unipi-via-mervis-proxy-hidden|Connecting to Unipi via Mervis Proxy]] tutorial.
  
-To display historic data in the SCADA control panel and the mobile app, the PLC must send data to the Mervis DB service. ​In this case, use identical login info for each PLC within ​single SCADA project. Again, Mervis DB login info can be found in the [[https://​www.unipi.technology/​getmervis|Customer portal]]. A more detailed explanation is available in the [[storing-data-to-mervis-db-hidden|Storing data to the Mervis DB]] tutorial.+To display historic data in the SCADA control panel and the mobile app, the PLC must send data to the Mervis DB service. ​Each PLC within single SCADA project ​can have specific Mervis DB credentials,​ but identical credentials for all PLCs can also be used. Again, Mervis DB login info can be found in the [[https://​www.unipi.technology/​getmervis|Customer portal]]. A more detailed explanation is available in the [[storing-data-to-mervis-db-hidden|Storing data to the Mervis DB]] tutorial.
  
  
Line 124: Line 155:
 The next step is to set the terminal’s properties to match those of the SCADA project we created in the customer portal. Open [[https://​www.unipi.technology/​customer/​scada/​|Customer portal]] and open detail of the previously created SCADA project. The next step is to set the terminal’s properties to match those of the SCADA project we created in the customer portal. Open [[https://​www.unipi.technology/​customer/​scada/​|Customer portal]] and open detail of the previously created SCADA project.
  
 +<​html><​div class="​directTag"​ id="​mervis-db-set"></​div></​html>​
 <​html><​span class="​kbBlueText">​Enter the following parameters into the properties of the parameters in Mervis IDE:</​span></​html>​ \\ <​html><​span class="​kbBlueText">​Enter the following parameters into the properties of the parameters in Mervis IDE:</​span></​html>​ \\
   * **Project ID:** copy the ID from the SCADA project detail   * **Project ID:** copy the ID from the SCADA project detail
Line 129: Line 161:
   * **Project Time Zone:** set the same timezone as you have set on the SCADA project   * **Project Time Zone:** set the same timezone as you have set on the SCADA project
   * **Project Domain:** copy the SCADA project domain   * **Project Domain:** copy the SCADA project domain
-  * **Mervis DB URL:** set to [[https://​db.unipi.technology/​dbaccess]] 
-  * **Mervis DB login and Mervis DB password:** enter the login and password entered in the PLC properties. 
  
-<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​12-mervis-scada-project-en.png)">​ +<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​12-mervis-scada-project-en_v240.png)">​ 
-<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​12-mervis-scada-project-en.png" />+<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​12-mervis-scada-project-en_v240.png" />
 </​figure></​html>​ </​figure></​html>​
  
 <​html><​span class="​kbBlueText">​Proceed to configure the individual controllers added to the terminal. In the SSCP Parameters section, edit the following properties:</​span></​html>​ \\ <​html><​span class="​kbBlueText">​Proceed to configure the individual controllers added to the terminal. In the SSCP Parameters section, edit the following properties:</​span></​html>​ \\
-  * set **HW configuration** to **Custom** ​+  * **End point:** change HW configuration ​to **Custom** ​
   * leave the device address on 1 (according to SSCP parameters settings in the PLC properties)   * leave the device address on 1 (according to SSCP parameters settings in the PLC properties)
   * if you left the login and password for the PLC unchanged, leave the default “user” and “rw”. You can confirm in the PLC properties by checking the Users Definition -> Username (Full Control) and Users Definition -> Password (Full Control)   * if you left the login and password for the PLC unchanged, leave the default “user” and “rw”. You can confirm in the PLC properties by checking the Users Definition -> Username (Full Control) and Users Definition -> Password (Full Control)
   * Enter the same **Proxy ID** as the one used in properties of the given PLC.  ​   * Enter the same **Proxy ID** as the one used in properties of the given PLC.  ​
 +
  
 <​html><​span class="​kbBlueText">​Continue with configuring the TCP Parameters. We recommend using the SSL secure connection. </​span></​html>​ \\ <​html><​span class="​kbBlueText">​Continue with configuring the TCP Parameters. We recommend using the SSL secure connection. </​span></​html>​ \\
-  * **Device ​Address:** proxy.unipi.technology  +  * **Device ​Hostname:** ''​proxy.unipi.technology''​ 
-  * **Port:** 12349+  * **Port:​** ​''​12349''​
   * **Enable SSL:** True   * **Enable SSL:** True
 +  * **Certificate Validation:​** set to FALSE
 +
 +/*
   * **Certificate Validation:​** set to FALSE by default, more info available at -> [[ssl-certification-validation-hidden|SSL Certification validity]]   * **Certificate Validation:​** set to FALSE by default, more info available at -> [[ssl-certification-validation-hidden|SSL Certification validity]]
 +*/
  
 +<WRAP center round tip 85%>
 +**Note:** you need to always use secured connection from Mervis IDE to the PLC. Chapter Securing the controller in [[en:​sw:​01-mervis:​creating-new-project-hidden#​securing_the_controller|this guide]] will guide you through the process.
 +</​WRAP>​
 +
 +<​html><​div class="​directTag"​ id="​plc-history-profile"></​div></​html>​
 +<​html><​span class="​kbBlueText">​Now you only need to set the PLC history profile.</​span></​html>​ \\
 +  * **Mervis DB URL:** set to [[https://​db.unipi.technology/​dbaccess]]
 +  * **Mervis DB User Name and Mervis DB Password:** enter the username and password entered in the PLC properties.
 +
 +/* FIXME - zveřejnit až bude hotový návod na který odkazuje
 More information about SSL is available at: [[using-secured-communication-ssl-hidden|Using secured communication SSL]] More information about SSL is available at: [[using-secured-communication-ssl-hidden|Using secured communication SSL]]
 +*/
  
-<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​13-mervis-scada-project-en.png)">​ +<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​13-mervis-scada-project-en_v240.png)">​ 
-<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​13-mervis-scada-project-en.png" />+<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​13-mervis-scada-project-en_v240.png" />
 </​figure></​html>​ </​figure></​html>​
  
Line 178: Line 224:
 </​figure></​html>​ </​figure></​html>​
  
 +To connect the table and the SCADA terminal, a terminal property is used. Look for the “Data Point table” item and choose the table you created. ​
 +
 +<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​27-mervis-scada-project-en.png)">​
 +<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​27-mervis-scada-project-en.png"​ />
 +</​figure></​html>​
 ==== 3.2 Import and properties of data points ==== ==== 3.2 Import and properties of data points ====
 To make a variable usable in the data point table, you need to configure it as such. For this step, we will use the **Variable browser**, in which you can select all variables you want to add to the table. Click on **For SCADA Import** in the right column of SCADA properties, and set it to True. To make a variable usable in the data point table, you need to configure it as such. For this step, we will use the **Variable browser**, in which you can select all variables you want to add to the table. Click on **For SCADA Import** in the right column of SCADA properties, and set it to True.
Line 191: Line 242:
 </​figure></​html>​ </​figure></​html>​
  
-For digital IOs (two or multiple state variables), you need to set up mapping, eg. how the variable value will be represented in Mervis SCADA. A variable can be represented either as a text or as a number. Click on three dots next to the **State Mapping**. ​+For digital IOs (two or multiple state variables), you can to set up mapping, eg. how the variable value will be represented in Mervis SCADA. A variable can be represented either as a text or as a number. Click on three dots next to the **State Mapping**. ​
  
 <​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​18-mervis-scada-project-en.png)">​ <​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​18-mervis-scada-project-en.png)">​
Line 242: Line 293:
  
 ==== 3.3 Adding data points into the Mervis DB ==== ==== 3.3 Adding data points into the Mervis DB ====
-After selecting and adding all data points into the table, ​select them all. +After adding all data points into the table, ​mark all datapoints belonging under one PLC
  
 <WRAP center round important 75%> <WRAP center round important 75%>
Line 248: Line 299:
 </​WRAP>​ </​WRAP>​
  
-<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​25-mervis-scada-project-en.png)">​ +<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​25-mervis-scada-project-en_ide240.png)">​ 
-<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​25-mervis-scada-project-en.png" />+<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​25-mervis-scada-project-en_ide240.png" />
 </​figure></​html>​ </​figure></​html>​
  
-Right-click on any of the highlighted itemsA context menu will appear. Select ​**Add to History**.+If you have only one PLC in this project, skip this paragraph and continue [[#add-to-history|adding to the history]]. If you have more than one PLC, click on the three dots {{:​files:​dialog-open_button.png?​nolink|}} next to the **Assigned history profiles** parameter. A window will open where you can assign the corresponding history profile, confirm with OK. Now mark the datapoints belonging to the next PLC and repeat the procedure
  
-<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​26-mervis-scada-project-en.png)">​ +<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​25a-mervis-scada-project-en_ide240.png)">​ 
-<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​26-mervis-scada-project-en.png" />+<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​25a-mervis-scada-project-en_ide240.png" />
 </​figure></​html>​ </​figure></​html>​
  
-Variables used by Mervis SCADA are now added into the [[storing-data-to-mervis-db-hidden|Mervis DB]]+<​html><​div class="​directTag"​ id="​add-to-history"></​div></​html>​ 
 +Next, select all data points and right-click on one of the selected items. A context menu will appear. Select **Add to History** 
  
-As Mervis SCADA reads variables from Mervis DB, you need to make sure the Mervis DB connection parameters in the PLC are set correctly+//**Note:** If you have multiple history logs, the datapoints can be sorted according to specific requirements,​ so the procedure may differ slightly.// 
  
-==== 3.4 Assigning a table to the terminal ====+<​html><​figure ondblclick="​redirectImg(this)"​ class="​zoom"​ onclick="​zoom(event)"​ style="​background-image:​ url(https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​26-mervis-scada-project-en_ide240.png)">​ 
 +<img src="​https://​kb.unipi.technology/​_media/​en:​sw:​01-mervis:​26-mervis-scada-project-en_ide240.png"​ /> 
 +</​figure></​html>​
  
 +Variables used by Mervis SCADA are now added into the [[storing-data-to-mervis-db-hidden|Mervis DB]]. 
 +
 +As Mervis SCADA reads variables from Mervis DB, you need to make sure the Mervis DB connection parameters in the PLC are set correctly. ​
  
 <WRAP center round info 90%> <WRAP center round info 90%>
Line 291: Line 348:
  
 <WRAP center round box> <WRAP center round box>
-The Mervis SCADA is now set. Go to the [[https://​scada.unipi.technology/​|scada.unipi.technology]] webpage and log in using the login info you [[#prvotni_nastaveni_mervis_scada|entered in Chapter 1]]+The Mervis SCADA is now set. Go to the [[https://​scada.unipi.technology/​|scada.unipi.technology]] webpage and log in using the login info you [[#introduction_into_the_mervis_scada|entered in Chapter 1]].
-If you want to **create a graphic template**, check out the  [[creating-scada-graphic-hidden|Creating a graphic HMI for Mervis SCADA]] tutorial and then return here+
 </​WRAP> ​ </​WRAP> ​
  
Line 301: Line 357:
 {{ :​en:​sw:​01-mervis:​31-mervis-scada-project-en.png?​nolink |}} {{ :​en:​sw:​01-mervis:​31-mervis-scada-project-en.png?​nolink |}}
  
-===== 5 Mervis SCADA web interface =====+===== 5 Creating a graphic scheme (HMI) for Mervis SCADA ===== 
 +If you want to **create a graphic template**, check out the  [[creating-scada-graphic-hidden|]] tutorial and then return here. 
 + 
 +===== 6 Mervis SCADA web interface =====
 The picture below depicts a web interface. This interface contains a single project (right column) and two data points (left column). ​ The picture below depicts a web interface. This interface contains a single project (right column) and two data points (left column). ​
  
Line 314: Line 373:
 </​figure></​html>​ </​figure></​html>​
  
-===== Mervis mobile app interface =====+===== Mervis mobile app interface =====
 {{ :​en:​sw:​01-mervis:​34-mervis-scada-project-en.png?​direct&​200|}} {{ :​en:​sw:​01-mervis:​34-mervis-scada-project-en.png?​direct&​200|}}
 [[https://​play.google.com/​store/​apps/​details?​id=cz.energocentrum.mervis|{{:​en:​sw:​01-mervis:​badge_new.png?​169}}]] ​   ​ [[https://​play.google.com/​store/​apps/​details?​id=cz.energocentrum.mervis|{{:​en:​sw:​01-mervis:​badge_new.png?​169}}]] ​   ​