Troubleshoot


Troubleshooting information is split into the following sections:

1.  Troubleshooting common issues

2.  Information for Linux users only

3.  Information for all operating systems

4.  Serial devices and drivers

5.  Setting executable permission for your USB HID Reader



1. Troubleshooting common issues


The following table lists some common problems and possible solutions.  The details of how to apply the solutions vary depending on your operating system.  It is suggested that you use Google to find details for your operating system.

Problem
Possible causes
Possible solutions
RoastLogger will not start
  • Attempt to run from within a compressed archive
  • Compressed archive (.zip file) not extracted correctly
  • Java not installed correctly
  • Archive must be uncompressed first
  • Right click compressed archive and select extract all. Google for details for your operating system
  • Remove all versions of Java then install the latest version of Java SE
RoastLogger runs but does not save my settings between sessions
  • This can only occur if you are running the RoastLogger in Windows OS and have installed it under \Program Files or \Windows
  • Move your installation of RoastLogger to your home or documents folder
My serial device does not appear in serial port drop down box
  • Serial driver not correctly installed
  • Faulty USB cable
  • Faulty serial device 
  • Linux users need to set permissions for serial device
  • Install the correct device driver for your serial device and operating system.  See Appendix C of the RoastLogger manual for details
  • Use a high quality USB cable
  • Check device with manufacturers own software
  • See 2. "Information for Linux users" below
USB HID reader will not start. DMM tab window just shows “Attempting connection to: [path to your USB HID Reader]
  • The executable permission was removed from the USB HID reader when it was downloaded/extracted.
  • Set the executable permission for the relevant USB HID Reader.  See section 5 below for details.
Linux user can not connect to USB HID or Serial device
  • Linux permissions to access the device not set.
  • Set the permissions for the relevant device.  See section 2. below for details.
When I unplug the serial cable RoastLogger or my operating system sometimes crashes
  • This is a known issue with serial communication/drivers.  In some cases RoastLogger performs a crash shutdown in an attempt to avoid an operating system crash
  • Do NOT unplug the USB cable during communication.  See section 4. below and Appendix C of the RoastLogger manual "Safe unplugging of serial devices"
Serial communication sometimes stops or RoastLogger or my operating system shuts down
  • Faulty USB cable/connectors breaking the connection during communication
  • Use a high quality USB cable without extension cables.  If you must use a poor cable avoid disturbing the connections during roasting




2.  Linux users only:


Linux users need to set permissions correctly on a new installation.  Please read the following three points for details of the necessary steps.  These steps are only necessary on a new installation.  If you update the roastLogger via menu > Help > Update RoastLogger then the executable permissions will be set automatically.

2.1  If you wish to use the DMM tab to read from a USB HID device then you may need to set the executable permission of the included USB HID readers included in the /HID folder ( USBHIDReader_Linux for 32 bit systems or USBHIDReader_Linux64 for 64 bit systems). 

2.2  Two issues exist with Linux which are both solved by adding the included udev rule.

  • Unknown devices are not accessible to non-root users in Linux.   Due to this the connection to your Victor 86 B or Victor 86 C multimeter will not work until you add the following rule.
  • Arduino Uno's are not correctly identified to the RoastLogger.  The following rule changes the serial port names from the Uno "ttyACM*" which is not recognised to "ttyUSB%n" which is recognised by the RoastLogger.

The included udev rule can be used to solve both of these issues.  The rule file is provided in the distribution in folder "/ReadMe Setup info/Linux users read this" titled "45-trcusbhidrule.rules".  Copy this rule file into the "/etc/udev/rules.d" folder and restart Linux to permanently fix both issues.

2.3  Serial Devices:

If you wish to connect to a serial device you need to set permission for serial port access.  One way to achieve this is to add yourself to the dialout group.  Google "linux serial port permissions" for information on granting permission for serial port access.



3.  All Operating Systems:


If you have a problem running the program please navigate to the installation folder and attempt to run RoastLogger.jar. The way you run a .jar file depends on your operating system and how you have installed Java.  Try in this order of preference:

  • double click the .jar file
  • right click the .jar file and select run with Sun Java 1.6 (or above)
  • Open a terminal (Command Prompt on Windows) navigate to the installation folder and enter
 java –jar RoastLogger.jar

If you can not run RoastLogger.jar open a terminal (Command Prompt in Windows) and enter the following:

Java –version

You should get a response similar to:

java version "1.6.0_07"
Java(TM) SE Runtime Environment (build 1.6.0_07-b06)
Java HotSpot(TM) Client VM (build 10.0-b23, mixed mode, sharing)
 
If the version is less than 1.6 then you need to update to a more recent version of Java.  If you have installed version 1.6 or above but the reported version is still less than 1.6 you need to make the latest version your default version of Java.  How this is done varies for different operating systems.  Currently it is necessary to take this step with Mac OS X versions below 10.6 which still uses Java version 1.5 as the default.  For Mac OSX versions below 10.6 set Java version 1.6 as the default version by running  /Applications/Utilities/Java/Java\ Preferences.app/Contents/MacOS/Java\ Preferences .




4.  Serial devices and drivers:


The Arduino TC4/C and the devices read by the SerialDMMReader communicate via RS232 serial.  These devices require a virtual com port driver.  Some operating systems install the correct driver automatically.  See the manufacturers website for suitable drivers for your operating system. 

For the Arduino the easiest way to ensure the driver is installed and working is to install the Arduino environment for your operating system.  This will install the driver and you can communicate with the Arduino in the Arduino environment to ensure everything is working OK.  Alternatively you can download the relevant TC4C driver.

Safe Unplugging of serial devices:


It is strongly recommended that you do not unplug serial devices whilst they are in use.  A number of virtual com port drivers are known to cause problems if the device is unplugged whilst in use.  In the worst case this can crash your system.  Any of the following actions will ensure it is safe to unplug the device.

Arduino Controller:  Close the Arduino Controller by pressing the stop button on the Arduino tab.  Alternatively you can close the RoastLogger.

Serial multimeter/digital thermometers: Press the stop button on the SerialDMMReader.  Alternatively you can close the SerialDMMReader by pressing the stop button(s) on the DMM tab (if reading both T1 and T2 it is necessary to press both stop buttons) or you can close the RoastLogger.



5.  Setting executable permission for your USB HID Reader:


Operating systems are becoming more fussy about the executable permissions of files downloaded from the internet.  The RoastLogger Automatic Updater attempts to reset these permissions but this is not always possible.  If your USB HID Reader will not run then this is likely to be the cause.  How you set the executable permission depends on your operating system.

How executable permissions are set varies between operating systems.  Please google “set file executable permissions for [your operating system]” for details.  In summary the following works in most cases:

For Windows:

  • In Windows Explorer, right-click the file or folder you want to work with.
  • From the pop-up menu, select Properties, and then in the Properties dialog box click the Security tab.
  • Users or groups that already have access to the file or folder are listed in the Name list box.
  • Select the user or group you want to change.
  • Click the “Edit” button.
  • Use the Permissions list box to grant executable permission.
  • Click OK when you have set the permission.

For OS X or Linux:

  • Open Terminal and enter the following with a space at the end but without pressing enter:
  • chmod +x
  • Then drag the USBHIDReader relevant for your OS** from finder to the Terminal window.  This will add the full path to the HID reader to the end of the command. 
  • Then press enter.

** If you are unsure which hid reader is relevant press start on the DMM tab with USB HID selected and the relevant HID reader name will be displayed.