Artisan Documentation

Visual scope for coffee roasters

Installation

How to setup the artisan software

IMPORTANT

Version 0.5.0 reverses the ET and BT probes. ET (Environment Temperature) is now probe 1 while BT (Bean Temperature) is probe 2.

Introduction

There are usually two downloads needed in order to get the artisan software up and running on your platform, a driver for your meter (if it is USB) and the artisan application itself.

  1. Install artisan application
  2. Install USB driver
  3. Connect your meter via USB/serial
  4. Launch artisan application
  5. Configure device and serial settings

Windows Installation

Download the latest ZIP file and unzip. The main application is called artisan.exe and it is located inside the zip file. Start artisan by double clicking on artisan.exe.

If artisan starts when clicking on artisan.exe (a window pops open with many buttons), then your computer has the required support files and you are ready. Windows 7 come with the required support files.

If artisan does NOT start this is because your computer is missing the Microsoft Visual C++ runtime library. Visual C++ Library is available at:
Microsoft Visual C++ 2008 SP1 Redistributable Package
(x86) 32 bit http://www.microsoft.com/downloads/en/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en
(x64) 64 bit http://www.microsoft.com/downloads/en/details.aspx?familyid=ba9257ca-337f-4b40-8c14-157cfdffee4e&displaylang=en

Mac OS X Installation

NOTE: A binary is only provided for OS X 10.6 Snow Leopard

  1. Download the artisan dmg OS X Disk Image file
  2. Double click on the dmg file you just downloaded
  3. Double click the disk image which appears on your desktop
  4. Drag the artisan application icon to your Applications directory.

Linux Installation

The Linux package is compatible with Ubuntu Linux 10.10, aka the Maverick Meerkat, and Debian Linux 5.0 “Lenny” as well as 6.0 “Squeeze”. For now, we simply offer a .deb Debian package that you have to install manually (see below). For future releases, we plan to have a repository so that you can “apt-get install artisan” and get updates automagically.

Help on getting Artisan packaged for RPM-based distributions would be appreciated.

Ubuntu Installation
In your web browser, simply download the .deb-File from the download page. This will start the Ubuntu Software-Center that guides you through the rest of the installation. It will also download all dependencies during the process, like python-qt4, python-matplotlib and others.

There is no menu entry yet, this will follow in the next version. You can start artisan by simply typing “artisan” into a terminal window.

Debian Installation
Download the .deb from the download page. Become root (either with “su -“, followed by entering your root-password, or if you have sudo configured with “sudo -i“) and install the package with “dpkg -i artisan_VERSION_all.deb“. dpkg will possibly complain about missing dependencies and decline to configure the package. With “apt-get -f install” you can automatically install all missing dependencies and dpkg will be happy.

There is no menu entry yet, this will follow in the next version. You can start artisan by simply typing “artisan” into a terminal window.

Device Driver Installation

RS232 meters don’t need any drivers but USB meters do. Fuji PIDs don’t need any drivers (but they need an RS485-RS232 converter).

Windows
To install a USB driver. Plug the meter in USB port. Let Windows find and install the driver automatically through the internet. You can also install the driver through manufacturer CD if you have one, or through the manufacturer’s website.

Mac OS X
Install USB/serial driver
for Omega meters download and run the FTDI VCP OS X installer

Start artisan.

Starting Screen - click for details

Device Configuration

Select your device using the menu Conf / Device…

Conf Menu - 0.5.0

 

The following devices are supported:

  • Fuji PXR/PXG 4 & 5 PID
  • Omega HH506RA, HH802U, HHM28, HH806AU (Check USB driver here: http://www.ftdichip.com/Drivers/VCP.htm )
  • CENTER 300, 301, 302, 303, 304, 305, 306, 309
  • VOLTCRAFT K202, K204, 300K, 302KJ
  • EXTECH 421509
  • Arduino TC4
  • TE VA18B
  • Delta DTA PID

Serial Configuration

The serial settings for the meters (devices) are already configured by the artisan software automatically when you select a device for the first time (or when you change devices). Once you have chosen a device, the correct serial configuration is loaded and it will remain in memory. The only setting that is not configured is the serial port number being used. To find out your serial port, you can press the scan button and select the correct comm port from the options found by the Scan button.

Select your device using the menu Conf / Serial port…

You can test to see if you have the correct comm port by clicking the green button “ON” on the lower left corner. 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.

Green button “ON” on the lower left corner

Links to tips on working with data loggers and PIDS

 

IMPORTANT

As you start using Artisan 0.5.0, you will notice that ET and BT have been switched around compared to 0.4.1. This was necessary in order to support an unlimited number of devices. We apologize for the inconvenience.

Version 0.5.0 reverses the ET and BT probes. ET (Environment Temperature) is now probe 1 while BT (Bean Temperature) is probe 2.

Tips on configuring the HH506RA for Version 0.5.0

Probe Plugs


Step 1. Unplug the probes and reverse of that the ET probe is in T1 and BT is in T2.

Keyboard


Step 2. Press key 7 to put the BT (T2) probe to the top display and press key 8 to put the ET (T1) probe to the small display.

Reverse Readings


The display should look like this now.

 

Report problems here:

https://lists.mokelbu.de/listinfo/artisan-user

Tags: , ,

36 Responses to “Installation”

  • sdelgran says:

    >>Windows | Visual C++ Library Requirement

    Since the newer OS do not have this requirement (which is mentioned) shouldn’t this be documented as “an exception rather than the rule”? Basically, I would think it should appear last in the Windows section as in “if it does NOT start”.

  • Michael Helms says:

    “There are usually two downloads needed in order to get the artisan software up and running on your platform: a driver for your meter (if it is USB) and the artisan application itself.”

  • Michael Helms says:

    Change your headings to “Windows Installation” and “Mac OS X Installation”.

  • Michael Helms says:

    Should you include a link to the 64 bit version of the C++ runtime library?

  • Michael Helms says:

    Does a binary exist for OS X 10.5? Most people are running 10.6 now … might just want to say that it’s only available for 10.6 since 10.5 is going to be depreciated before long.

  • Michael Helms says:

    These steps don’t make sense:

    “1 Download and run the artisan OS X installer
    2 Double click on the dmg file you just downloaded”

    If there’s an installer you typically won’t need to drag the application into the Applications folder. If it’s a more conventional app then you should tell people to “run the artisan OS X installer”.

  • sdelgran says:

    Like it! Thanks.

    Something else:

    >>From version 0.2.0 on, the following devices are supported:

    The list seems outdated. The list on the introduction page is up-to-date.

  • […] the provided docs so lacking Details on which loggers and PIDS are supported can be found at Installation | Artisan Documentation __________________ Rich Helms http://coffeetroupe.com/ my blog about growing and roasting […]

  • DINGES Erhard says:

    What is the difference between version 4 and 5?
    On my win-xp-laptop version 4 now is running well, version 5 not at all.
    Is there any idea about a possible reason?

    Thanks Erhard

    • RichHelms says:

      The key difference is 5 had multi-thread support. Is it throwing an error and when? What is the error?

  • Obrien Requina says:

    This software is GREAT!!! This was very helpful on our temperature simulation task during our online debugging… Thank you very much for the creator and supporter…

  • Adding a Fluke 54 ll to the list would be appreciated. The quality and reliability of Fluke products is the main reason I use them. Never cared for Omega or Extech.

    • MAKOMO says:

      If you could provide us with details of the Fluke’s serial protocol we would be happy to implement that.

  • Kyle I says:

    I’m taking delivery on a new San Franciscan Roaster and they currently have a WATLOW display. They said they might be able to change it out with a Fuji, but I’m trying to figure out how that signal would get from the device to my Mac.

    Any thoughts on the best setup for this?

    • MAKOMO says:

      The WATLOW PIDs build into the San Franciscan roasters are now supported by the Artisan Modbus implementation. See the Artisan blog for more details:

  • RichHelms says:

    The fuji needs to be purchased with the optional RS485. Then you need a MAC compatible RS232 to usb converter.

    ZB

  • GeorgeC says:

    I just connected my PXR3 and the reading is 1/10th of the actual temperature. Is there a way of multiplying the readout by 10?

  • GeorgeC says:

    Oh, I just got the answer, change the pid from 0 to 1 decimal and that should solve the problem

  • andytanguay says:

    Any other Arduino solutions possible? Seems like the TC4 is not shipping any time soon, sadly.

    Hooking up thermocouples doesn’t seem too bad…
    http://learn.adafruit.com/thermocouple/overview

  • Jason says:

    Hi,

    I’m using your software with a HH-806AU. It reads the meter fine, but when I turn the roaster on the meaurements stop in your software (meter keeps working). If I allow the drum to warm and then turn the roaster off, sure enough your software starts working again and tracks the temp decline perfectly! Seen this one before?

    Jason

  • Nixda says:

    Hi there,

    I am trying to use an Amprobe TMD-56 with my DIY corretto roaster, using Artisan to monitor my roasts. I am having problems getting the TMD-56 to communicate properly with Artisan.

    The funny thing is that everything works just fine with my Mac Pro, but not with a MacBook Air, a Mac Mini, or a MacBook Pro.

    Here is the pertinent info:

    – Artisan 0.7.3 or 0.7.4

    – Latest version of FTDIUSBSerialDriver installed

    – Attach TMD-56 to USB port (channel is set to 0)

    – Start Artisan; go to Config > Device; select ‘Amprobe TMD-56’ under ‘Meter’; Select Comm Port ‘FT232R USB UART’; other parameters 19200, 8, E, 1, 1

    – Hit the ‘On’ button

    MacPro, MacBook Pro, MacMini: Mac OSX 10.8
    MacBook Air: Mac OSX 10.9

    The MacPro reads the temperatures just fine, all other machines show ‘-1’ for both ET and BT.

    I am at a loss here, so any help would be greatly appreciated.

    Thank you so much in advance!

    Cheers,
    MM

    • nixda says:

      I discovered that everything works as it should when using Artisan 0.6.0, but 0.7.3/4 are flaky. It worked occasionally but is finicky, e.g., after switching temperature probes, 0.7.3 lost the connection again, whereas 0.6.0 worked just fine.

  • Nimrod Gisis says:

    Hi Guys,
    I have the CENTER304 with 3 thermocouples connected.
    I have windows 7 32bit.
    I have installed and configured the CP210x_VCP_Windows USB Driver driver for the USB300 provided by CENTER technologies.
    and in the COM \ PORS device manager it states that the driver is installed correctly.
    Using a CENTER app. I can see the probes reporting correctly to the app.
    I have installed the latest artisan applciation (7.4 i prosume) and configured the CENTER304 with defaults.
    But in Artisan the BT and ET are constantly on -1.0 value.

    what should be the reson for that?
    Also adding the additional 3rd prob to the Extra device (using CENTER304 defaults) causign an exception sayign the Serial prot couldnt be opened.

    What can be the reasons for these issues?

    • Chris Gwynne says:

      Did you ever get this answered? I too have a 304 and have an app showing me that data is getting into my laptop fine, but I can’t get Artisan to see any data, -1.0 values as well

    • stefan says:

      i have the exact same problem using a voltcraft k204 with 4 probes. the only difference is that it is plugged into the computer using a serial to usb adaptor

  • Erhard DINGES says:

    -1,0 values suddenly came up after ARTISAN worked well for more than a year.
    I did no changes to the system, and I do not know how this problem could be solved.
    I use WIN-XP and Voltcraft 204 + Si-LAB software (Com to USB)

    As I can see I am not alone with this problem.

    Any solutions?
    Any settings to change (in Artisan or in the registry of the USB-to UART driver?)

    thank you for help to come!