discover command - Manual - DCP Utility - Documentation for the SIMATIC AX DCP Utility tool. - DCP Utility,

DCP Utility CLI Tool (dcp-utility)

Portfolio
SIMATIC AX
Product
DCP Utility
Software version
1.1.2
Edition
04/2024
Language
English (original)
Package Name
@ax/dcp-utility-docs
apax dcp-utility discover [options]

Outputs a list of devices discovered on the network interface provided.

If the device has a non-PROFINET-compliant name (see 'set-name'), it is decoded using IDNs

WARNING

Name decoding supports various languages but, based on YAML formatting specifications (https://yaml.org/spec/1.2.2/#51-character-set), non-printable characters will not be translated and are escaped.

Emojis are a good example of this. '😁' - is translated as "\U0001F601" in YAML format.

Options

  • --source-mac – The MAC address of the host network interface (REQUIRED)
  • -o, --output-file – The output file to save Discovery results
  • -f, --format – The output format
  • --timeout – The timeout in milliseconds to capture (Default 3000, maximum is 60 000)
  • -?|-h|--help – Show help information
  • Output:
[
    {
      "Name": "localplc.profinet-interface1",
      "IP": "192.168.0.2",
      "Subnet": "255.255.255.0",
      "Gateway": "192.168.0.2",
      "Family": "S7-1500 (PLCSIM)",
      "MAC": "C0:A8:XX:XX:XX:XX"
    },
    {
      "Name": "physicalplc.profinetinterface1",
      "IP": "192.168.0.1",
      "Subnet": "255.255.255.0",
      "Gateway": "192.168.0.1",
      "Family": "S7-1500",
      "MAC": "64:17:XX:XX:XX:XX"
    }
]