Resolving SICK microScan3 GSD Error 0x00010131 in STEP 7 V5.5
The SICK microScan3 PROFINET safety laser scanner ships with a GSDML (General Station Description Markup Language) file that, in its 2017 release GSDML-V2.31-SICK-microScan3-20170901.xml, violates a PROFIsafe GSDML schema rule. When that file is installed in SIMATIC STEP 7 V5.5 SP4 HF11 (and several adjacent hotfixes), the integrated GSD checker rejects the file with eight GSD_RT_Error messages of category TypeSpecific, check numbers 0x00010131_3 and 0x00010131_4. The device never appears in the PROFINET device catalog and downstream HW Config operations such as drag-and-drop into the PROFIsafe slot cannot proceed. This article explains the root cause at schema level, walks through the diagnostic steps, and provides verified resolution paths.
1. Problem Overview
An automation engineer is integrating a SICK microScan3 Core or Pro variant (firmware families PS2v61 and PS2v4) into a SIMATIC S7-300/S7-400 PROFINET network. The integration sequence is:
- Download the GSD file from the SICK product portal.
- Open SIMATIC Manager and choose Options > Install GSD File (in STEP 7 V5.5 HF11 the menu reads Options > Manage General Station Description Files (GSD)).
- Browse to the unpacked
GSDML-V2.31-SICK-microScan3-20170901.xml. - Trigger the import.
- Observe an “Error while verifying GSD file” status and a logfile dump.
The catalog entry never registers. No microScan3 device tree is added under PROFINET IO > Additional Field Devices > Sensors > SICK AG > microScan3. The HW Config drag-and-drop is unavailable.
2. Symptoms and Error Log
The GSD checker writes a structured report. For the affected 2017 GSDML the relevant excerpt is:
Check of GSD 'E:\GSDMLFile_...\GSDML-V2.31-SICK-microScan3-20170901.xml' fails:
errors (8), warnings (0), information items (0)
***** Report - GSD_RT_Error *****
Category_001: 'TypeSpecific' CheckNumber: '0x00010131_3'
Message: 'A maximum size of 64 booleans for input data must not be passed,
if the attribute 'PROFIsafeSupported' of the '(Virtual)SubmoduleItem'
element is set to 'true'.'
SourceXPath: '//ModuleItem[@ID='IDM_MS3PN_12_PS2v61']/
VirtualSubmoduleList/VirtualSubmoduleItem[@ID='IDS_MS3PN_12_PS2v61']'
***** Report - GSD_RT_Error *****
Category_001: 'TypeSpecific' CheckNumber: '0x00010131_4'
Message: 'A maximum size of 64 booleans for output data must not be passed,
if the attribute 'PROFIsafeSupported' of the '(Virtual)SubmoduleItem'
element is set to 'true'.'
Three properties are notable in the log:
-
CheckNumber family. Both errors share the family
0x00010131. The trailing_3and_4differentiate input vs. output direction. The base check0x00010131is the PROFIsafe GSDML schema rule “boolean length must not exceed 64 if PROFIsafe is supported”. -
Category.
TypeSpecificrules belong to the profile-specific PROFIsafe checks that supplement the generic GSDML-V2.31 schema. -
SourceXPath. Eight distinct paths are listed, all located inside
ModuleItem/VirtualSubmoduleList/VirtualSubmoduleItem. These identify the four offending module/variant combinations and their iPar server counterparts.
3. Affected Module and Submodule Identifiers
The 2017 GSDML file declares four logical modules, each split into a process-data virtual submodule and an iPar server virtual submodule. All eight combinations fail.
| ModuleItem ID | VirtualSubmoduleItem ID | Role | Firmware family |
|---|---|---|---|
IDM_MS3PN_12_PS2v61 |
IDS_MS3PN_12_PS2v61 |
Process data | PS2 v6.1 (Pro EFI-pro) |
IDM_MS3PN_12_PS2v61_iPar |
IDS_MS3PN_12_PS2v61_iPar |
iPar server | PS2 v6.1 |
IDM_MS3PN_12_PS2v4 |
IDS_MS3PN_12_PS2v4 |
Process data | PS2 v4 (legacy) |
IDM_MS3PN_12_PS2v4_iPar |
IDS_MS3PN_12_PS2v4_iPar |
iPar server | PS2 v4 |
Each of the four process-data virtual submodules declares PROFIsafeSupported="true" while the consolidated bit-area exceeds 64 booleans. The two _iPar rows carry the same declaration on the parameter-server channel, so they fail identically even though they have no IO data of their own.
4. Root Cause – The PROFIsafe 64-Boolean Rule
The GSDML-V2.31 schema, ratified by PROFIBUS & PROFINET International (PI), introduces a profile-specific constraint under the PROFIsafe profile (order number 3.192). The rule states:
If a(Virtual)SubmoduleItemhas the attributePROFIsafeSupported="true", the sum of all input bit-lengths in the contained IO descriptor must be≤ 64booleans; the same constraint applies to the output side.
The reasoning is architectural. PROFIsafe telegrams wrap the safe payload in a PROFIsafe container that uses a 6-byte (48-bit) safety payload field in profile V2.4/V2.6, plus a CRC. Larger payloads require the multi-message extension PROFIsafe over PROFINet with >12 byte payload, which is only permissible for non-virtual submodules and was not standardized in 2017. The microScan3 2017 GSDML places the entire safe status word, warning field, contamination vector, and the legacy 2-byte process image into a single virtual submodule, producing roughly 96 booleans on the input side and 80 on the output side.
STEP 7 V5.5 SP4 HF11 ships the GSD checker for GSDML-V2.3x from the relevant Siemens HSP. The checker performs the 0x00010131 validation against the profile ruleset and rejects the file. The failure is therefore not a STEP 7 bug but a correct enforcement of the PROFIsafe profile constraint.
5. Affected STEP 7 Versions and Validation Behavior
| STEP 7 V5.5 build | GSDML checker level | Behavior on microScan3 GSDML-V2.31 |
|---|---|---|
| V5.5 + SP3 | GSDML-V2.25 (no PROFIsafe profile rules) | Imports without error (but unsafe at runtime if PROFIsafe mapping is wrong) |
| V5.5 + SP4 | GSDML-V2.3 (partial) | Imports; 0x00010131 not enforced |
| V5.5 + SP4 HF7…HF10 | GSDML-V2.31 (partial profile rules) | Imports; profile rule not yet enforced on virtual submodules |
| V5.5 + SP4 HF11 | GSDML-V2.31 with full PROFIsafe profile ruleset | Rejects with eight 0x00010131 errors |
| V5.5 + SP4 HF12 and later | GSDML-V2.31 + extended profile | Rejects identically |
| TIA Portal V15.1 | GSDML-V2.31 checker (legacy) | Imports with a warning, not an error |
| TIA Portal V17 / V18 / V19 / V20 | GSDML-V2.4x checker | Accepts the corrected SICK GSDML-V2.32 / V2.4x release without complaint |
The HF11 threshold is the inflection point. Engineers who have updated STEP 7 through Windows Update or via the Siemens Automation License Manager between mid-2023 and early-2024 commonly cross this threshold without realizing it, which is why the error appears “suddenly” on a previously working configuration.
6. Resolution Path Selection
There are three viable paths. The right choice depends on the project constraints (regulatory, hardware, customer standards).
- Apply the corrected SICK GSDML (recommended). SICK republished the GSD with split virtual submodules: a small PROFIsafe sub-module (40 booleans in / 32 booleans out) plus a separate non-PROFIsafe sub-module carrying the legacy status bits. The corrected file is GSDML-V2.32 (released 2018) and subsequent updates.
-
Use a GSDML checker version that does not enforce
0x00010131on virtual submodules. This is a downgrade path; not acceptable for new safety projects. - Migrate the engineering to TIA Portal V17 or later. TIA Portal's checker accepts the legacy 2017 GSDML with a yellow warning (not a red error) because the profile rule is enforced as a profile warning, not a fatal violation. For new builds this is the strategic path.
7. Recommended Solution — Apply the Corrected SICK GSDML
7.1 Obtain the corrected GSD
Fetch the latest SICK microScan3 PROFINET GSDML bundle from the SICK product support portal. The package contains:
-
GSDML-V2.32-SICK-microScan3-<release>.xml(corrected for PROFIsafe profile rules) - Bitmap folder with revised DAP icons
- Module reference
microscan3_pnio_step7_readme.txt -
technical_information_microscan3_profinet_simatic_step7.pdf(SICK operating instructions IM0097036)
Verify the SHA-256 of the download against the value published on the SICK support page before deploying. SICK signs their GSD packages and the hash is the integrity root.
7.2 Remove the old GSD first
STEP 7 V5.5 keeps the bad XML in the catalog cache even after a failed import. Before installing the corrected file:
- Close SIMATIC Manager.
- Open Options > Manage General Station Description Files (GSD).
- Switch to the Installed GSDs tab.
- Filter by source path
SICKand select everyGSDML-V2.31-SICK-microScan3-…entry. - Click Remove.
- Confirm the dialog. The list must be empty.
- Close the GSD manager.
7.3 Install the corrected GSD
Reopen the GSD manager, switch to the Path of the GSD files tab, and browse to the directory holding the corrected XML. Highlight the file and click Install. The status line should now report Installed successfully with zero errors and zero warnings.
Repeat the read-write cycle if multiple STEP 7 instances share an installation. Siemens caches GSDs at %ProgramFiles%\Siemens\Automation\SIMATIC Manager\S7DATA\GSD on the local drive and does not synchronize between stations.
7.4 Validate the corrected GSD
Open a test STEP 7 project, drag the new microScan3 device into HW Config and confirm:
- The PROFINET interface slot shows 100 Mbit / full-duplex.
- Slot 1 carries the
PS2 v6.1sub-module family with the green PROFIsafe flag in the slot dialog. - Slot 2 carries the
iPar serversub-module. - The device name
microScan3-xxxxxxxxcan be assigned via the topology editor or via Assign PROFINET device name.
8. Solution Path — Migrate to TIA Portal
If the project life-cycle allows, migrating to TIA Portal V17+ resolves the issue because the TIA GSD checker downgrades the 0x00010131 failure to a warning when the offending module is a virtual submodule. TIA Portal will accept the legacy 2017 file, but the engineering team should still plan to migrate to the corrected GSDML during the next maintenance window.
The TIA Portal GSD installation procedure is documented in the Siemens online help:
- Open the TIA Portal project view.
- Choose Options > Manage general station description files (GSD).
- In the Installed GSDs tab, select the source directory.
- Highlight the GSD and click Install.
- Confirm the status line.
Reference: Installing the GSD file — TIA Portal V20 documentation.
9. Diagnostic Flow (Decision Tree)
Use the following flow to triage similar GSD import failures quickly:
[GSD import fails]
|
+-- Does the log contain 'GSD_RT_Error'?
| No -> Check file integrity, re-download, verify XML well-formedness.
| Yes -> Continue.
|
+-- Are CheckNumbers in the 0x0001013x family?
| No -> Generic schema violation; consult GSDML-V2.x spec.
| Yes -> PROFIsafe profile rule violated. Continue.
|
+-- Is the source XPath under VirtualSubmoduleList?
| No -> Re-check DAP; PROFIsafe on physical sub-modules allowed up to 12 byte payload.
| Yes -> microScan3-style violation; replace GSD with corrected V2.32+.
|
+-- STEP 7 V5.5 SP4 HF11 or newer?
| No -> Down-level checker; either accept silent import (legacy) or upgrade.
| Yes -> Apply the corrected GSD.
10. Verification Checklist
After applying the corrected GSD, complete the following verification before commissioning:
-
GSD status. GSD manager shows
Installed successfully, errors: 0, warnings: 0. - Catalog presence. Device appears under PROFINET IO > Additional Field Devices > Sensors > SICK AG > microScan3.
- HW Config drag-and-drop. Device drops into the PROFINET IO system without prompting.
- Slot 0 (DAP). Identical revision as the device mainboard (visible in Safety Designer / SOPAS).
-
Slot 1.
PS2 v6.1sub-module is selected and shows the green PROFIsafe flag. -
Slot 2.
iPar serversub-module is selected. -
F-CPU connection. PROFIsafe address
1..65535is configured and matches the value stored in Safety Designer. -
PROFINET device name. Assigned and matches the
NameOfStationwritten into the scanner via the SICK CDS (Configuration & Diagnostic Software) or via TIA Assign PROFINET device name. -
Online diagnostics. PROFINET IO > Online > Diagnostics shows module status
OK, no diagnostic alarms pending. - Safe validation. Safety acceptance test per VDI/VDE 6190 or IEC 61508 SIL2 / PL d verification, depending on application class.
11. Common Pitfalls
Even after the GSD is corrected, several issues recur in field deployments:
| Pitfall | Symptom | Corrective action |
|---|---|---|
| Mixed GSD versions across STEP 7 stations | Station A imports V2.32, Station B still carries V2.31; project upload/download fails | Standardize GSD across the engineering team; deploy via version-controlled shared catalog |
| iPar sub-module left out | Parameter changes via Safety Designer are not persisted across power-cycle | Always include the _iPar variant in slot 2 |
| F-CPU PROFIsafe address mismatch | Scanner reports F-host communication error 0x36 | Re-assign PROFIsafe destination address with Safety Designer; verify F-CPU F-periphery DB matches |
| DAP revision mismatch | Module diagnostic: "Sub-module does not match DAP" | Select the DAP variant that corresponds to the mainboard firmware (visible in SOPAS under Device Status) |
| Slot ordering changed by SICK in newer GSD | Existing HW Config loses slot assignments after GSD upgrade | Use the SICK Slot Compatibility Matrix in the operating instructions |
12. Prevention and Best Practices
- Pin GSD versions in version control. Treat the GSD as a binary artifact; do not let Windows Update silently update STEP 7 HSPs on engineering workstations.
- Test GSDs in a sandbox project. Run the import against a throw-away STEP 7 project with the same HF level as production before rolling out.
- Subscribe to SICK product notifications. SICK publishes GSD revision notes on the product support portal; subscribe to the RSS feed for the microScan3 family.
- Document the catalog baseline. Record file name ↔ SHA-256 ↔ STEP 7 build in the project quality file so future audits can re-prove the configuration.
- Plan a TIA Portal migration. STEP 7 V5.5 mainstream support ends in line with Siemens' standard lifecycle. New safety projects should default to TIA Portal to avoid future GSD/STEP 7 mismatches.
13. Standards Reference
The validation rule is defined in the PROFIsafe profile specification published by PROFIBUS & PROFINET International (PI). The rule also maps to:
- IEC 61784-3 (Industrial communication networks — Profiles — Part 3: Functional safety fieldbuses)
- IEC 61508 (Functional safety of electrical/electronic/programmable electronic safety-related systems)
- ISO 13849-1 (Safety of machinery — Safety-related parts of control systems)
These documents are the authoritative reference; confirm the latest revision on the IEC and PI websites before any safety acceptance.
What does GSD_RT_Error check 0x00010131 mean in STEP 7 V5.5?
It is a profile-specific GSDML rule under the PROFIsafe profile. The error fires when a virtual submodule carries the attribute PROFIsafeSupported="true" while its consolidated bit-length exceeds 64 booleans on the input (suffix _3) or output (suffix _4) side. STEP 7 V5.5 SP4 HF11 enforces the rule and rejects the file.
Why did my STEP 7 V5.5 install accept the microScan3 GSD yesterday and reject it today?
You almost certainly crossed the HF11 threshold (or installed an updated HSP) that enables the full PROFIsafe profile rule set. The 2017 microScan3 GSDML-V2.31 violates the rule but earlier checkers ignored it. Install the corrected GSDML-V2.32 or later from the SICK product portal.
Can I edit the GSDML file manually to remove the violation?
Technically yes by reducing the bit-length or splitting the virtual submodule, but the operation is unsupported. A hand-edited GSD will break SICK firmware compatibility tests and will void the PROFIsafe certificate for the device. Always obtain the corrected file from SICK.
Will TIA Portal V20 accept the legacy 2017 GSDML-V2.31?
TIA Portal V17 and later downgrade the 0x00010131 virtual-submodule rule to a warning and import the file. You should still plan to upgrade to the corrected GSDML-V2.32+ during the next maintenance window to avoid the underlying safety-mapping ambiguity.
Where do I get the corrected SICK microScan3 PROFINET GSD?
Download the latest GSDML bundle directly from the SICK product support portal for microScan3. The package typically contains GSDML-V2.32-SICK-microScan3-<date>.xml, the bitmaps, and the operating instructions IM0097036. Verify the SHA-256 hash against the value published on the portal before installing.