SIMPL-Arduino Installation Instructions

We are still testing the simpler installation procedure detailed below. It is very difficult to cover off all possible combinations of Linux systems and configurations so we need your help. If you discover a problem with this installer script or want to make suggestions for improvement do not hesitate to contact us on the SIMPL mailing list or at icanprogram[ATNOSPAM]295[DOT]ca.

Prerequisites

On your Linux distribution you'll want to verify that you have the following additional packages:

a complete installation of Arduino development kit

The self installing archive simplifies the installation of SIMPL and the SIMPL-Arduino extension into a single install script. This installation will be done in /tmp and will allow you to run the SIMPL unit test as a temporary demo. If you are satisfied and wish to make this SIMPL installation permanent you will be offered that option.

Unfortunately, it is difficult to automate the final steps in the SIMPL-Arduino installation in a seamless manner, so this is left to be done manually (see readme.arduino).

The steps are as follows:

download the self installing archive and place the file (arduinosimpl.sh) in /tmp.
Verify that the cksum on arduinosimpl.sh is:
912837239 501244 arduinosimpl.sh
from the /tmp directory type
chmod u+x arduinosimpl.sh
./arduinosimpl.sh

NOTE: If you wish to examine this install script before running it you can simply edit arduinosimpl.sh. The installer script is contained in the first part up until the line:

__TARBALL_FOLLOWS__

Operating the testing framework

If all your code installed and built correctly using the procedure above you should be able to see a list of tests associated with SIMPL tools.

From that list of tests you can select the first SIMPL unit test by typing:

s0001

at the installer script prompt.

If you are successful the test should run.

Configuring the SIMPL-Arduino library

The SIMPL-Arduino stuff will be installed in the SIMPL code tree. This code tree lives at $SIMPL_HOME (eg. /home/simpl) which you get to choose in the above script.

Inside $SIMPL_HOME/docs there is a readme.arduino file which describes how to configure the SIMPL-Arduino library.

Inside this package there are two examples.

eightLeds
numTimesTwo

Have fun. Hope you enjoy SIMPL-Arduino programming.

The 2nd Edition of the SIMPL book is a great resource for your SIMPL project.