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.

Weitere Informationen zur Modbus-Konfigurationsdatei (CSV) finden Sie unter CSV-Datei für den Import von Modbus-Geräten.

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.

 

Da die Gerätepunkte als flache Liste in die Managementsicht importiert werden, bieten die vorkonfigurierten Beispieldateien zudem eine vordefinierte technische Sicht, die für die vor Ort erforderliche Konfiguration verwendet werden kann.

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

Der Abschnitt [Connections] ist wie folgt zusammengesetzt:

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

Der Abschnitt [Devices] ist wie folgt zusammengesetzt:

Daten

Beschreibung

[ParentConnectionName]

Name der diesem Gerät zugeordneten Schnittstelle.

[DeviceName]

Gerätename.

[DeviceDescription]

Die Gerätebeschreibung, die im System Browser angezeigt werden soll.

[ObjectModel]

Nicht verwendet.

[Alias]

Nicht verwendet.

[Function Name]

Nicht verwendet.

[Discipline ID]

Nicht verwendet.

[Subdiscipline ID]

Nicht verwendet.

[Type ID]

Nicht verwendet.

[Subtype ID]

Nicht verwendet.

[LogicalHierarchy]

Zur Erstellung einer Hierarchie in der Technischen Sicht.

[UserHierarchy]

Zur Erstellung einer Hierarchie in der Betreibersicht.

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

Der Abschnitt [Points] ist wie folgt zusammengesetzt:

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