Kaliedo Protocol
Kaliedo Roaster Protocol
Quick command reference for Artisan / HiBean serial control
Format Conventions
Instruction stream uses {[ as prefix and ]} as suffix.
Data stream uses { as prefix and } as suffix. Responses start with sid (status byte).
All keywords are uppercase. Each command is terminated with a newline (\n).
Multiple commands can share one {[ ]} pair, separated by commas — for example: {[HP 80,FC 60,RC 90]}
Connection and Setup
|
Command |
Description |
|---|---|
|
{[PI]} |
Ping — connection test. Returns {sid}. |
|
{[SC AR]} |
Start Artisan session. Returns {sid,SN:xxxxxxxx}. |
|
{[SC CP]} |
Start Cropster session. Returns {sid,SN:xxxxxxxx}. |
|
{[CL AR]} |
Close Artisan session. |
|
{[CL CP]} |
Close Cropster session. |
|
{[TU C]} |
Set temperature unit to Celsius. |
|
{[TU F]} |
Set temperature unit to Fahrenheit. |
Reading Data
|
Command |
Description |
|---|---|
|
{[RD A0]} |
Read main parameters (BT, ET, AT, HP, FC, RC, AH, TS). |
|
{[RD A1]} |
Read main parameters plus heating status (adds HS field). |
Example response (A1)
{0,BT:190.5,ET:185.0,AT:25.0,HP:80,FC:55,RC:90,AH:0,TS:180.0,HS:1}
Response fields
BT — bean temperature (0-300 °C / 32-572 °F)
ET — drum / environment temperature
AT — ambient temperature
HP — heater power %, step 5
FC — smoke fan speed %, step 5
RC — drum roll speed %, step 10
AH — auto-heat enabled (0 or 1)
TS — target temperature setpoint
HS — heating active (0 or 1, A1 mode only)
Heat Control
|
Command |
Description |
|---|---|
|
{[HS 0]} |
Stop heating. |
|
{[HS 1]} |
Start heating. |
|
{[HP n]} |
Set heater power n% (step 5, range 0-100). |
|
{[HP UP]} |
Step heater up by 5%. |
|
{[HP DW]} |
Step heater down by 5%. |
|
{[TS n.n]} |
Set target temperature (0-250 °C / 32-482 °F). |
|
{[AH 0]} |
Disable auto-heat (manual power mode). |
|
{[AH 1]} |
Enable auto-heat (device PID controls heat to TS). |
Fan and Drum
|
Command |
Description |
|---|---|
|
{[FC n]} |
Smoke fan n% (step 5, range 0-100). |
|
{[FC UP]} |
Step fan up by 5%. |
|
{[FC DW]} |
Step fan down by 5%. |
|
{[RC n]} |
Drum roll n% (step 10, range 0-100). |
|
{[RC UP]} |
Step drum up by 10%. |
|
{[RC DW]} |
Step drum down by 10%. |
Cooling
|
Command |
Description |
|---|---|
|
{[CS 0]} |
Cooling off. |
|
{[CS 1]} |
Cooling on. |
Roast Event Markers
Sends a user-tagged roast event to the device. The device synchronizes the event to its embedded control panel.
|
Command |
Description |
|---|---|
|
{[EV 1]} |
Charge — beans loaded into drum. |
|
{[EV 2]} |
Temp Return (TP) — turning point. |
|
{[EV 3]} |
Dry End — end of drying phase. |
|
{[EV 4]} |
First Crack Start. |
|
{[EV 5]} |
First Crack End. |
|
{[EV 6]} |
Second Crack Start. |
|
{[EV 7]} |
Second Crack End. |
|
{[EV 8]} |
Drop — beans dropped to cooling tray. |
|
{[EV 9]} |
Cool End — cooling complete. |
Status Byte (sid) Decoder
Every response begins with a status byte. Convert sid to 8-bit binary, then read the low 4 bits when the lowest bit of the high nibble is 0:
|
Command |
Description |
|---|---|
|
0000 |
IDLE |
|
0001 |
CHARGE |
|
0010 |
TP (Turning Point) |
|
0011 |
DRY END |
|
0100 |
FC (First Crack) |
|
0101 |
FC END |
|
0110 |
SC (Second Crack) |
|
0111 |
SC END |
|
1000 |
DROP |
|
1001 |
COOL END |
Typical Session Sequence
The handshake Artisan uses on connection, captured live from a real roaster:
|
Command |
Description |
|---|---|
|
{[PI]} |
Ping the roaster to verify connection. |
|
{[TU C]} |
Set the unit (C or F). |
|
{[SC AR]} |
Open an Artisan session — roaster returns its serial number. |
|
{[RD A0]} |
Poll for live data, repeated about every 1.5 seconds. |
|
{[CL AR]} |
Close the session when disconnecting. |
Notes
Polling interval for RD should be at least 1 second. Default 1.5 seconds. Repeated queries faster than 1 second are ignored.
The roaster responds to RD without requiring SC AR first, though using SC AR is the documented startup sequence.
Baud rate observed: 57600, 8 data bits, no parity, 1 stop bit, no flow control.
CP210x VID:PID is 10C4:EA60.