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

In this article, you will learn how to connect a Yoshan/Dongyi roast machine, to Cropster's Roasting Intelligence.

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

Beta means that the features are being tested with a select group of users to help us identify minor flaws under everyday conditions that we cannot reproduce internally. Therefore, it will be necessary that you share feedback with us and let us know whenever you come across some unexpected behavior.

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).

    The picture above, was taken from a Mac's Bluetooth interface.
  3. Input the match code 1234.

    The picture above, was taken from a Mac's Bluetooth interface, after the code has been inputted for the HC-0X Bluetooth device.

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


Proceed with the Roasting Intelligence (RI) Setup.

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.

Proceed with the Roasting Intelligence (RI) Setup.

Roasting Intelligence (RI) Setup

Installing the Roasting Intelligence (RI) software

  1. Download the Roasting Intelligence from https://download.cropster.com/
  2. The Cropster installer leads you through all the installation steps.
  3. Open the RI by double-clicking the Cropster icon on the desktop.
  4. Enter your username and password.
    The username is the email address your Cropster invitation has been sent to. Use the password you've generated when accepting the invitation.
  5. Check the Remember credentials box if you want to be able to run the RI offline.
  6. Click the Login button.
     Screenshot 2024-05-21 at 14.02.47 

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-1 Preferences  > Machine > Configuration bottom left to access the preferences screen.
  2. Select the Roast machine you would like to connect from the drop-down menu (e.g. Yoshan YS-10). 

    If the machine is not in the list you can add via the online platform.

  3. Select Generic Modbus over serial port from the dropdown for all measurements.
  4. Change the order of the measurements by using the drag and drop icon and moving it into position.

    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-05-21 at 14.08.07
  5. Click on the Gear icon to open more settings.
  6. Copy the settings as shown in the screenshot below, based on the manufacturing year, 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.

      After May 2017 Before May 2017

  7. Leave the empty fields as they are, then click OK.
  8. Click Save to confirm the changes. 
  9. RI will automatically restart after saving the changes. If the setup was successful you will be able to see temperature values on the right-hand side of the RI screen, after the restart.

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.

Learn how to customize your RI user 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. Go to Account > Preferences > Machine tab.
  2. Verify the Roast machine you would like to connect from the drop-down menu (e.g. Yoshan YS-10), is still selected.
  3. Select Generic Modbus over serial port from the drop-down 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.

  6. Leave the empty fields as they are, then click OK.
  7. Click Save to confirm the changes. The RI requires a restart to apply the settings.

For further assistance, please create a support ticket by clicking the Support button in the left lower corner of the app. A Cropster support rep will get in touch with you.


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