ikalogic-at1000 0.2.1

Python SDK for Ikalogic AT1000 devices

ikalogic-at1000

Official Python SDK for the Ikalogic AT1000 Series Test Sequencers.

This package provides a high-level API to control and automate the Ikalogic AT1000, a test sequencer designed for functional testing of electronic devices, PCBs, and complex systems. It ships both a synchronous client (ikalogic_at1000) and an asynchronous client (ikalogic_at1000.aio).

Key Features

• 32 Programmable I/Os: Handle analog and digital signals within a ±25V range.
• 8 Dry Contact Relays: Control external circuits, with one relay equipped for high-precision current measurement.
• Programmable Power Supply: Delivers 0 to 24V at up to 2A with precise current monitoring.
• Dual USB 3.0 Ports: Feature power cycling (on/off control) and current measurement for testing USB devices.
• Communication Interfaces: Includes Ethernet, RS232, RS485, CAN, SPI, I2C, and UART.
• Human-Machine Interface (HMI): Onboard screen, rotary knob, and speaker for standalone operation and feedback.

Installation

pip install ikalogic-at1000

Or, with uv:

uv add ikalogic-at1000

Requires Python 3.10 or newer.

Quick Start

Discover devices on the local network, then open one to take control:

from ikalogic_at1000 import AT1000

# Discover AT1000 devices over mDNS (returns host strings)
for host in AT1000.find_devices():
    print(host)

# Open a device by host string (hostname or IP). open() acquires exclusive
# access; if another opener takes over, this client's mutating calls raise
# AccessRevokedError until it opens again.
device = AT1000.open("at1000.local")
print(device.info.model, device.info.serial_number)

device.reset()
device.close()

Pass readonly=True to observe a device without taking control (no session is opened and no calls are gated).

Standalone vs remote

Inside an AT1000 project container the device resolves its own address without mDNS. Use AT1000.is_standalone() to branch:

from ikalogic_at1000 import AT1000

if AT1000.is_standalone():
    device_address = AT1000.find_local_device()
else:
    devices = AT1000.find_devices()
    device_address = devices[0] if devices else None

if not device_address:
    raise SystemExit("No devices found")

device = AT1000.open(device_address)

Asynchronous Usage

The same API is available as coroutines under ikalogic_at1000.aio:

import asyncio

from ikalogic_at1000.aio import AT1000


async def main():
    device = await AT1000.open("at1000.local")
    print(device.info.model, device.info.serial_number)

    await device.reset()
    await device.aclose()


asyncio.run(main())

Real-time Events

Subscribe to live device state changes over a WebSocket. Connect, then register callbacks per event type (or "*" for all events):

from ikalogic_at1000 import AT1000

device = AT1000.open("at1000.local", readonly=True)
device.events.connect()


def on_gpio(event):
    print(event.type, event.data)


unsubscribe = device.events.subscribe("gpio.state", on_gpio)

# later
unsubscribe()
device.close()

Documentation

Full API documentation is available at https://ikalogic.com/kb/at1000-api/at1000_home/.

License

This package is distributed under the MIT License.