Plug&Play connectors
      Back to home
      1. Helpdesk : Cropster
      2. Connecting your roast machine
      3. Plug&Play connectors

      Yoshan/Dongyi - Roasting Intelligence (RI) Setup (beta)

      This manual covers the connection of a Yoshan/Dongyi roast machine to Cropster's Roasting Intelligence.

      This roast machine is currently in the beta stage of development at Cropster.

      Beta testing involves the evaluation of new features by a limited group of users to uncover minor issues that may not be apparent during internal testing. Your feedback is crucial in helping us improve the functionality of our product. Please let us know in case you come across any unexpected behavior.

      If you haven't been invited to participate in the beta program for this integration but are keen on participating and testing this new feature, please sign up here.

      We will be happy to assist in resolving any issues you may encounter or propose alternative connection options.

      Specifications

      Requirements

      Supported measurements

      • Bean temperature
      • Exhaust temperature

      Setting up a connection


      Via Bluetooth

      1. Access your computer's Bluetooth interface.
        • On Mac: Go to Apple icon > System preferences > Bluetooth.
        • On Windows: Go to Settings > Bluetooth & devices.
      2. Turn on Bluetooth, and connect to the device HC-0X (e.g. HC-06, HC-02).
      3. Input the match code 1234.
      4. Proceed with the Roasting Intelligence (RI) Setup.

      Some computers may not be compatible for a Bluetooth connection, and alternatively, connect via data cable.

      Via data cable 

      1. Turn on the power on the roast machine.
      2. Plug the data cable into the roast machine's communication port.
      3. Connect the cable to the computer's USB port.
      4. Proceed with the Roasting Intelligence (RI) Setup.

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

      4. Enter your username and password.
        Use the same login information that you use to access the online platform C-sar.

      5. Click the Login button. 

      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

        1. If you are setting up RI for the first time, click the Select Machine button in the banner at the top or click gear-png-2 Preferences  > Machine > Configuration bottom left to access the Preferences screen.
          📚 Learn how to use the keyboard shortcuts in RI.
        2. To choose the Roast machine, click on the dropdown menu in the Machine section. 
          📚 Learn how to add a new roast machine. 
        3. After selecting the machine all supported measurements will load.
          Change the order of the measurements by using the  Drag and Drop icon and moving it into position.
        4. Switch on the measurements you would like to enable and select Generic Modbus over serial port 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. 
          Screenshot 2024-08-16 at 14.04.53
        5. Click on the Gear icon to open and configure the settings based on the manufacturing year as shown below:
          💡 Choose Celsius or Fahrenheit according to the temperature unit displayed from the machine's temperature readouts.

          Operation system  Serial port 
          Windows COMx
          Mac USBx

           

          Before May 2017


          Screenshot 2024-11-13 at 09.48.54


          After May 2017

          Screenshot 2024-08-16 at 14.24.43

        6. Leave the empty fields as they are.
        7. Click OK.
        8. Click Save to finalize the changes.
          9. 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 2024-08-13 at 13.54.12-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?
      • Is the correct serial port within the RI selected?

      Alternative configuration

      If you are receiving Sources connected, and you have selected the Serial port referring to the connection of the roast machine, but you do not have any temperature measurements, try the following settings:

      1.  Navigate to gear-png-2 Preferences  > Machine > Configuration. 
      2. Verify the Roast machine you would like to connect from the dropdown menu (e.g. Yoshan YS-10), is still selected.
      3. Select Generic Modbus over serial port from the dropdown for all measurements.
      4. Click on the Gear icon to open more settings.
      5. Copy the settings as shown in the screenshot below, and select the Serial port, and Temperature unit:
        • Serial port:
          Windows: Choose the COMx option that refers to the connection to the roaster.

          Mac: Choose the USBx option that refers to the connection to the roaster.

        • Temperature unit: Choose Celsius or Fahrenheit according to the temperature unit displayed from the machine's temperature readouts.

          Screenshot 2024-08-16 at 14.26.43
      6. Leave the empty fields as they are.
      7. Click OK.
      8. Click Save to finalize the changes. 

      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.

      The temperature decimal is in the incorrect location or other connection issues


      To solve these issues,  you need to download the custom version of Roasting Intelligence (RI) depending on your computer's Operating System here. 

      If you are utilizing a custom version of Roasting Intelligence (RI), please take a moment to sign up via this form.

      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.