iec61850 0.2.0

IEC 61850 client for Python, backed by rust_61850 (Rust core).

iec61850

IEC 61850 client for Python — async-first, type-hinted.

Status: early development (v0.1.x). Vertical slice currently supports:

• TCP connect / disconnect with timeout
• read_int32 / write_int32 over MMS
• Typed exception hierarchy (IedError / IedConnectionError / IedTimeoutError / IedDataAccessError / IedServiceError / IedControlError)

Additional surface (read_bool, read_float, reporting, control, datasets, TLS, GOOSE / SV) is stubbed and will land per release.

Install

pip install iec61850

Requires Python 3.11+.

Platform support note (v0.1.x): only Windows x86_64 wheels are published. Linux / macOS support arrives in a later release.

Quick start

import asyncio
import iec61850

async def main():
    conn = await iec61850.IedConnection.connect("127.0.0.1:102", timeout_ms=5000)
    try:
        value = await conn.read_int32("simpleIOGenericIO/LLN0.Mod.stVal", iec61850.FC.ST)
        print("Mod.stVal =", value)
    finally:
        await conn.disconnect()

asyncio.run(main())

Error handling

try:
    conn = await iec61850.IedConnection.connect("10.0.0.1:102", timeout_ms=2000)
except iec61850.IedTimeoutError:
    ...   # 連線超時
except iec61850.IedConnectionError:
    ...   # TCP / OSI stack 失敗
except iec61850.IedError:
    ...   # 其他 IEC 61850 錯誤的 catch-all base

License

Apache-2.0