Beckhoff IPC Diagnostics

pyads-ipc-diag is a Python library for reading IPC Diagnostics information from Beckhoff IPCs and EPCs.

IPC Diagnostics have been available on Beckhoff IPC/EPC devices for years. The data can be accessed via ADS, OPC UA, or C#.
This library focuses on ADS access using Python.

For detailed documentation, see the Beckhoff Information System:
https://infosys.beckhoff.com/content/1033/devicemanager/index.html?id=7887654213086576625

The library uses pyads for ADS communication. pyads is supported on multiple platforms, including Windows, Linux, and FreeBSD.

This project is still under development and may be unstable.

Documentation is also under preparation!

Installation

Install using pip (recommended)

pip install pyads-ipc-diag

Clone from source

git clone https://github.com/dewabe/pyads-ipc-diag.git
cd pyads-ipc-diag
pip install -e .

Features

• Read all IPC Diagnostics data via ADS - just check the documentation provided by Beckhoff
• Available modules to read: CPU, Fan, Mainboard, Memory, NIC, OS, Software, Time, TwinCAT, UserManagement

Command Line Arguments

You can also use command line arguments, in example store all the data into file output.json:

pyads-ipc-diag --ams-net-id 1.2.3.4.1.1 --module all --json output.json

For more information, use

pyads-ipc-diag -h

Basic usage

import pyads
from pyads_ipc_diag import MDP, CPU, CONFIG_AREA

with MDP("10.10.10.11.1.1") as ipc:
    cpu = CPU(ipc)
    print(cpu.properties())
    # CPU_Info(
    #   frequency=1917,
    #   usage=3,
    #   temperature=43
    #   )
    mac_address = ipc.read(CONFIG_AREA.NIC, 0x8001, 1, pyads.PLCTYPE_STRING)
    print(mac_address) # nn:nn:nn:nn:nn:nn

Requirements

• Python 3.9+
• pyads
• Beckhoff IPC/EPC with IPC Diagnostics available

To Do

• All "High level MDP Service Classes", such a Memory, NIC, UPS etc.
• Possibility to write data (i.e. change IP address)
• Optimize code
• Write tests
• Write documentation