Skip to main content

Installation

Installing Roaster Scope​

Step 1: Download Roaster Scope​

Go to the Download page and click the link for your platform to download the latest Roaster Scope release.

Step 2: Install Roaster Scope on your system​

Windows​

Run the installer by double clicking on the setup .exe file.

macOS​

Mount the installation .dmg archive with a double-click and drag the contained artisan.app to your Applications folder.

Linux​

Install the downloaded installer file by a double-click or run the installer via the following console command on

Redhat/CentOS

# sudo rpm -i artisan-linux-x.x.x.rpm

Debian/Ubuntu/Raspian

# sudo dpkg -i artisan-linux-x.x.x.deb

Step 3: Configure Roaster Scope for your roaster​

You need to tell Roaster Scope which machine or devices you attached. Startup Roaster Scope and select your roasting machine (menu Config >> Machines) or open the Device Assignment dialog (menu Config >> Device) and configure your device here.

To operate certain meters or other devices may require installing a corresponding driver. Refer to your product's section in Supported Machines or Supported Devices for more detailed information.


Some additional notes for Linux​

In case you run into permission problems such that Roaster Scope is not allowed to read or write to the selected /dev/USB device, you might need to add your account (username) to the dialout group via

# sudo adduser <username> dialout

After this command you might need to logout and login again. Try

# id

that your account was successful added to the dialout group.

Under Linux Manjaro (and presumably Arch and derivatives), the user has to be part of the uucp group. To do this, use "sudo gpasswd -a <username> uucp". You must log out and back in for this to take effect.

Note that for apps running by non-root users access to Phidgets or Yoctopuce devices require the installation of corresponding udev rules. Check the Phidgets and Yoctopuce platform installation notes. Those rules are installed automatically by Roaster Scope, but require the users to be in the sudo group for security considerations.

Consistent USB names on Debian (by Rob Gardner)​

On some Debian-based systems the USB device names are different, once /dev/tty/USB0 another time /dev/tty/USB1, on each connect of the same device. The solution is to add a udev rule that creates a symbolic link with a constant name to point to the actual device. In my situation, I added a file called

/etc/udev/rules.d/datalogger.rules

that contains this

ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", GROUP="plugdev", SYMLINK="tmd-56"

This tells udev to create a symbolic link "tmd-56" to point to the real device file. You can use the 'lsusb' command to easily find the vendor and product ID for your device. Then I just simply tell Roaster Scope that my serial port is /dev/tmd-56 and it always finds it, no matter if the probe is plugged in before or after starting Roaster Scope. You may need to customize the plugdev group also for your distro and add yourself to the plugdev group. On some systems the "dialout" group is used for serial devices (see above).