tia-devices-general

Scope

Device-level engineering — full C# Openness implementation.

When the roadmap routes here, the entire solution is C#. Do not mix with Python wrapper calls. Always load tia-csharp-common first (done by roadmap).

---

Reference files

Load ONLY the reference file(s) relevant to the task. Do not load all files at once.

Reference file	Load when the task involves
references/device-enumeration.md	Listing, finding, or iterating devices; device groups; ungrouped devices; navigating DeviceItems.
references/device-creation.md	Creating or deleting devices; understanding TypeIdentifier formats (OrderNumber, GSD, System).
references/device-attributes.md	Reading/writing basic device or device-item attributes; using GsdDevice service; managing Application IDs (CustomIdentityProvider).
references/hardware-parameters.md	Setting specific hardware parameters via SetAttribute (e.g., IO addresses, diagnostic settings, module-specific enums).
references/software-container.md	Accessing PlcSoftware or HmiTarget from a device; using the SoftwareContainer service.
references/device-item-operations.md	Plugging, moving, copying, or deleting device items/modules; changing device/module types; hardware catalog queries.
references/device-item-interfaces.md	NetworkInterface service; IOController/IOConnector attributes; hardware identifiers; managing addresses and channels.
references/networks-and-connections.md	Opening hardware/network editors; querying targets from a network perspective; address object attributes.

For tasks spanning multiple areas, load all relevant reference files before generating code.

---

Execution pattern

1. Access Project.Devices composition (or DeviceGroups / UngroupedDevicesGroup)
2. Find or create Device objects
3. Navigate DeviceItem hierarchy as needed
4. Access SoftwareContainer via GetService<SoftwareContainer>() when PLC/HMI software is needed
5. Use ICompilable for hardware or software compile (see tia-project-general/references/compile.md)