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 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 Roasting Intelligence (R)I.

      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.

        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. Use the same credentials that you use to access the online platform C-sar.

      Stay informed about the latest features and enhancements by reviewing the Release Notes for each version of RI5. You can access them directly in RI by clicking on Help > Release Notes.

      Establishing a connection to the machine

      Before you start configuring your roasting machine, make sure that it has been added to your account on 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.

      8. Change the order of the measurements by using the  Drag and Drop icon and move it into position.
        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 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!

        Your opinion matters. If you have further questions, feedback, or concerns, please submit a support ticket directly from support.cropster.com.