Installing GUIslice on Arduino

Return to: GUIslice Overview

Installation: Arduino IDE

The following options are available for users who wish to use the Arduino IDE for development.

Note about Arduino IDE Versions

Please note that there is a bug in the compiler shipping with latest Arduino IDE versions (1.8.6, 1.8.7) that can impact build stability (resulting in a lto1.exe error). It is recommended that users select Arduino AVR Boards version 1.6.21 in the Board Manager:

• In Arduino IDE, select Tools -> Board: ... -> Boards Manager
• Find Arduino AVR Boards in the list
• If the version is listed as 1.6.22 or 1.6.23, then click on Select version, change it to 1.6.21 and then click on Install
• 

Installing from Arduino IDE

Installing a major release version of GUIslice can be done from the Arduino IDE:

• Click on Sketch -> Include Library... -> Manage Libraries...
• In the search bar, type: GUIslice
• Select the latest version from the dropbox and click Install

Installing from GitHub source

If you would like the most recent version of GUIslice under development, you can install the library directly from the GitHub repository:

• Download the GUIslice library
  • From the GUIslice page, click Clone or Download and then Download ZIP.
  • 
  • Extract the ZIP file on your computer. This will probably create a GUIslice-master folder on your computer (let's call this the GUIslice unzipped folder).
• Move this unzipped folder into your Arduino libraries folder
  • To find your Arduino IDE libraries folder, go to File -> Preferences and note the path to your Sketchbook folder
  • Navigate to this folder and look for the libraries subfolder. This is your Arduino Library folder.
  • Ensure that any old copies of GUIslice within the Arduino Library folder (either GUIslice or GUIslice-master are removed first. Note that if you have previously modified the GUIslice config file, you may want to save a copy of it or move it elsewhere first.
  • Drag the unzipped GUIslice folder into the Arduino libraries folder
• Install selected graphics and hardware libraries
  • The GUIslice Configuration Guide provides some guidance on determining which additional libraries may need to be installed via the Arduino IDE.
  • Use the Arduino IDE's Include Library -> Manage Libraries option to add the libraries according to the GUIslice_config_ard.h settings. eg. Adafruit-GFX and Adafruit-ILI9341.

Installation: PlatformIO

The following method is available for users who wish to use PlatformIO for development. This is only an initial capture of the steps -- it will be revised soon.

• Install PlatformIO. Often this can be done within an IDE environment such as Atom.
• Install libraries via File -> Settings then click on Libraries
  • Search for the applicable library names in the search bar and click Install for each:
  • Adafruit GFX Library, Adafruit ILI9341, Adafruit STMPE610 (or as needed by your setup)
  • GUIslice
• The above should download the libraries to your PlatformIO library folder, eg: C:\Users\username\.platformio\lib\
• From the Home page, click on Import Arduino Project, navigate to the downloaded library folder and click on Import. This will create a copy of the project in your user projects directory, eg: C:\Users\username\Documents\PlatformIO\Projects\
• Open the imported project, modify any configuration files necessary
• Select PlatformIO -> Build then PlatformIO -> Run