Kaleido Setup

Rostoc has experimental support for selected Kaleido setups. Use this guide when you want Kaleido roast data to stay connected to green coffee lots, inventory usage, roast plans, batches, and production records.

Kaleido support is exact-setup specific. Check the catalog entry for your machine and connection method before relying on the setup for production logging.

What you need

Identify the exact Kaleido setup first:

model size, such as M1, M2, M6, or M10
edition, such as Standard, Pro, Dual System, Lite, or another regional name
connection method: USB, Bluetooth, Wi-Fi, or Ethernet
operating system and whether a serial driver is installed
whether the Kaleido software, the Kaleido tablet, or other roasting software is already connected

For Dual System machines, follow the manufacturer or distributor instructions for your edition. Some Dual System USB cables are reserved for the Kaleido tablet and should not be plugged into the computer. Use the connection path that matches the exact Rostoc catalog entry.

Add Kaleido

Open Settings -> Machines in Rostoc.
Click Add Machine.
Search for Kaleido in the catalog.
Select the exact Kaleido entry for your setup.
Review the connection details before saving. For Kaleido Network, replace the pre-filled host with the roaster’s IP address on your local network — see the connection notes below.
Close other roasting software that may be using the same USB, Bluetooth, or network connection.
Run Test Connection.

Choose the catalog entry by connection path:

Kaleido Network — for Wi-Fi or Ethernet setups that expose Kaleido data on the local network.
Kaleido Serial — for USB or Bluetooth serial setups.
Kaleido Legacy — for older TC4-style serial setups.

If your exact model, edition, or connection path is missing, send a support request instead of using a nearby entry. A different Kaleido edition can have a different computer connection path.

Connection notes

For USB or Bluetooth serial setups:

use a data-capable cable when the setup requires USB
install the USB serial driver if the operating system does not show a serial port
on Windows, confirm the COM port after reconnecting the machine because port assignments can change
keep only one roasting application connected to the machine during the test

For Wi-Fi or Ethernet setups:

keep the roaster, tablet, and computer on the same local network when the setup requires it
enter the roaster’s own IP address as the host. The pre-filled host 127.0.0.1 is a placeholder that points at your computer, not the roaster — the connection cannot succeed until you replace it. If you don’t know the address, click Scan network under the host field: Rostoc checks your local network for devices answering on the entry’s port and lists what it finds. The Kaleido workflow and your router’s device list also show it.
keep the port and path from the catalog entry; only the host varies per setup
avoid troubleshooting Rostoc stream mappings until the network connection is stable

Validate the first roast

Treat your first Rostoc roast as a validation roast. Confirm that:

bean temperature and environment temperature move as expected
optional set value, ambient temperature, heater, fan, drum, and status streams appear only when the selected entry exposes them
units and labels match the roaster workflow
the saved Batch reopens with the same stream labels and values

What Rostoc reads

Kaleido Network and Kaleido Serial — bean temperature, environment temperature, set value, ambient temperature, drum, auto heating, heater, and fan.
Kaleido Legacy — bean temperature, environment temperature, and ambient temperature.

Machine controls

The Kaleido Network and Kaleido Serial entries expose direct controls — heater, heater power, fan, drum, and auto heating (PID) — that you can operate from Roast Studio. The Kaleido Legacy entry is read-only.

Telemetry and control are separate capabilities, and Kaleido support is experimental: validate each control against the roaster’s own display before using it in a production roast. See Machine controls for how controls are armed, operated, and kept safe during a roast.

Troubleshooting

If Rostoc cannot read from Kaleido:

confirm the selected Rostoc catalog entry matches the exact Kaleido edition and connection method
close the Kaleido software and any other roasting app that may already be connected
try another USB data cable or USB port for serial setups
install or reinstall the serial driver if the serial port is missing
recheck the COM port or device path after reconnecting the roaster
for Dual System setups, confirm whether the computer should use Bluetooth, Wi-Fi, or another path instead of the tablet USB cable
for network setups, confirm the host is the roaster’s IP address, not the pre-filled 127.0.0.1 — a “connection refused” or “connect call failed (‘127.0.0.1’, 80)” error means the placeholder host was never replaced
for network setups, confirm the roaster and computer are on the same local network
run a short test roast and compare Rostoc readings with the values shown by the Kaleido workflow

If Kaleido drops out in the middle of a roast, keep roasting from the machine and see what Rostoc does when the connection drops mid-roast.

See Troubleshooting Connections for general USB, serial, and network connection checks.