Integrating SecuriFire Modbus System

Scenario: You want to configure Desigo CC to connect to a SecuriFire panel through the Modbus protocol.

 

Reference: For background information, see SecuriFire System Through Modbus.

 

Workflow diagram:

 

 

  • The Securiton SecuriFire extension module is installed and included in the active project. The following extension is also selected automatically:
    • Fire Domain Libraries Common

 

Steps:

1 – Create the Configuration File

To integrate a SecuriFire panel into Desigo CC, you must first create a configuration (CSV) file that defines the data for the panel that you want to integrate. Then you can use the CSV file to import the configuration. You can create the CSV file in one of the following ways:

  • Convert the XML configuration file from SecuriFire.
  • Configure a CSV file manually starting from a template. See SecuriFire Modbus Configuration (CSV) File.
    NOTE: You can also convert the XML file and then customize the CSV output to add a hierarchical structure.

Convert the XML Configuration File from SecuriFire

  • The SecuriFire XML configuration file is available on the local disk or over the network.
  • You copied the SecuriFire_CSV_Converter file on the local disk or over the network. The tool is available in the AdditionalSW folder of the software distribution kit.
  1. In the DefaultFiles subfolder, copy the template file _Template_for_SecuriFireCSV.csv into a new CSV file. Choose a filename that includes the name of the SecuriFire panel to import.
  1. Start the XML conversion tool CSVTool.exe.
  1. In the tool window, browse and select the XLS file and then the new CSV file.
    NOTE: Do not select the CSV template file.
  • In a few seconds, the CSV file is populated with data extracted from the XML file.

 

2 – Create the Modbus 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 Modbus Driver.
  1. In the New object dialog box, enter a description and click OK.
    NOTE: To avoid difficulties and mistakes in choosing the driver in multi-selection lists, do not use the same description on the Desigo CC server and FEP stations.
  • The newly created Modbus driver is added to System Browser, but not started.
3 – Create the Modbus Network
  1. Select Project > Field Networks.
  1. In the Object Configurator tab, click New and select New Modbus Network.
  1. In the New Object dialog box, enter a name and description, and click OK.
  • The newly created Modbus network is added to System Browser.

 

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

 

5 – Start the Modbus Driver

The status of a newly created driver is Stopped. To be able to connect, the driver must be started with either Start or Start Conf…

  1. Select Project > Management System > Servers > Main Server > Drivers > [Modbus driver].
  1. In the Extended Operation tab, click Start.
    NOTE: Only for configuration purposes, you can also click Start Conf… to activate the driver without establishing any real connection to the field.

 

6 – Import the Configuration File

Scenario: You are configuring Desigo CC to connect to a SecuriFire panel, and now you want to import the device configuration data from a CSV file into the SecuriFire network.

  • To speed configuration, make sure the Desigo CC Transaction Mode is set to Simple or the Automatic Switch of Transaction Mode is set to True.
    The automatic switch setting is recommended. Without it, to re-enable the logs, you need to set the Transaction Mode to Logging at the end of the configuration procedure.
  1. Select Project > Field Networks > [SecuriFire network].
  1. In the Import tab, click Browse.
  1. In the Open dialog box, do the following:
    a. Navigate to and select the device configuration file (CSV).
    b. Click Open.
  • By default data structures are imported into Management View.
  1. (Optional) To check the pre-import log, click Analysis Log.
  • The Analysis Log dialog box displays its outcome that you can also save in a .txt file.
  1. (Optional) In the Hierarchies Mapping expander, define destination in other system views of the data structures (hierarchies contained in the configuration file). The suggested field indicates the correct view root to link for each specific hierarchy. To assign each hierarchy to a destination view, proceed as follows:
    a. Select the Manual Navigation check box to retain the Import tab.
    b. In System Browser, select the optional view (logical view or user-defined view).
    c. Drag the optional view root node from the System Browser tree to the suggested field.
    NOTE: The hierarchies mapping configuration cannot be modified after the import of the configuration file. For general background information about the Desigo CC import feature and Desigo CC views, see Field Data Import and Views.
  • The hierarchies settings configured are activated and will be applied during the configuration import.
    NOTE: If you configure the hierarchies mapping, and the [Logical Hierarchy] and [User Hierarchy] fields are not defined in the CSV configuration file, data structures will not be imported into the logical view and user-defined view.
  1. To transfer the interfaces to import from the Source Items list to the Items to Import, click .
  1. (Optional) Select the Delete unselected items from the Views check box to remove from the views—during the import—any items that are not present in the file to import.
  1. Click Import.
  • The Import tab displays the Import in progress page.
  • The Cancel button becomes available and allows you to stop the procedure at any time. In this case, a summary of the partial results is provided.
    NOTE: No rollback function is available. This means that canceling the import may result in an inconsistent state of the system database.
  • When the import completes, the imported configuration data structures are added to System Browser.
  1. (Optional) To view a summary of the import, click Import Log.
  • The Import Log dialog box displays its outcome that you can also save in a .txt file.

 

7 – Modify the Communication Settings for SecuriFire

When integrating a SecuriFire panel, after the import of the configuration file, you can modify the communication settings (TCP port and IP address) of the communication interface.

  • System Manager is in Engineering mode.
  1. In System Browser, select Management View.
  1. Select Project > Field Networks > [SecuriFire network] > [SecuriFire interface].
  1. In the Modbus tab, open the Communication Interface expander.
  1. Modify the values in the fields TCP port or IP address.
  1. Click Save .
Communication Settings of the Interface