Connecting your roast machine
      Back to home
      1. Helpdesk : Cropster
      2. Connecting your roast machine

      Connecting your roast machine to Roasting Intelligence (RI) using a Generic Connector

      This article will explain how to connect your roast machine to Cropster's Roasting Intelligence (RI) using a Generic Connector.

      This article is relevant to users of custom roast machines who want to integrate their machines with Cropster's Roasting Intelligence (RI)

      What is a Generic Connector?


      Establishing a connection between your roast machine and Cropster is the essential first step to accessing our comprehensive suite of tools.

      If you are familiar with the communication protocol and register settings of your roast machine, you can establish a connection using one of the available Generic Connectors listed below:
      1. Generic Modbus over Network (TCP)
      2. Generic Modbus over Network (UDP)
      3. Generic Modbus over Serial port 
      4. Generic Siemens S7 over Network 

      Specifications


      Requirements 

      • USB cable, Ethernet cable, WiFi connection (depends on which Generic Connector is being used).
      • Driver for the USB serial converter in cases where a USB connection is being used.

      You may need to install a specific driver based on your machine's requirements. Unfortunately, we are unable to provide detailed guidance on this at this stage of the process. 

      The necessary driver might already be included with your operating system.

      If you are connecting the roast machine with an ethernet cable directly to your computer, you will also need to set up a static IP address.

      Supported measurements

      • Bean temperature
      • Exhaust temperature 
      • Gas* 
        *Not when using the Generic Modbus over serial port connector.

      The supported measurements are read-only. The Generic Connector doesn't support controls. 

      Roasting Intelligence Setup

      Installing the Roasting Intelligence (RI) software 

      1. Download RI.

      2. Complete the installation process by following the steps provided.

      3. Double-click the Cropster icon on your desktop to access Roasting Intelligence (RI).
      4. Click the green Login with the browser button.
        💡 Select the "Remember me on this device" option to save your login credentials for future access.

        Screenshot 2025-03-26 at 12.10.43

      5. You will be directed to the C-sar browser. 
        Screenshot 2025-03-26 at 11.46.59
      6. Enter your Username* and Password* and click the green Sign in with password button.
        💡        You need to use the same credentials that you use to access the online platform C-sar.

      Check out the Release notes for every version of RI5 to stay updated on the latest features and improvements. You can access the Release notes directly in RI by clicking on Help > Release Notes.

      Establishing a connection to the machine


      Before you begin configuring your roast machine, ensure that you have added it via the online platform C-sar. 
      1. If you are setting up Roasting Intelligence (RI) for the first time, click the Select machine button in the banner at the top or click Preferences > Machine > Configuration to access the Preferences screen. 
      2. Select the Machine by clicking on the dropdown in the Roasting Machine section. 
      3. Navigate to the Connector setup section. Choose the relevant Generic Connector from the available options by clicking the +Add connector button. 
      4. Click Select. 
        Screenshot 2025-03-31 at 15.06.20

      5. Navigate to the Machine > Measurements tab.

      6. All supported measurements will be displayed here.  To activate the measurements, simply click the green toggle button.

      7. Switch on the measurements you would like to enable and select the relevant Generic connector from the dropdown. 
        💡 Make your measurement readouts more compact. Choose the size of your measurement readouts by selecting either the Small or Large view for display.

      8. Change the order of the measurements by using the  Drag and Drop icon and move it into position.
        💡You can also customize the color of each measurement by clicking on the colorful dots on the right side of the screen.
        Screenshot 2025-04-01 at 10.09.42

      9. Navigate back to the Machine > Configuration tab and click on the gear-png-1Gear icon in the Connector setup section next to the previously added connector to open and configure more settings.

      10. Fill in all the information according to the specifications of your roast machine.
      11. Click OK.
      12. Click Save to finalize the changes. 

        13. After saving the changes, RI will automatically restart. If the setup was successful, you will see the temperature values displayed on the right-hand side of the RI screen following the restart.
      Screenshot 2025-03-31 at 13.05.11-1

        📚 Learn more about the Roasting Intelligence (RI) Preferences.

        Troubleshooting


        If the RI indicates No source connected and/or you cannot see any measurements, please check the following: 

        • Is the roast machine connected to the computer? 
        • Have you downloaded the driver for the USB serial converter?
        • Have you set up a static IP address if using an ethernet connection directly into your computer?
        • Is the correct serial port within the RI selected?
        • Are the settings copied correctly?

        Driver for the USB serial converter

        If you cannot select the correct serial port within the RI's Serial port field, your computer may not have the appropriate driver needed to recognize the serial converter's physical connection.

        Please reach out to support.cropster.com, and attach the following information relevant to the USB serial converter used:

        • Brand, and model

        • Serial number

        • Picture of the serial converter

        • RI log files

        A Cropster representative will assess the information, and assist in providing the required driver for the USB serial converter used.

        If you have selected a serial port from the RI, and you receive Sources connected from the bottom-right corner of the roasting application, but you can't see live temperature readouts, you may not have selected the serial port referring to the roast machine's connection.

        Related content

        Congratulations! You have successfully set up the Cropster Roasting Intelligence!

        Check out the Roasting Intelligence (RI5) - Getting Started manual and enjoy tracking your first roasts! More manuals and videos can be found on help.cropster.com.