Przejdź do treści
Biblioteka skilli
Inne · Integracja z narzędziem

parameters

/parameters

Obsługuje parametry napędów SINAMICS: odczyt i zapis, połączenia BiCo, dostęp po indeksie lub nazwie oraz manipulowanie bitami parametrów.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Obsługuje parametry napędów SINAMICS: odczyt i zapis, połączenia BiCo, dostęp po indeksie lub nazwie oraz manipulowanie bitami parametrów.

Oryginalny opis (EN)

Drive parameters for SINAMICS drives. Use when reading/writing parameters, BiCo wiring, accessing parameters by index or name, and manipulating parameter bits.

Jak działa

  1. Overview
  2. Required Namespaces
  3. Required Assemblies
  4. Common Patterns
  5. Quick Reference
  6. Related Files
  7. Exception Handling
Sekcje z nagłówków SKILL.md, w oryginale · 136 linii, 666 słów
Podgląd SKILL.md
---
name: parameters
description: Drive parameters for SINAMICS drives. Use when reading/writing parameters, BiCo wiring, accessing parameters by index or name, and manipulating parameter bits.
metadata:
  siemens-depends-on: "openness-base, drive-objects"
---

# Parameters

## Overview

Drive parameters in SINAMICS drives are accessed through the `Parameters` collection on a `DriveObject`. Parameters can be retrieved by numeric index, by string name (e.g., `"r945[2]"`), or via `Find(index, subindex)` for BiCo wiring. Parameter bits provide granular control, enabling individual bit toggling for safety activation and feature flags.

## Required Namespaces

```csharp
using System.Linq;
using Siemens.Engineering;
using Siemens.Engineering.MC.Drives;
```

## Required Assemblies

- `Siemens.Engineering.Base.dll`
- `Siemens.Engineering.Step7.dll`
- `Siemens.Engineering.Startdrive.dll`

## Common Patterns

### BiCo Parameter Wiring

**Description:** Find a BiCo parameter by index and subindex, locate a target parameter bit, and assign the bit as the BiCo value. This creates a cross-wiring connection between parameters.

**Example:**

```csharp
var bicoParameter = redAxis.GetService<DriveObjectContainer>()
    .DriveObjects.First()
    .Parameters.Find(840, 0);

var connectedParameter = parameterBits.First(
    x => x.Name.Substring(x.Name.IndexOf('.') + 1) == "7");

bicoParameter.Value = connectedParameter;
```

**Key Types and Methods:**
- `Parameters.Find(index, subindex)` — locate a BiCo-capable parameter by numeric address
- `Parameter.Value` — assign a `ParameterBit` reference as the BiCo source
- `ParameterBits` — collection of available bit references for wiring

### Read Parameter Value

**Description:** Read the current value of a drive parameter by accessing its `.Value` property. This is the most common parameter operation — retrieving the current setting of a parameter like `r945` (motor rated current) or any other read/writable parameter.

**Example:**

```csharp
var parameter = driveObject.Parameters.Find("r945[2]");
if (parameter != null)
{
    var currentValue = parameter.Value;
    Console.WriteLine($"Parameter {parameter.Name} = {currentValue}");
}
```

**Key Types and Methods:**
- `Parameter.Value` — get the current value of the parameter
- `Parameter.Name` — the SINAMICS parameter name (e.g., `"r945[2]"`)

### Parameter Access by Index

**Description:** Access a drive parameter via numeric index from the `Parameters` collection. Direct index access is the fastest way to retrieve a known parameter.

**Example:**

```csharp
var parameters = driveObject.Parameters;
var parameterViaIndexAccess = parameters[100];
```

**Key Types and Methods:**
- `Parameters[index]` — indexer to retrieve a parameter by numeric ID
- `Parameter` — the returned parameter object with `.Value`, `.Name`, `.Bits`

### Parameter Access by String Name

**Description:** Find a parameter using `Parameters.Find(string)` with the parameter name, e.g., `"r945[2]"` for read-only parameters or `"p999"` for writable ones.

**Example:**

```csharp
var parameterViaStringAccess = parameters.Find("r945[2]");
```

**Key Types and Methods:**
- `Parameters.Find(name)` — locate parameter by SINAMICS naming convention
- Read parameters use `"r"` prefix; write parameters use `"p"` prefix

### Parameter Bit Access by Name

**Description:** Access a specific bit of a parameter via the `.Bits` collection and filter by the fully qualified bit name (e.g., `"p9603.1"`). Setting bit values enables individual features like safety functions.

**Example:**

```csharp
parameters.Find("p9603").Bits
    .Single(x => x.Name == "p9603.1")
    .Value = 1;
```

**Key Types and Methods:**
- `Parameter.Bits` — collection of individual bits within a parameter
- `Bit.Name` — fully qualified name in `"parameter.bit"` format
- `Bit.Value` — set or read the bit value (0 or 1)

## Quick Reference

| Method/Pattern | Purpose |
|---|---|
| `Parameter.Value` (read) | Read the current value of a parameter |
| `Parameters.Find(index, subindex)` | Locate BiCo parameter by numeric address |
| `Parameters[index]` | Direct index access to a parameter |
| `Parameters.Find("r945[2]")` | Find parameter by string name |
| `Parameter.Bits.Single(x => x.Name == "p9603.1").Value` | Access and set individual parameter bits |
| `Parameter.Value = bit` | Assign a BiCo wiring connection |

## Related Files

- [`drive-objects`](../drive-objects/SKILL.md) — obtaining the `DriveObject` whose `Parameters` collection you access
- [`safety-commissioning`](../safety-commissioning/SKILL.md) — uses parameter bit writes (e.g., `p9603`, `p9604`) to activate safety functions
- [`telegrams`](../telegrams/SKILL.md) — telegram configuration interacts with parameter-based addressing
- [`hardware-and-modules`](../hardware-and-modules/SKILL.md) — hardware projection sets configuration entries that map to parameters

## Exception Handling

- `Parameters.Find(string)` returns `null` if the parameter name does not exist. Always check for null before accessing properties.
- `Parameters[index]` throws `IndexOutOfRangeException` for invalid parameter numbers.
- `Parameter.Bits.Single()` throws `InvalidOperationException` if the bit name is not found. Use `FirstOrDefault()` with null checks for robust code.
- Writing to read-only parameters (e.g., `"r..."` prefix) throws `EngineeringException`. Only `"p..."` parameters are writable.
- BiCo wiring requires both source and target to support BiCo. Verify BiCo capability before assignment.

Wersje

RepozytoriumWynikLicencja
Ta strona · asckye/tia_portal_openness_mcp100MIT
thedaviddias/front-end-checklist100MIT
Alejo2075/claude-code-aws90MIT

Migawka bazy z 13.11.2026 · wersja paczki a74778c091d8 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100drive-objects
    Obsługuje obiekty napędowe i DriveFunctionInterface w napędach SINAMICS: telegramy, zapis parametrów, napędy Double-MoMo, odświeżanie stanu po zapisie i dezaktywację obiektów.
  • 100safety-commissioning
    Konfiguruje funkcje bezpieczeństwa napędów SINAMICS, takie jak STO i SImO, aktualizuje sumy kontrolne i prowadzi testy odbiorcze PROFIsafe.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.