Artisan Documentation

Visual scope for coffee roasters


We are now working on a v0.6.x version that will renew several internal libraries and add some new features like generic support for Modbus devices.

Version 0.5.6 – 14-11-2012

  • Fixes the communication with the Voltcraft K201 and Center 302 devices as well as some other minor bugs.

Version 0.5.5 – 30-09-2011

  • fixes ArdruinoTC4 extra devices
  • fixed autoDrop recognition
  • fixes serial settings for extra devices

Version 0.5.4 – 30-08-2011

  • adds events by value
  • adds custom event button palettes
  • adds virtual device from plot
  • adds K204 CSV import
  • improves Designer
  • improves Statistics
  • improves Help dialogs
  • improves relative times
  • bug fixes

These are some of changes and their explanations in artisan version 0.5.4

– adds events by value

Events by value draw faster than events by type. There is no penalty of performance when drawing more than 20 events by value or any other higher number. At the end of a roast, you could always convert/visualize to events type. It is just a mode. They are made in the same principle ans events by type but instead of using only 4 bars (four event types), events by value use 11 bars. Lowest bar is for no value. Then second lowest bar is for value 0, thrid lowest bar is for value 1, etc, up to value 10.
Events by value are configured in the menu Config/Events…

– adds custom event button palettes

A palette is a memory footprint of a button configuration. There are now 10 memory allocations to store button configurations (there are 10 palettes). Palettes allow categorization and unlimited expansion of of event buttons. Each palette can be accessed by using the keyboard shortcut numbers 0-9.

Let me give you an easy example. These steps show how to program 3 palettes of 3 different colors:

Go to Config/Events/Buttons:

Press button [B Defaults]. This button generates automatically 4 rows (from 4 event types) of buttons with a range of values from 0 to 10. Now you have created new buttons but they have to be saved in a palette if you want to have more than one configuration.

Then go to palette tab (third tab) and save buttons as palette #0 (you have made one palette #0)

Go back to tab Buttons (second tab). Enter number 190 in color pattern. Then go to palette tab and save buttons as palette #1 (you have made palette #1).

Go back to tab Buttons. Enter number 300 in color pattern. Then go to palette tab and save buttons as palette #2 (you have made palette #2).

In this example, you have saved/programed 3 palettes. Instead of just changing colors, you could have programmed the buttons for any other purpose or configuration.

Now close the Event Configuration Dialog.

Press keyboard [0],[1],[2] and see how the buttons change. (ie. pallete #0 is restored with the keyboard shortcut [0], etc)

There is also an option to save-restore the palettes to a text file in the third tab. For example, It could take some time to do all the work of programming the buttons, and then lose the work for some reason. For example if you ever had to do a Factory Reset (in the Help menu), then all the settings and all the palettes would be lost. With a text file, your time of hard work programming the buttons could be saved.

– adds virtual device from plot

There is a new button to add a virtual device from the Tools/Extras math plotter

– adds K204 CSV import

new import method

– improves Designer

Now it is easier to use Designer to create profiles from pen and paper. For example, you can record the main points of a roast with a pen, then transfer the data using Designer to create a profile.

– improves Statistics

One more option was added to hide/show the evaluations and other minor improvements.

– improves Help dialogs

New help dialogs were added to help in the development of artisan and to find bugs easier.

– improves relative times

In the Roast properties (and other places), you can edit the CHARGE time with more flexibility. This time is important because the other mark times are relative to it.

– adds axes Reset time.

Now you can tell artisan what max time you want to reset to after pressing Reset. Config/Axes menu.

– modify events per click

If you right click on a BT curve you can modify the time of events like CHARGE or DRY via a popup menu.

– many bug fixes

The artisan Team.

Version 0.5.3 – 30.07.2011

  • performance improvements, device external-program, serial log, bug fixes

Version 0.5.2 – 23.07.2011

  • added Delta DTA PID support
  • added automatic CHARGE/DROP event detection
  • added separate RoR axis
  • added cross lines locator
  • smaller Mac OS builds with faster startup
  • optimized legend and statistics layout
  • improved Wheel Graph editor (interactive)
  • performance improvements
  • bug fixes

Version 0.5.1 18.06.2011

  • Bug fixes

Version 0.5.0 – 09.06.2011

Although some of the new features of release 0.5.0 have already been introduced in the beta versions, here is quick summary of what you can expect with this release:

  • Unlimited number of devices/curves running at the same time
  • Virtual devices
  • Profile designer
  • Wheel graph editor
  • Mathematical plotter
  • Localizations (translations for German, French, Spanish, Swedish, Italian)
  • Enhanced multi-core CPU performance
  • Template/background reproduction playback aid
  • Alarms with programmable outputs
  • Custom event buttons
  • Fully configurable cupping graphs
  • Enhanced delta plotting
  • Mac OS X 10.4 support
  • Omega HHM28 support
  • Enhanced Arduino TC4 support

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.0b1 – 28.5.2011

  • support for Mac OS X 10.4 and PPC added
  • added more translations
  • added wheel graph editor
  • added custom event-control buttons
  • added Omega HHM28 multimeter device support
  • added support for devices with 4 thermocouples
  • added PID duty cycle
  • added math plotter in Extras
  • added run-time multiple device compatibility and symbolic expressions support
  • improved configuration of Axes
  • improved configuration of PID
  • improved Arduino code/configuration
  • improved cupping graphs
  • improved performance/responsiveness in multi-core CPUs
  • bug fixes

Version 0.4.0 – 10.03.2011

  • improved CSV import/export
  • K202 CSV support added
  • adds localization support
  • adds German, French, Spanish, Swedish, Italian menu translations
  • fixed cut-copy-paste on Mac and added cut-copy-paste menu
  • LCD color configuration
  • replay of events via background dialog
  • relative times are used everywhere
  • adds profile designer
  • adds alarms
  • more robust Arduino/TC4 communication
  • bug fixes

Using on old computers
There is special version of artisan to prevent crashes when using old CPU processors.

This special version should run without crashes in old processors (like the celeron). If your CPU is newer then use the regular artisan version (better). But if you are stuck with and old laptop that crashes when running artisan, then you can use this other option. This special version introduces some mathematical errors. For example the 00:00 axes would read -01:52 but it works OK.

  • 0.3.4 – 28.02.2011 – Arduino TC4, TE VA18B, improved main window layout, events, roasting properties dialog, delta filter, bug fixes
  • 0.3.3 – 13.02.2011 – Fuji PXR5/PXG5, manual logging, improved serial communication, keyboard shortcuts, Linux binary, bug fixes
  • 0.3.2 – 31.01.2011 – Fixed Center 309, added smaller corrections and improvements
  • 0.3.1 – 12.01.2011 – Fixed bug introduced in v0.3.0 that prevented to loading of the users application preferences
  • 0.3.0 – 11.01.2011 – New profile file format, Mac OS 10.5 support and bug fixes
  • 0.2.1 – 02.01.2011 – Bug fixes
  • 0.2.0 – 31.12.2010 – Added support for CENTER 300, 301, 302, 303, 304, 305, 306, VOLTCRAFT K202, K204 300K, 302KJ, EXTECH 421509
  • 0.1.0 – 20.12.2010 – Initial release

4 Responses to “Versions”

  • DINGES Erhard says:

    Best wishes to your team!
    Credits will come, when ARTISAN is running on my WinXp Laptop.
    K202 does well on the original software

    Running ARTISAN i get the failure: o bytes received, 10 needed.

    Do not know, what is going wrong, but seems to be an old problem.
    Are there no FAQS?

    thank you!


    • RichHelms says:

      “ARTISAN i get the failure: o bytes received, 10 needed.”

      This means Artisan sent the command to the data logger but didn’t get a reply.

      Most common issue is not configured correctly. Check the comm port. That is probably the problem. In the installation section there is discussion on this.

  • sw chung says:

    Thank you for realesed this great program.
    I have one error and unable to operate program

    ‘Exception Error: sample() ‘ascii’ codec can’t decode byte 0xc1 in position 10: ordinal not in range(128)’

    could you tell me how to fix this matter?
    Thank you~

    • Marko Luther says:

      Which version are you using? Which OS (Windows,Mac,Linux,..)? What meter are you using? What did you do the moment before that error happened?

      With more information it is more likely that we can help you out,