kv-hostlink 1.0.0

Python library for KEYENCE KV series Host Link (Upper Link) communication.

KEYENCE KV Host Link for Python

Python library for KEYENCE KV Host Link PLC communication.

Supported PLC profiles

The maintained profile table is in PLC profiles. Choose one exact canonical PLC profile from that table.

Supported device types

The maintained device and range tables are in Supported registers. Use that page for supported device families, address syntax, and profile-specific notes.

Installation

pip install kv-hostlink

Quick example

import asyncio
from hostlink import HostLinkConnectionOptions, device_range_catalog_for_plc_profile, open_and_connect, read_typed

async def main() -> None:
    catalog = device_range_catalog_for_plc_profile("keyence:kv-7000")
    options = HostLinkConnectionOptions(host="192.168.250.100", plc_profile="keyence:kv-8000", port=8501)
    async with await open_and_connect(options) as client:
        dm0 = await read_typed(client, "DM0", "U")
        print(f"DM0 = {dm0}")

asyncio.run(main())

Documentation

Page	Use it for
Full documentation site	Unified docs for all PLC communication libraries.
Getting started	Install the package, connect to your PLC, and run your first read/write.
Usage guide	Use the high-level API and common Host Link workflows.
Supported registers	Check supported device families and address forms.
PLC profiles	Choose the canonical profile that matches your PLC model and device ranges.
Gotchas	Check the common Host Link failure modes before troubleshooting wiring or ladder code.
Examples	Run maintained Python samples: samples/high_level_async.py, samples/high_level_sync.py, samples/basic_high_level_rw.py, samples/named_snapshot.py, samples/polling_monitor.py.

Hardware verified

Live-device verification is maintained in Latest communication verification. See that page for verified PLC models, transports, dates, limitations, and retained validation notes.

License and registry

Item	Value
License	MIT
Registry	PyPI
Package	kv-hostlink