Siemens.Collaboration.Net.TiaPortal.Openness.Startdrive.Extensions 21.0.1765368573

Includes

TIA Portal Openness SINAMICS Startdrive Extensions

Siemens Collaboration Openness SINAMICS Startdrive Extensions provide extensions for Siemens Engineering SINAMICS Startdrive types to help you write cleaner and more efficient code.

[!WARNING] Important Compatibility Notice

TIA Portal Openness Extensions V21 are only compatible with TIA Portal V21 and above.

TIA Portal V21 introduces breaking changes in the Openness API. Applications built against TIA Portal versions below V21 are not compatible with V21 and above.

Installation

• install package Siemens.Collaboration.Net.TiaPortal.Openness.Startdrive.Extensions and select a matching version (20.* = TIA Portal V20, 21.* = TIA Portal V21)
• reload and build the project

Dependencies

By installing this package, the following packages are automatically installed and must not be installed individually:

• TIA Portal Openness References
  All Siemens.Engineering assemblies are referenced automatically. Please see README for further documentation.

• TIA Portal Openness Resolver
  Using Api.Global.Openness().Initialize() will resolve all Siemens.Engineering assemblies at runtime. Please see README for further documentation.

• TIA Portal Openness Extensions
  TIA Portal Openness Core Extensions for Siemens Engineering types. Please see README for further documentation.

Extensions

TIA Portal Openness SINAMICS Startdrive Extensions provide a lot of extensions for various Siemens Engineering SINAMICS Startdrive types. The following chapters are an excerpt of the most frequently used extensions.

Common

Get all DriveObjectContainer in this project recursively

IEnumerable<DriveObjectContainer> driveObjectContainers = tiaProject.AllDriveObjectContainers()

Check if the given Device is a SINAMICS Startdrive device

bool isSinamics = device.IsSinamics()

Additional extensions (e.g. IsSinamicsS120) are available respectively

DriveObjectContainer

Get the DriveObjectContainer of a DeviceItem

DriveObjectContainer driveObjectContainer = deviceItem.AsDriveObjectContainer()

Get all DriveObject of a Startdrive device

IEnumerable<DriveObject> driveObjects = drive.DeviceItems.DriveObjects()

Change the telegram number of a telegram

driveObject.ChangeTelegramNumber(5, TelegramType.MainTelegram);
driveObject.ChangeTelegramNumber(31, TelegramType.SafetyTelegram);

Parameters

Get a parameter by symbolic name (can also handle bit parameters)

DriveParameter parameter = driveObject.Parameters.Get("p9316.1")

Get a bit parameter of a DriveParameter

DriveParameter parameter = parameter.Bit(1)

Check if the parameter is a BiCo parameter

bool isBico = parameter.IsBiCo()

Type safe access to common parameters

float referenceSpeed = parameters.P2000().Get();

Type safe access to G120 parameters

var acknowledgeParameter = parameters.Parameters.G120().P3981();
acknowledgeParameter.SetAndWaitUntilReset(1);

TO - DO Connection

Connect DriveObject to a Technological Object

TechnologicalInstanceDB redAxis = ...;
driveObject.ConnectToTechnologyObject(redAxis)

Connect actor / sensor / torque to a drive telegram

TechnologicalInstanceDB redAxis = ...;
Telegram telegram = driveObject.Telegrams.First(x => x.Type == TelegramType.MainTelegram);
redAxis.ConnectActor(telegram);
redAxis.ConnectSensor(...);
redAxis.ConnectTorque(...);