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.
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:
-
Add parameters — copy from the main expert list, paste from the clipboard, or enter the parameter index in
p####[index]notation (for indexed parameters). - Comment — every row accepts a free-text comment column, allowing group headings such as "Speed Limits" or "Encoder Configuration".
- Duplicate — the same parameter may appear multiple times in different rows, in unsorted order, with different comments.
-
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
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:
- 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.
- Convert to script — generates an executable script (see next section) that performs the same transfer when run later.
- 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.
- Select the rows in the expert list to migrate.
- Right-click and choose Add to watch table > New watch table.
- In the Insert Watch Table dialog, edit the name, author, version, and comment fields. The name is auto-populated.
- 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.
*.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.
p140on 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,
p340EEPROM status) are ignored — every green/blue writable parameter gets a write request.
Procedure: Generate an Executable Script
- Right-click the Tab 1/2 register and choose Save list.
- Activate the Save as executable script checkbox in the dialog and click OK.
- Enter a script name in the Insert Script dialog and click OK.
- SCOUT creates a script folder under the DO containing the new script.
- (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
-
Establish baseline. On the reference drive, open Tab 1 and add every parameter that defines the machine's behaviour. Save as
reference_drive.cdl. - Capture value snapshot. Save the same selection via Tab 4 as a value list. Verify Tab 3 shows zero diffs against the online drive.
- Generate script. Use Tab 4 > Save as executable script. Confirm the MM4xx start/stop sequences (or manually inject unlock code for SINAMICS).
- 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.
-
Permanent storage. Append the EEPROM save (
p340 = 1for MM4xx;p0977 = 1for SINAMICS) so the parameters survive a power cycle. - 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.
- [ ]
*.cdlfile 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.