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.
    They are the email address and password you were given to access your Cropster account on c-sar.cropster.com.
  5. Check the Remember credentials box if you want to be able to run the RI offline.
  6. Click the Login button.
      

Establishing a connection to the machine

  1. Go to Account > Preferences > Machine tab.
  2. Select the Roast machine you would like to connect from the drop-down menu (e.g. Yoshan YS-10)
  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, 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

  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.

    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 our Getting started video and enjoy tracking your first roasts! 

    More manuals and videos can be found on help.cropster.com.