Specifications

Requirements

• USB cable
• Driver (serial converter) for machines built before February 2022:
  • https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers
• Driver (serial converter) for machines built February 2022 onwards:
  • Windows 
  • macOS 
  • Linux 

Supported measurements

• Bean temperature
• Exhaust temperature
• Inlet temperature

Multi-barrel Roasting Intelligence setup

Downloading the startup script

1. Download the Beta version of Roasting Intelligence.
2. Complete the installation process by following the steps provided.
3. Download the multibarrel startup script below and save it to the desktop.
   • Windows: RoastingIntelligence5.beta.vbs
   • Mac: RoastingIntelligence5.beta.command.zip
   • Linux: RoastingIntelligence4.sh

Configuring the startup script

The startup script is preconfigured for a four-barrel sample roaster. If your roaster has fewer than four barrels, you will need to adapt the file first. 
Follow the steps based on your computer's operating system:

Configuring the startup script on macOS

1. Double-click the .zip file to decompress the .command file.
2. Right-click on the .command file, select Open With and choose the Text edit application.
3. The file contains four text blocks as shown below. Each block refers to one barrel of your roaster.
   

   

4. Refer to the machine and identify the number of barrels you are setting up.
   ⚠️ The number of barrels on your roaster must match the number of blocks in the file.
5. Starting from the bottom of the file, delete the text blocks until there are as many text blocks as there are barrels on the roaster. e.g., If you have a two-barrel roast machine, you need to delete the last two text blocks. 
6. Save your changes to the file.
7. Open Roasting Intelligence.

Configuring the startup script on Windows 
 

1. Right-click on the vbs. file, select Open With, and choose the Notepad application.
2. The file contains four text blocks as shown below. Each block refers to one barrel of your roaster.
   

   

3. Refer to the machine and identify the number of barrels you are setting up.
   ⚠️ The number of barrels on your roaster must match the number of blocks in the file.
4. Starting from the bottom of the file, delete the text blocks until there are as many text blocks as there are barrels on the roaster, e.g., if you have a two-barrel roaster, you need to delete the last two text blocks. 
5. Save your changes to the file.
6. Open Roasting Intelligence.

Roasting Intelligence setup

Opening Roasting Intelligence on Windows
 

1. Double-click the startup script (RoastingIntelligence5.beta.vbs) and several instances of the Roasting Intelligence will open.

Opening Roasting Intelligence on macOS

1. Download the make executable.zip (2 items).
2. Unpack the file by double-clicking it. It will create a new file called make_executable.
3. Unpack the start script file (RoastingIntelligence5.beta.command.zip) It will create a file called RoastingIntelligence5.beta.command.
4. Drag the RoastingIntelligence5.beta.command file on top of the extracted make_executable automator file.
   

   

5. Click Open in the following dialog. Nothing visually will happen, but the file will now be executable.
6. Double-click the startup script (RoastingIntelligence5.beta.command) and everal instances of the Roasting Intelligence will open.

Opening Roasting Intelligence on Linux
 

1. Check how to run a sh-file on Linux or issue a support ticket for further assistance. 

Roasting Intelligence configuration

1. SelectPreferences > Machine > Configuration.
2. To choose the Roast machine, click on the dropdown menu in the Machine section.
3. Click the + Add connector option to choose your connector from the dropdown list.
4. Select Arc Roaster from the dropdown.
5. Click Select to add the connector.
   

   

6. Click on the Gear icon in the Connector setup section to open and configure more settings.
7. Select the Serial port referring to your roast machine, Temperature unit, and Version:
   
   • Serial port:
     • Windows: COM 
     • Mac: USB 
       ⚠️ Select a different Serial port in each Roasting Intelligence instance.
   • Temperature unit: Choose Celsius or Fahrenheit according to the temperature unit displayed from the machine's temperature readouts.
   • Version: Choose the version corresponding to your machine's manufacturing date.
     • Before February 2022 - Version: Before February 2022
     • February 2022 onwards - Version: February 2022 onwards 
8. Click OK.
   

   

9. Navigate to the Machine > Measurements tab. All supported measurements will be displayed.
10. To activate the measurements, click the green toggle button.
11. Enable the desired measurements and choose Arc Roaster as the connector type.
12. (Optional) Change the order of the measurements by using theDrag and Drop icon and move it into position.
13. Click Save to finalize the changes.
    ⚠️ Repeat these steps for each remaining barrel within its respective Roasting Intelligence instance.
    

    

14. Restart Roasting Intelligence. If the setup was successful, you will see the temperature values displayed on the right-hand side of the screen following the restart
    
    

    

• Is the roast machine connected to the computer? 
• Have you downloaded the driver for the USB serial converter, according to the manufacturing year of the machine?
• Is the correct Serial port within Roasting Intelligence selected?

If the serial port has been reassigned, Roasting Intelligence can no longer find the connection it previously saved. This results in a "No sources connected" error. This usually happens if you plug the USB cable into a different port or if the OS reorders your devices:

1. SelectPreferences > Machine > Configuration.
2. Click on the Gear icon in the Connector setup section to open and configure more settings.
3. Locate the Serial port dropdown menu.
4. Select the new active port from the list.
5. Click OK.
6. Click Save to finalize the changes.
7. Restart Roasting Intelligence.