Integrating B&R products in versiondog

Network diagram

System requirements

versiondog

Version

B & R Automation

3.0

4.0 4.1 4.2 4.3 4.4 4.5 4.6 4.7
3.1 ✓*                
4.0 ✓*          
7.0 ✓*

* Only comparison

Other requirements

In this tutorial:

Does my licence support B&R?

Check if BRAutomationStudio is listed in AdminClient > Licencing > Information tab > Data types field.
If it is not listed, see: What to do if B&R is not listed in Data types in versiondog

How do I integrate an existing B&R Automation Studio project into versiondog?

Quick answer: Create a B&R component, manually copy the complete B&R project (including the APJ file) into the versiondog working directory and then open the file in its editor (F4).
Detailed answer: Integrating existing B&R projects into versiondog

How do I create a new project for B&R Automation Studio for management within the versiondog system?

Quick answer: Create a B&R component, open the editor, create a new project in Automation Studio, save the project in the folder of your B&R component and then close Automation Studio, create a version, write a comment and check it in.
Detailed answer: Creating new B&R Automation Studio projects to manage it in versiondog

What is the first thing to check if you cannot open a B&R Automation Studio project from versiondog?

Quick answer: The B&R software is more restrictive with regard to special characters than versiondog. Verify that the path of the B&R component in versiondog does not contain any of the following characters: /*?"<>|&#$%§äöüÄÖÜ~'
Detailed answer: What is the first thing to check if you cannot open a B&R Automation Studio project from versiondog?

How do I back up a B&R device?

Quick answer: Create a B&R component, check-in a fully configured B&R project, create a new BRAutomationStudio job, configure the common settings of the job and then select the B&R device.
Detailed answer: Backing up B&R devices

How do I go back to a previous version on a B&R device?

Quick answer: Select the B&R component, check-out a working version of the B&R project, open the project with Automation Studio, transfer the project to the device using Automation Studio.
Detailed answer: Going back to a previous version on a B&R device

How do I perform disaster recovery of a backed up B&R device?

Quick answer: Select the B&R component, select the Jobs tab, select a backup, right-click the backup and select Copy backup to directory, select the directory into which the backup will be uncompressed, open the backup with B&R Automation Studio and download the backup onto the PLC.
Detailed answer: Performing disaster recoveries of a backed up B&R device

How do I configure versiondog to also back up projects in simulators?

Quick answer: You need to modify the upload\Classes.ini file: In the AdminClient, go to INI files, select upload\Classes.ini, (if not already in file) add to the file a [BRAutomationStudio] section, create the key 5435 and set it to Y
Detailed answer: Configuring versiondog to also back up projects in simulators

B&R Automation can create an upgrade folder for retro-compatibility purposes. How do I trigger the creation of this folder to include it in every version?

Quick answer: If you want to use the B&R Automation functionality that creates upgrade folders and include these folders in every version, you need to trigger the creation of such a folder every time you create a version. To do this, you need to modify the upload\Classes.ini file: In the AdminClient, go to INI files, select upload\Classes.ini, (if not already in file) add to the file a [BRAutomationStudio] section, create the key 17725 and set it to Y

Detailed answer: Configuring versiondog to also version the upgrade folders created by B&R

How do I set the standard language in B&R?

If your B&R editor does not open in the language you want when you double-click on a project (or open it from versiondog), then you need to change the path in the registry.

Quick answer: Open the Windows registry at HKEY_LOCAL_MACHINE\SOFTWARE\Classes\apjprogram\Shell\Open\command, and verify the value of the key (it is a path). The ./Bin-**/ part of the path determines the language. Change that part of the path. This will give you a path that ends similarly to this example:
"...\BrAutomation\AS40\Bin-en\AutomationStudio.exe" "%1"
The "en" opens the editor with the English interface.

Detailed answer: Changing the standard language of the B&R editor

B&R opens the most recent project and not the one I selected in versiondog. How can I remedy this?

If your B&R editor opens another project instead of the one you double-clicked or opened through versiondog, you need to make a change to your Windows registry:

Quick answer: Open the Windows registry. Go to HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.apj, and delete the value of the key.
Detailed answer: Configuring B&R so that it does not always open the last project

Due to the PLC.PKG, the version/ backup comparison is always showing a difference. How can I resolve this problem?

If the version/ backup comparison of PLC.PKG is constantly showing a difference, you can ignore this element when conducting a comparison. To do this, you will need to make changes to the compare\Classes.ini file.

Quick answer: In the AdminClient, go to INI files and select compare\Classes.ini and insert the following section into the file: [BRAutomationStudio] (If this is not already present) and create the key 17726 with the value Y.
Detailed answer:

Ignore PLC.PKG in version/ backup comparison

The version/backup comparison always shows a difference in the BR files that were created during runtime. How can I resolve this problem?

Quick answer: go to Jobs in the AdminClient, select the N&R Job that you wish to make the changes to. Then go to B&R Automation Studio Settings followed by Excluded BR Files. Here, you can select the BR Files that you wish to be ignored during the job execution. Save the changes.
Detailed answer:Ignore B&R files when executing jobs

There are many configurations present and when I try to execute a job, a warning message is always shown. How can I resolve this problem?

You can avoid this problem by ensuring that only active job configurations are taken into consideration when executing a job.

Quick answer: go to Jobs in the AdminClient, select the B&R Job that you wish to make the changes to. Then go to B&R Automation Studio Settings and activate the checkbox Only active configuration. This is located under Automation Studio settings. Save the changes.
Detailed answer: Check the box: Only the Active Configuration

How can I configure the PVITransfer.exe storage location?

To manually configure a location in which to save the PVITransfer.exe file, you must make changes in the Upload\AgentStation.ini file.

Quick answer: In the AdminClient, go to INI files and select Upload\AgentStation.ini and insert the following section into the file (If not already present) : [BRAutomationStudio]. Afterwards, create the key 5430 and enter as value aim to PVITransfer.exe.
Detailed answer: Configuring a place to save the PVITransfer.exe file


Last updated: 02 July 2020