# Siemens Step7 5.x

## Supported Configurations

**Key:**

<mark style="color:green;">**✓**</mark><mark style="color:blue;">**:**</mark> Part of a supported configuration

<mark style="color:red;">**✕:**</mark> Not supported and no plans to add support

<table><thead><tr><th width="393">Step7 Version</th><th>Supported?</th></tr></thead><tbody><tr><td>v5.7 SP1-SP3</td><td><mark style="color:green;"><strong>✓</strong></mark></td></tr><tr><td>v5.6 SP2</td><td><mark style="color:green;"><strong>✓</strong></mark></td></tr><tr><td>v5.5 and earlier</td><td><mark style="color:red;"><strong>✕</strong></mark></td></tr></tbody></table>

| PLC Model         | Supported?                                       |
| ----------------- | ------------------------------------------------ |
| S7-300 Non-Safety | <mark style="color:green;">**✓**</mark>          |
| S7-400 Non-Safety | <mark style="color:green;">**✓**</mark> \[2]     |
| S7-300F Safety    | <mark style="color:green;">**✓**</mark> \[1]     |
| S7-400F Safety    | <mark style="color:green;">**✓**</mark> \[1]\[2] |

\[1] Can back up blocks from regular programs but not safety programs

\[2] S7-400 Multi-Compute configuration not supported

{% hint style="warning" %}
**Note:** Step7 v5 PLCs do not store the variable names or symbol tables on-device. As such, Copia backups will use whatever symbol tables and variable names exist in the Source Control project file, and will not include new or modified variable names or symbol tables.
{% endhint %}

### DeviceLink Limitations for SIMATIC Manager

Some SIMATIC Manager features affect DeviceLink's ability to perform backups:

* **Know-How Protected Blocks**: DeviceLink can back up Know-How protected blocks, and the contents of Know-How protected blocks are rendered in the Copia web app. Copia does not obscure the contents of Know-How protected blocks.
* **Block Privacy**: DeviceLink does not support SIMATIC Manager projects with blocks that were encrypted with the Block Privacy feature. A backup will fail if the project contains blocks encrypted with Block Privacy.
* **CPU Access Protection**: DeviceLink can back up projects with CPU write protection but not CPU read protection. A backup will fail if the CPU has read protection.
* **Safety Programs**: DeviceLink can back up safety (F-series) CPUs. However, DeviceLink can only back up the non-safety program of the CPU. DeviceLink cannot back up the safety program that was created with Distributed Safety. In other words, DeviceLink cannot back up F-CALL, F-FB, F-FC, nor F-DB blocks.
* **Multiprojects**: DeviceLink cannot back up S7-400 Multiprojects. However, DeviceLink can back up a single project containing multiple stations.
* **Multicompute**: DeviceLinkc annot back up CPUs in multicompute configurations.
* **Non-S7 Programs**: DeviceLink can only back up S7 programs. It cannot back up non-S7 programs such as SINAMICS drives or WinCC Flexible HMIs.
* **Block Types**: DeviceLink can only back up FB, FC, DB, and OB blocks. DeviceLink cannot back up system blocks (SDB, SFC, SFB), User Defined Data Types (UDT), Variable Tables (VAT), nor safety blocks (F-CALL, F-FB, F-FC, F-DB).&#x20;
* **Hardware Configuration**: DeviceLink does not detect changes to hardware configuration.

## Agent Requirements

Below are the Agent system requirements to configure a Copia Agent for the backup of Siemens Step7 TIA Portal projects:

* You will need a licensed copy of Siemens Step7 5.x (see [supported versions](https://docs.copia.io/docs/overview/supported-vendors-and-device-types)) that is capable of backing up a Project from the Device(s). If there are many versions of a Project that will be managed by the Agent, each version should be installed. The Agent should be able to backup the project without error.
* The Windows user account with Siemens Step7 5.x installed must remain logged in.
* The PG/PC Interface in Simatic Manager must be configured correctly in order to for the Agent to go online and back up all PLCs.

### SIMATIC Manager PG/PC Interface

In SIMATIC Manager the PG/PC Interface must be set to the interface that will allow going online to the PLC(s). For example if the PLCs are networked to the Agent over Ethernet via an Intel(R) PRO/1000 MT Desktop Adapter, the corresponding TCP/IP adapter must be selected in the "Set PG/PC Interface" menu:

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FlVCCEXNQ2BELScawmgeb%2Fimage.png?alt=media&#x26;token=76a662b4-22e0-41c5-86a8-8731b439c8e1" alt=""><figcaption><p>The "Set PG/PC Interface" menu in SIMATIC Manager, with the "Intel(R) PRO/1000 MT Desktop Adapter.TCPIP" interface selected</p></figcaption></figure>

## New Project Configuration

To configure a new project for Siemens Step7 5.x, you will need a repository containing the Siemens Step7 5.x `.zip` file.

Click either of the *Add a Project* buttons in the Projects tab.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2Fne2KmUwhbSS6N4IXtece%2FWebApp_Projects_FANUC_AddProject.png?alt=media&#x26;token=80e5f56f-c026-4621-b3db-5a09d59b4576" alt=""><figcaption></figcaption></figure>

The *Add a new project* configuration dialog will appear which allows you to fully configure the project, devices and job for the project.

{% hint style="info" %}
Any items highlighted with an asterisk are required.
{% endhint %}

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FcwaXoFHfSdW3yPKP7gF1%2Fnew_project_flow_a.png?alt=media&#x26;token=600d35fd-b785-4180-826b-1d53f4d0b972" alt=""><figcaption></figcaption></figure>

This is a multi-step process with each section explained in detail.  At any time, you can edit the prior section of this workflow.   &#x20;

{% hint style="info" %}
Project can be edited after creation.  Devices and Jobs can also be edited or created directly, using the Devices or Jobs tab.  The steps for creation are similar to the steps provided below for those sections.
{% endhint %}

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FMcEBl1XWIFew5MWB3R6D%2Fdevicelink-step7-5.x-initial-project-setup.png?alt=media&#x26;token=a1324e11-3b6a-45c4-95fe-ceed6b1f9089" alt=""><figcaption></figcaption></figure>

You will now select the Project Path, which is the location (Repo/Branch) that the project is, or will be stored.

{% hint style="info" %}
As seen, you can edit the previous steps at any time.
{% endhint %}

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2F8oOyxY7IaIchojD0yh2h%2Fdevicelink-step7-5.x-select-repo.png?alt=media&#x26;token=48426d97-c15b-4a89-ba91-b8490791021d" alt=""><figcaption></figcaption></figure>

When creating a Step7 5.x DeviceLink Project, you will only be allowed to select .zip files in this step.

Once selected, press *Save and Continue* to proceed.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FG1ZajOJaY6tapcRejw5s%2Fdevicelink-step7-5.x-select-project-file.png?alt=media&#x26;token=b40c4668-9831-4e82-b342-1fbc272e531f" alt=""><figcaption></figcaption></figure>

The project details allows you to update the Project name and description if desired.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FItxy4wiz4DRWLS6GU6ck%2Fdevicelink-step7-5.x-define-project-name.png?alt=media&#x26;token=11ae6685-a4db-43bf-beb9-264c34ce1ff4" alt=""><figcaption></figcaption></figure>

## Define the Device(s)

The Device Setup section is for defining the device information (PLC, network, authentication, etc.) that is in your project.  If you have already created your devices, you can add existing devices to the project. If not, you can *Add a Device* as shown below.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FaRJKr8NfwpgXRSqyfG8J%2Fdevicelink-step7-5.x-device-config.png?alt=media&#x26;token=85d18399-c678-48aa-87e6-ea6685955092" alt=""><figcaption></figcaption></figure>

Fill in all required fields, and any fields that are applicable. &#x20;

* Enter a **unique** name in the *Device Name* field.  A common choice may be "*projectname\_devicename"*, where devicename is the same as the next field.
* In the *Device Name in Project* field, enter the name of the PLC exactly how it appears in the SIMATIC Manager object tree, as seen below.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FVnIs2LErTozMTWOcWO0v%2Fimage%20(2).png?alt=media&#x26;token=96c88c71-ad16-4355-bcf2-e944c4c1177d" alt=""><figcaption><p>In this example, the "Device Name in Project" field should be filled with "SIMATIC 300 Station"</p></figcaption></figure>

* Check the "Partial Backups" box if you are configuring a subset of the project's devices in Copia and want the backup to succeed despite not all devices being configured.
* Enter an optional Description.

Press *Save Device* when complete.

At this point, if it is a multi-device (PLC) project, you should continue to add all of the devices. Once complete, you can proceed to *Add a Job*.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2Fpb9j6KhwFr8CjnFcII62%2Fimage.png?alt=media&#x26;token=e70ee09c-2b3f-47a4-8485-a686d1b97747" alt=""><figcaption></figcaption></figure>

### Define the Job(s)

Creating Jobs is similar for all vendor types, and is described in the [Creating Jobs](https://docs.copia.io/docs/devicelink/jobs/creating-jobs) section.  It is recommended to review that section while completing a job configuration, and press Save to save the job.  You can create more than one job for a device if desired.&#x20;

#### Back Up Actual DB Value Changes

Ticking the *Back Up Actual DB Value Changes* checkbox will instruct DeviceLink to back up actual (current) values in DB blocks. The values will be included in the comparison to the reference program when determining whether the program has differences. If *Back Up Actual DB Value Changes* is left unticked, DeviceLink will still back up and compare the source code of DBs, including initial values, but actual values will be ignored. Leave *Back Up Actual DB Value Changes* unticked if your program has DBs with frequently changing values and the changes are unimportant.

If *Back Up Actual DB Value Changes* is unticked, actual DB value changes may still appear in backup results when a DB also has source code changes. This is because DeviceLink always backs up the entire DB contents, including actual values, when it detects changes to the DB's source code.

### Submit the Configuration

Once complete, press *Submit Project Setup* to create the Project, Device(s) and Job(s).

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FLFkiK30tpkhanbHkCtLK%2Fimage.png?alt=media&#x26;token=a6872651-d303-4054-9e13-4cceb15814a4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Don't forget to enable/disable the [Watch ](https://docs.copia.io/docs/projects-and-devices#watching-a-project)button, based on your preferences for project [Notifications](https://docs.copia.io/docs/devicelink/administration/notifications).
{% endhint %}