SoMachine V3.

1
Service Pack 1

Release Notes
.

Release Date: October 2012

This document contains important information

about the SoMachine software update. Please read the complete
document before you run the update.

This documentation is not intended as a substitute for and is not to be used for determining suitability or reliability of these
products for specific user applications. It is the duty of any such user or integrator to perform the appropriate and complete
risk analysis, evaluation and testing of the products with respect to the relevant specific application or use thereof. Neither
Schneider Electric nor any of its affiliates or subsidiaries shall be responsible or liable for misuse of the information
contained herein. All pertinent state, regional, and local safety regulations must be observed when installing and using this
product. When devices are used for applications with technical safety requirements, the relevant instructions must be
followed. Failure to use Schneider Electric software or approved software with our hardware products may result in injury,
harm, or improper operating results. Failure to observe this information can result in injury or equipment damage. If you
have any suggestions for improvements or amendments or have found errors in this publication, please notify us. No part of
this document may be reproduced in any form or by any means, electronic or mechanical, including photocopying, without
express written permission of Schneider Electric.

© 2012 Schneider Electric. All rights reserved.

October 2012
 Table of contents

General ...................................................................................... 3

Compatibility ............................................................................ 3

Content of this package ........................................................... 3

Installation ................................................................................ 4

Special Note on Lexium Library Update ................................. 5

Special Note on CANopenStack Library Update .................... 6

Special Note on Packaging Library Update ............................ 8

SoMachine V3.1 Service Pack 1 Schneider Electric 2/9

Release Notes
 General
This product software update introduces new version of the several components to
SoMachine V3.1. In addition it provides an update to the packaging library that is I the
scope of the SoMachine V3.1 Solution Extension.

Compatibility
This update package is compatible with SoMachine V3.1 (3.1.10.1) only.
It requires the installation of SoMachine V3.1 Software.

In case the SoMachine Solution Extension is already present when applying this patch, the
Packaging Library will be update, too.

Content of this package

The update package contains the following SoMachine V3.1 Software components

(1) Lexium Library V1.3.8.0+

(2) CANopenStack Library V3.4.1.70 [HotFix_1]

(3) DeviceEditorModbus.plugin.dll (3.4.1.91)

(4) DeviceEditorSoftMotion.plugin.dll (3.4.1.91)

(5) M258BuildConfiguration.plugin.dll (2.0.2.12)

(6) TM2.rules.plugin.dll (2.0.30.5)

(7) Some support information and release notes

In addition one components of the SoMachine V3.1 Solution Extension is updated

(8) Packaging Library V3.0.1.3+ [HotFix_1]

All these components are included in one single installation package

called SoMaV3.1 Service Pack 1.exe.

SoMachine V3.1 Service Pack 1 Schneider Electric 3/9

Release Notes
 Installation
To install the software update on your computer, follow the given instructions:

(1) Close any SoMachine instances running on your PC before you start the
update.

(2) Copy the SoMaV3.1 Service Pack 1.exe file to a temporary location on your
target system.

(3) Run the exe-file to start the installation.

(4) The installation routine does not require any further configuration details. Simply
follow the given instructions to install the update.

(5) In case the installation utility comes up with a Windows Installer message that
the program to be upgraded may be missing, this is an indication that the
current installation of SoMachine is incompatible with this update package.

(6) After the update has been successfully installed, you will find the update in the
“Add or Remove Programs” of the Window’s Control Panel; ensure that you
have check marked the “Show updates” checkbox in the header line of the
dialog to see all updates.

Please note that this patch cannot individually be removed from SoMachine.

Be aware that you have to reopen existing projects, rebuild them and do a
complete download to the PLC in order to utilize the library updates that have
been installed to your PC as part of this software update!

As part of this installation package, an update of an application library will be installed if the
SoMachine V3.1 Solution Extension has been installed before this patch is applied.

In case you install the SoMachine V3.1 Solution Extension at a later point in time, you will
need to rerun the update installation a second time after you successfully installed the
Solution Extension.

You can verify that this update has properly applied to SoMachine Software and Solution
Extension by calling up the “Add or Remove Programs” and verify that both packages are
listed in the applied service pack.

SoMachine V3.1 Service Pack 1 Schneider Electric 4/9

Release Notes
 Special Note on Lexium Library Update
This package contains a new Lexium Library that corrects some shortcomings of a former
version. In case a customer imports a SoMachine V3.1 project archive, which may contain
an older version of the library, the new one will be accidentally overwritten.

If this happens, please follow the repair instructions that show how to restore the proper
version of the Lexium Library.

DETAILED REPAIR INSTRUCTION

IDENTIFYING THE PROBLEM

To verify if SoMachine is running with correct version of the Lexium Library, it is not
sufficient to simply check for the version number displayed by the Library Manager – which
is always 1.3.8.0. You must read the details of the library to detect the correct one; to do
so, pleae perform the following next steps:

(1) Launch the Library Repository dialog from the Tools main menu,

(2) Navigate down to the Devices/ Lexium Library and select the version 1.3.8.0

(3) By pressing the Details…. Button, a pop-up with a Description in the Properties
field will appear. In case of the correct library this reads as follows:

Description: Lexium Library for SoMachine V1.3.8.0+

FixRevision: HotFix_1

In case the Lexium Library is overwritten by an older version, – for example, as a result of
an import of a project archive that contains an older library version – any attempt to compile
a project that contains this library results in a build error that shows up such as the
following:

Outdated library version, please install the last update on

www.schneider-electric.com or contact us.

Revisiting the information mentioned in steps 1 to 3 from aboveand the different details will
be displayed.

SOLVING THE PROBLEM

In order to eliminate the build error, you must restore the proper version of the Lexium
Library again. A backup copy of this library has been stored on the PC during installation of
SoMachine. Please follow the following steps to restore the correct library:

(1) Start a SoMachine session and open the project that displays the build error.

(2) Select the Library Repository function from the Tools main menu entry.

(3) Select the “Lexium Library Schneider Electric” version 1.3.8.0

and uninstall the incorrect library.

SoMachine V3.1 Service Pack 1 Schneider Electric 5/9

Release Notes
 (4) Install the correct library version.
Press the Install button in the Library Repository Dialog, select the backup
copy of the library, which is available in the following folder:

\Program Files\Schneider Electric\SoMachine\Support

(5) Close the current project and reopen it again. This will ensure that the new
Lexium library is taken into account.

(6) When running another compilation of the project, the error message that was
previously displayed, should no longer be valid.
(7) Note that the restored library will not appear with a different revision then the
old library. Re-perform steps 1 to 3 explained in the previous chapter for
verification.

Special Note on CANopenStack Library Update

This patch was created resolve a potential hindrance with the CANopen Stack library
3.4.1.70 delivered through SoMachine V3.1. The potential hindrance is applicable only to
this particular SoMachine Version 3.1.10.1, it does not occur in previous SoMachine
Versions.

While using the CANopen Stack library, there is the potential, that the function block
GetState from the library CiA405 returns the device state to "operational", even if the
corresponding CANopen slave is disconnected from the CANopen bus. This may
potentially lead to a situation where the application can rely on incorrect information.

The manifestation of the suspected non-conformance occurs in projects that are using the
CANopenStack library 3.4.1.70, in combination with the GetState FB, as the only guarding
mechanism for the device status and the following scenario: CANopen Heartbeat is active
AND at least one synchronous PDO defined.

Precondition: the drive must have been in operational state and was in the process of being
disconnected from the CANopen bus.

Remark: Explicitly excluded from this scenario are CANopen slaves connected to
CANopen Performance or CANopen Optimized, which by default are using CANopen
Heartbeat as guarding mechanism AND asynchronous PDOs. Also explicitly excluded are
CANopen slaves connected to CANmotion.

In case a customer imports a SoMachine V3.1 project archive, which may contain the
original version 3.4.1.70 of the CANopenStack library, the new one will be accidentally
overwritten.

If this happens please follow the repair instructions that show how to restore the proper
version of the CANopenStack Library.

SoMachine V3.1 Service Pack 1 Schneider Electric 6/9

Release Notes
 DETAILED REPAIR INSTRUCTION
IDENTIFYING THE PROBLEM

To verify if SoMachine is running with correct version of the CANopenStack Library, it is not
sufficient to simply check for the version number displayed by the Library Manager – which
is always 3.4.1.70. You must read the details of the library to detect the correct one; so
follow the next steps:

(1) Launch the Library Repository dialog from the Tools main menu,

(2) Navigate down to the CANopenStack Library and select the version 3.4.1.70

(3) By pressing the Details…. Button, a pop-up with a Description in the Properties
field will appear. In case of the correct library this reads as follows:

FixRevision: HotFix_1

In case the CANopenStack Library is overwritten by an older one – for example as a result
of an import of a project archive that contains an older library version – any attempt to
compile a project that contains this library results in a build error that shows up like this:

Outdated library version, please install the last update on

www.schneider-electric.com or contact us.

Revisiting the information mentioned in steps 1 to 3 from above, you will now see different
details.

SOLVING THE PROBLEM

In order to get rid of the build error, you have to restore the proper version of the
CANopenStack Library again. A backup copy of this library has been stored on the PC
during installation of SoMachine. Please follow the following steps to get the correct library
restored:

(1) Start a SoMachine session and open the project that shows up the build error

(2) Select the Library Repository function from the Tools main menu entry

(3) Select the “3S CANopenStack.” library version 3.4.1.70

and uninstall the wrong library.

(4) In a next step install the correct library version. Press the Install… button in
the Library Repository dialog, select the backup copy of the library, which is
available in folder :

\Program Files\Schneider Electric\SoMachine\Support

(5) Close the current project and reopen it again. This ensures that the new
CANopenStack library is taken into account.

(6) When running another compilation of the project, the error message that was
previously displayed, should no longer be valid
(7) Note that the restored library will not appear with a different revision then the
old library. Re-perform steps 1 to 3 explained in the previous chapter for
verification.

SoMachine V3.1 Service Pack 1 Schneider Electric 7/9

Release Notes
 Special Note on Packaging Library Update
In case you are operating SoMachine V3.1 Solution Extension your software is updated
with a corrected packaging application library. In case a customer imports a
SoMachine V3.1 project archive, which may contain an older version of the library, the new
one will be accidentally overwritten.

If this happens please follow the repair instructions that show how to restore the proper
version of the Packaging Library.

DETAILED REPAIR INSTRUCTION

IDENTIFYING THE PROBLEM

To verify if SoMachine is running with correct version of the Packaging Library, it is not
sufficient to simply check for the version number displayed by the Library Manager – which
is always 3.0.1.3. You must read the details of the library to detect the correct one; so
follow the next steps:

(1) Launch the Library Repository dialog from the Tools main menu,

(2) Navigate down to the Packaging Library and select the version 3.0.1.3

(3) By pressing the Details…. Button, a pop-up with a Description in the Properties
field will appear. In case of the correct library this reads as follows:

Description: Packaging Library V3.0.1.3+

FixRevision: HotFix_1

In case the Packaging Library is overwritten by an older one – for example as a result of an
import of a project archive that contains an older library version – any attempt to compile a
project that contains this library results in a build error that shows up such as the following:
:

Outdated library version, please install the last update on

www.schneider-electric.com or contact us.

Revisiting the information mentioned in steps 1 to 3 from above, you will now see different
details.

SoMachine V3.1 Service Pack 1 Schneider Electric 8/9

Release Notes
 SOLVING THE PROBLEM

In order to get rid of the build error, you have to restore the proper version of the Packaging
Library again. A backup copy of this library has been stored on the PC during installation of
SoMachine. Please follow the following steps to get the correct library restored:

(1) Start a SoMachine session and open the project that shows up the build error.

(2) Select the Library Repository function from the Tools main menu entry.

(3) Select the “Packaging Schneider Electric” version 3.0.1.3

and uninstall the wrong library.

(4) In a next step install the correct library version. Press the Install… button in
the Library Repository dialog, select the backup copy of the library, which is
available in folder:

\Program Files\Schneider Electric\SoMachine\Support

(5) Close the current project and reopen it again. This ensures that the new
Packaging library is taken into account.

(6) When running another compilation of the project, the error message that was
previously displayed, should no longer be valid.
(7) Note that the restored library will not appear with a different revision then the
old library. Re-perform steps 1 to 3 explained in the previous chapter for
verification.

SoMachine V3.1 Service Pack 1 Schneider Electric 9/9

Release Notes