Resolving WinCC V13 Faceplate Animation Failures in TIA Portal

David Krause11 min read
SiemensTIA PortalTroubleshooting
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

Problem Overview

When configuring HMI faceplates in SIMATIC WinCC Comfort/Advanced/Professional V13 inside TIA Portal V13, the Appearance animation driven by a faceplate property fails to update on the HMI Runtime even though the bound PLC tag changes value. The faceplate renders correctly in the engineering graphics view and the WinCC Runtime simulation (RT Simulation), but the dynamic color, blink, or visibility state never changes once the project is loaded onto a real Panel, Comfort Panel, or PC Runtime.

The typical indicator reported by integrators is a compilation or download warning in the inspector window:

  • Faceplate Appearance tag missing — the compiler cannot resolve the internal tag that backs the property.
  • Faceplate property 'state' is not linked to a valid tag — the property exists in the faceplate type but the instance is not bound.
  • 0x80040xxx HMI Runtime warnings about unresolved HMI tags when the screen is opened.
Critical: The simulation runs a slightly different code path than the on-device Runtime. A faceplate animation that works in the PLCSIM-coupled RT Simulation is not a guarantee that it will work on a real Panel. Always verify on target hardware before sign-off.

Affected Versions and Symptom Matrix

TIA Portal Version WinCC Version Symptom Fix Status
V13 (initial release) WinCC V13.0 Appearance animation does not trigger on Runtime; PLC tag change has no effect. Resolved in V13 SP1.
V13 SP1 WinCC V13.0 SP1 Issue is corrected for V13 projects. Workaround not required.
V14 (initial release) WinCC V14.0 Re-introduction of the V13 root cause; the same Appearance tag missing warning returns. Resolved in V14 SP1.
V14 SP1 WinCC V14.0 SP1 Regression confirmed — same symptom as V13 base release. Resolved in V14 SP1 UPD3.
V14 SP1 UPD3 and later WinCC V14.0 SP1 UPD3+ Appearance animations update correctly on Runtime. Recommended baseline.
V15 / V15.1 / V16 / V17 / V18 WinCC V15.0 onward Behavior matches V14 SP1 UPD3; no regression reported. No additional patch required.

Root Cause Analysis

The Appearance animation in a WinCC faceplate is driven by an internal HMI tag that is generated automatically from the faceplate's interface property. The compiler must:

  1. Detect the faceplate property (e.g., state : DInt) at the faceplate-type level.
  2. Create a backing internal HMI tag of the matching data type inside the faceplate container.
  3. Propagate the property to every instance, including the connection point to the animation engine.

In TIA Portal V13 base release and again in V14 SP1 (a regression), step 2 silently fails for the Appearance animation when the property is configured as an enumeration (e.g., 0 = off, 1 = on, 2 = error) and bound to a multistate graphic list. The compiler does not raise a hard error; it only issues a non-blocking warning, so the project compiles and downloads. At runtime, the HMI tag exists, but the link between the tag and the animation table inside the faceplate instance is missing — hence the dialog Faceplate Appearance tag missing.

This is purely a tool-side defect in the cross-reference generation between the faceplate container and the faceplate instance. The PLC tag, the HMI tag, and the property interface are all correctly defined; the broken link is internal to the WinCC project database.

Resolution Path

Primary Fix — Update the Engineering Software

Siemens has addressed this defect in the following updates:

After installing the update, recompile the HMI station fully (Project tree → HMI_1 → Compile → Software (rebuild all)). Re-download the entire runtime, not just delta, because the faceplate container XML is regenerated.

Workaround for V14 SP1 Without UPD3

If updating the engineering tool is not immediately possible, the following manual workaround restores the link:

  1. Open the faceplate type in the editor.
  2. Delete the Appearance animation on the affected object (e.g., the circle).
  3. Add a temporary intermediate property (e.g., colorAux : Int) and bind Appearance to that property.
  4. Map colorAux to the original state property through a script or through an additional animation on the faceplate interface.
  5. Compile and download.

This forces the compiler to re-create the internal cross-reference.

Prerequisites for a Healthy Faceplate Animation

Before applying the patch or the workaround, confirm that the basic configuration of the faceplate is correct. Most "non-working" reports are caused by configuration drift rather than the compiler bug.

PLC Tag Definition

  • The PLC tag (e.g., DB1.HMI_State) must be defined in the PLC data block with the same data type as the faceplate property (typically DInt or Int).
  • The HMI connection must be compiled so that the tag is reachable from the HMI. Trigger with Compile → Software (rebuild all) on the PLC station first, then on the HMI.

Faceplate Property Interface

  • Open HMI → Faceplates → [Type name] and confirm the property is listed in the Interface column.
  • Set Type to DInt (or the same as PLC) and Name to the value used in the script (e.g., state).
  • Tick Plc-relevant only if the value must be read back from PLC; otherwise leave clear to keep the tag internal to the HMI.

Animation Configuration

  1. Select the graphic object inside the faceplate (e.g., the circle).
  2. In Properties → Animations add Appearance.
  3. For Variable choose the faceplate property, not an external HMI tag. The drop-down lists every property declared on the faceplate interface — if state is missing, the interface is not properly published.
  4. Define the value ranges in the appearance table. Example mapping for the three-state indicator:
    Property value Range type Background color Blink
    0 Single value White (0xFFFFFF) Off
    1 Single value Green (0x00C000) Off
    2 Single value Red (0xC00000) On, 250 ms / 250 ms

Step-by-Step: Building the Faceplate from Scratch

  1. Create a new faceplate type: Project tree → HMI_1 → Faceplates → Add new faceplate. Name it FP_StatusIndicator.
  2. In the faceplate editor, draw a circle (radius 60 px) and a text field. Add a property state : DInt in the Interface column.
  3. Select the circle → Properties → Animations → Appearance. Bind the variable to the state property. Add the three value ranges from the table above.
  4. Save the faceplate type. The compiler auto-generates the internal HMI tag ::FP_StatusIndicator::state.
  5. On the process screen, drag the faceplate from the Toolbox → Faceplates panel onto the canvas.
  6. In the faceplate instance configuration panel, set the state property to the PLC tag "DB_HMI".HMI_State (HMI tag pointer, not raw name).
  7. Compile the HMI station with Software (rebuild all) and start the Runtime simulation. The circle should turn green when the PLC writes 1, red blinking when the PLC writes 2.
  8. If the simulation passes but the on-device Runtime does not, the project has the V13 / V14 SP1 defect. Apply the update and re-deploy.

Working with SiVArc and Generated Faceplates

When faceplates are generated automatically through SIMATIC Visualization Architect (SiVArc), the property-to-animation binding is driven by the generation template, not the manual drag-and-drop flow. The official Siemens documentation explains that to generate animations for faceplates with SiVArc, the dynamic properties for the animation must be configured in the faceplate type that serves as the generation template. See the example Generating faceplates with animations - SiVArc for the exact workflow in TIA Portal V20 (the same principle applies to V14 onward).

SiVArc-Specific Pitfalls

  • Template mismatch: The generation template must contain the Appearance animation in the faceplate type itself, not in an overlay. SiVArc only copies bindings that are baked into the type.
  • Property propagation: If the SiVArc rule assigns the state property from a UDT instance, the data type must match exactly (DInt → DInt). A mismatch silently nulls the internal tag at generation time.
  • Regeneration: After updating TIA Portal (V13 SP1 or V14 SP1 UPD3), regenerate all SiVArc outputs with Generate → Regenerate all visualization. Do not rely on incremental generation; the faceplate container XML must be re-emitted.

Verification Procedure

After applying the patch and re-downloading, validate the fix on the actual target (Panel or PC Runtime):

  1. Open the project on the HMI. The faceplate should render in its default state (white).
  2. From the PLC, write 1 to DB_HMI.HMI_State (e.g., from a watch table in TIA Portal). The circle should turn green within one polling cycle (default 1 s for cyclic acquisition, 100 ms for "On change").
  3. Write 2. The circle should turn red and begin blinking at the configured period (250 ms in this example).
  4. Write 0. The circle should return to white and stop blinking.
  5. Open the HMI diagnosis view (Diagnostics → Runtime diagnostics) and confirm that no Faceplate Appearance tag missing warning is logged for the faceplate container.

Reading the HMI Logs

Activate extended logging in Runtime settings → Services → Diagnostics and reproduce the animation. The generated *.log file in the runtime directory contains entries such as:

[HmiRt] Faceplate 'FP_StatusIndicator' instance 1: appearance tag 'state' linked
[HmiRt] Animation 'Appearance' on object 'Circle_1' updated value=1

Absence of the first line after a tag write indicates the cross-reference is still broken.

Performance and Polling Considerations

Acquisition mode Default cycle CPU load on HMI Suitable for
Cyclic continuous 1 s Low Slow status indicators
Cyclic in operation 100 ms Medium Process alarms
On change Event-driven Lowest Boolean transitions, error states
On demand (via script) Manual Minimal Driven by user actions

For the three-state indicator in this article, set acquisition to Cyclic in operation at 500 ms. This gives sub-second response without flooding the HMI–PLC link when the value is steady.

Troubleshooting Matrix

Symptom Likely cause Action
Animation works in simulation, fails on device. V13 base / V14 SP1 compiler defect. Install V13 SP1 or V14 SP1 UPD3 and re-download.
"Faceplate Appearance tag missing" warning on compile. Property not published in faceplate interface. Re-open faceplate type, confirm property is listed in Interface column with correct data type.
Animation triggers but with wrong colors. Value ranges mis-ordered in the appearance table. Sort the value ranges; "Single value" entries must not overlap and must be in ascending order.
Blink does not work on the red state. Blink attribute unchecked or set on the wrong value range. Tick Blink on the value range 2 only. Verify blink period (default 250 ms / 250 ms).
Animation does not respond at all; warning is silent. Internal HMI tag not propagated to the faceplate container. Delete and re-add the faceplate instance on the screen, then re-bind the property.
Tag value updates but the faceplate property reads 0. HMI tag pointer resolves to the wrong address; area pointer or DB number drifted after recompile. Re-compile PLC first, then HMI, in that order. Verify the connection list shows the DB block.
Multiple faceplate instances update in cascade with delay. Acquisition cycle too slow for the number of instances. Switch from 1 s cyclic to "On change" for binary states, or distribute across multiple HMI connections.
Imported picture element does not animate. Imported graphics are static objects; animations are not supported on imported picture content. Redraw the indicator using native WinCC shapes (Circle, Rectangle) so that Appearance can be applied.

Notes on Long-Term Maintenance

Once the project is moved to V15 or later, the legacy Appearance animation can be migrated to the newer Styles property in WinCC Unified. The new styles engine handles state changes through CSS-like attribute selectors and is not subject to the cross-reference defect that affected V13 and V14 SP1. For new projects, prefer WinCC Unified (V16+) where the platform is supported. Existing Comfort/Advanced projects should remain on a patched V14 SP1 UPD3 (or V15.1) baseline for the rest of their lifecycle.

FAQ

Why does my faceplate animation work in WinCC RT Simulation but not on the actual Panel?

The RT Simulation uses a different code path than the on-device Runtime. In TIA Portal V13 base release and again in V14 SP1 (a regression), the compiler fails to generate the internal cross-reference between the faceplate property and the Appearance animation, even though the project compiles without a hard error. Install V13 SP1 or V14 SP1 UPD3 and re-download the complete runtime to restore the link.

What does the warning "Faceplate Appearance tag missing" mean?

It means the internal HMI tag that WinCC auto-generates from the faceplate property was not created or not propagated to the faceplate container. The PLC tag and the faceplate interface are usually correct — the broken link is internal to the WinCC project database. The fix is the SP1 UPD3 patch plus a full rebuild all on the HMI station.

Can I animate an imported picture (PNG, SVG, DXF) inside a faceplate?

No. Imported graphics are static objects in WinCC Comfort/Advanced; only visibility is animatable on them, and even that is limited. For a color-changing or blinking indicator, redraw the object using native WinCC shapes (Circle, Ellipse, Rectangle, Polygon) so that the Appearance animation can be applied.

How do SiVArc-generated faceplate animations differ from manual ones?

SiVArc copies the binding from the generation template into every instance. The Appearance animation must be configured inside the faceplate type, not in an overlay, and the property that drives it must be a faceplate-type property (not an external HMI tag). See the official example Generating faceplates with animations - SiVArc for the V20 workflow, which applies identically to V14 onward.

Which TIA Portal version is the recommended baseline for new WinCC faceplate projects today?

For WinCC Comfort/Advanced (Classic) projects, use TIA Portal V15.1 or V16 with all available updates applied. For new developments, prefer WinCC Unified starting in TIA Portal V16 — the modern Styles property is not subject to the V13/V14 SP1 cross-reference defect and offers better performance for high-instance-count dashboards.

Back to blog