Resolving the ProAgent License Missing Error on MP 277 10" Touch in WinCC Flexible 2008 / STEP 7 5.5 SP1
This technical reference addresses a recurring field issue where a STEP 7 5.5 SP1 project with SIMATIC Fault Messages (SFM) and a WinCC Flexible 2008 project compiled cleanly, yet at runtime the MP 277 10" Touch panel displays "License required: WinCC Flexible / ProAgent for panel" and the system alarms fail to appear. The root cause is twofold: the panel-side runtime license for ProAgent has not been transferred to the MP 277, and the WinCC Flexible connection that links the ES to the panel has not been validated against the integrated station. This article documents both corrective paths with field-proven procedures, parameter references, and a verification matrix.
1. Problem Description and Observable Symptoms
When ProAgent is enabled in a WinCC Flexible 2008 project that targets a SIMATIC MP 277 10" Touch, the following sequence is observed during engineering and commissioning:
- The SFM blocks (FB49 = SFM_FB, FC49 = SFM_FC, DB49 = SFM instance DB, DB50 = additional information DB) are generated from the S7 standard library in STEP 7 5.5 SP1.
- The CSV diagnostic file is exported from STEP 7 via Options > SFM > Export.
- The CSV is imported into the WinCC Flexible project via Options > ProAgent > Import or via the Diagnostics Editor.
- ProAgent is activated (Options > ProAgent > Activate) and the project is compiled.
- The compiler reports 0 errors but emits an informational note: "License required: WinCC Flexible / ProAgent for panel".
- The compiled project is downloaded to the MP 277.
- On the panel, the ProAgent unit/step/motion views open, but the system alarms remain empty and a dialog is shown: "No valid license for WinCC Flexible ProAgent. Please contact your Siemens representative."
The error appears regardless of whether the ProAgent license is installed on the engineering station. It is a runtime-side defect, not a compile-side defect.
2. ProAgent Architecture and Component Overview
ProAgent is the process diagnostics option for SIMATIC HMI panels from the MP 177 / MP 277 / MP 377 / Panel PC families. It visualizes CPU-side fault messages (SFM) and unit/step/motion view data so that operators can navigate from a process tag alarm to the causing STEP 7 logic block. The architecture is split into three layers, each of which has its own license:
| Layer | Component | License Type | Location |
|---|---|---|---|
| Engineering | STEP 7 5.5 SP1 + SFM blocks (FB49/FC49/DB49/DB50) | STEP 7 Standard (included) | Programming device / ES |
| Configuration | WinCC Flexible 2008 ES with ProAgent option | WinCC flexible ProAgent (ES license) | Engineering station |
| Runtime | ProAgent runtime on MP 277 | WinCC flexible ProAgent (panel runtime license) | MP 277 / panel image |
Reference: SIMATIC HMI WinCC flexible 2008 ProAgent - System Manual (PDF).
3. SFM Block Reference
The SFM (System Fault Messages) functionality is delivered as four standard blocks in the STEP 7 Standard Library under SFM:
| Block | Type | Name | Purpose |
|---|---|---|---|
| FB49 | FB | SFM_FB | Trigger/aggregate SFM entries per channel/address area |
| FC49 | FC | SFM_FC | Auxiliary routine invoked by FB49 for message composition |
| DB49 | DB | SFM instance DB | Instance data for FB49 (one per CPU) |
| DB50 | DB | Additional info DB | Zinfo data block referenced by FB49 |
These blocks are called from OB1 (or OB82/OB86 for diagnostic interrupts) and read error OBs to compose textual fault messages. The CSV export from STEP 7 contains the mapping of the SFM text library to the STEP 7 symbols so ProAgent can display meaningful messages in the WinCC Flexible view.
4. Root Cause 1 - Panel Runtime License Not Transferred
The compile-time message "License required: WinCC Flexible/ProAgent for panel" is a warning that the engineering tool cannot detect a valid panel-side runtime license. It is not an error, which is why compilation continues with status 0. At runtime, the MP 277 checks its own license container (located on the internal flash of the panel) for the ProAgent runtime key. If absent, the unit/step/motion views open as empty shells and the "No valid license" dialog is raised.
There are two valid ProAgent license positions:
- Engineering license (WinCC flexible ProAgent, ES): installed via the Automation License Manager on the ES, permits the engineer to enable ProAgent, import CSV, and compile.
- Runtime license (WinCC flexible ProAgent, RT for panel): a separate license key (delivered as a *.zip or license key file) that must be transferred to the MP 277's CF/flash via ProSave. Without it, the panel cannot display SFM-based diagnostics.
Having a valid ES license is necessary but not sufficient. The RT license must be pushed to the panel.
5. Root Cause 2 - Connection / Station Not Selected
WinCC Flexible 2008 distinguishes between the integrated HMI station under the STEP 7 project and a "standalone" HMI project. When the WinCC Flexible project is integrated into STEP 7 5.5 SP1, the connection is bound to the S7 station. If the connection is created without selecting a target station, ProAgent cannot resolve the SFM text source at compile time and emits the license warning. At runtime, the empty container is detected and the panel shows the missing-license dialog.
Field resolution: in WinCC Flexible ES, open Project > Connections, select the connection row (e.g., "S7ONLINE" or named MPI/PROFIBUS/ETHERNET connection), and check the Station field. If it is empty, edit the connection and select the S7 station that owns the SFM blocks. Save, regenerate, and re-download.
6. Step-by-Step Resolution
6.1 Prerequisites
- STEP 7 V5.5 SP1 (or higher SP up to SP4) installed with HW Update for the CPU in use.
- WinCC flexible 2008 SP2/SP3/SP4/SP5 with ProAgent option.
- Valid ES license for ProAgent (Automation License Manager entry).
- Valid panel runtime license for ProAgent (license key file, e.g., 6AV6 661-7A... series).
- ProSave V13 SP1 or higher on the ES, with Ethernet, MPI, PROFIBUS, or USB-PPI cable for panel connectivity.
- MP 277 10" Touch with firmware >= V2.0.0 (recommended >= V2.4.5 for WinCC flexible 2008 SP5 compatibility).
6.2 Transfer the ProAgent Panel Runtime License via ProSave
- Launch ProSave on the engineering station.
- Select the device type: Panel, SIMATIC MP 277 10" Touch.
- Select the connection mode (Ethernet preferred; PROFIBUS/MPI if Ethernet not configured).
- Enter the panel's IP address (default 192.168.0.1, mask 255.255.255.0) and click Connect.
- Once connected, navigate to the License Keys tab.
- Click License Key Transfer and browse to the ProAgent panel runtime license file (typically named
*.zipor*.binas supplied with the license sticker / CoL). - Confirm the transfer. The MP 277 stores the key in its internal license container.
- Cycle power to the panel when prompted.
6.3 Validate the Connection in WinCC Flexible
- Open the WinCC Flexible project (the one integrated into STEP 7 5.5 SP1).
- Open the project tree and double-click Connections.
- Select the connection used by ProAgent (typically the only MPI/Profibus/Ethernet connection).
- Confirm the Station column shows the S7 station name. If empty, double-click the row and assign the station.
- Save the project.
- Re-import the latest CSV via Options > ProAgent > Import SFM text library.
- Re-activate ProAgent via Options > ProAgent > Activate.
- Recompile via Project > Compiler > All. Confirm 0 errors and 0 warnings.
- Download the runtime project to the MP 277. Include the ProAgent runtime license in the transfer dialog.
6.4 Regenerate SFM Blocks and CSV
When modifications are made to the S7 logic, the SFM blocks must be regenerated to pick up the new error OB configurations and symbol names. The procedure in STEP 7 5.5 SP1 is:
- Open the S7 project in SIMATIC Manager.
- Open the SFM dialog: Options > SFM > Generate Blocks (or via the SFM Editor in the CPU folder).
- Confirm the SFM block list shows FB49, FC49, DB49, DB50 with current timestamp.
- Export the CSV: Options > SFM > Export. Save to a known path (e.g.,
D:\Proj\SFM_export.csv). - Switch to WinCC Flexible, Options > ProAgent > Import, select the CSV.
- Recompile and re-download.
7. ProAgent Activation and Screen Generation
When ProAgent is activated, WinCC Flexible automatically inserts three screen objects in the configured alarm screen:
- Unit overview: lists the configured diagnostic units (SFM groups per OB82/OB86 sources).
- Step overview: lists the current step / state of each unit (driven by the SFM step list in the CSV).
- Motion overview: shows the current motion sequence in the unit, useful for S7-300F/S7-400F safety logic.
These views consume the SFM buffer in DB49 and the Zinfo data in DB50. The buffer size is configured in the SFM editor (default 16 entries, expandable to 256 with an S7-400 CPU). If the buffer is too small for the active fault count, older entries are overwritten and may appear as gaps in the ProAgent view.
8. MP 277 10" Touch Technical Reference
| Parameter | Value |
|---|---|
| Order number (10" Touch) | 6AV6 643-0CD01-1AX1 / -1AX2 |
| Display | 10.4" TFT, 64K colors, 640 x 480 |
| Operating system | Windows CE 5.0 |
| Interfaces | 1 x Ethernet (10/100), 1 x USB, 1 x MPI/PROFIBUS, 1 x RS422/485 |
| Memory | 6 MB configuration / 4 MB recipe |
| Configuration tool | WinCC flexible 2008 SP2 - SP5 |
| ProAgent support | Yes (per WCF08 ProAgent manual) |
9. ProAgent System Limits
The following panel-image and ProAgent capability matrix is taken from the SIMATIC HMI WinCC flexible 2008 ProAgent manual:
| Panel | ProAgent | Max diagnostic units | Max messages in buffer |
|---|---|---|---|
| MP 177 6" Touch | Yes | 32 | 256 |
| MP 270B Touch | Yes | 32 | 256 |
| MP 277 10" Touch | Yes | 32 | 256 |
| MP 277 8" Key | Yes | 32 | 256 |
| MP 370 12" Touch | Yes | 64 | 512 |
| MP 370 15" Touch | Yes | 64 | 512 |
| MP 377 12" / 15" / 19" Touch | Yes | 64 | 512 |
Source: SIMATIC HMI WinCC flexible 2008 ProAgent - System Manual.
10. Verification Procedure
- On the MP 277, open the panel control panel: Start > Settings > Control Panel > OP (or HMI).
- Open License Info and verify that WinCC flexible / ProAgent is listed as installed and valid (green check, expiration not exceeded).
- Restart the runtime project. Open the ProAgent alarm screen.
- Trigger a test SFM (e.g., remove and re-insert a slave on PROFIBUS to fire OB86, or short-circuit an analog input channel to fire OB82).
- Confirm that the system alarm appears in the unit overview within one polling cycle (typically 1 s).
- Click on the alarm entry; the step view should populate from the SFM step list defined in the CSV.
- If the license dialog still appears, repeat section 6.2 and confirm the ProSave transfer completed without error.
11. Troubleshooting Matrix
| Symptom | Likely Root Cause | Corrective Action |
|---|---|---|
| Compile 0 errors, warning "License required: WinCC Flexible/ProAgent for panel" | Panel RT license missing | Transfer ProAgent RT license via ProSave, then re-download |
| Alarms empty at runtime, "No valid license" dialog | RT license not transferred, or stale CSV | Re-transfer license, re-export and re-import CSV |
| Compile 0 errors, but some unit views missing | CSV not re-imported after SFM regeneration | Re-export CSV from STEP 7, re-import in WinCC flexible |
| ProAgent greyed out in Options menu | ES license for ProAgent not installed | Install WinCC flexible ProAgent ES license via Automation License Manager |
| Compile aborts with "SFM block not found" | FB49/FC49/DB49/DB50 not in the S7 program | Regenerate SFM blocks from STEP 7 Standard Library |
| Connection configured but Station field empty | WinCC project not bound to STEP 7 station | Edit connection and assign the S7 station |
| Panel shows old alarms after re-download | Panel internal buffer not cleared | Cycle power to MP 277 after download |
| ProAgent views open but no step list | DB50 not updated or wrong instance assigned | Regenerate SFM blocks, confirm DB50 instance in FB49 call |
12. Additional Field Notes
- Always cycle power to the MP 277 after a license transfer. The license container is not hot-swappable.
- When migrating from a previously working project, do not overwrite the existing connection row in WinCC Flexible. Create a new connection and delete the old one; otherwise the SFM source binding can be lost.
- If the project is a multi-station STEP 7 5.5 SP1 project, the ProAgent CSV import must be performed once per WinCC Flexible project; a shared CSV is permissible only when the SFM text list is identical.
- When upgrading a STEP 7 5.5 SP1 project to STEP 7 V5.6, re-generate the SFM blocks; FB49/FC49/DB49/DB50 are forward-compatible but the CSV format may differ and must be re-exported.
- Back up the panel image before the license transfer to enable a fast rollback if the wrong license file is mistakenly pushed.
Reference for further reading: SIMATIC HMI WinCC flexible 2008 ProAgent Manual (PDF).
Frequently Asked Questions
Why does WinCC Flexible compile with 0 errors and still show a license warning for ProAgent?
The compile-time message "License required: WinCC Flexible/ProAgent for panel" is a non-fatal warning emitted when the engineering tool cannot detect a panel-side runtime license. The compile continues; the missing key only manifests at runtime on the MP 277 as an empty unit view and a "No valid license" dialog. Transfer the ProAgent panel runtime license via ProSave to clear it.
How do I transfer the ProAgent runtime license to the MP 277 10" Touch?
Open ProSave on the engineering station, select Panel / SIMATIC MP 277 10" Touch, connect to the panel (Ethernet or MPI/PROFIBUS), open the License Keys tab, and use License Key Transfer to push the ProAgent panel runtime license file. Cycle power to the panel when prompted. The license is stored in the internal flash and is retained across reboots.
Do I need a separate ProAgent license for every MP 277 panel?
Yes. The panel runtime license for ProAgent is keyed to the panel's serial number (or CoL certificate) and is non-transferable. A ProAgent ES license covers the engineering station only. Plan one ProAgent panel runtime license per MP 277 / MP 377 / Panel PC that will display ProAgent diagnostics.
What SFM blocks must be in the STEP 7 5.5 SP1 program for ProAgent to work?
The STEP 7 Standard Library "SFM" folder must contain FB49 (SFM_FB), FC49 (SFM_FC), DB49 (instance DB), and DB50 (additional info DB). These are inserted by STEP 7 via the SFM Editor; if any of them is missing, the CSV export will be incomplete and WinCC Flexible will compile with errors instead of warnings.
After modifying the S7 program, why do the ProAgent alarms no longer appear on the panel?
The CSV diagnostic file exported from STEP 7 is the static link between the SFM text library and the WinCC Flexible views. Any change to the SFM configuration, symbol names, or FB49/DB49/DB50 instance assignment requires re-exporting the CSV from STEP 7 and re-importing it into the WinCC Flexible project via Options > ProAgent > Import, followed by a recompile and re-download to the MP 277.
Is the MP 277 10" Touch supported by ProAgent in WinCC Flexible 2008?
Yes. The MP 277 (all variants: 8" Key, 10" Touch, and the 8"/10" Touch derivatives) is listed as a supported ProAgent panel in the WinCC flexible 2008 ProAgent manual with up to 32 diagnostic units and 256 messages in the buffer.