Defining GSD based Devices/Modules - References - SIMATIC AX - AX Hardware Engineering documentation - Hardware Engineering,

Hardware Engineering reference

Portfolio
SIMATIC AX
Product
SIMATIC AX
Software version
3.0.0
Edition
08/2025
Language
English (original)
Package Name
@ax/hw-docs

To configure a device based on a GSD file, the module's TypeIdentifier must contain the GsdId of the device and its GSD file name (FileName).

Devices:
  - Name: CentralStation
    Modules:
      - Name: Controller
        TypeIdentifier:
          OrderNumber: 6ES7 516-3AN01-0AB0
          Version: V2.9
        AccessProtection:
          AccessLevel: NoAccess
        Interfaces:
          - Label: X1
            Name: Interface1
            Addresses:
              Configured:
                - IPv4: 192.168.0.1/24

  - Name: ET200SP
    Modules:
      - Name: InterfaceModule
        TypeIdentifier:
          FileName: GSDML-V2.43-Siemens-ET200SP-20240726.XML
          GsdId: DIM ST V3.3
        Interfaces:
          - Label: X1
            Name: Interface1
            Addresses:
              Configured:
                - IPv4: 192.168.0.5/24
      - Name: DQ8x24VDC
        TypeIdentifier:
          GsdId: "DQ 8x24VDC/0,5A HF" #This value can be easily found via. 'get-supported-devices' command.
          FileName: GSDML-V2.43-Siemens-ET200SP-20240726.XML
        IoConfiguration:
          OutputAddress: "12"
        Parameters:
          RecordDataList:
            - Index: 243
              RawValue: "0x01000000" #Light base module
      - Name: DI8x24VDC
        TypeIdentifier:
          GsdId: "DI 8x24VDC HF V2.0, MSI"
          FileName: GSDML-V2.43-Siemens-ET200SP-20240726.XML
        IoConfiguration:
          InputAddress: "21"
        Parameters:
          RecordDataList:
            - Index: 243
              RawValue: "0x00000000" #Dark base module
      - Name: ServerModule
        TypeIdentifier:
          GsdId: Servermodule_without_io
          FileName: GSDML-V2.43-Siemens-ET200SP-20240726.XML

IoSystems:
  - Name: IoSystem
    ControllerInterfaces:
      - Ref: CentralStation/Controller/Interface1
    DeviceInterfaces:
      - Ref: ET200SP/InterfaceModule/Interface1
        Parameters:
          PnWatchdogFactor: 4

Note

When using modules based on GSD files, all modules and submodules in a device must be based on the same GSD file.

Combining modules based on different GSD files or combining modules based on GSD files with modules identified by order number is not possible.