Differences

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

--- en:sw:01-mervis:weintek-hmi-bacnet-mervis-hidden [2020/08/20 13:17]
avsetula
+++ en:sw:01-mervis:weintek-hmi-bacnet-mervis-hidden [2021/08/06 12:12] (current)
avsetula
@@ Line 2: / Line 2: @@
 <WRAP group 100%>
 <WRAP half column 81%>
-HMI panels are useful devices that can make control of various automation projects (boiler control, smart home control, industrial production control etc.) much easier. If you then need to connect HMI panel to the Mervis IDE, you can do so using the BACnet protocol over LAN.
+If you need to connect the Mervis IDE and the HMI display using a local network, you can use the BACnet protocol. For your project, you can use the HMI, in this case, the Weintek touchscreen HMI display, for system control, production control, boiler control, home control, etc.
 </WRAP>
 <WRAP half column 15%>
 ;;#
-<html><span class="dev-tag dev-axon">Axon</span></html> \\
+<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-unipi11">Unipi&nbsp1.1</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>
-In this tutorial, we will show you how to set up a BACnet server, how to connect a client to this server and how to generate a variable list (EDE file).
+In the following tutorial, you will learn how to set up a BACnet server, how to connect to the server with a client, or how to generate a list of variables (.EDE file).
+The result of this tutorial is to show the PLC inputs as controls on the HMI display and to control the PLC digital outputs directly from the HMI display.
 === About BACnet ===
   * The protocol uses Client-Server model
   * The client access data via server-side objects (A/D values, trend logs etc.)
+\\
-===== Things you will need: =====
+<WRAP center round box>
+<html><span class="kbBlue-H4alt">Prerequisites:</span></html>
   * [[https://www.unipi.technology/axon-c20|Unipi PLC]] with Mervis OS v2.2.0 or newer
-  * [[https://www.unipi.technology/power-supplies-c15|24V DC power supply]] for the Unipi PLC
+  * [[https://www.unipi.technology/power-supplies-c15|24 V⎓ power supply]] for the Unipi PLC
   * Local network connectivity (switch or router)
   * 2× RJ45 network cable
   * [[https://www.weintek.com/globalw/Download/Download.aspx|EasyBuilder PRO]] program (also contains a simulator)
   * [[https://www.unipi.technology/hmi-devices-c29|Weintek HMI display]] with Ethernet, or Weintek HMI simulator
-    * + 24 V DC power supply for the HMI display
+    * + 24 V⎓ power supply for the HMI display
     * + 1× network patch (RJ45) cable for the HMI display
-== Useful additional info: ==
+\\
+<html><span class="kbBlueText">Useful additional info:</span></html>
   * Creating a [[en:sw:01-mervis:creating-new-project-hidden|new project in the Mervis IDE]]
   * [[https://sourceforge.net/projects/yetanotherbacnetexplorer/|Yet Another BACnet Explorer]] (YABE) – a software to access BACnet network
   * [[en:sw:01-mervis:weintek-ip-series-hidden|A Modbus guide for connecting the HMI to a Unipi]] PLC with Mervis OS
   * Mervis OS update guide for [[en:sw:01-mervis:running-on-axon-hidden|Axon]] / [[en:sw:01-mervis:running-on-neuron-hidden|Neuron & Unipi 1.1]] and latest [[files:software:mervis:00-start|Mervis IDE installer]]
+</WRAP>
+\\
 == Connection example: ==
 {{ :en:sw:01-mervis:weintek_hmi_bacnet.png?nolink |}}
 ===== 1 Basic Mervis IDE settings =====
 Create a new Mervis IDE project or open an already existing project. Follow the following guide:
-\\
 Create a server channel by right-clicking on PLC and choosing <html><span class="avBlueText">Add Server Channel</span></html>. Name the new channel <html><span class="avOrangeText">BACnet_server</span></html>.
 {{ :en:sw:01-mervis:001_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 Select the newly created <html><span class="avOrangeText">BACnet_server</span></html> and set the protocol type to <html><span class="avBlueText">BACnetServer</span></html>.
 {{ :en:sw:01-mervis:002_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 Right-click on the <html><span class="avOrangeText">BACnet_server</span> <span class="avBlueText">server channel</span></html> and choose <html><span class="avBlueText">Add Server Device</span></html>.
 {{ :en:sw:01-mervis:003_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 Name the newly created device <html><span class="avOrangeText">BACnet_UDP</span><html>. Select the device and set the same parameters in <html><span class="avBlueText">Properties</span></html> in as following:
-  * **Device instance:** 1 (1 - 4 194 302, unique within the network)
+  * **Device instance:** 1 (1-4194302, unique within the network)
   * **Management Password:** //set your password//
   * **IP Address:** 0.0.0.0
   * **Device Port:** 47808
 {{ :en:sw:01-mervis:004_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 We are almost done now. Click on <html><span class="avBlueText">Build Solution</span></html>.
 {{ :en:sw:01-mervis:005_weintek-hmi-mervis-_bacnet_en.png |}}
 ===== 2 Variables, mapping and linking =====
 Next step is to create <html><span class="avBlueText">BACnet objects</span></html> and link them to a local or global variable. This step is very important to allow the client to read or write to variables. There are 2 ways to do this:
-\\
 //**Note:** It is possible to link unused variables to BACnet objects. However, Mervis IDE will warn you that server variables could not be loaded, and that image could not be created. The reason is the variable is not used for compilation and the BACnet object thus does not have any variable to link to.//
 {{page>weintek-hmi-bacnet-mervis-imgnexttotext-hidden}}
 ==== 2.1 Variables, mapping and linking ====
 Click on the <html><span class="avOrangeText">BACnet_UDP</span></html> device and then right-click into the blank space. A pop-up menu will appear – choose <html><span class="avBlueText">Add Variable</span></html>.
 {{ :en:sw:01-mervis:006_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 A drop-down variable list will appear. Choose a variable you wish to read or write to via the Weintek HMI.
 {{ :en:sw:01-mervis:007_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 A BACnet server variable will become available. Click on <html><span class="avBlueText">Build Solution</span></html> in order to generate BACnet object parameters (identifier, type, etc…) – until now, these were displayed only as <html><span class="avBlueText">n/a</span></html>.
 {{ :en:sw:01-mervis:008_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 The result should look like this. You now have your first <html><span class="avBlueText">BACnet object</span></html> including its ID.
 {{ :en:sw:01-mervis:009_weintek-hmi-mervis-_bacnet_en.png |}}
 \\
 ==== 2.2 The alternative way: directly through the Variable Browser ====
 In the <html><span class="avBlueText">Variable Browser</span></html> look up the variable you want to make available for the BACnet server to read from/write to, and check the <html><span class="avBlueText">PLC:BACnet visible</span></html> checkbox.
 {{ :en:sw:01-mervis:010_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 A drop-down menu will appear. In <html><span class="avBlueText">PLC: BACnet Device</span></html>, choose the BACnet device you want to make the variable available for. In our case the tab will be pre-filled with <html><span class="avOrangeText">BACnet_UDP</span></html>. Check the following picture for reference:
 {{ :en:sw:01-mervis:011_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 If you now click on the <html><span class="avOrangeText">BACnet_UDP</span></html> device, the Mervis IDE should display all previously selected objects.
 {{ :en:sw:01-mervis:012_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 Now click on <html><span class="avBlueText">Build Solution</span></html>. By doing so the BACnet object parameters will update and new parameters will be generated.
 {{ :en:sw:01-mervis:013_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 The result for adding two objects should look like this:
 {{ :en:sw:01-mervis:014_weintek-hmi-mervis-_bacnet_en.png |}}
-\\
 You can now deploy the solution by clicking on <html><span class="avBlueText">Deploy Solution</span></html>. All changes you made will be uploaded into the PLC.
 {{ :en:sw:01-mervis:015_weintek-hmi-mervis-_bacnet_en.png |}}
 \\
 ===== 3 EDE file export (optional step) =====
 <html><span class="avBlueText">EDE files</span></html> are useful if your BACnet client is unable to automatically detect objects on the BACnet server, or if you want to set up client device without access to BACnet server.
 \\
-\\
 Right-click on <html><span class="avOrangeText">BACnet_server</span></html> and choose <html><span class="avBlueText">Export EDE file</span></html>.
-\\
 You will need these files to import the variable settings into the client, so the display will know which variables it should read or write to. Any exported EDE files can be found in the <html><span class="avBlueText">/“<i>Project_Name</i>“/export</span></html> subfolder.
 {{ :en:sw:01-mervis:016_weintek-hmi-mervis-_bacnet_en.png |}}
 == Examples of exported EDE files: ==
 {{:en:sw:01-mervis:screenshot_1.png?370|}}
 \\
 ===== 4 EasyBuilder PRO settings, simulator/HMI download =====
 Download, install and run the <html><span class="avBlueText">EasyBuilder PRO</span></html> software tool.
 {{:en:sw:01-mervis:001_weintek-hmi-easybuilder-bacnet.png?400|}}
 \\
-\\
 Create a new project for your HMI display model. If you don’t have the HMI display, you can choose the MT6071iP/MT8071iP as on the picture below.
 {{ :en:sw:01-mervis:002_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Upon creating the new project, a <span class="avBlueText">System Parameter Settings</span></html> will appear. Click on <html><span class="avBlueText">New device/server</span></html>.
 {{ :en:sw:01-mervis:003_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 A new window with several additional settings will appear. Enter the following parameters:
   * **Name:** BACnet/IP (Device)
@@ Line 130: / Line 149: @@
 Now click on the <html><span class="avBlueText">Settings...</span></html> button.
 {{ :en:sw:01-mervis:004_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 In this tab you can set up the IP address either manually, or you can click on <html><span class="avBlueText">Who Is…</span></html> and the server will be found and set up automatically. The standard BACnet port is 47808 – if you selected a different port in Mervis IDE, you need to change the BACnet port here as well.
 \\
-\\
 **Caution:** Make sure that no other application is listening on the same port on your PC. If it would listen on the same port, the <html><span class="avBlueText">Who Is…</span></html> option would be unable to find any servers and the simulation would not communicate with the BACnet server.
 {{ :en:sw:01-mervis:005_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Confirm all changes and click on the newly created <html><span class="avBlueText">BACnet/IP</span></html> tab. Then click on <html><span class="avBlueText">Tag Manager…</span></html>.
 {{ :en:sw:01-mervis:007_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Now click on <html><span class="avBlueText">Get Tag Info…</span></html> to automatically download objects from the BACnet server (Mervis). If the variable info cannot be downloaded, please check if the port is not already used.
 {{ :en:sw:01-mervis:008_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Select BACnet objects you wish to use – in our case select everything. Confirm all changes and close the settings window:
 {{ :en:sw:01-mervis:009_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 You should now see an empty HMI window which is used to insert various graphics elements.
 {{ :en:sw:01-mervis:010_weintek-hmi-easybuilder-bacnet.png |}}
-\\
-Let’s test it by creating a single <html><span class="avBlueText">Toggle Switch</span></html> and a single <html><span class="avBlueText">Bit Lamp</span><html> The Tag tab serves for object mapping..
+Let’s test it by creating a single <html><span class="avBlueText">Toggle Switch</span></html> and a single <html><span class="avBlueText">Bit Lamp</span></html> The Tag tab serves for object mapping..
 {{ :en:sw:01-mervis:011_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 In the list you can see objects available on the Unipi PLC. Please choose a DO for Toggle Switch. Then look up the <html><span class="avBlueText">hw_$Axon S105_DO_1_01_w$</span></html> object and select <html><span class="avBlueText">PresentValue</span></html>.
 {{ :en:sw:01-mervis:012_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 For <html><span class="avBlueText">Bit lamp</span></html> choose one of the <html><span class="avBlueText">DI</span></html> variables.
-\\
 Look up the <html><span class="avBlueText">hw_$Axon S105_DO_1_01_w$</span></html> object and select <html><span class="avBlueText">PresentValue</span></html>.
 {{ :en:sw:01-mervis:013_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 The result should look like this.
 Note the displayed info about which BACnet object is linked to the graphics element.
 {{ :en:sw:01-mervis:014_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Now click on <html><span class="avBlueText">Compile</span></html>.
 {{ :en:sw:01-mervis:015_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Upon compilation you can now either load the HMI project into the HMI display, or you can start the simulator.
   * If you have HMI display, click on <html><span class="avBlueText">Download (PC -> HMI)</span></html>
@@ Line 173: / Line 192: @@
 **Note:** The <html><span class="avBlueText">Offline simulation</span></html> option cannot be used, as the simulation would not be able to connect to the PLC.
 {{ :en:sw:01-mervis:016_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 ===== 5 Result =====
 Now check the HMI or the simulation. You can see that the state of <html><span class="avBlueText">DI1</span></html> is being displayed on the <html><span class="avBlueText">Bit lamp</span></html> object which glows blue when the DI is active. Also, by clicking on the <html><span class="avBlueText">Toggle switch</span></html>, you can switch the value of <html><span class="avBlueText">DO1</span></html>.
 {{ :en:sw:01-mervis:017_weintek-hmi-easybuilder-bacnet.png |}}
-\\
 Check the PLC’s LED indicators. If you followed all steps and the communication is running OK, states of DI1 and DO1 on the PLC presented by the LEDs will correspond to the states on the HMI/simulation.
-\\
 \\
 {{ :en:sw:01-mervis:unipi_axons105_di1_do1.png?direct&300 |}}
 ===== Downloads =====
   * {{ :en:sw:01-mervis:ebpro_manual.pdf |Weintek EasyBuilder Pro complete manual}}