kymocore 0.1.0

kymocore for Python · Measurements from your script, live on screen

Pure Python sender for the Kymotrace protocol – the PC counterpart of KymoCore.

What is it about?

Not every signal comes from a microcontroller. A Raspberry Pi reads sensors, a test bench script drives a power supply, a simulation computes a plant model. Printing those values or writing CSV files means looking at them afterwards.

kymocore sends them to KymoStudio while they happen, with the same compact binary frames (9 to 21 bytes) that the KymoCore firmware library uses. Firmware and PC script appear side by side in one KymoStudio workbench: as curves, XY traces or in 3D.

_{Live data in KymoStudio: three signals over time, two as XY traces.}

What kymocore can do

What it is used for

• Raspberry Pi and single-board computers: plot sensor values read via I²C, SPI or GPIO live.
• Test benches and HIL setups: show the script's setpoints next to the measurements of the device under test.
• Simulations: watch a plant model or controller simulation run, with the same charts as on real hardware.
• Data from other programs: forward values from instruments, logs or APIs to KymoStudio.

Quick start

pip install kymocore            # UDP and TCP
pip install kymocore[serial]    # + serial / USB CDC (pyserial)
pip install kymocore[mqtt]      # + MQTT (paho-mqtt)

Complete example

The following script sends a sine wave on channel 0 and a cosine with an X coordinate on channel 1, every 10 ms for ten seconds.

import math
import time

from kymocore import Sender

with Sender.udp('127.0.0.1', 5025) as sender:
    for i in range(1000):
        sender.send(0, math.sin(i / 20))           # channel 0, value
        sender.send(1, math.cos(i / 20), x=i)      # channel 1, XY point
        time.sleep(.01)

In KymoStudio, add a UDP source on port 5025, start it and assign channel 0 to a chart.

Transports

KymoStudio connects to a TCP device, so tcp_server listens and sends to every connected client. Values sent while no client is connected are dropped, as on a device. MQTT publishes one message per value.

Options

Channel IDs outside 0–255 and NaN or infinite values raise ValueError. Microsecond timestamps need KymoStudio 2.5 or newer.

Part of Kymotrace

Documentation

• Protocol: byte layout, CRC, example frames
• Website: KymoStudio download, guides and features

License

Copyright (c) 2026 Christof Seidel. kymocore for Python is licensed under the MIT license: free for any use, including commercial projects, without disclosing your own source code.