SINAMICS G120 PROFINET GSDML: Finding Legacy Versions

David Krause11 min read
SiemensTIA PortalTutorial / How-to
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

Overview

When commissioning a SINAMICS G120 (or G120S) drive that ships with older PROFINET firmware, the GSDML file shipped with the current TIA Portal (for example, the 2020-era GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml revision) is often the only version that matches the drive's slot structure, submodule layout, and telegram definitions. Installing a newer GSDML — such as the 2020 refresh that the Siemens Online Support portal pushes by default — typically produces configuration mismatches, telegram errors, or outright rejection by the controller during device replacement or topology comparison.

This article documents the field-proven path for retrieving, validating, and installing legacy SINAMICS G120 PROFINET GSDML files, including the GSDML-V2.3-20140313 revision, while preserving configuration parity with the drive firmware already in the cabinet.

Engineering rule of thumb: The GSDML date stamp (YYYYMMDD) and the GSDML specification version (V2.3, V2.4, V2.45) are independent. A 2020 GSDML can still be V2.3, and a 2014 GSDML can be V2.3. Match the device module definition, not just the spec version.

GSDML File Naming Convention

Siemens publishes SINAMICS G120 GSDML files using the standard PI (PROFIBUS International) naming scheme:

Field Meaning Example
GSDML Prefix indicating a GSD file for PROFINET (XML format) GSDML
V2.3 PROFINET GSDML specification version (per PI) V2.3
sinamics Vendor short name (Siemens AG) sinamics
sinamics_g120s_vector Device family and functional profile sinamics_g120s_vector
20140313 File release date YYYYMMDD 20140313 (2014-03-13)
.xml File extension (XML, not binary GSD) .xml

Other variants you will encounter on Siemens support pages for the G120 family include:

  • GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml — V4.x firmware era, vector control
  • GSDML-V2.3-sinamics-sinamics_g120s_vector-20160614.xml — V4.7 firmware, extended telegram 350/352 support
  • GSDML-V2.4-sinamics-sinamics_g120s_vector-20190116.xml — V4.7 SP3 / V5.0 transition
  • GSDML-V2.45-sinamics-sinamics_g120s_vector-20200615.xml — 2020 release matching TIA Portal V16/V17
Always open the GSDML in a text editor and confirm the <DeviceID> and <VendorID> tags match the drive. Siemens VendorID is 0x002A (42 decimal). The G120S DeviceID is registered in the file header.

GSDML Specification Versions vs. Drive Firmware

The PROFINET GSDML specification evolves independently from SINAMICS firmware. A drive running firmware V4.5 SP3 (for example) can be described by a GSDML-V2.3 file dated 2014, or by a GSDML-V2.45 file dated 2020. The drive itself does not care which GSDML version the controller uses, as long as the configured submodules (telegrams, diagnostics, I/O slots) match the drive's parameter set (p0922, p2079).

SINAMICS G120 Firmware Released Compatible GSDML (typical) PROFINET Spec
V4.4 2013-09 GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml V2.3
V4.5 / V4.5 SP3 2014-05 / 2015-09 GSDML-V2.3-sinamics-...-20140313.xml V2.3
V4.6 2016-01 GSDML-V2.3-sinamics-...-20160614.xml V2.3
V4.7 / V4.7 SP3 2017-06 / 2019-04 GSDML-V2.3 / V2.4-sinamics-...-20190116.xml V2.3 / V2.4
V5.0 / V5.1 2019-10 / 2021-02 GSDML-V2.45-sinamics-...-20200615.xml V2.45

The GSDML specification itself is maintained by PROFIBUS International (PI) and is available as a paid download from the PI GSDML specification page. Understanding the spec version helps when third-party controllers reject the GSDML on import (see the B&R example below).

Prerequisites

  1. Know the SINAMICS G120 control unit type (CU240E PN, CU240S PN, CU250S PN, etc.) and the firmware version installed. Read this from r0018 (firmware version) on the drive, or from the operator panel (BOP-2 / IOP).
  2. Identify the GSDML currently installed in TIA Portal: Options → Manage general station description files (GSD) and look for sinamics_g120s_vector entries.
  3. Confirm the target TIA Portal version (V13, V14, V15, V15.1, V16, V17, V18). Newer TIA Portal versions can import older GSDML files, but older TIA Portal versions may reject newer GSDML files (e.g., TIA V15 cannot import a GSDML-V2.45).
  4. Note the slot/telegram configuration already in the cabinet: standard telegram 1, 2, 3, 5, 6, 7, 9, 20, 350, 352, or free telegram configuration via p0922.

Locating Legacy GSDML Files on Siemens Support

Siemens no longer maintains a separate "legacy GSDML" archive — they ship only the current release. To obtain older revisions such as the 2014-03-13 GSDML, use the following ordered method.

Method 1 — Siemens Online Support Entry List

  1. Navigate to Siemens Industry Online Support and search for SINAMICS G120 GSDML or the specific entry ID 23431435 (the master "GSDML files for SINAMICS G120/G120S" entry).
  2. Open the entry, expand the Downloads section. The page contains multiple GSDML files with dated hyperlinks.
  3. Right-click the older filename (e.g., GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml) and use Save link as. The download name may be auto-rewritten with a counter; the file content is identical.
  4. If the 2014-03-13 file has been superseded and removed from the entry, proceed to Method 2.

Method 2 — TIA Portal Hardware Support Package (HSP) Archives

Older TIA Portal versions install GSDML files as part of the HSP package. These packages are retained in the TIA Portal installation media and in the Siemens Automation License Manager / TIA Administrator cache.

  1. Open the TIA Portal install media (or the corresponding TIA Updater download). HSPs for SINAMICS are bundled under Support/HSP.
  2. Locate HSP_SinamicsG120_Vxxxx.zip matching the G120 family.
  3. Extract the archive. Legacy GSDML files are stored under PROFINET subfolders with their original dated filenames.
  4. The TIA Portal install path on a populated engineering workstation also caches the imported GSDML files at: C:\Program Files\Siemens\Automation\Portal V[ver]\Data\HspDB\Public\Sinamics. Recover the file from the cached HSP database, not from the user project.

Method 3 — TIA Updater / Automation Tool

The TIA Updater (formerly "TIA Portal Updater") packages are cumulative. For example, TIA Updater 3 for V15.1 contains every HSP released through that date. After running the updater, GSDML files back to ~2012 are stored locally in the updater cache at:

C:\Users\<user>\AppData\Local\Siemens\TIAUpdater\Updates

Search the cache for sinamics_g120s_vector; copy out the dated file you need.

Method 4 — SINAMICS Startdrive Project Migration

  1. Open the existing drive project in the version of TIA Portal (or Startdrive) that originally commissioned the cabinet.
  2. Right-click the G120 device → Export GSDML. TIA Portal writes the GSDML used by the project into the export folder.
  3. This is the most reliable way to obtain the exact GSDML revision the cabinet was built with, since it bypasses any Siemens-side file update.
If you are retrieving a GSDML from a colleague's project that uses an older TIA Portal version, have the colleague open the project and use Project → Export to external storage → Include GSDML/GSD. This is the only clean way to ship both the project and the GSDML together.

Installing the Legacy GSDML in TIA Portal

  1. Close all open TIA Portal instances.
  2. Copy the legacy .xml file into an empty working directory (e.g., D:\gsdml\g120s_2014\).
  3. Open TIA Portal → Options → Manage general station description files (GSD).
  4. Browse to the source directory and select the GSDML. Click Install.
  5. Confirm the version string in the installed GSDML list. TIA Portal will show both the spec version (V2.3) and the release date (2014-03-13).
  6. Reopen the project; the device catalog will now list SINAMICS G120S Vector — GSDML V2.3 (2014-03-13) under Other field devices → PROFINET IO → Drives → Siemens AG → SINAMICS.
  7. Replace the existing G120 device in the project. Do not use device replacement if the slot configuration is identical; instead, manually verify the slot assignment matches the drive's p0922 parameter.
If TIA Portal reports "GSD file is for a more recent TIA Portal version," the GSDML spec (V2.45) is too new for your TIA version. Conversely, if the error reads "GSD file is for a different device family," the VendorID or DeviceID inside the XML is wrong — re-download from the source entry.

Verifying Firmware and GSDML Compatibility

After installing the legacy GSDML, perform these checks before going online with the drive.

Check Where to verify Pass criterion
GSDML VendorID == 0x002A Open GSDML in editor, search <VendorID> 42 (decimal)
GSDML DeviceID matches CU type Search <DeviceID> Compare to r0090 on the drive
Slot 1 = standard telegram Device view → Slot 1 Matches p0922 value on drive
Slot 0 = DAP Device view → Slot 0 Empty / DAP submodule
Module 2 / 3 = supplementary telegrams Device view → Slot 2, 3 Same telegram numbers as drive's p2079
Diagnostic module present Device view → Slot 4 (typical) PROFINET diagnostics module is enabled

Common Errors and Resolutions

Error: "GSDML file version is not supported" (B&R X20BC00E3)

When integrating a SINAMICS G120 into a B&R X20 PLC (such as the X20BC00E3 PROFINET bus controller), the controller may reject a GSDML that is technically valid for Siemens tooling. The B&R community knowledge base documents that the error text "GSDML file version is not supported" is raised when the PROFINET stack on the controller does not recognize the GSDML specification version number inside the XML header.

For the X20BC00E3 firmware (typical pre-V2.45):

  • V2.3 GSDML → accepted
  • V2.4 GSDML → accepted
  • V2.45 GSDML → rejected, "GSDML file version is not supported"

Resolution: install the GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml revision (or any GSDML that carries the V2.3 spec tag) on the engineering workstation before exporting the bus configuration to the B&R controller. The drive firmware itself does not need to be changed.

Error: "Configuration fault — submodule does not match"

This is the most common symptom of a mismatched GSDML revision. The drive drops from PROFINET exchange within seconds of the controller going RUN.

  1. Read the actual submodule layout from the drive via Webserver → PROFINET → Submodule list, or via STARTER / Startdrive online Diagnostics → Telegram configuration.
  2. Compare against the TIA Portal device view.
  3. Replace the device in the project with the legacy GSDML that matches the drive's actual telegram layout, or reconfigure the drive's p0922 to match a newer GSDML.

Error: "Device has been replaced — different module"

When you download the new project to a PLC that already has the G120 in its AR (Application Relationship), the PLC will report a device-replacement fault. Clear it by either powering-cycle the drive, or by performing PLC → Online → Accessible nodes → Reset AR from the controller side. Always back up the drive parameters (p0971 = 1 for RAM copy to ROM) before this operation.

Field-Proven Verification Steps

  1. Compile the TIA Portal project; confirm zero warnings on the PROFINET IO system.
  2. Download the hardware configuration to the PLC.
  3. Connect the drive to the controller. In Online → Diagnostics → PROFINET, confirm the drive status is Data exchange, not Not connected or Configuration error.
  4. In the drive's Diagnostics → Telegram diagnostics, verify that the cycle time and watchdog match the PLC's PROFINET update time (typically 1 ms for G120). Mismatch produces fault F08501 (PROFINET communication error).
  5. Read the drive's r2050[0..7] (process data words received from PLC) and verify the control word 1 (STW1) cycles correctly when you toggle bits from the PLC.
  6. Run a 60-minute heat test with the drive under load to confirm there is no intermittent AR (Application Relationship) shutdown.
Safety: If the drive is part of a safety-integrated application (SINAMICS G120 with CU250S-2 PN Safety or CU240E-2 PN F), the GSDML revision affects the PROFIsafe channel layout (slot 5, PROFIsafe submodule). Always cross-check the F-Host GSDML (or the F-CPU's PROFIsafe configuration) against the drive's safety slot assignment before energizing the machine. A mismatched safety GSDML can prevent safety acknowledgment or, worse, defeat a stop function.

Notes on PROFINET Conformance Class

The SINAMICS G120S PROFINET interface is certified to Conformance Class C (CC-C), which requires support of PROFINET IRT (Isochronous Real-Time) with the Fast Forwarding (FF) standard. The GSDML-V2.3-20140313 file does support CC-C, but only when the controller is also configured for IRT. If the controller defaults to RT (Real-Time, not isochronous), the drive will fall back to RT, and the cycle time jitter increases — often acceptable for V/f drives but problematic for vector control loops.

FAQ

Where can I download the GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml file?

The original 2014-03-13 GSDML is no longer on the top of the Siemens Online Support entry list. Recover it from a TIA Portal install media HSP cache, the TIA Updater archive, or by exporting the GSDML from a colleague's existing drive project via Project → Export GSDML. Siemens Entry ID 23431435 hosts the current and prior SINAMICS G120 GSDML files.

Why does my TIA Portal reject the older GSDML as "too old"?

Modern TIA Portal versions (V17, V18) accept GSDML V2.3, V2.4, and V2.45 equally. The reverse error "GSD file is for a more recent TIA Portal version" appears when you try to import a GSDML-V2.45 file into TIA V13/V14. There is no minimum GSDML age restriction on current TIA Portal releases.

Will the drive firmware need to be updated if I install a new GSDML?

No. The drive firmware and the GSDML are independent. The drive's PROFINET stack interprets whatever submodule configuration the controller sends. As long as the configured telegrams (p0922) match the GSDML's slot layout, firmware and GSDML revisions are orthogonal. A V4.4 drive can be commissioned with a 2020 GSDML if the telegram assignment is identical.

What causes the "GSDML file version is not supported" error on B&R X20BC00E3 controllers?

The controller's PROFINET stack does not recognize the GSDML spec version (V2.45) embedded in the XML. The X20BC00E3 ships with a stack that supports up to GSDML spec V2.4. Install the GSDML-V2.3-sinamics-sinamics_g120s_vector-20140313.xml (or any V2.3/V2.4 GSDML) on the engineering workstation before exporting the bus configuration to the controller. Refer to the B&R KB article for the firmware matrix.

How do I know which GSDML revision my existing drive project uses?

In TIA Portal, open the project, select the G120 device in the Device view, and open the Properties → General → Identification pane. The exact GSDML filename, spec version, and release date are listed there. The same data can be extracted by opening the project file's underlying XML and searching for gsdml_file_name in the device section.

Back to blog