...
For the integration of meter readings in from the GridVis software a plugin is available and can be installed on the following NETx Systems:
- NETx BMS Platform
- NETx Multi Protocol Server (MP Server)
- NETx BMS Server 2.
...
- 0
Online meter readings will be read via the GridVis REST WEB API (https://gridvis-energy.de/rest/doc/).
...
For systems already running with a purchased BMS NETx license, the plugin has to be activated within the existing BMS this license.
Configuration
The configuration of the GridVis plugin is has to be done in the NETx BMS the NETx Studio. After installing the plugin successfully a new menu item GridVis appears in the menu bar of the NETx BMS Studio.
The GridVis menu contains 4 menu items:
...
| Info |
|---|
Before starting the explorer the NETx BMS Server has to be stopped. |
...
- on the left hand side: Available data points found by an online scan of the GridVis server.
- on the right hand side: Data points configured in the BMS serverNETx Server.
Server management
The drop down list shows configured GridVis servers.
| Button | Description |
|---|---|
| Add ... | Add a new GridVis |
| server configuration | |
| Modify ... | Modify the selected GridVis |
| server configuration | |
| Delete | Delete the selected GridVis |
| server configuration |
After selecting a server configuration the section "Current Configuration" will show the configured data points.
...
| Warning | ||
|---|---|---|
| ||
When deleting a GridVis Server server configuration all related data points will be deleted too. |
...
When selecting a project or a device all sub nodes will be selected too - the unselect works analog.
Click the Add button Add to copy the selected data points to the configuration of the BMS ServerNETx Server. A polling interval has to be defined how often the GridVis server is going to read the selected data points.
...
After defining the polling interval the user has to confirm to save the data points. After starting the NETx BMS Servers The NETx Server has to be restarted to make the new added data points will be available.
In the section on the right hand side the data points of the selected GridVis server appear - when changing the server, the list will update automatically.
...
The user can filter for projects, devices and data points.
| Button | Function |
|---|---|
| Change polling | Change the polling interval. |
| Delete | Deletes selected data points from the current configuratio. When a project or a device was deleted also the sub nodes will be removed. |
The user has to confirm for saving the changes. Changes in the list of data points will show effect after starting the NETx BMS Serversthe NETx Server.
Server- and data point definitionen
All definition data will be are stored in DAT files in the Workspace of the NETx BMS Servers in DAT filesthe NETx Server. Both definitions can be shown or changed in BMS in NETx Studio GridVis > Server definitions or GridVis > Data point definitions.
...
| Info |
|---|
Both configuration files "xio.GridVis.ServerDefinitions.dat" and "xio.GridVis.DatapointDefinitions.dat") are stored in the folder "DataFiles" of the current Workspace. The "DataFiles" folder can be found in C:\Program Files (x86)\NETxAutomation\NETx.BMS.Server.2.0<NETx product>\Workspaces\<workspacename>\DataFiles |
The configuration files can be edited directly without GridVis Explorer - but in this case there is no verification of the data. In NETx BMS Server Studio the definition data can be exported to / imported from Excel. This is helpful when a lot of data have to be changed (e.g. polling interval).
Server definitions
| Column | Description |
|---|---|
| Server name | Unique, mandatory name identifying the GridVis server within the NETx |
| Server. | |
| URL | Defines the URL of the GridVis server (e.g. https://192.168.0.1) |
Data point definitions
| Column | Description |
|---|---|
Server name | Defines the GridVis Server name of the assigned data point. The GridVis Server name has to be defined in advance in the server definitions. |
| Project name | Project name of the GridVis data point. |
| Device ID | Device ID of the GridVis data point. |
| Device name [] | Optional name of the device, shown in combination with the Device ID. |
| Value | Correnspons to the "Value" Tag of the GridVis data point. |
| Type | Correnspons to the "Type" Tag of the GridVis data point. |
| Unit[] | Unit of the data point. The unit will be set automatically during scan by the GridVis Explorer. |
| Polling Interval | Defines how often the GridVis Server reads a data point (in seconds). |
Driver configuration
Global settings can be done here.
| Column | Description |
|---|---|
| Timeout | Value in ms, used as parameter when reading a GridVis value. |
| Timeliness | Value in ms, used as parameter when reading a GridVis value. |
| Ignore item quality | When set to active (checked), unseccessful HTTP requests will NOT set the data point to "UNCERTAIN" in |
| NETx Server. The last valid value will stay visible. | |
| Ignore NaN values | When set to active (checked), received "NaN" values will be ignored. This means that a "NaN" value will not set the data item to "UNCERTAIN" in |
| NETx Server. The last valid value will stay visible. | |
| HTTP Timeout (ms) | Value in ms, used HTTP requests. |
| Info |
|---|
Changes in the driver configuration will be immediately effective without restarting the server. |
...
| Info |
|---|
The configuration file ("xio.GridVis.cfg") is stored in the folder "ConfigFiles" of the current workspace. The folder "ConfigFiles" can be found in C:\Program Files (x86)\NETxAutomation\NETx.BMS.Server.2.0<NETx product>\Workspaces\<workspacename>\ConfigFiles |
Visualization of data points in NETx
...
Server
After doing a correct configuration configuring correctly, the GridVis data points will be are available as Server Items in NETx BMS Serverin the NETx Server. An overview of all available Server Items is shown in the Item Tree in NETx BMS Studio.
All GridVis data points will appear in the sub tree "NETx\XIO\GridVis" in a structured way and grouped by GridVis server, project and device id.
...
- OPC DA: All Server Items are available as OPC Items via OPC DA.
- OPC UA: In addition to "classical" OPC DA NETx BMS Server has an OPC UA interface. This interface has to be installed with the Extension Manager in BMS in NETx Studio > Extensions > Manager > Start Excension Manager.
- oBIX: Is an open, standardized web interface for home and building automation. This interface has to be installed with the Extension Manager in BMS in NETx Studio > Extensions > Manager > Start Excension Manager.
- BACnet: Server Items can be read as BACnet objects from BACnet clients via BACnet/IP.
...