SINAMICS G120 GSD File Installation in STEP 7 HWConfig

David Krause14 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

The SINAMICS G120 modular drive family (Control Units CU230P-2, CU240B-2, CU240E-2, CU250S-2) requires a PROFIBUS GSD file (for DP slaves) or a PROFINET GSDML file (for IO devices) before the inverter appears in the STEP 7 hardware catalog. After the file is loaded, the drive is reachable only by drilling into a specific catalog path that varies by STEP 7 version and by the bus protocol. Engineers who only look at the top-level SINAMICS folder will not find the G120 and conclude the installation failed, when in fact the device is simply located under Additional Field Devices > Drives > SINAMICS on PROFIBUS or under Drives > SINAMICS on PROFINET.

This reference covers the full sequence: identifying the correct file revision, installing it in STEP 7 V5.4 through V5.6 and in TIA Portal V13 through V17, navigating to the G120 in the hardware catalog, configuring the standard telegram, and verifying the configuration with STARTER or Startdrive. It also documents the fallback method of copying GSD data from the Control Unit's CompactFlash (CF) card at \SIEMENS\SINAMICS\DATA\CFG\ when the offline installer is unavailable.

Prerequisites

Before installing the GSD or GSDML file, confirm the following:

  • STEP 7 V5.4 SPx or later for PROFIBUS GSD, or STEP 7 V5.5 SP2 and the matching GSDML Hotfix (HF-HSP) for PROFINET GSDML Rev. 2 devices.
  • TIA Portal V13 SP1 minimum for current SINAMICS G120 PROFINET integration; TIA Portal V15, V16, or V17 with the latest Hardware Support Package (HSP) is recommended for firmware V4.7 SP6 and later. The current SINAMICS G120 HSP for TIA Portal V17 is available through the TIA Updater (article ID 72341852).
  • Administrative rights on the engineering station so that the GSD/GSDML copy utility can write to %ProgramFiles%\Siemens\Automation\S7\...\S7GSDAX\ and the hardware catalog database.
  • The Control Unit's article number (e.g. 6SL3244-0BB00-1BA1 for a CU240B-2 DP) and firmware version (read with the IOP, BOP-2, or the inverter's r0018 parameter) to select a matching GSD/GSDML revision.
  • STARTER V5.1 SP1 minimum (for STEP 7 V5.4) or Startdrive V13 SP1 minimum (for TIA Portal) for offline parameterization and online commissioning.
Note: A GSD or GSDML file is bound to a Control Unit firmware version. Using a file for firmware V4.7 against a CU running V4.4 causes the IO controller to reject the device during configuration, typically with PROFINET error code 0x001E ("Module diff") or PROFIBUS diagnosis PRS / PRSE. Always match the file revision to the firmware shown on the CU's display or in r0018.

GSD versus GSDML: File Types and Selection

The naming convention differs by bus protocol and by the file generator version. The following table summarizes the file families and where they are used.

Bus File type Filename pattern STEP 7 tool Catalog root
PROFIBUS DP GSD (ASCII) SI0xxxxx.GSD HW Config > Options > Install GSD File PROFIBUS DP > Additional Field Devices > Drives > SINAMICS
PROFINET IO GSDML (XML) GSDML-Vx.x-Siemens-SinamicsG120PN-YYYYMMDD.xml HW Config > Options > Install GSDML File PROFINET IO > Drives > SINAMICS > GSD
PROFINET IO (legacy) GSDML-V2.0 gsdml-v2.0-siemens-sinamicsg120prof-20080514.xml STEP 7 V5.5 SP2 + HF-HSP PROFINET IO > Drives > SINAMICS

Siemens publishes GSDML files for the G120 in two parallel streams: the PROFIsafe-capable PROFINET profile (filename contains SinamicsG120PN) and the legacy PROFIdrive-only profile (filename contains SinamicsG120PROF). The PROFIsafe variant is required when the CU240E-2 F or CU250S-2 F is wired for STO/SS1 via PROFIsafe slot 30.

Downloading the Correct GSD/GSDML File

Always source the device description from the official Siemens Industry Online Support. Two article IDs cover the full G120 device family:

Both entries are continuously updated, so the article header shows the latest published build (for example, "G120 GSD V4.7.13, 2024-05-22"). For the older PROFINET profile, the public mirror at gsdml-v2.0-siemens-sinamicsg120prof-20080514.xml is sometimes the only remaining copy of legacy V2.0 descriptions when used for archive or migration projects. The Siemens-published file should still be preferred for new installations.

Inside the download ZIP, the directory layout is standardized:

G120_GSD_V4.7.13/
  |- SI0280B6.GSD       (PROFIBUS, G120 CU240B-2)
  |- SI0280E6.GSD       (PROFIBUS, G120 CU240E-2)
  |- SI0380B6.GSD       (PROFIBUS, G120 CU250S-2)
  |- GSDML-V2.32-Siemens-SinamicsG120PN-20240315.xml
  |- GSDML-V2.32-Siemens-SinamicsG120PN-20240315.bmp
  |- Readme.txt

Installing the GSD in STEP 7 V5.x HWConfig

  1. Extract the ZIP to a local folder, e.g. D:\Siemens\G120_GSD\. The file extension determines which installer to use: *.GSD for PROFIBUS, *.GSDML for PROFINET.
  2. Open SIMATIC Manager and load the STEP 7 project containing (or destined to contain) the SINAMICS G120 station.
  3. Open HW Config for the station. Confirm the catalog on the right side shows the standard folder structure.
  4. Choose Options > Install GSD File for a PROFIBUS GSD, or Options > Install GSDML File for a PROFINET GSDML.
  5. Browse to the folder from step 1, select the file, and click Install. The tool copies the file to the STEP 7 catalog path and registers it in S7GSDLDX.DLL / S7GSDAX.DLL.
  6. Close and re-open HW Config. The catalog is rebuilt from disk on the next launch.
Common pitfall: If you only re-open the catalog pane (View > Catalog) without restarting HW Config, the new device may not appear. Force a full refresh with Options > Update Catalog.

Installing the GSDML in TIA Portal

  1. Extract the GSDML to a local folder. Confirm the file name matches the project hardware; e.g. GSDML-V2.32-Siemens-SinamicsG120PN-20240315.xml.
  2. Open the TIA Portal project and switch to the Device View or Network View.
  3. Choose Options > Manage general station description files (GSD).
  4. Browse to the folder, select the GSDML, and click Install. TIA Portal parses the XML and registers the device in the Devices & Networks hardware catalog.
  5. Close the dialog. The SINAMICS G120 appears under Other field devices > Drives > SINAMICS.

For multi-firmware projects, install several GSDML revisions side by side. TIA Portal sorts them by version; the highest matching revision is offered by default when dragging a device. Use Options > Manage GSD files > Details to confirm which revision is bound to a specific instance.

Locating the SINAMICS G120 in the Hardware Catalog

This is the step that traps most first-time users. After installation, the SINAMICS G120 is not under the top-level SINAMICS folder in the catalog. The exact path depends on the bus type:

Bus Catalog path in HW Config Visible after
PROFIBUS DP PROFIBUS DP > Additional Field Devices > Drives > SINAMICS > SINAMICS G120 STEP 7 V5.4 SP5 or later
PROFINET IO PROFINET IO > Drives > SINAMICS > GSD STEP 7 V5.5 SP2 with HF-HSP or TIA Portal V13 SP1+
PROFINET IO (legacy) PROFINET IO > Drives > SINAMICS > G120 STEP 7 V5.5 SP2 with GSDML V2.0 hotfix
PROFIBUS DP (TIA) Other field devices > Drives > SINAMICS > SINAMICS G120 TIA Portal V13 SP1+

Within SINAMICS G120, the catalog is sub-divided by Control Unit. Each CU is its own GSD entry:

  • SINAMICS G120 CU230P-2 DP / PN (article numbers 6SL3243-0BB30-..., -0BB31-...)
  • SINAMICS G120 CU240B-2 DP / PN (6SL3244-0BB00-1BA1, 6SL3244-0BB10-1BA1)
  • SINAMICS G120 CU240E-2 DP-F / PN-F (6SL3244-0BB12-1BA1, 6SL3244-0BB13-1BA1)
  • SINAMICS G120 CU250S-2 DP / PN (6SL3246-0BA22-...)

Drag the correct CU to the PROFIBUS or PROFINET line. The address is assigned automatically or can be set in the device properties (typical DP address 3..6 for a single-drive cell).

Alternative: Extracting the GSD from the CF Card

When the engineering station has no internet access and the GSD ZIP is not available, the device description can be copied directly from the CompactFlash card shipped with the Control Unit. The SINAMICS G120 stores every supported GSD and GSDML under the standard Siemens directory:

\SIEMENS\SINAMICS\DATA\CFG\
  |- SI0280B6.GSD
  |- SI0280E6.GSD
  |- GSDML-V2.x-Siemens-SinamicsG120PN-YYYYMMDD.xml
  |- *.bmp

To use this method:

  1. Power down the CU and remove the CF card.
  2. Insert the card into a CF reader on the engineering station. Windows assigns a drive letter, for example E:\.
  3. Browse to E:\SIEMENS\SINAMICS\DATA\CFG\.
  4. Copy the file matching the connected CU to a local staging folder, e.g. D:\G120_GSD\.
  5. Follow the standard install procedure from step 4 of the STEP 7 V5.x instructions above.
Important: The CF card files correspond to the firmware version that was flashed on the drive at the factory. Reinstalling a different firmware updates the contents of \SIEMENS\SINAMICS\DATA\CFG\ only if the new firmware's Firmware Update job writes the matching GSD bundle. Otherwise the file on the CF card will lag behind the running firmware and the catalog will show a mismatched device.

Configuring the Standard Telegram

Once the G120 is placed on the bus, open its slot configuration. For PROFIdrive integration the default slot 1 is the standard telegram; the available telegrams for the G120 are:

Telegram PZD setpoint / actual Typical use CU support
1 2 / 2 Standard speed control with ramp generator All G120 CUs
2 4 / 4 Speed control with basic positioning (CU250S-2) CU250S-2
3 9 / 9 Speed control with torque limit and 2 encoder words CU240E-2, CU250S-2
4 6 / 14 Speed control with extended status and MAV CU250S-2
5 9 / 9 Speed control with DSC and 2 encoders CU250S-2
6 10 / 10 Speed/temperature channel CU240E-2, CU250S-2
20 2 / 6 Standard speed control, VIK-NAMUR profile All G120 CUs
350 4 / 4 Standard with free mapping CU240E-2, CU250S-2
352 6 / 6 Standard with 16-bit speed setpoint, PCS 7 APL All G120 CUs
353 2 / 2 Standard with PKW channel for PCS 7 All G120 CUs
999 Free / Free User-defined BICO interconnect CU240E-2, CU250S-2

For a basic speed-controlled drive, leave the default telegram 1. For PCS 7 APL library blocks (FB 31, FB 32, FB 35) select telegram 352 or 353. After selecting, compile the station and download the HW Config. The PLC CPU configures the CU on next start-up, and the G120 boots into the chosen telegram within ~3 s.

Troubleshooting Matrix

Symptom Probable cause Diagnostic Remedy
Drive does not appear under SINAMICS in HW Config GSD not actually copied to STEP 7 catalog folder Check %ProgramFiles%\Siemens\Automation\S7\...\S7GSDAX\ for the file Re-run Options > Install GSD File, then Options > Update Catalog
PROFINET IO controller reports F01910 (PROFINET IO communication failure) GSDML revision does not match the firmware on the CU Read r0018 on the drive; compare with GSDML file header Install the GSDML that matches the firmware, or upgrade the CU firmware to match the project
CU fails to start PROFIsafe (F01611, F30611) Wrong GSDML profile (legacy SinamicsG120PROF instead of SinamicsG120PN) Check slot 30 in the device view Install the SinamicsG120PN GSDML that includes the PROFIsafe subslot
Diagnostic buffer: "Module diff at slot 1" Telegram length changed after first download Compare telegram config in HW Config vs STARTER online Recompile HW Config, download, restart CU
TIA Portal shows two identical G120 entries Two GSDML versions installed Options > Manage GSD files Uninstall the older revision unless required for legacy devices
STARTER cannot go online (timeout) PN device name not assigned PROFINET diagnostics > Device name Assign the PN name via TIA Portal or PRONETA, then power-cycle the CU
Drive appears in catalog but slots are empty Wrong CU sub-variant selected (e.g. B vs E) Catalog shows e.g. CU240B-2 PN Delete the device, place the matching CU240E-2 PN for safety or CU250S-2 PN for positioning
File install fails with "GSD invalid" File extracted with extension change by archive tool Confirm .GSD or .GSDML extension Re-extract the ZIP, do not rename the file

Verification and Commissioning Checklist

Run the following checks after the GSD installation and project download:

  1. In HW Config, the SINAMICS G120 icon shows a green check mark on the bus line and no red "x" on the device.
  2. The slot configuration in HW Config matches the drive parameter p0922 (PROFIdrive telegram selection). Read r0922 online; it must equal the telegram number selected in HW Config (e.g. 1 for telegram 1, 352 for the PCS 7 standard).
  3. STARTER/Startdrive goes online: Project > Online > Connect to target system. The diagnostic buffer is empty of F01910 and F08501 messages.
  4. Perform an empty test run with the control word 0x047E (OFF1 enable + ramp-function generator enable + no setpoint). The drive replies with status word 0x0A31 ("ready to run, no fault, no OFF"). This confirms PZD data is being exchanged.
  5. Write setpoint 0x0FA0 (400.0 hex = 4000 rpm) to control word 1, then issue 0x047F. The motor must run to 4000 rpm and report ZSW1 = 0x0A37 ("operation enabled, with setpoint reached").
  6. Save the parameter set to the CF card: STARTER Drive > Copy RAM to ROM, or BOP-2 menu "Copy RAM to ROM". This protects the configuration against power loss.
Safety check: When the project includes a SINAMICS G120 with PROFIsafe (CU240E-2 F or CU250S-2 F), validate the PROFIsafe address and watchdog time p9610 in the safety acceptance test. The acceptance log must reference the F-address and the GSDML revision used. A mismatch invalidates the safety certification.

Hardware Catalog Path Flowchart

Start HW Config Open Hardware Catalog Drill to bus root PROFIBUS DP PROFINET IO Additional Field Devices > Drives > SINAMICS Drives > SINAMICS > GSD Place SINAMICS G120 (CUxxxx-2)

Tips for Mixed and Legacy Projects

  • STEP 7 V5.4 SP4 and earlier: The GSD for firmware V4.4 and later is not visible. Upgrade to SP5 minimum to gain support for the current G120 family.
  • STEP 7 V5.6 with GSDML Rev. 2.32: The HF-HSP from Siemens article ID 105830207 is required; the base SP cannot parse GSDML with slots > 32.
  • Cross-tool projects: TIA Portal and STEP 7 V5.x install their GSDs into different folders (...\S7GSDAX\ vs ...\HSP\). A GSD installed in one tool is invisible to the other.
  • Multi-vendor catalog: If the G120 must sit next to a non-Siemens drive in the same project, use a generic PROFIdrive GSD; the Siemens-specific telegrams (352, 353) then become unavailable.
  • CF card with encrypted project files: Since firmware V4.7 SP3, the \SIEMENS\SINAMICS\DATA\CFG\ directory is read-only when the CU is configured with the SINAMICS Security option. Copy the GSD before the option is activated, or boot the CU in service mode.

Quick Reference: Required Articles by STEP 7 Version

Tool version PROFIBUS GSD support PROFINET GSDML support HSP / HF required
STEP 7 V5.4 SP5 GSD up to FW 4.7 Not supported None
STEP 7 V5.5 SP2 GSD up to FW 4.7 GSDML V2.0 only HF-HSP for GSDML V2.0
STEP 7 V5.5 SP4 + HF7 GSD up to FW 4.7 SP6 GSDML V2.31 HF-HSP for GSDML V2.31
STEP 7 V5.6 + GSDML V2.32 GSD up to FW 4.7 SP10 GSDML V2.32 Siemens KB 105830207
TIA Portal V13 SP1 via HSP GSDML V2.30 HSP for G120 V13 SP1
TIA Portal V15.1 via HSP GSDML V2.31 HSP for G120 V15.1
TIA Portal V17 via HSP GSDML V2.34 HSP for G120 V17 (KB 72341852)

Frequently Asked Questions

Why does the SINAMICS G120 not appear under SINAMICS in the STEP 7 V5.4 hardware catalog after I install the GSD?

The G120 is intentionally nested under the bus root, not the vendor root. On PROFIBUS the path is PROFIBUS DP > Additional Field Devices > Drives > SINAMICS > SINAMICS G120; on PROFINET it is PROFINET IO > Drives > SINAMICS > GSD. If the entry is still missing, force a catalog refresh with Options > Update Catalog, and confirm the file was copied to %ProgramFiles%\Siemens\Automation\S7\...\S7GSDAX\.

Can I use the GSDML for a CU240E-2 F in a STEP 7 V5.5 project without an HF-HSP?

No. The PROFIsafe profile for the G120 requires a GSDML V2.31 or later and a corresponding hotfix on STEP 7 V5.5. Without the HF-HSP, HW Config parses only the first 32 slots and silently drops the PROFIsafe sub-slot 30, which causes the safety configuration to fail at runtime with F01611.

Where can I find the GSD file if the engineering PC has no internet and I do not have the original Siemens CD?

Copy the file directly from the Control Unit's CompactFlash card at \SIEMENS\SINAMICS\DATA\CFG\. The card ships with all GSD and GSDML files matching the firmware flashed at the factory. Mount the CF card in a reader, copy the matching file, then install via HW Config Options > Install GSD File.

Does the GSDML revision have to match the firmware on the CU?

Yes. The GSDML describes the slot layout (telegrams, subslots, I&M data) and the firmware must accept that layout. A mismatch produces PROFINET diagnostic "Module diff" and the controller refuses the AR. Read r0018 on the drive to confirm the firmware version, and install the GSDML with the matching build date from Siemens Support 26641490.

Which telegram should I select for a basic speed-controlled G120 in a non-PCS 7 project?

Use telegram 1 (2 setpoints / 2 actuals) for a one-quadrant speed drive with setpoint and feedback. Use telegram 20 (2/6) when the PLC side is a NAMUR drive profile block. Use telegram 352 or 353 only inside PCS 7 APL library projects. Telegram 999 is intended for free BICO interconnection and is rarely used outside custom engineering tools.

What is the difference between the SinamicsG120PN and the legacy SinamicsG120PROF GSDML?

The PN variant includes the PROFIsafe sub-slot 30, PROFIsafe parameters (p9601 ff.), and extended diagnostics; it is required for F variants. The legacy PROF variant supports only PROFIdrive telegrams without PROFIsafe and corresponds to firmware versions before V4.5. For new installations always use the PN variant from Support entry 26641490.

Back to blog