Siemens SIMATIC S7 - Setoperatingstate Method

SIMATIC Automation Tool API for .NET framework
6.9 The ICPU interface
SIMATIC Automation Tool V2.1 user guide
Manual, V2.1.1 07/2016, A5E33042676-AC
109
6.9.3.10
SetOperatingState method
Return type
Method name
Result
SetOperatingState
Parameters
Name
Data type
Parameter type
Description
password
EncryptedString
In This method opens a legitimized connec-
tion to the device. Therefore, a password
may be required
nRequestState
OperatingStateREQ
In
The new operating state
This method is used to change the operating state of a CPU.
Not all CPUs support this feature. The property C
hangeModeAllowed can be checked to
ensure that the current CPU supports this feature.
The following example searches the
IProfinetDeviceCollection for a CPU at a specific IP
address. When found, it checks that the CPU supports the change mode feature, and sets
the CPU to RUN.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;
if ((devAsCpu != null) &&
(devAsCpu.ChangeModeAllowed == true)
)
{
retVal = devAsCpu.SetOperatingState(new EncryptedString(""),
OperatingStateREQ.Run);
}
}
}