Guide
Roaster connection overview
How to connect roasting machines in First Crack and which protocols we support
Connection steps depend on model and protocol. First Crack supports three paths:
| Method | Typical cases | Docs |
|---|---|---|
| Modbus RTU/TCP | Delta/Autonics controllers, Probat, Giesen, gas drum roasters | Modbus |
| Phidget22 | Diedrich, Phidget temperature boards | Phidget |
| Artisan settings | Machines already linked in Artisan | Import Artisan settings |
Common flow
Section titled “Common flow”- Sign in to the desktop app.
- Settings → Roasting machines → Add machine.
- Enter alias, batch capacity, and preset (Modbus / Phidget / other).
- Set port, IP, slave ID, register map, etc.
- Click Connect and confirm live BT/ET.
Checklists by path
Section titled “Checklists by path”USB serial (Modbus RTU)
Section titled “USB serial (Modbus RTU)”- USB cable from roaster to PC
- Correct USB–serial driver for your OS
- Correct COM port (Windows) /
/dev/tty.*(macOS) in the app - Baud, parity, slave ID match the roaster manual
LAN / Wi‑Fi (Modbus TCP)
Section titled “LAN / Wi‑Fi (Modbus TCP)”- Roaster and PC on the same network
- Static IP or DHCP reservation for the roaster
- Firewall/router allows Modbus port (default 502)
- Update app IP if the roaster IP changes
Phidget
Section titled “Phidget”- Phidget22 drivers and Network Server running
- Sensors visible in Control Panel
- Phidget preset + channel mapping in the app
Unknown model
Section titled “Unknown model”Send Contact:
- Roaster make & model
- Artisan machine settings screenshot if any (→ Artisan guide)
- Temperature controller brand (Delta, Autonics, etc.)
- USB vs LAN
When things fail
Section titled “When things fail”See Connection troubleshooting first.