Configuring SINAMICS Expert Lists in SIMOTION SCOUT V4.x

David Krause11 min read
SiemensTechnical ReferenceVFD / Drives
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 Expert List in SIMOTION SCOUT (and the equivalent toolset in STARTER) is the central worksheet for editing every writable and readable parameter of a SINAMICS drive object (DO) or a MICROMASTER (MM4xx, ET200, G110, G120) drive. SCOUT V4.x expands the classic parameter table with four auxiliary tabs that allow engineers to:

  • Curate a working subset of parameters (Tab 1: User-defined parameter list)
  • Recall saved lists for documentation or replication (Tab 2: Open existing parameter list)
  • Capture a point-in-time value snapshot and diff it against the live drive (Tab 3: User-defined value list)
  • Persist the working set in one of three formats for downstream use (Tab 4: Save list as *.cdl, watch table, or executable script)

This reference covers each tab, the underlying *.cdl ASCII format, the script-generation logic (including the MicroMaster start/stop unlock sequence), and the version-compatibility rules that govern interchanging lists between SCOUT V3.2, V3.2 SP1, V4.0, and V4.2.

The expert list is a context-bound view. A parameter list created against Drive1 and opened against Drive2 will display "NOT AVAILABLE" warnings in cells where the firmware version of Drive2 lacks the corresponding parameter index.

Expert List Architecture and Storage Model

The four expert-list tabs share a single storage philosophy: only the parameter name and the user's comment string are persisted inside the user-defined list. The actual parameter value lives in the associated drive object (DO) inside the S7 project. When a value changes anywhere in the engineering tool, SCOUT synchronizes the value back to the source expert list automatically. This decoupled model means that:

  • Deleting a user-defined list does not delete parameter values on the drive.
  • Renaming a DO may orphan a user-defined list; SCOUT flags this with informational text in the list view.
  • Two user-defined lists can reference the same parameter index (e.g. p1120) without conflict.

Default storage location for any saved list, value list, or script is the S7 project under the U7 user-data folder, with the *.cdl extension for parameter and value lists. Users may export the same files to any external directory via the Save As dialog.

Tab 1: User-defined Parameter List

Tab 1 is the working surface. Use it to assemble a curated subset of the parameters that matter for a given commissioning task — for example, ramp-up time (p1120), ramp-down time (p1121), reference speed (p2000), and control word source (p922) on a CU320-2.

Supported operations:

  1. Add parameters — copy from the main expert list, paste from the clipboard, or enter the parameter index in p####[index] notation (for indexed parameters).
  2. Comment — every row accepts a free-text comment column, allowing group headings such as "Speed Limits" or "Encoder Configuration".
  3. Duplicate — the same parameter may appear multiple times in different rows, in unsorted order, with different comments.
  4. Export — save as *.cdl, as a watch table (V4.2+), as a value list, or as an executable script.

To create a new list, click the left-most tab and choose New; to edit an existing list, click the second tab and choose Open. SCOUT opens a new register where rows can be added, edited, or removed.

File Format: *.cdl

The *.cdl file is a plain ASCII text file. It stores parameter names and comment text only — never the parameter values. Example structure:

; User-defined parameter list
; Created: 2024-05-12 SCOUT V4.4
p1120    ; Ramp-up time
p1121    ; Ramp-down time
p2000    ; Reference speed
p922     ; Control word source
Lists created with V3.2 or V3.2 SP1 can be opened in V4.0; the stored values are ignored on import. Lists created with V4.0 or later cannot be loaded into older SCOUT versions.

Tab 2: Open Existing User-Defined List

The second tab opens a previously saved parameter list. SCOUT resolves the list against the currently selected DO and overlays the values from that DO's online or offline view, depending on the active connection state. The visible cell values therefore always reflect the project's current state, not a frozen snapshot.

Connection State Source of displayed values Write-back target
ONLINE Online (drive) values Online (drive) RAM
OFFLINE Offline (project) values Offline (project) RAM
No connection Last cached values Read-only

Tab 3: User-defined Value List

The third tab is the commissioning engineer's comparison tool. Unlike Tab 2, a value list stores both the parameter index and its unit-tagged value at the moment the list was saved. When reopened against any DO, SCOUT performs a cell-by-cell diff:

  • Equal — white background, no action required.
  • Different — colored background (red/orange), indicating a divergence between the saved value list and the current DO value.
  • NOT AVAILABLE — orange background in the second column; the parameter index does not exist on the current DO (firmware mismatch, optional module absent, etc.).

The dialog provides three action buttons:

  1. Accept values — pushes the value-list values into the current DO. Each write request is logged in the Scripting output window. SINAMICS components may apply dynamic locks (access level, expert-level lock, drive state) and skip individual parameters; SCOUT reports these as errors in the Scripting window.
  2. Convert to script — generates an executable script (see next section) that performs the same transfer when run later.
  3. Close — dismisses the comparison without writing anything.

Direct edit in the second column (the "current object" column) is supported; the cell color updates as soon as the edit field loses focus.

Tab 4: Save Format Selection

The fourth tab is the export hub. From the context menu, choose Save list and select one of three output targets:

Format Extension Use case Available since
User-defined list *.cdl Curated parameter set, values inherited from DO V4.0
Watch table internal Online monitoring with force/modify capability V4.2
Executable script internal / *.txt export Series commissioning, factory-default diff replay V4.0

Converting Lists to Watch Tables

Watch tables are SCOUT's standard online-monitoring widget, with force/modify buttons per cell. They are the only conversion target that allows live manipulation of drive values during commissioning.

  1. Select the rows in the expert list to migrate.
  2. Right-click and choose Add to watch table > New watch table.
  3. In the Insert Watch Table dialog, edit the name, author, version, and comment fields. The name is auto-populated.
  4. Confirm; SCOUT creates a new watch table under the DO.

To append to an existing watch table instead, choose Add to watch table > <existing name>. No secondary dialog appears; values are appended immediately.

Conversion of older user-defined lists (created in pre-V4.2 SCOUT) to watch tables is supported only for SIMOTION technology objects (TOs). A reconversion back to a *.cdl parameter list is not possible.

Save Expert List as Script

From V4.0 onward, SCOUT can serialize any parameter selection as a chain of read/write requests stored in a script under the DO's Script folder. If the folder does not exist, SCOUT creates it. Typical applications:

  • Capturing the result of a "factory setting comparison" as a script that restores the commissioning state on a replacement drive.
  • Series commissioning: copy a reference drive's parameters to N identical machines by replaying the script.
  • Change documentation: the script is a textual record of which parameters were touched and in which order.

Script Example

' 10/1/2006 from "Script_test.cdl" converted script
APP.LogActive = TRUE                       ' Activate output

' Readable parameter
Value = (Parameters(2, 0))                 ' Drive operating status

' Writable parameter
Parameters(5, 0) = 2                       ' BOP operating status selection

MicroMaster Unlock Sequence

For MICROMASTER drives (MM4xx, ET200, G110, G120), SCOUT auto-prepends a start/stop sequence around the visible parameter set so that the script can run online. The sequence is inserted during conversion, not authored by the user:

' Start sequence (auto-inserted)
Parameters(3, 0) = 4                       ' p3 = 4 (parameter access level)
Parameters(3950, 0) = ZS4_password         ' p3950 = expert password
Parameters(10, 0) = 29                     ' p10 = 29 (drive commissioning filter)

' User parameter set (visible)
...

' Stop sequence (auto-inserted)
Parameters(340, 0) = 1                     ' p340[0] = 1 (save to EEPROM)
Parameters(340, 1) = 1                     ' p340[1] = 1
Parameters(340, 2) = 1                     ' p340[2] = 1
Parameters(10, 0) = 0                      ' p10 = 0 (filter off)
Parameters(3, 0) = old_p3                  ' restore original access level
Parameters(3950, 0) = old_p3950            ' restore original password

The drive-side password ZS4 must match the expert password configured on the MM4xx for the start sequence to succeed.

SINAMICS Limitations in V4.0

  • Auto-unlock is not supported for SINAMICS drives in V4.0. If a parameter is read-only because of CU access level (e.g. p9, p10, p301, p922), each blocked write is reported as an error in the Scripting output window.
  • Structure-changing parameters (e.g. p140 on SINAMICS, which switches BICO topology) are not reordered. The user must ensure such parameters are at the top of the selected set so the script executes before dependent BICO references exist.
  • Unit-system changes (e.g. switching SI <-> US units via p0100) are not applied by the script. The engineer must ensure the unit context is consistent before script execution.
  • Expert-list locks (access level, motor code dependency, p340 EEPROM status) are ignored — every green/blue writable parameter gets a write request.

Procedure: Generate an Executable Script

  1. Right-click the Tab 1/2 register and choose Save list.
  2. Activate the Save as executable script checkbox in the dialog and click OK.
  3. Enter a script name in the Insert Script dialog and click OK.
  4. SCOUT creates a script folder under the DO containing the new script.
  5. (Optional) Right-click the script and Export to ASCII to save a portable copy.

Parameter Index Reference Table

The following parameter indices are referenced by SCOUT's auto-inserted unlock/EEPROM sequences and are essential for manual debugging when a script fails.

Index Name (typical) Function in unlock context
p3 Access level (MM4xx) Set to 4 to allow expert writes
p9 Device identification Often read-only on SINAMICS CU
p10 Commissioning filter Set to 29 to expose all parameters
p140 BICO topology (SINAMICS) Structure-changing; order-sensitive in script
p301 Encoder assignment Often locked by access level
p340[0..2] EEPROM save mode 1 = save RAM to non-volatile
p922 Control word source selection Often locked by access level
p1120 Ramp-up time Common commissioning value
p1121 Ramp-down time Common commissioning value
p2000 Reference speed Common commissioning value
p3950 Expert password (MM4xx) ZS4 default; required for expert writes

Version Compatibility Matrix

Source version Target version Behavior
V3.2 / V3.2 SP1 V4.0 Lists open, stored values ignored, parameter names load
V3.2 / V3.2 SP1 V4.2 Auto-converts to watch table (SIMOTION TOs only)
V4.0 V4.2 Full feature parity
V4.0+ V3.2 / V3.2 SP1 NOT supported — newer *.cdl rejected
V4.2+ V4.2+ Watch tables, scripts, value lists fully interchangeable

Troubleshooting Matrix

Symptom Likely cause Remediation
"NOT AVAILABLE" in orange cell Parameter missing in target DO firmware Verify CU firmware version; upgrade or remove parameter from list
Script errors on every SINAMICS p9/p10/p301/p922 write V4.0 unlock not implemented for SINAMICS Manually raise access level in the drive, then re-run
MM4xx script fails at start sequence p3950 password mismatch Re-enter ZS4 (or site-specific expert password) in p3950
Script commits but drive topology breaks p140 structure change applied after dependent BICO writes Reorder script: place p140 at top of parameter set
Values revert after power cycle p340 EEPROM save not executed Append Parameters(340, 0..2) = 1 to script's stop sequence
Diff shows all rows red after firmware upgrade Firmware reset parameters to factory defaults Open saved value list, click Accept values to push commissioning data
Watch table reconversion not possible Pre-V4.2 limitation Recreate the *.cdl parameter list manually and re-import
Dynamic-lock error in Scripting window during Accept values SINAMICS access level too low Set p0003 = 3 (expert) on the CU before re-running

Field-Proven Commissioning Workflow

  1. Establish baseline. On the reference drive, open Tab 1 and add every parameter that defines the machine's behaviour. Save as reference_drive.cdl.
  2. Capture value snapshot. Save the same selection via Tab 4 as a value list. Verify Tab 3 shows zero diffs against the online drive.
  3. Generate script. Use Tab 4 > Save as executable script. Confirm the MM4xx start/stop sequences (or manually inject unlock code for SINAMICS).
  4. Series replication. On each target drive, open the project, navigate to the DO, right-click the saved script, and Execute. Verify Tab 3 on each drive shows zero diffs after execution.
  5. Permanent storage. Append the EEPROM save (p340 = 1 for MM4xx; p0977 = 1 for SINAMICS) so the parameters survive a power cycle.
  6. Documentation. Export the script and the *.cdl file to a project archive folder under version control.

Verification Checklist

  • [ ] Parameter list opens without "NOT AVAILABLE" warnings on the target DO.
  • [ ] Value list diff (Tab 3) is all white after Accept values.
  • [ ] Script runs end-to-end with no errors in the Scripting output window.
  • [ ] Drive retains all parameters after a power cycle (EEPROM persistence confirmed).
  • [ ] Watch table (if generated) shows the same values as the source parameter list.
  • [ ] *.cdl file is checked into the project archive with a date stamp.

Frequently Asked Questions

What is the difference between a user-defined parameter list and a value list?

A parameter list (Tab 1/2) stores only parameter names and comments; values are inherited from the DO. A value list (Tab 3) stores parameter names and their captured values with units, enabling diff against the live drive and direct restore via Accept values.

Why does the script fail when writing p9, p10, p301, or p922 on a SINAMICS drive?

SCOUT V4.0 does not implement auto-unlock for SINAMICS. These parameters are gated by the CU access level (p0003). Manually set p0003 = 3 on the drive before script execution, or upgrade to a SCOUT version that supports SINAMICS unlock sequences.

Can I open a *.cdl file created in V3.2 inside SCOUT V4.4?

Yes. Lists created in V3.2 or V3.2 SP1 open in V4.0 and later; the stored values are discarded on import, but the parameter names and comments load correctly. Lists created in V4.0 or later cannot be opened in older SCOUT versions.

How do I make script parameter changes persist after a power cycle on a MICROMASTER?

The auto-inserted stop sequence includes p340[0] = 1, p340[1] = 1, p340[2] = 1, which triggers an EEPROM save. On SINAMICS, use p0977 = 1 to copy RAM to non-volatile storage. Verify with a power-cycle test after the script completes.

Can I convert a watch table back into a *.cdl parameter list?

No. SCOUT provides a one-way conversion from user-defined lists to watch tables. To rebuild a parameter list, recreate it manually in Tab 1 and re-add the desired indices.

Back to blog