Kaleido setup

Which Kaleido do you have?

Kaleido ships several generations, and the best connection depends on your model. Pick the row that matches your machine.

Before you connect

1. Install the Roastline desktop app — not the browser-only simulator.
2. Quit Artisan (or any app using the roaster's serial port or WebSocket).
3. Kaleido Pro: install the Board C USB driver (Mac or Windows), then replug the cable.
4. In Roastline: device picker → Kaleido M → expand Connection & settings and pick Network, USB serial, Bluetooth (Classic SPP), or Bluetooth (SnowBear ESP32).
5. Turn on Allow machine control → Save (burner / airflow / drum stay read-only otherwise).
6. Pick °C or °F in the top bar before Start — Kaleido receives the unit at connect.

Connect via network (WebSocket)

Typical for M-series, Dual, and Pro when the roaster is on its own wireless network or your LAN.

Roaster in access-point mode

Many Kaleidos broadcast their own wireless network when powered on. Join that network on your laptop, then use the default endpoint:

Full URL: ws://192.168.4.1:80/ws

Roaster on your home router

If the Kaleido is already on your LAN, enter its assigned IP in Device settings → Network (WebSocket) → Host (e.g. 192.168.1.50). Port and path stay 80 and /ws unless your firmware differs.

Steps in Roastline

1. Power the roaster on; connect the computer to the roaster's wireless network or the same LAN.
2. Device picker → Kaleido M → Connection & settings → Network (WebSocket).
3. Confirm Host / Port / Path (defaults above).
4. Allow machine control → Save → press Start.

On success the Console Log shows the connect and preheat:

Connect via USB serial

For Kaleido Pro (Board C) and M-series machines with a USB data port to the computer.

Drivers (Pro / Board C)

Install the Mac or Windows USB driver from Kaleido Software and Drivers. After install, replug the cable and confirm a serial port appears.

Port names

Serial settings

Steps in Roastline

1. Install the USB driver (Pro) if needed.
2. Plug the USB data cable (not the Dual tablet-only port).
3. Kaleido M → USB serial → Refresh → select the port → set baud if it differs from 57600.
4. Allow machine control → Save.
5. Quit Artisan and close other serial monitors, then press Start.

Connect via Bluetooth (Classic SPP)

Classic Bluetooth exposes a virtual serial port at 57600 8N1 with the same {[tag]} protocol as USB — the same path Artisan uses on Android, macOS, and Windows.

Dual-system roasters

On Kaleido Dual, disconnect the Kaleido tablet from the roaster before connecting from your laptop. With the tablet attached, Bluetooth may look like it works but control will fail. Match °C / °F with the tablet if you use both — mismatched units can cause COM port errors.

Pair the roaster (OS)

1. Power the roaster on (wait for the startup beep).
2. macOS: System Settings → Bluetooth → add the roaster (names vary: SRS_V6, Roaster_SRS, …).
3. Windows: Settings → Bluetooth → add device. Note the outgoing COM port in Device Manager → Ports — Roastline needs the outgoing port, not incoming.

Port names after pairing

Steps in Roastline

1. Pair in OS Bluetooth settings (above).
2. Quit Artisan / HiBean on your phone if they hold the session.
3. Kaleido M → Bluetooth (Classic SPP) → Serial port → Refresh → pick the Bluetooth port.
4. Confirm baud 57600 (or 9600 for Board B).
5. Allow machine control → Save → press Start.

Connect via Bluetooth (SnowBear ESP32)

For macOS / iOS where Classic SPP is missing or unreliable, the community SnowBear firmware turns an ESP32-S3 into a USB↔BLE bridge.

Confirmed machines (beta): M1 Lite, M1 Pro, M2 Legacy (unsealed).

Flash SnowBear (one-time)

1. Get an ESP32-S3 board and a USB data cable.
2. Download the SnowBear firmware image (BLE_host_v1.2z_Kaleido_SnowBear.bin) for your board.
3. Flash with ESPHome Web in Chrome/Edge (Connect → Install → choose file).
4. Plug the flashed ESP32 into the Kaleido tablet USB port (top) — not the bottom Artisan data port.

Steps in Roastline

1. Roaster powered; ESP32 LED active; HiBean / Artisan disconnected.
2. Kaleido M → Bluetooth (SnowBear ESP32).
3. Grant Bluetooth permission to Roastline (macOS Privacy & Security).
4. Allow machine control → Save → press Start.

Roastline scans for the Nordic UART service or a name prefix like SnowBear / BLE_host, then runs the same handshake as network/USB (no baud setting on BLE).

Temperature units (°C / °F)

Roastline stores canonical °C internally, but Kaleido follows the machine unit you pick at connect. Choose °C / °F in the top bar before you press Start.

Setpoint range: 0–250 °C (32–482 °F).

Running a roast

Telemetry (what you see)

Roastline also shows RoR and an SV slider when PID is enabled.

Preheat, charge, and drop

1. Preheat (PID on): turn PID on in the Mode bar, set your SV (default from the profile ~200 °C), and raise the Burner above 0%.
2. Charge → manual roast: press Charge, turn PID off, and set the Burner manually. Fan and drum sliders work independently of the heater.
3. Drop: Roastline cuts the heat, opens the cooling tray, and runs the fan and drum to cool the batch.

Verify the connection

Open View → Console Log (Cmd+Shift+L on macOS, Ctrl+Shift+L on Windows). A healthy connect ends with PREHEATING — Kaleido connected and steadily updating BT / ET.

For raw traffic, enable Tools → Serial Debug Logging. During preheat you should see the handshake and heater commands:

Troubleshooting