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.
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
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
- 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). - Identify the GSDML currently installed in TIA Portal: Options → Manage general station description files (GSD) and look for
sinamics_g120s_vectorentries. - 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).
- 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
- Navigate to Siemens Industry Online Support and search for
SINAMICS G120 GSDMLor the specific entry ID23431435(the master "GSDML files for SINAMICS G120/G120S" entry). - Open the entry, expand the Downloads section. The page contains multiple GSDML files with dated hyperlinks.
- 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. - 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.
- Open the TIA Portal install media (or the corresponding TIA Updater download). HSPs for SINAMICS are bundled under
Support/HSP. - Locate
HSP_SinamicsG120_Vxxxx.zipmatching the G120 family. - Extract the archive. Legacy GSDML files are stored under
PROFINETsubfolders with their original dated filenames. - 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
- Open the existing drive project in the version of TIA Portal (or Startdrive) that originally commissioned the cabinet.
- Right-click the G120 device → Export GSDML. TIA Portal writes the GSDML used by the project into the export folder.
- 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.
Installing the Legacy GSDML in TIA Portal
- Close all open TIA Portal instances.
- Copy the legacy
.xmlfile into an empty working directory (e.g.,D:\gsdml\g120s_2014\). - Open TIA Portal → Options → Manage general station description files (GSD).
- Browse to the source directory and select the GSDML. Click Install.
- 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).
- 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.
- 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
p0922parameter.
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.
- Read the actual submodule layout from the drive via Webserver → PROFINET → Submodule list, or via STARTER / Startdrive online Diagnostics → Telegram configuration.
- Compare against the TIA Portal device view.
- Replace the device in the project with the legacy GSDML that matches the drive's actual telegram layout, or reconfigure the drive's
p0922to 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
- Compile the TIA Portal project; confirm zero warnings on the PROFINET IO system.
- Download the hardware configuration to the PLC.
- Connect the drive to the controller. In Online → Diagnostics → PROFINET, confirm the drive status is Data exchange, not Not connected or Configuration error.
- 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). - 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. - Run a 60-minute heat test with the drive under load to confirm there is no intermittent AR (Application Relationship) shutdown.
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.