Sysmac Studio

Overview

Copia provides support for Omron Sysmac Studio versions V1.26-V1.64, with advanced feature support for the following:

• Graphical Display and Differences

• Rung Commenting for Code Review

Copia has tested support back to V1.26, though it's likely that older versions can also be supported for rendering. If you are using older project versions and would like to see if they are supported, feel free to test in a repository or contact [email protected] so we can test for you.

---

Configuration

General

Copia supports Omron Sysmac Studio files, with .smc2 as the standard working file format.

To get set up, simply store the file in a Copia repository. Once you perform the appropriate commit and push operations, you'll be able to see your project file and all of its data from both the Web App and Desktop App.

Configuring Project Files (recommended)

By default, Sysmac Studio saves your projects locally in a hidden folder on the user's computer as a collection of individual files. Copia is only able to visualize changes made to a supported format (see Supported Types), so we recommend that you version control only those files using one of the following options.

Option 1: Configure Sysmac Studio to Save Projects in .smc2 Format

Newer versions of the Sysmac Studio allow users to configure the IDE so that it it manages project in units of files. This function can be enabled by selecting the "Manage in Project File" checkbox found on the Start Page. This option allows users to define the Save location to your repository's location and saves the file in the .smc2 format without any additional user steps required.

Option 2: Manually Export by Saving as .smc2 Format

If your IDE does not support Option 1, you can manually save the project in the .smc2 format by clicking File > Save As, configure the save location to be your repository's location, and set the Save as type to .smc2 .

---

Graphical Display and Differences

General

When the exported project file is selected in the Web App or Desktop App, Copia displays the project tree structure in a way that's familiar to users of the Sysmac Studio IDE. This way, you can easily navigate to a project item or identify differences.

Supported Types

The following Sysmac Studio file types are currently supported for graphical output:

File Type	Extension	Rendering Support
Sysmac Studio V1.00-V1.07 project file	.smc	✓
Sysmac Studio V1.08 or higher project file	.smc2	✓
Sysmac Studio V1.04-V1.07 compact project file	.csm	✓
Sysmac Studio V1.08 or higher Compact Project File	.csm2	✓
Sysmac library file	.slr	✓
Safety function block	.sfb	✕
Intelligent application gadgets	.iag	✕

The following project item types are currently supported for graphical output:

Any project items not found on this list do not have graphical rendering support. However, Copia is still able to detect and indicate if the project items are modified.

Type	Change Detection	Graphical Rendering
Ladder (LAD)	✓	✓
Structured Text (ST)	✓	✓
Variables	✓	✓
Data Types	✓	✓
FBD (Safety)	✓	✕
Other	✓	✕
Password-protected block	✓	✕

View Options

There are several options you can manage while viewing your Rockwell files in Copia.

• Show Unmodified Items

  This setting affects the tree view, and if enabled will display the items that are not modified

• Show System Items

  Sysmac Studio project files contain items that are not necessarily visible in the IDE, which is why Copia hides them by default. Enabling this toggle will reveal these items in the project tree.

• Hide Errored Items

  This lets you disregard all tag value changes

• Ignore Source Protected Items

  If source protected items are not exposed, they will be assumed to be different. In those cases, you can toggle them to be ignored, if desired.

• Show Unmodified Tags

  This applies to unmodified datatype and tag values

• Hide unchanged rungs

  This applies to logic rungs that have not changed

• Show XML

  This displays the difference in a direct XML text-based compare

The View Options dropdown on the left affects items in the project tree, while the one on the right controls more specific viewing settings for items that are in a focus state.

---

Code Commenting for Code Review

Copia supports PR commenting for Sysmac Studio the following:

• Ladder Logic code

• Structured Text code

• ariables

Code Commenting enhances the Code Review process once someone generates a Pull Request to merge a Branch. During the review process, users can add comments directly to the supported parts of the code.

You can watch an overview of rung commenting in the video below.

The product version in the video may be older than the current release, but the process is still applicable

Once the Pull Request is merged, you will be given the opportunity to delete the branch by clicking the Delete Branch button. This is an optional step that will only delete the branch in the remote repository -- the local branch will remain unless it is deleted locally.

---