Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

After having installed the NETx BMS Server, a new project called workspace has to be created. A workspace contains the whole configuration of a BMS server project. To do so, start the NETx BMS Studio and select the entry "New ..." within the "Workspace" menu.

Image RemovedImage Added 

Give the workspace a name (e.g. "Tutorial"). Afterwards, a new workspace is created and the NETx BMS Server is restarted.

...

Import the export file (.nxe) of your KNX installation into the NETx BMS Server using the entry "Import NETx ETS app file ..." within the menu "KNX" of the NETx BMS Studio.

Image RemovedImage Added 

Select "Replace current definitions" and step through the wizard. After having finished the import, stop the NETx BMS Server and start it again. Verify whether the KNX connection is working and whether you can control your KNX data points within the Item Tree of the NETx BMS Server.

Image RemovedImage Added

Creating a visualization project using the BMS Client Editor

The NETx BMS Server includes a web server that can be used to create web based visualizations. To create a new visualization project, right-click at the "Project Tree", select "New visualization project ..." and give the project a name.

Image RemovedImage Added 

Afterwards, the BMS Client Editor (BCE) starts. The BCE is a tool for designing and creating web based visualizations. As next, a user name and a password have to be chosen. Then, the new project is opened and an empty visualization page is shown.

...

Create a new page called "Master page". Within the configuration dialog, select the option "Is master page".

Image RemovedImage Added

Then place a "Back" button on the master page. In addition to create your own buttons, some predefined buttons are already provided within the library. Select "Library" from the object catalog, choose a color theme, and place a "Button-Back-Rect" button on the bottom left corner. Double-click the button, change to the "Object" tab and select "Go to page" as function. As "Linked page" select "Navigate back". Change to the "Position/Layer" tab, change the width and height to "70" and close the dialog.

...

Now the label shows the raw value of the data point. If the value is a 1 Byte KNX object defines as KNX DPT 5.010 (Value 1 UCount) or as EIS6, the value range is from 0 ... 255. To recalculate the value to 0% ... 100%, you can specific the scale factor "0,3922". If it is defined as KNX DPT 5.001 (Scaling), no scale factor is necessary since the BMS server is automatically recalculating the value to percentage as defined by the KNX standard. The following figure shown a group address within the BMS server which is calculated as DPT 5.001.

Image Added

In order to format it (e.g. limit the number of digits and adding a unit), a format string can be specified. The format string can be specified in the "Appearance" tab of the label configuration.  Here some useful text formats are listed:

...

For a detailed description see Annex A.1 of the manual of the BMS Client Editor (available via the menu "Help").

Image RemovedImage Added

Testing the visualization in a web browser or on your smart phone

...

Info
iconfalse

 http://<your IP>/<client name>

...

 

 

For iOS and Android, a dedicated app called NETx Touch is available. This app can be downloaded from iTunes or Google Play Store for free. After starting the app, the connection setting (IP address of the NETx BMS Server, BMS Client name, user name, password, ...) have to be entered. 

Please keep in mind that only one device can connect to a BMS Client definition at the same time. Therefore, you have to create a BMS Client definition for each device separatly (web browser, iOS or Android device). 

 

Related articles

Filter by label (Content by label)
showLabelsfalse
max5
spacesVOY50
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("voyager","visualization","bms-client") and type = "page" and space = "VOY50"
labelsvoyager bms-client visualization

...