Open .ap13 Files in STEP 7 Basic V12 TIA Portal Compatibility

David Krause15 min read
SiemensTIA PortalTutorial / How-to
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

Open .ap13 Files in STEP 7 Basic V12: TIA Portal Compatibility Guide

You received an S7-1200 project file with the .ap13 extension and STEP 7 Basic V12 (part of a TIA Portal V12 starter kit) refuses to open it. The error is not a defect in your installation — it is the documented one-way compatibility rule between TIA Portal major versions. This guide explains why the file is rejected, what the .ap number means, and the four supported paths to make the project usable: install a Hardware Support Package, request the V13 upgrade, switch to the V13 trial, or downgrade the project using Compatibility Mode V12 inside TIA Portal V13 SP1 or later.

1. TIA Portal Project Archive File Extensions

Each major release of TIA Portal uses a distinct archive file extension. The number after .ap identifies the originating TIA Portal version. TIA Portal refuses to open archives created by a newer major version because the underlying XML schema, block signatures, and CPU firmware descriptors have changed.

Archive Extension Originating TIA Portal Version Compatible Editors Notes
.ap11 TIA Portal V11 / V11 SP1 / V11 SP2 V11, V11 SP1, V11 SP2 First release of the unified STEP 7 / WinCC environment.
.ap12 TIA Portal V12 / V12 SP1 V12, V12 SP1 SP1 introduced bug fixes required by some S7-1200 firmware V4 CPUs.
.ap13 TIA Portal V13 / V13 SP1 / V13 SP2 V13, V13 SP1, V13 SP2 First release to support S7-1500 and S7-1200 firmware V4.x CPUs.
.ap14 TIA Portal V14 / V14 SP1 V14, V14 SP1 Added S7-1500 R/H redundant CPUs and OPC UA server.
.ap15 TIA Portal V15 / V15.1 V15, V15.1 Introduced multiuser editing and the Simulation Table (S7-PLCSIM V15).
.ap15_1 TIA Portal V15.1 V15.1, V16 (with restrictions) First release for SIMATIC Drive Controller.
.ap16 TIA Portal V16 V16, V17 Added Energy Suite and Modular Application Creator.
.ap17 TIA Portal V17 V17, V18 Introduced ProDiag and TIA Portal Cloud Connector.
.ap18 TIA Portal V18 V18, V19 GraphQL support, expanded S7-1200 G2 family.
.ap19 TIA Portal V19 V19, V20 Adds S7-1500 TM NPU and AI integration.
.ap20 TIA Portal V20 V20, V21 Current release family.
Archive vs project: An .apXX file is a zipped, exported TIA Portal project. Inside the ZIP the actual project carries the .apXX extension itself (a single-file container), not a folder. Use Project → Archive → Retrieve in TIA Portal to extract it.

2. Why STEP 7 Basic V12 Cannot Open .ap13

Per the official compatibility rules in the TIA Portal help system:

If you load the project data of an S7-1200 CPU with the TIA Portal V13, you can no longer use TIA Portal V12 to access this data. To do this, first restore the project in TIA Portal V13 and export it as a V12 archive.

Three structural changes in V13 break backward compatibility with V12:

  1. Block signature schema: V13 introduced a new compiled block signature (F-attribution and know-how protection fields). V12 cannot parse these fields and aborts the load with error 0900:00007F "Unknown block version".
  2. CPU firmware descriptor: V13 supports S7-1200 firmware V4.0 and V4.1. The CPU type records (Type="S7-1200/S7-1217" FW V4.1) are absent from the V12 device catalog.
  3. HMI tag connection routing: V13 routes HMI tags through symbolic connections that V12 stores differently. Loading a V13 project into V12 corrupts the HMI tag table.

Because the conversion is lossy, Siemens did not implement a one-click downgrade. The supported workflow requires a V13-or-newer editor to either downgrade the project or open it natively.

3. S7-1200 CPU Family vs TIA Portal Version

The S7-1200 starter kit (6AV6651-7DA02-3AA0 historically, plus regional variants) typically shipped with STEP 7 Basic V12 SP1 and a CD containing the S7-1212C DC/DC/DC firmware V3.0 image. Newer starter kits may include a S7-1217C DC/DC/DC whose firmware requires TIA Portal V13 or later.

CPU Model Order Number (MLFB) Firmware Minimum TIA Portal Recommended TIA Portal
S7-1211C DC/DC/DC 6ES7211-1AE40-0XB0 V4.0 / V4.1 / V4.2 / V4.3 / V4.4 / V4.5 / V4.6 / V4.7 V12 SP1 + HSP V13 SP1+ for FW 4.2+
S7-1211C DC/DC/Rly 6ES7211-1BE40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1212C DC/DC/DC 6ES7212-1AE40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1212C DC/DC/Rly 6ES7212-1BE40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1214C DC/DC/DC 6ES7214-1AG40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1214C DC/DC/Rly 6ES7214-1BG40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1215C DC/DC/DC 6ES7215-1AG40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1215C DC/DC/Rly 6ES7215-1BG40-0XB0 Same V12 SP1 + HSP V13 SP1+
S7-1217C DC/DC/DC 6ES7217-1AG40-0XB0 V4.0+ V13 V13 SP1+
S7-1217C DC/DC/Rly 6ES7217-1BG40-0XB0 V4.0+ V13 V13 SP1+
S7-1200 G2 (CPU 1211G / 1212G / 1214G / 1215G / 1217G) 6ES721x-1xxxxx-0XK0 family V5.0+ V18 Update 3+ V19 / V20
CPU detection at connect time: If you cannot establish an online connection from STEP 7 Basic V12 to an S7-1217C, the cause is the missing V13 device description. V12's PG/PC interface enumerates the device as "Unknown S7-1200 CPU" and rejects the connection. Online → Accessible nodes returns the CPU with its firmware version; cross-check that against the table above.

4. Compatibility Mode V12 in TIA Portal V13 SP1+

The most economical solution does not require an upgrade purchase. TIA Portal V13 SP1 introduced a Compatibility Mode V12 that lets V13 act as a V12 editor for the duration of the session, opening .ap12 archives in their original V12 schema.

From Siemens support entry 82169157: "In this case you must use 'Compatibility Mode V12'. However, this is only possible if a STEP 7 (TIA Portal) V12 SP1 project is open. For the case that you do [not have one]…"

Procedure:

  1. Install TIA Portal V13 SP1 or later. The free 21-day trial license (order 6ES7822-1AA03-0YA5 trial key) is sufficient for evaluation and for one-shot downgrade workflows.
  2. Start TIA Portal V13 SP1.
  3. Open a blank V12 SP1 project: Project → New → Templates → "V12 SP1 empty project". If the template is not visible, install it from the TIA Portal V13 SP1 installation media under Optional Packages → V12 Project Templates.
  4. With the empty V12 SP1 project open, choose Options → Compatibility Mode V12. The title bar changes to [Compatibility Mode V12].
  5. Use Project → Retrieve to open the friend's .ap13 archive. In Compatibility Mode V12, V13 will refuse only the bits it cannot downgrade; the project loads.
  6. Immediately Project → Archive → Archive As… and save as .ap12. The V12 archive is now usable in STEP 7 Basic V12 SP1.
  7. Exit Compatibility Mode (close V13). Open STEP 7 Basic V12 SP1 and open the new .ap12 archive.
Lossy downgrades: V13 features that do not exist in V12 (e.g., S7-1200 FW V4.1 motion blocks, S7-1500 devices, GRAPH V13 enhancements) are removed during the downgrade. Expect a TIA Portal warning dialog listing the dropped items before the archive is written.

5. Hardware Support Packages (HSP) for V12 SP1

If you intend to keep working in STEP 7 Basic V12 SP1, the second path is to add CPU support without changing the editor. Siemens publishes HSPs that add new CPU modules and firmware revisions to the device catalog of an existing TIA Portal version.

HSP Designation For TIA Portal Adds
HSP TIA Portal V12 SP1 — S7-1200 FW 4.0 V12 SP1 Initial FW 4.0 CPU support (1211C–1217C FW V4.0.0)
HSP TIA Portal V12 SP1 — S7-1200 FW 4.1 Update 1 V12 SP1 FW V4.1.x bug fixes; S7-1217C 6ES7217-1xx40-0XB0
HSP TIA Portal V12 SP1 — S7-1200 FW 4.2 V12 SP1 FW V4.2 (motion and PTO improvements)
HSP TIA Portal V13 — S7-1200 FW 4.4 V13 FW V4.4 (new OPC UA server, extended PROFINET)
HSP TIA Portal V13 SP1 — S7-1200 FW 4.5 V13 SP1 FW V4.5 (security updates, TLS)

Installation:

  1. Locate the HSP file (typically HSP_TIA_Portal_V12_SP1_S7-1200_FW_4.1.hsp) on the starter kit DVD or download from the Siemens support site entry for TIA Portal V12 SP1 HSPs.
  2. Start STEP 7 Basic V12 SP1 with administrator rights.
  3. Options → Support Packages → Install. Browse to the .hsp file and confirm.
  4. Restart the TIA Portal. The new CPUs appear under Add new device → SIMATIC S7-1200 → CPU → <firmware>.
HSPs do not change the archive format. An HSP lets V12 SP1 create and edit projects for a CPU that was not in the original device catalog, but it does not let V12 SP1 open a V13 archive. The .ap13 schema is independent of the device catalog. To open an .ap13, you still need either a V13 editor or the downgrade path described in section 4.

6. Upgrade Paths from STEP 7 Basic V12

If you intend to keep working on the S7-1217C long-term, the cleanest path is the official upgrade. The license model is cumulative: an existing license is a prerequisite for the upgrade license.

Source License Target License Order Number (MLFB) Notes
STEP 7 Basic V12 (6ES7822-0AA02-0YA5) STEP 7 Basic V13 (PowerPack) 6ES7822-0AA02-0YE5 Same Basic feature set as V12 but on V13 platform.
STEP 7 Basic V12 (6ES7822-0AA02-0YA5) STEP 7 Professional V13 (PowerPack) 6ES7822-1AA03-0YE5 Adds S7-300/400, WinCC Professional, GRAPH, SCL.
STEP 7 Basic V12 SP1 STEP 7 Basic V13 SP1 (PowerPack) 6ES7822-0AA02-0YG5 Recommended to also pick up V13 SP1 bug fixes.
STEP 7 Basic V13 (license-only) STEP 7 Basic V14 (PowerPack) 6ES7822-0AA02-0YJ5 Skips to V14 to avoid paying twice.
STEP 7 Professional V13 STEP 7 Professional V16 (combo PowerPack) 6ES7822-1AA04-0YK5 Covers V14, V15, V16 in one license.
  1. Order the PowerPack from your local Siemens sales channel (online or via sales rep).
  2. You receive a License Key USB stick (orange) labeled with the new MLFB.
  3. Install the new TIA Portal version (V13, V13 SP1, or later) on top of V12 — the installer supports side-by-side installation.
  4. Transfer the license: Start → All Programs → Siemens Automation → Automation License Manager → Move License… from the old USB to the new USB.
  5. Start TIA Portal V13. The License Manager detects the upgraded key and unlocks the new feature set.

7. 21-Day Trial License

For one-off evaluation — for example, to read a friend's .ap13, downgrade it, and walk away — request a 21-day trial from your Siemens rep or from the Siemens Industry Online Support portal. The trial is full-featured (no Basic/Pro distinction), and you can run V13 or V13 SP1 alongside V12.

  1. Download the TIA Portal V13 SP1 trial installer from the Siemens support page.
  2. During installation select Trial as the licensing mode.
  3. After 21 days the editor goes into a 14-day grace period, after which it refuses to start.
  4. The trial license cannot be extended, and any project saved during the trial is fully usable in the licensed version once you upgrade.
Trial gotcha: The 21-day clock starts at first use, not at install. Plan the evaluation to coincide with the project hand-off date from your friend.

8. Step-by-Step: Complete Workflow to Open a .ap13 in STEP 7 Basic V12

Use this procedure when the editor you have licensed is V12 Basic and the project arrived as .ap13. It combines the Compatibility Mode V12 method with the trial license for minimum cost.

8.1 Prerequisites

  • STEP 7 Basic V12 SP1 installed and licensed (your existing starter kit).
  • TIA Portal V13 SP1 trial installed (no license required, 21-day window).
  • At least 25 GB free disk space for the TIA Portal installation footprint plus the .ap13 archive (typical project: 5–500 MB).
  • Administrator rights on the engineering PC.
  • Offline access — the downgrade does not need a connected PLC.

8.2 Procedure

  1. Copy the friend's .ap13 file into a working folder such as C:\TIA\Projects\FriendProject\.
  2. Start TIA Portal V13 SP1.
  3. Create a new project: Project → New, name it DowngradeStaging, choose template V12 SP1 empty project. Save.
  4. With the empty V12 SP1 project open, click Options → Compatibility Mode V12. Confirm. The status bar shows [Compatibility Mode V12].
  5. Choose Project → Retrieve. Select the .ap13 archive. TIA Portal will issue warnings about V13 features that cannot be downgraded — read the list, click Continue only if the affected blocks are non-critical to your work.
  6. Verify the project loaded: Project tree → PLC_1 → Program blocks should show the blocks. Note any block marked with a red exclamation mark — these failed the downgrade and must be re-coded in V12 syntax.
  7. Choose Project → Archive → Archive As… Save as FriendProject.ap12.
  8. Close TIA Portal V13 SP1.
  9. Start STEP 7 Basic V12 SP1.
  10. Project → RetrieveFriendProject.ap12. The project opens in V12.
  11. Compile: right-click PLC_1Compile → Software (rebuild all blocks). Any block that fails to compile is a V13-only feature; rewrite it in V12 syntax.
  12. Save and proceed with your work.

9. Online Connection Problems After Downgrade

Even after a clean downgrade, you may not be able to go online with the S7-1217C from STEP 7 Basic V12 SP1. The Online → Accessible nodes scan returns nothing, or returns the CPU with a red icon and a message "Online: The firmware version is not supported by this version of STEP 7."

Root cause and remedy by symptom:

Symptom Root Cause Remedy
Accessible nodes empty, PROFINET cable plugged in V12 SP1 has no driver for the S7-1217C Ethernet interface Install the V12 SP1 HSP for FW 4.1 (see section 5).
Accessible nodes shows CPU with red X CPU firmware is newer than the editor supports Upgrade the editor to V13 (recommended) or downgrade the CPU firmware (only possible if a V12 SP1 image is bundled in the CPU service pack).
"Online: The firmware version is not supported" CPU FW V4.2+, editor is V12 SP1 V12 SP1 HSP chain tops out at FW V4.2. For FW V4.3+ you must use TIA Portal V13 SP1 or later.
Compile of blocks fails with "Unknown instruction" V13-specific instruction dropped during downgrade Replace with V12 equivalent (e.g., CTRL_PTO V13 → V12 CTRL_PTO with limited parameter set).
HMI tags show as "Connection not configured" V13 symbolic connections do not downgrade Recreate the HMI connection manually in V12 with absolute addressing, or run the project in V13.

10. Troubleshooting Matrix

Error / Symptom When Root Cause Fix
"The project data cannot be loaded because it was created with a newer TIA Portal version." Open .ap13 in V12 Version mismatch Use V13 SP1 + Compatibility Mode V12 (section 4) or upgrade editor.
"Cannot install HSP: file corrupt" Installing .hsp in V12 SP1 without SP1 baseline V12 base (no SP1) cannot accept newer HSPs First install V12 SP1 update, then re-attempt the HSP install.
"License not found" after upgrade Moving license key Automation License Manager did not detect new USB Re-seat the USB stick, click Refresh in ALM, restart TIA Portal.
V13 trial expired mid-project After 21 days Trial clock Purchase upgrade; the project saved during trial is fully usable.
Project compiles but will not download to CPU Downgraded project in V12, CPU firmware is V4.2+ V12 cannot load V4.2 firmware images Either use V13 editor or downgrade CPU firmware via the SIMATIC Automation Tool.
"Project password protected" Opening friend's project Know-how protection set Ask the friend for the password; V12/V13 do not bypass it.
Empty online diagnostics V12 SP1 + S7-1217C V12 SP1 does not know the device Install the V12 SP1 FW 4.1 HSP at minimum.

11. Verification Checklist

After completing the downgrade workflow, run through this verification list before signing the project off.

  1. Archive round-trip: The .ap12 archive opens in V12 SP1 with no error dialog. Pass = clean open.
  2. Block compile: Compile → Software (rebuild all blocks) returns 0 errors, 0 warnings. Pass = clean compile.
  3. Hardware configuration compile: Right-click the PLC → Compile → Hardware (rebuild). Pass = no device errors.
  4. PLC online accessibility: Online → Accessible nodes lists the S7-1217C with a green check. Pass = online connection.
  5. Block compare: Online → Compare offline/online shows no unexpected differences (only the project-level signature differs).
  6. Download test: On a non-production S7-1217C, download and run the project. Verify the user program runs in RUN mode with no diagnostic buffer entries.
  7. Watch table test: Open the watch table, force a known input, verify the expected output.

12. Frequently Asked Questions

Can I open a .ap13 project in STEP 7 Basic V12 SP1 at all?

No. STEP 7 Basic V12 SP1 cannot open archives produced by TIA Portal V13 or later. The official remedy is to open the .ap13 in TIA Portal V13 SP1 (or newer) using Compatibility Mode V12, re-archive as .ap12, and then open the new archive in V12 SP1. See Siemens support entry 82169157.

What is the cheapest way to view a .ap13 file I received from someone else?

Install the free TIA Portal V13 SP1 trial (21-day license). Open the .ap13 natively, or use Compatibility Mode V12 to downgrade and re-archive as .ap12 for use in your licensed V12 editor. See the TIA Portal version compatibility documentation for the full ruleset.

Do I need TIA Portal Professional or is Basic enough for an S7-1217C?

TIA Portal Basic is sufficient for the S7-1200 family, including the S7-1217C. Professional is required only when the project also contains S7-300/400, WinCC Professional, GRAPH, SCL, or S7-1500. For a pure S7-1217C + KTP700 Basic HMI setup, V13 Basic is enough. See the TIA Portal version compatibility table for editor-vs-CPU mapping.

Will installing a Hardware Support Package let me open a .ap13 in V12 SP1?

No. HSPs add new CPU types to the device catalog so V12 SP1 can create projects for those CPUs, but HSPs do not change the V12 archive schema. An .ap13 archive is rejected at the XML level, not the device level. You still need a V13-or-newer editor to open the archive.

Why does TIA Portal V13 force my V12 SP1 project into V13 format when I save it?

Saving in V13 always writes the V13 schema, regardless of whether Compatibility Mode V12 was active. Compatibility Mode V12 only affects the open path. To preserve a V12-format file, you must re-archive explicitly as .ap12 using Project → Archive → Archive As… before closing the project.

What order numbers do I need to upgrade from V12 Basic to V13?

The V12 to V13 Basic PowerPack is 6ES7822-0AA02-0YE5; the V12 Basic to V13 Professional PowerPack is 6ES7822-1AA03-0YE5. The license is delivered on a USB stick and moved to a new USB via the Automation License Manager after V13 is installed.

Back to blog