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

TIA Portal Openness SINAMICS Startdrive Extensions

Includes

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

Installation

• install package Siemens.Collaboration.Net.TiaPortal.Openness.Startdrive.Extensions and select a matching version (17.* = TIA Portal V17, 18.* = TIA Portal V18)
• 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.

All DriveObjectContainer based extensions are also available for OnlineDriveObjectContainer

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(...);