Verify that your operating system fulfills the requirements listed under supported Platforms.
Verify that your roasting machine and the devices you plan to operate with Artisan are among the Supported Machines or Supported Devices.
Find and download the package of the latest release for your platform. The filenames are as follows, with x.x.x the version number.
- macOS:
artisan-mac-x.x.x.dmg- Artisan is also available via the Homebrew Cask package manager. See below for instructions.
- Windows:
artisan-win-x.x.x.zip - Linux Redhat/CentOS:
artisan-linux-x.x.x.rpm - Linux Debian/Ubuntu:
artisan-linux-x.x.x.deb - Raspberry Pi:
artisan-linux-x.x.x_raspbian-XX.deb
Extract the downloaded zip archive and start the included installer.
Mount the installation .dmg archive with a double-click and drag the contained Artisan.app to your Applications folder
You need to (temporarily during installation) tick "Allow applications downloaded from Anywhere" in the Security & Privacy Preference Panel to start the app. On first app start Mac OS X can warn about unidentified developer. See https://support.apple.com/kb/PH21769 on how to open an app from an unidentified developer. After first application start, tick again "Allow applications downloaded from Anywhere" in the Security & Privacy Preference Panel.
Artisan is available on Homebrew. To install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
To install Artisan via Homebrew:
brew install --cask artisan
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
To operate some devices like Phidget modules or certain meters you need to install corresponding drivers. See the corresponding Section under Supported Devices for further details.
Under 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, It is required to log out and back in for this to take effect.
In case you run into permission problems such that Artisan 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.
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 Artisan, but require the users to be in the sudo group for security considerations.
To allow Artisan to remember the artisan.plus password gnome-keyring needs to be installed. You can install this on Ubuntu and Raspbian via
sudo apt-get update
sudo apt-get install gnome-keyring
A bug in Ubuntu 22.04 has been reported that deactivates certain /dev/ttyUSB device ports, eg. the one used by the Mastech 6514. The culprit is a package called BRLTTY, which is installed automatically in 22.04. This package is for blind folks who use a TTY. A work around is to use synaptic or the following terminal commands to remove this package.
# sudo apt-get remove brltty
There is an alternative, but more complex fix that works without deinstalling that package.
You need to tell Artisan which machine or devices you attached. Startup Artisan and select your roasting machine (menu Config >> Machines) or open the Device Assignment dialog (menu Config >> Device) and configure your device here.
The serial settings for meters are already configured by Artisan automatically when you select a device for the first time (or when you change devices). The only setting that is not configured is the serial port number being used. To find out your serial port, connect your device/meter and select the correct comm port from the ports popup menu. You can test to see if you have the correct comm port by clicking the green button "ON" on the top of the main window. If you see the two temperatures from the meter come up on the LCDs, you have completed all the configuration steps. You can now start using artisan.
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 Artisan 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 Artisan. 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).
The Omega HH806AU, HH802U as well as the Amprobe TMD-56 device are supported by Artisan only if they are communicating on channel 0.
- How to check the channel number
When the meter is off press [C/F] key and [POWER] for 5
seconds, LCD's main display will show channel number,
the second display will show ID number.
- How RESET the meter to channel zero
To SET CH/ID to 00,00, by pressing the "T1-T2" key
(labeled "Hi/Lo Limits" on the HH802U) and
the power key for more than 6 seconds with the meter
powered down. The meter will set channel and ID
to 00,00 status. The second display will show 00,
which means that the channel and ID has been set to
00.
Artisan uses one decimal point. You have to manually configure your pid so that it outputs one digit after the decimal point. See page 42 in the instruction manual.
On Linux, Artisan needs read/write access to the USB device. Corresponding udev rules are automatically installed along Artisan in /etc/udev/rules.d. However, those require the users to be in the sudo group for security considerations.