Integrating an IEE Occupancy Tool Adapter

Scenario: You want to configure Desigo CC to operate on the IEE Occupancy Tool system.

 

Reference: For background information, see IEE Occupancy Tool.

 

Workflow diagram:

 

 

Prerequisites:

  • The IEE Occupancy Tool extension is installed and included in the active project. The following extension is also selected automatically.
    • SORIS Driver
  • The IEE Occupancy Tool adapter is running and connected to the IEE Occupancy Tool system. For instructions, see Installing and Configuring the IEE Occupancy Tool Adapter.
  • System Manager is in Engineering mode.
  • System Browser is in Management View.

 

Steps:

1 – Create the SORIS Driver
  1. Depending on where the driver will run, select one of the following:
  • Project > Management System > Servers > Main Server > Drivers
  • Project > Management System > FEPs > [FEP station] > [drivers folder]
    NOTE:
    If the drivers folder is not available, to create it select the FEP station and click New .
  1. In the Object Configurator tab, click New and select New SORIS Driver.
  1. In the New object dialog box, enter a description and click OK.
  • The newly created SORIS driver is added to System Browser, but not started.

NOTE: In the SORIS tab, in the Polling threads field, you can specify the value for the polling volume. It is recommended to use the default value 75.

SORIS Driver Polling Threads

 

2 – Create the SORIS Network
  1. Select Project > Field Networks.
  1. In the Object Configurator tab, click New and select New SORIS Network.
  1. In the New Object dialog box, enter a name and description, and click OK.
  • The newly created SORIS network is added to System Browser.

 

3 – Associate a Driver to the SORIS Network
  1. Select Project > Field Networks > [SORIS network].
  1. In the SORIS tab, open the Network Settings expander.
  1. From the Monitored by driver drop-down list, select the driver.
  1. Click Save .
Linking the Network to the Driver

 

4 – Start the SORIS Driver

The status of a newly created driver is Stopped. To be able to connect, the driver must be started.

  1. Depending on where the driver runs, select one of the following:
  • Project > Management System > Servers > Main Server > Drivers > [SORIS driver]
  • Project > Management System > FEPs > [FEP station] > [drivers folder] > [SORIS driver]
  1. In the Extended Operation tab, click Start.

 

5 – Create an IEE Occupancy Tool Adapter Under the Network
  1. Select Project > Field Networks > [SORIS network].
  1. In the Object Configurator tab, click New .
  1. In the New Object dialog box, enter a name and description, and click OK.
  • The newly created adapter is added to System Browser. The adapter starts automatically as a Windows service.
  1. Select the newly created adapter and click the SORIS tab.
  1. In the ULR field, enter the IP address of the computer from which the network adapter is run using the following format: https://<IP address>:<port number>, for example: https://192.169.7.200:8080.
  • In the Operation tab, the Online property indicates Connected and the property URL displays the IP address configured.
    NOTE: The connection requires that the adapter was started as a service (see Installing and Configuring the IEE Occupancy Tool Adapter) or launching the Siemens.Gms.IEEOccupancyToolAdapter.exe file.
IEE Occupancy Tool Adapter Configuration

 

6 – Discover IEE Occupancy Tool Adapter Basic Objects
  1. Select Project > Field Networks > [SORIS network] > [IEE Occupancy Tool adapter].
  • In the Extended Operation tab, the Online property indicates Connected while the Discovery Status property indicates Idle.
  1. Next to the URL property, click Discover.
  • Under the IEE Occupancy Tool Adapter node, System Browser displays the imported objects (Zones and Sensors).