tia-networks

name	tia-networks
description	C# Openness implementation of topology and low-level network engineering.
license	MIT

tia-networks

Scope

Topology and low-level network 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/subnets-and-nodes.md	Reading/writing subnet attributes (name, type, PROFIBUS bus params, isochronous settings); accessing node attributes (IP address, PROFINET device name, node type); SubnetOwner service
references/io-systems.md	PROFINET IO system attributes; DP master system (IoSystem) attributes; TransferArea creation/deletion on PN or DP interfaces
references/addresses-and-channels.md	Address objects (StartAddress, IoType, Length, IsochronousMode, ProcessImage); channel access (ChannelType, ChannelIoType); AddressController service
references/io-timing.md	IoConnector timing/watchdog attributes (PnUpdateTime, PnWatchdogFactor, RtClass, SyncRole); IO device interface isochronous settings (PnSendClock, IsochronousTi, IsochronousTo)
references/communication-connections.md	Configuring and inspecting S7, FDL, ISO, ISO-on-TCP, TCP, UDP, PTP, and HMI communication connections through CommunicationManagement.Connections
references/online-connection-configuration.md	Choosing/inspecting online connection paths with ConnectionConfiguration: modes, PC interfaces, target interfaces, subnets, gateways, accessible devices, and ApplyConfiguration

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

---

Execution pattern

1. Access devices and device items from Project.Devices
2. Navigate network interfaces and nodes via Openness HW namespace
3. Use GetService<SubnetOwner>() to access subnets owned by a device item
4. Use GetService<NetworkInterface>() to access the network interface
5. Create or modify IO systems, subnets, nodes as needed
6. Modify addresses or channel timing via deviceItem.Addresses / deviceItem.Channels
7. Use GetService<CommunicationManagement>() for configured communication connections
8. Use OnlineProvider.Configuration only for online connection-path selection, not for project topology creation
9. Compile hardware after changes (see tia-project-general/references/compile.md)