Rainfrog Inc.

Setting Up Phidgets Legacy Lib21

Danny Hall

These are outdated instructions, and only apply to Roastmaster 10 and earlier, which uses Phidgets Lib21 software. If you are configuring Phidgets for Roastmaster 11 (October, 2017) or later, please see the instructions for Lib22 in Setting Up Phidgets

Phidgets offer a versatile and scalable solution for monitoring and logging roast temperatures with Roastmaster’s Data Logging option. Roastmaster connects to one or more Phidget Temperature Sensors through your WiFi network via a network “host”.

Please see How Do Phidgets Work? to become acquainted with how a network host is used to communicate with Roastmaster.

To use Phidgets with Roastmaster, you’ll need…

  1. A Phidget Temperature Sensor and attached K or J thermocouple(s)
  2. A network host to send wireless readings (one of the following):
    • A full-size computer, e.g. Mac or PC desktop or laptop
    • Phidget SBC with USB WiFi adapter
    • Another brand of wireless DIY computer
  3. A wireless Ethernet network
  4. Roastmaster’s Data Logging entitlement (available as an in app purchase in the “Probes” section of Roastmaster’s Utilities screen)

Configuring your Host

Once you have procured the necessary parts, you need to configure your host with the Phidget Network Server software drivers that allow it to communicate with Roastmaster on your wireless network.

Standard Computer Host, e.g. laptop, desktop

  1. Download and install the appropriate version of Driver Library 21
  2. Attach the Temperature Sensor to your computer via the supplied USB cable
  3. Launch the Preference Pane (Mac) or Control Panel (Windows)
  4. Assign an arbitrary Server ID, e.g. Danny’s Mac, My Phidget Host, etc.
  5. Turn the WebService on.

SBC Host

  1. Download and install the appropriate version of Driver Library 21 to a standard computer. This software and the computer will be used only once to perform the initial configuration of the SBC.
  2. Attach the Temperature Sensor to your SBC via the supplied USB cable
  3. In the PhidgetSBC tab of the Phidgets Preference Pane (Mac) or Control Panel (Windows), double click the SBC to launch the web Administration Console.
  4. In the Administration Console, verify that Library 21 is installed on your SBC.
  5. Make the SBC a member of your network in one of two ways:
    • If you will network the SBC with an Ethernet cable…
      1. Attach one end of the cable to your router or switch, and the other to the SBC.
    • If you will network the SBC using the Phidget wireless adapter…
      1. Attach the wireless adapter to the SBC.
      2. In the Administration Console, navigate to Status > Wireless.
      3. Select your network in the detected networks, and enter the network password.
      4. To automatically join this network whenever the SBC is in range, verify that the “Remember this network” checkbox is checked. If so, the SBC/Temperature Sensor combination will become completely self-sufficient, automatically joining your network when it boots, and available for immediate use to Roastmaster.
      5. Click “Add This Network”.
  6. Navigate to the Phidgets > phidget21 Webservice pane.
  7. Verify that Phidget Webservice is enabled.
  8. Assign an arbitrary Server ID, e.g. Danny’s SBC, My Phidget Host, etc.
  9. Click “Start” to launch the Webservice if it is not already running.

Define Probes in Roastmaster

After configuring the network host, it’s time to define the probes you want to use in Roastmaster. This process is only performed once. After the probes are defined, they will be available for the life of the app on your device.

If you have not yet purchased the Data Logging option, you can purchase it by navigating to Probes, and tapping “Probe Store” in the bottom toolbar.

  1. Navigate to “Probes” in Roastmaster.
  2. Tap “+” to create a new probe.
  3. Choose Phidgets Temperature Sensing.
  4. Locate the Serial number of the Temperature Sensor.
    • Standard Computer Host: Navigate to the “Phidgets” tab of the “Phidget Control Panel” application. The Serial # column will show the serial number of any attached Temperature Sensors
    • SBC Host: Navigate to the Phidgets > Status pane. The Serial Number column will show the serial number of any attached temperature sensors.
  5. Enter the Temperature Sensor Serial number in the “Serial” field of the probe definition.
  6. Choose the “Port” that your thermocouple will be attached to on the Temperature Sensor
  7. Choose the correct Alloy Type: K or J
  8. Name the probe
  9. Tap Save

Verify Connection

After entering a valid Serial Number and Port, Roastmaster should display a green “Linked” status, as well as the current temperature of the probe.

If you see “Unlinked” displayed in red, and have followed all of these steps, it’s very likely that a firewall somewhere on your network (either on the host or the router itself) is blocking the Network Server traffic. Please visit Troubleshooting Phidgets for a list of common connection problems and possible solutions.

Begin Using Your Probe!

Once your probe definition has been created, and displays a linked status, all that’s left to do in the future is to link the probe to reading curves in roasts to report temperatures and log data.

  1. In “Roasts”, tap the “+” button to create a new roast.
  2. Tap the curve button, and choose “Create New Curve”
  3. Set the curve type to “Reading”
  4. Tap the “Bind To” field to bind the curve to your new probe definition.
  5. Save the curve

In the roast console, you can select your curve by tapping the console graph. Roastmaster will display live temperature readings as they change on the probe. After you start the roast, Roastmaster will log these temperatures at the interval defined in the curve for the duration of the roast.

Have a look at some of our screencasts, particularly those in the “Roasting with Roastmaster” series, for instructions on how to leverage curves and profiles with Data Logging to create effortless workflows with vital Reference Curves for targeting, and Data Curves for logging new data.

Tags: , ,
Categores: ,