pyiconlaser 0.1.0

Unofficial Python wrapper for the TYCMA ICON Interface HTTP TCPIP API for laser marking systems.

pyiconlaser

Unofficial Python wrapper for the TYKMA ICON Interface HTTP/TCP API used by industrial laser marking systems.

This library provides a simple Python API for controlling compatible laser marking systems through the ICON Interface software.

This project is community-maintained and is not affiliated with or endorsed by any hardware manufacturer.

This library was developed and tested against TYKMA ICON Interface software based on available API documentation and observed real-world behavior.

---

Features

• Load marking jobs
• Read available IDs and modify their values
• Start and stop marking sequences
• Enable or clear jobs
• Control limits (tracing beam)
• Retrieve machine status
• Get template preview images

---

Requirements

This library requires the vendor software TYKMA ICON Interface to be installed and running on the target machine.

The HTTP/TCP API must also be enabled manually in the Config.xml configuration file.

Before using this library:

• Install TYKMA ICON Interface software
  • Vendor contact may be required to obtain the software and API documentation
• Enable HTTP/TCP communication in Config.xml
• Verify the API is accessible (default port 5287)
• Ensure the laser system is connected and recognized by ICON Interface

Installation

pip install pyiconlaser

Or install locally:

pip install .

---

Quick Start

from pyiconlaser import IconLaserClient

laser = IconLaserClient()

laser.prepare_job("test_job")

laser.set_id("SN", "123456")
laser.set_id("QR", "PRODUCT001")

laser.enable_job()
laser.start()

laser.clear_job()

---

Important Note

ICON Interface has undocumented behavior.

After loading a job:

laser.load_job("test_job")

the software automatically enables limits mode internally.

This causes:

all_ids -> empty response
set_id -> id_not_found

To fix this, limits must be disabled before modifying IDs:

laser.load_job("test_job")
laser.limits_off()

For convenience:

laser.prepare_job("test_job")

does both automatically.

---

python sdk laser industrial-automation automation hardware http-api wrapper

Basic Example

from pyiconlaser import IconLaserClient

laser = IconLaserClient()

print(laser.version())
print(laser.job_status())
print(laser.all_ids())

---

Supported API Methods

version()
job_status()
loaded_job()
state()

load_job()
prepare_job()
clear_job()
enable_job()

all_ids()
set_id()

start()
stop()

limits_on()
limits_off()

get_preview()

---

License

MIT License