Installing and Configuring the Helvar Lighting Adapter

You can install the adapter software service on any networked PC that can connect to the Helvar Lighting system and to Desigo CC.
Typically, you can install it on the Desigo CC server station.

  1. After installation, the HelvarLighting_Adapter.msi installer package is available in AddSW folder of the EM.
  2. You have exported the Helvar Lighting configuration from the Designer tool into a CSV file. For example, Device_Report.CSV.
  1. Run HelvarLighting_Adapter.msi.
    Follow the wizard instructions to complete the installation.
  2. Copy the CSV file to the adapter folder
    (by default C:\Program Files (x86)\Siemens\Helvar Adapter).
  3. In the installation folder, edit and verify the Config.json file:
    • In ClusterIpAddress, enter the IP address of the Helvar Lighting system.
    • The ClusterIpPort default (50000) is typically correct. You may need to change it for special network requirements.
    • In DeviceReportFileName, enter the CSV file name.
    • Do not modify DeviceReportVersion and DeviceTypesFileName.
    • The default PollingTime is 10 sec. You may need to adjust this setting to speed up or slow down the update frequency based on the network performance and system size. A higher value will result in a slower refresh of the management system status, and vice versa a smaller value will speed it up. Test carefully high-frequency settings (very low values) that may result in data refresh failures (shown as #COM status in the Desigo CC property values).
      The following is an example of Config.json file:
      {
      "ClusterIpAddress": "192.169.7.93",
      "ClusterIpPort": 50000,
      "DeviceReportFileName": "Device_Report.csv",
      "DeviceReportVersion": 4,
      "DeviceTypesFileName": "DeviceTypes.json",
      “PollingTime”: 10
      }
  4. From the installation folder, run one of the following batch files:
    • Install_AdapterAsService_HTTP, to run the HTTP service on port 8080
    • Install_AdapterAsService_HTTPS, to run the HTTPS service on port 443
  5. The adapter service starts with the new configuration.
    NOTE: you can run Uninstall_AdapterAsService.bat to stop the service.
info

The use of HTTPS protocol is strongly recommended to ensure a secure communication over public networks. Failing to use HTTPS increases the vulnerability to cyberattacks when using an open or badly secured network.

info

After the upgrade of this extension, the adapter must be manually upgraded by running the adapter MSI file, and then selecting the upgrade option.

info

For more details about certificates, in SORIS, see Secure Communication.