Kaspersky Industrial CyberSecurity for Networks

File with descriptions of devices: devices.csv

March 22, 2024

ID 129118

The file with descriptions of devices contains an enumeration of devices, their types, and connection IDs. Connection ID in the device description file is specified in the connections description file and is used for linking protocols to the devices.

If you use different protocols with different sets of tags, you have to use several connections for one device. Connection IDs in each row of the devices.csv file have to be unique.

The file should begin with header strings containing the data needed for file processing. An example of header strings of the devices.csv file is provided below.

Example:

'Devices

'Format Version V1.0.0.0;KICS Importer Version V1.0.0.0

'Field separator: ; Decimal separator: . Text quotes: " Var name separator: .

'Device;Type;Connection

Header strings of the devices.csv file contain the following values:

  • Devices

    The name of the CSV file is specified in this string. Devices – the name of the device description file. The data file name corresponds to the file purpose and is defined for each file in the set.

  • Format Version;KICS Importer Version

    This string specifies the version of the file format and the version of the tool using which the file was created. Specify the value V1.0.0.0 for the parameter Format version. It is then recommended to specify the name and version of the tool that was used to create the CSV file.

  • Field separator: ; Decimal separator: . Text quotes: " Var name separator: .

    Use this string to specify the separators used in the data file:

    • Field separator: ;
    • Decimal separator: .
    • line terminator: Text quotes: "
    • field separator in tag name: Var name separator: .
  • Device;Type;Connection

    This string contains the names of columns with data. Data in the file should be arranged according to the following order of columns:

    • Device – device name.
    • Type – device type code. The following codes are used:
      • 0 – SIEMENS SIMATIC S7-300
      • 1 – SIEMENS SIMATIC S7-400
      • 2 – SCHNEIDER ELECTRIC MOMENTUM
      • 3 – SCHNEIDER ELECTRIC M340
      • 4 – MITSUBISHI SYSTEM Q
      • 5 – ALLEN-BRADLEY CONTROL LOGIX 5000
      • 6 – SIEMENS SIPROTEC
      • 7 – IEC 61850 GOOSE, MMS device
      • 8 – IEC 60870-5-104 device
      • 9 – ABB RELION 670
      • 10 – GENERAL ELECTRIC RX3I
      • 11 – SIEMENS SIMATIC S7-1500
      • 12 – IEC 61850 SAMPLED VALUES device
      • 13 – SIEMENS SIPROTEC 6MD66
      • 14 – SIEMENS SIPROTEC 7SS52
      • 15 – SIEMENS SIPROTEC 7UM62
      • 16 – SIEMENS SIPROTEC 7SA52
      • 17 – SIEMENS SIPROTEC 7SJ64
      • 18 – SIEMENS SIPROTEC 7UT63
      • 19 – GENERAL ELECTRIC MULTILIN B30
      • 20 – GENERAL ELECTRIC MULTILIN C60
      • 21 – EMERSON DELTAV
      • 22 – SCHNEIDER ELECTRIC M580
      • 23 – RELEMATIKA TOR 300
      • 24 – EKRA 200 series
      • 25 – EKRA BE2704 / BE2502
      • 26 – OMRON CJ2M
      • 27 – ABB AC 800M
      • 28 – YOKOGAWA CENTUM
      • 29 – CODESYS V3 based device
      • 30 – DNP3 device
      • 31 – OPC UA server
      • 32 – ABB AC 700F
      • 33 – SIEMENS SIMATIC S7-1200
      • 34 – OPC DA server
      • 35 – BECKHOFF CX series
      • 36 – PROSOFT-SYSTEMS REGUL R500
      • 37 – EMERSON CONTROLWAVE
      • 38 – IEC 60870-5-101 device
      • 39 – MOXA NPORT IA 5000 series
      • 40 – I/O device
      • 41 – ABB RELION REF615
      • 42 – SIEMENS SIMATIC S7-200
      • 43 – MODBUS TCP device
      • 44 – SCHNEIDER ELECTRIC SEPAM 80 NPP
      • 45 – YOKOGAWA PROSAFE-RS
      • 46 – SCHNEIDER ELECTRIC FOXBORO FCP280 / FCP270
      • 47 – HONEYWELL CONTROLEDGE 900 series
      • 48 – HONEYWELL EXPERION C300
      • 49 – SCHNEIDER ELECTRIC MICOM C264
      • 50 – UMAS device
      • 51 – TASE.2 server
      • 52 – PROFINET device
      • 53 – DIRECTLOGIC
      • 54 – Server with encryption support
      • 55 – BACNET device
      • 56 – SCHNEIDER ELECTRIC P545
      • 57 – YCU/ELC
      • 58 – FEU device
      • 59 – Generic IED
      • 60 – Generic Gateway
      • 61 – Generic PLC
      • 62 – VALMET DNA device
      • 63 – IPU device
      • 64 – OWEN PLC100 series
      • 65 – CODESYS V2 based device
      • 66 – PNU20 device
      • 67 – KNX device
      • 68 – DTS device
      • 69 – B&R
      • 70 – SIEMENS SICAM PAS server
    • Connection – connection ID from the connections.csv file containing a description of connections.

The header strings are followed by the file body containing the values of parameters (device name, device type code, connection ID). An example of the devices.csv file is provided below.

Example:

'Devices

'Format Version V1.0.0.0;KICS Importer Version V1.0.0.0

'Field separator: ; Decimal separator: . Text quotes: " Var name separator: .

'Device;Type;Connection

"ms_plc";4;"ms_plc"

"mc_SysQ";8;"mc_SysQ"

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.