Darra Profinet Slave · Python SDK

把 Windows 主机作为 PROFINET IO 从站设备使用，受主站系统（如西门子 PLC）控制：RT Class 1 实时周期，DCP 设备发现 / 命名 / 地址分配，过程数据 IO，报警与诊断（含 I&M），GSDML 导入 TIA V15+；SDK 以服务模式使用。

Use a Windows host as a PROFINET IO device under a master (e.g. a Siemens PLC) — RT Class 1, DCP, process-data IO, alarms and diagnostics (I&M), GSDML for TIA V15+. The SDK is used in service mode.

能力 · Capabilities

• 从站设备 — Windows 主机作为 PROFINET IO Device，受 PLC 等主站控制
• 实时周期 — RT Class 1
• 发现与组态 — DCP 发现 / 命名 / 地址；GSDML 导入 TIA V15+
• 过程数据 — 写 Q、读 I；报警、诊断、I&M
• 0 拷贝 — 过程映像映射成结构体，供高性能直接读写（读可并发；写请调用方串行化）

开始 · Get started

1. 先安装官方安装包：下载页 · https://download.darra.xyz/profinet/client/Darra-Profinet-Setup.exe
2. 本包是 Python SDK：

pip install darra-profinet-slave

3. 新人：基础知识 · 从 SDK 继续 · Python 文档

升级 / 重装：先卸载旧版 → 重启电脑 → 再安装新版。操作前请先保存好工程和配置文件。

最佳用法 · 0 拷贝

Start 后把 I / Q 映射成结构体，之后当普通变量读写即可——读是当前周期，写下个周期发出。

import ctypes
from darra_pns import PnSService

class FromPlc(ctypes.BigEndianStructure):   # I：控制器 → 设备
    _pack_ = 1
    _fields_ = [("present", ctypes.c_uint8),
                ("recipe", ctypes.c_int16)]

class ToPlc(ctypes.BigEndianStructure):     # Q：设备 → 控制器
    _pack_ = 1
    _fields_ = [("ready", ctypes.c_uint8),
                ("busy", ctypes.c_uint8)]

svc = PnSService()                          # 构造随时可调
svc.start()                                 # 启动服务 + 建立过程数据通道

inp = svc.process_data.inputs_mapping(FromPlc)   # 映射一次（I 只读）
outp = svc.process_data.outputs_mapping(ToPlc)   # 映射一次（Q 可写）

outp.ready = 1                              # 写下的下个周期发出
present = inp.present                       # 读到的永远是当前周期

要整段一次读出用 svc.read()（一次调用取一份，同一拍自洽）。

i = svc.read()   # I 区整段字节

连本机服务 127.0.0.1:18840，启动后读 connected，再读诊断里的 iocr_active 和 rx_rt_frames。

from darra_pns import PnSService

svc = PnSService()          # 本机服务 127.0.0.1:18840
svc.start()
print(svc.connected)
diag = svc.get_diag()
print(diag.connected, diag.iocr_active, diag.rx_rt_frames)

变量表 · Variables

从运行配置 XML 解析变量名→地址映射，支持层级前缀联想：

svc.set_config_xml("config.xml")
vars = svc.variables
print(vars.count)
v = svc.get_variable("Module1.Sub1.Item1")
list = svc.suggest_variables("Module1.")

API 速查 · API Reference

其它语言 · Other SDKs

许可 · License

专有软件 · Proprietary — © Darra Technology，使用须遵守随产品提供的许可协议。