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. |
.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:
-
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". -
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. - 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 |
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:
- 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.
- Start TIA Portal V13 SP1.
- 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.
- With the empty V12 SP1 project open, choose Options → Compatibility Mode V12. The title bar changes to
[Compatibility Mode V12]. - Use Project → Retrieve to open the friend's
.ap13archive. In Compatibility Mode V12, V13 will refuse only the bits it cannot downgrade; the project loads. - Immediately Project → Archive → Archive As… and save as
.ap12. The V12 archive is now usable in STEP 7 Basic V12 SP1. - Exit Compatibility Mode (close V13). Open STEP 7 Basic V12 SP1 and open the new
.ap12archive.
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:
- 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. - Start STEP 7 Basic V12 SP1 with administrator rights.
-
Options → Support Packages → Install. Browse to the
.hspfile and confirm. - Restart the TIA Portal. The new CPUs appear under Add new device → SIMATIC S7-1200 → CPU → <firmware>.
.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. |
- Order the PowerPack from your local Siemens sales channel (online or via sales rep).
- You receive a License Key USB stick (orange) labeled with the new MLFB.
- Install the new TIA Portal version (V13, V13 SP1, or later) on top of V12 — the installer supports side-by-side installation.
- Transfer the license: Start → All Programs → Siemens Automation → Automation License Manager → Move License… from the old USB to the new USB.
- 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.
- Download the TIA Portal V13 SP1 trial installer from the Siemens support page.
- During installation select Trial as the licensing mode.
- After 21 days the editor goes into a 14-day grace period, after which it refuses to start.
- The trial license cannot be extended, and any project saved during the trial is fully usable in the licensed version once you upgrade.
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
.ap13archive (typical project: 5–500 MB). - Administrator rights on the engineering PC.
- Offline access — the downgrade does not need a connected PLC.
8.2 Procedure
- Copy the friend's
.ap13file into a working folder such asC:\TIA\Projects\FriendProject\. - Start TIA Portal V13 SP1.
- Create a new project: Project → New, name it
DowngradeStaging, choose template V12 SP1 empty project. Save. - With the empty V12 SP1 project open, click Options → Compatibility Mode V12. Confirm. The status bar shows
[Compatibility Mode V12]. - Choose Project → Retrieve. Select the
.ap13archive. 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. - 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.
- Choose Project → Archive → Archive As… Save as
FriendProject.ap12. - Close TIA Portal V13 SP1.
- Start STEP 7 Basic V12 SP1.
-
Project → Retrieve →
FriendProject.ap12. The project opens in V12. - Compile: right-click PLC_1 → Compile → Software (rebuild all blocks). Any block that fails to compile is a V13-only feature; rewrite it in V12 syntax.
- 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.
-
Archive round-trip: The
.ap12archive opens in V12 SP1 with no error dialog. Pass = clean open. - Block compile: Compile → Software (rebuild all blocks) returns 0 errors, 0 warnings. Pass = clean compile.
- Hardware configuration compile: Right-click the PLC → Compile → Hardware (rebuild). Pass = no device errors.
- PLC online accessibility: Online → Accessible nodes lists the S7-1217C with a green check. Pass = online connection.
- Block compare: Online → Compare offline/online shows no unexpected differences (only the project-level signature differs).
- 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.
- 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.