# uneidel/profinetdcp architecture

> Architecture diagram of the GitHub repository uneidel/profinetdcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/uneidel/profinetdcp
- Repository: https://github.com/uneidel/profinetdcp

## Overview

`profidcp` is a Rust library for Profinet DCP discovery and configuration. A caller creates a handler for a network interface, then identifies devices or sends actions such as setting a station name, blinking an LED, and resetting a device. The handler builds DCP/Ethernet requests and reads responses into device information or result strings. The README documents these capabilities; the excerpts show the handler and packet/block parsing, but not every request-building step, so some internal links are omitted or marked unverified.

Main entry points: [`src/dcp.rs`](https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs) (DCP handler), [`src/constants.rs`](https://github.com/uneidel/profinetdcp/blob/main/src/constants.rs) (Protocol constants), [`src/dcpblockrequest.rs`](https://github.com/uneidel/profinetdcp/blob/main/src/dcpblockrequest.rs) (Request block), [`src/dcpblock.rs`](https://github.com/uneidel/profinetdcp/blob/main/src/dcpblock.rs) (DCP block)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Library API"]
  node_handler["DCP handler<br/>[dcp.rs]"]
  node_discovery["Device discovery<br/>[dcp.rs]"]
  node_configuration["Device configuration<br/>[dcp.rs]"]
  node_device["Device result<br/>[dcp.rs]"]
end

subgraph group_protocol["DCP Protocol"]
  node_constants["Protocol constants<br/>[constants.rs]"]
  node_requestblock["Request block<br/>[dcpblockrequest.rs]"]
  node_block["DCP block<br/>[dcpblock.rs]"]
  node_packet["DCP packet<br/>[dcppaket.rs]"]
  node_utils["Address utilities<br/>[utils.rs]"]
end

subgraph group_network["Network I/O"]
  node_interface["Network interface"]
  node_devices(("Profinet devices"))
end

node_caller(("Library caller"))

node_caller -->|"creates"| node_handler
node_caller -->|"requests"| node_discovery
node_caller -->|"requests"| node_configuration
node_handler -->|"opens channel"| node_interface
node_discovery -->|"uses"| node_handler
node_configuration -->|"uses"| node_handler
node_handler -->|"uses values"| node_constants
node_handler -->|"converts addresses"| node_utils
node_handler -->|"builds and parses"| node_packet
node_handler -.->|"builds request"| node_requestblock
node_handler -->|"parses blocks"| node_block
node_handler -->|"sends requests"| node_devices
node_devices -.->|"returns responses"| node_handler
node_discovery -->|"returns devices"| node_device
node_configuration -->|"returns results"| node_device

click node_handler "https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs"
click node_discovery "https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs"
click node_configuration "https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs"
click node_device "https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs"
click node_constants "https://github.com/uneidel/profinetdcp/blob/main/src/constants.rs"
click node_requestblock "https://github.com/uneidel/profinetdcp/blob/main/src/dcpblockrequest.rs"
click node_block "https://github.com/uneidel/profinetdcp/blob/main/src/dcpblock.rs"
click node_packet "https://github.com/uneidel/profinetdcp/blob/main/src/dcppaket.rs"
click node_utils "https://github.com/uneidel/profinetdcp/blob/main/src/utils.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_handler,node_discovery,node_configuration,node_device toneBlue
class node_constants,node_requestblock,node_block,node_packet,node_utils toneAmber
class node_interface,node_devices toneMint
class node_caller toneIndigo
```

## Components

### Library API

- [DCP handler](https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs): `src/dcp.rs`
- [Device discovery](https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs): `src/dcp.rs`
- [Device configuration](https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs): `src/dcp.rs`
- [Device result](https://github.com/uneidel/profinetdcp/blob/main/src/dcp.rs): `src/dcp.rs`

### DCP Protocol

- [Protocol constants](https://github.com/uneidel/profinetdcp/blob/main/src/constants.rs): `src/constants.rs`
- [Request block](https://github.com/uneidel/profinetdcp/blob/main/src/dcpblockrequest.rs): `src/dcpblockrequest.rs`
- [DCP block](https://github.com/uneidel/profinetdcp/blob/main/src/dcpblock.rs): `src/dcpblock.rs`
- [DCP packet](https://github.com/uneidel/profinetdcp/blob/main/src/dcppaket.rs): `src/dcppaket.rs`
- [Address utilities](https://github.com/uneidel/profinetdcp/blob/main/src/utils.rs): `src/utils.rs`

### Network I/O

- **Network interface**
- **Profinet devices**

### Other components

- **Library caller**

## Connections

- Library caller → DCP handler: creates (evidence: `README.md`)
- Library caller → Device discovery: requests (evidence: `README.md`)
- Library caller → Device configuration: requests (evidence: `README.md`)
- DCP handler → Network interface: opens channel (evidence: `src/dcp.rs`)
- Device discovery → DCP handler: uses (evidence: `src/dcp.rs`)
- Device configuration → DCP handler: uses (evidence: `src/dcp.rs`)
- DCP handler → Protocol constants: uses values (evidence: `src/dcp.rs`)
- DCP handler → Address utilities: converts addresses (evidence: `src/dcp.rs`)
- DCP handler → DCP packet: builds and parses (evidence: `src/dcp.rs`)
- DCP handler → Request block: builds request (evidence: `src/dcp.rs`)
- DCP handler → DCP block: parses blocks (evidence: `src/dcp.rs`)
- DCP handler → Profinet devices: sends requests (evidence: `src/dcp.rs`)
- Profinet devices → DCP handler: returns responses
- Device discovery → Device result: returns devices (evidence: `README.md`)
- Device configuration → Device result: returns results (evidence: `src/dcp.rs`)
