Multiscan Configuration (CSV) File

To integrate Multiscan++ or Galileo control panels into Desigo CC you must first prepare a textual configuration file in CSV (comma separated values) format that defines the data structure for the panel.

To do this, use Microsoft Excel or a text editor to edit the configuration file.
NOTE: Use a comma (,) as separator.

You can then use this file to import the configuration.

For reference information about the Modbus configuration CSV file, see CSV File for Modbus Device Import.

To obtain pre-configured CSV sample files to edit, contact the Technical Support team.

Pre-configured sample files can be used to create custom configuration files by removing unwanted gas detectors and relays according to the specific configuration.

info

Do not change the IDs already configured since they are fixed in the Modbus interface. Therefore, each detector or relay allocates its own fixed Modbus register.

To have the panel data imported and its diagnostic provided, the panel rows must not be deleted.

 

Also, pre-configured sample files provide examples for function mapping in the first four detector lines of each sample file. These can be useful when adding new points and starting from an example of an existing point type included in the CSV file with functions defined. The following functions are currently available:

info

Multiscan++ function mapping samples

For the Multiscan++ control panel types, in addition to the first four detector lines which are for the internal detectors, pre-configured sample files provide four function mapping samples for the first four detectors connected to the loop.

 

Additionally, since the device points are imported into Management View as a flat list, pre-configured sample files also provide a predefined logical view that can be used for the configuration required on the field site.

As for the logical view, pre-configured sample files can be also modified to automatically create a user-defined view out of the import. This part is not provided in pre-configured CSV files because user views strictly depend on the customer’s requirements that can be easily added.

Multiscan++/Galileo Configuration File Sections

Section

Description

[Connections]

Communication channels between Multiscan and Desigo CC. 1 interface for each device must be defined.

[Devices]

Galileo or Mutliscan++ control panels.

[Points]

Physical points.

Multiscan++/Galileo Connections Data

The [Connections] section comprises the following data:

Data

Description

[ConnectionName]

Interface name. Special characters are not allowed.

[ConnectionDescription]

Interface description to display in System Browser.

[SlaveId]

Galileo or Mutliscan++ Modbus subordinate address.

[IP_Address]

Interface IP address.

[Port]

TCP Modbus port. Default value: 502.

[Alias]

Not used.

[FunctionName]

Not used.

[Discipline ID]

Not used.

[Subdiscipline ID]

Not used.

[Type ID]

Not used.

[Subtype ID]

Not used.

Connections Section (When Not Used Fields Are Collapsed)
Connections Section (When Not Used Fields Are Collapsed)

Multiscan++/Galileo Devices Data

The [Devices] section comprises the following data:

Data

Description

[ParentConnectionName]

Name of the interface assigned to this device.

[DeviceName]

Device name.

[DeviceDescription]

Device description to display in System Browser.

[ObjectModel]

Not used.

[Alias]

Not used.

[Function Name]

Not used.

[Discipline ID]

Not used.

[Subdiscipline ID]

Not used.

[Type ID]

Not used.

[Subtype ID]

Not used.

[LogicalHierarchy]

Used to create a hierarchy in the logical view.

[UserHierarchy]

Used to create a hierarchy in the user-defined view.

Multiscan++ Devices Section (When Not Used Fields Are Collapsed)
Multiscan++ Devices Section (When Not Used Fields Are Collapsed)
Galileo Devices Section (When Not Used Fields Are Collapsed)
Galileo Devices Section (When Not Used Fields Are Collapsed)

Multiscan++/Galileo Points Data

The [Points] section comprises the following data:

Data

Description

[ParentDeviceName]

Name of the device to which the point is connected.

[Name]

Point name. Special characters are not allowed.

[Description]

Point description to display in System Browser.

[FunctionCode]

Not used.

[Offset]

Used in combination with the import rules table to achieve the correct value of the register.

For more information about the rules that apply to the different Multiscan CSV configuration files, see below.

[SubIndex]

Not used.

[DataType]

Not used.

[Direction]

Defines the address/response mode used for accessing the value on the Modbus server:

  • Input: Data must be read from the Modbus server.
  • Output:. Data must be written to the Modbus server.

To read back an output item, a Modbus InOut point must be created.

In this specific case (Multiscan ++ and Galileo panels) this field is always set to “I” in the CSV files. Anyway, during the import it is automatically set by the system because this association is defined in the import rules of this extension.

[Object Model]

Name of the object model linked to this point.

Multiscan++ panel

  • Panel: GMS_MODBUS_Multiscan_Panel_150
  • Detectors: GMS_MODBUS_Multiscan_Detector_150
  • Relays: GMS_MODBUS_Multiscan_Relay_150
  • Park Panel: GMS_MODBUS_Multiscan_ParkPanel_150

 

Galileo panel

  • Panel: GMS_MODBUS_Galileo_Panel_150
  • Detectors: GMS_MODBUS_Galileo_Detector_150
  • Relays: GMS_MODBUS_Galileo_Relay_150

[Property]

Not used.

[Alias]

Not used.

[Function]

“Function name” used to automatically associate the function (for example, “Multiscan_CO2Detection_150”) to the point instance during the import of the CSV file.
This field is optional. Leave it blank if no function should be assigned during the import.

[Discipline ID]

Not used.

[Subdiscipline ID]

Not used.

[Type ID]

Not used.

[Subtype ID]

Not used.

[Min]

Not used.

[Max]

Not used.

[MinRaw]

Not used.

[MaxRaw]

Not used.

[MinEng]

Not used.

[MaxEng]

Not used.

[Resolution]

Not used.

[Eng Unit]

Not used.

[StateText]

Not used.

[AlarmClass]

Not used.

[AlarmType]

Not used.

[AlarmValue]

Not used.

[EventText]

Not used.

[NormalText]

Not used.

[UpperHysteresis]

Not used.

[LowerHysteresis]

Not used.

[LogicalHierarchy]

Used to create a hierarchy in the Logical View.

[UserHierarchy]

Used to create a hierarchy in the User-Defined View.

Multiscan++ Points Section (When Not Used Fields Are Collapsed)
Multiscan++ Points Section (When Not Used Fields Are Collapsed)
Galileo Points Section (When Not Used Fields Are Collapsed)
Galileo Points Section (When Not Used Fields Are Collapsed)

Rules for Multiscan ++ with RIO Detectors

Rules for Multiscan ++ with 485 detectors

Rules for Multiscan Galileo

Rules for Multiscan Galileo IDI detectors