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

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

---

• Specifications
• Setting up a connection
• Roasting Intelligence (RI) Setup
  • Installing the Roasting Intelligence (RI) software
  • Establishing a connection to the machine
• Troubleshooting

---

Specifications

Requirements

• USB cable
• Driver for the USB serial converter:
  • Windows: CP210x Universal Windows Driver
  • Mac: Mac OSX VCP Driver

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.

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. Click the green Login with the browser button.
   💡 Select the "Remember me on this device" option to save your login credentials for future access.
   
   
5. You will be directed to the C-sar browser. 
   
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.

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. Click Preferences > Machine > Configuration at the bottom left to access the Preferences screen. 

2. To choose the Roast machine, click on the dropdown menu in the Machine section.

3. By clicking on the + Add connector option, you can choose your connector from the available options in the dropdown list.

4. You need to select Generic Modbus over serial from the dropdown. 
5. Click Select to add the connector.
   

6. Navigate to the Machine > Measurements tab. All supported measurements will be displayed.

7. To activate the measurements, simply click the green toggle button.

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

9. Change the order of the measurements by using the  Drag and Drop icon and move it into position.

10. Navigate back to the Machine > Configuration tab and click on the Gear icon in the Connector setup section next to the previously added connector to open and configure more settings based on the manufacturing year as shown below:💡 Choose Celsius or Fahrenheit according to the temperature unit displayed on the machine's temperature readouts.
    
    

    Operation system	Serial port
    Windows	COMx
    Mac	USBx

    
    Before May 2017
    
    
    After May 2017
    
    
    
11. Leave the empty fields as they are.
12. Click OK.
13. Click Save to finalize the changes.

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.

 

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  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. By clicking on the + Add connector option, you can choose your connector from the available options in the dropdown list.

4. You need to select Generic Modbus over serial from the dropdown. 
5. Click Select to add the connector.

6. Navigate to the Machine > Measurements tab. All supported measurements will be displayed.

7. To activate the measurements, simply click the green toggle button.

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

9. Change the order of the measurements by using the  Drag and Drop icon and move it into position.

10. Navigate back to the Machine > Configuration tab and click on the Gear icon in the Connector setup section next to the previously added connector to open and configure more settings based on the manufacturing year as shown below:
11. 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.

      
12. Leave the empty fields as they are.
13. Click OK.
14. Click Save to finalize the changes. 

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. 

---

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.