This document is very much a work in progress. This instructions are not necessarily correct.

1. Download and install the Arduino environment for your operating system. The following URL links to a page that tells you how to do this.

   http://arduino.cc/en/Guide/HomePage

   For Debian, you can just do an "apt-get install arduino".

2. Install the latest version of the Ethernet library, containing asynchronous sockets (Asocket). a) Download the zip archive "Ethernet.zip" from http://code.google.com/p/kegger/ b) Unzip the downloaded archive file, called "Ethernet.zip", so the directory "Ethernet" overwrites the corresponding directory in the directory where Arduino keeps its libraries.

3. Install the "Streaming" library, which is not distributed as standard with the Arduino software. The streaming library is not used by Agentuino itself, but is used by the demonstration application. a) Download the library archive (a zip file) from http://arduiniana.org/libraries/streaming/ b) Unzip the downloaded zip archive into a directory called "Streaming", within the directory where Arduino keeps its libraries (/usr/share/arduino/libraries on Linux).

4. Install the MemoryFree.h library. a) The source code is in the Arduino Playground: http://www.arduino.cc/playground/Code/AvailableMemory b) Make a directory "MemoryFree" in the directory where Arduino keeps its libraries. c) In this new directory, create a file "MemoryFree.h", containing the code from the section labelled "MemoryFree.h:" on the playground web page. d) Also create a file "MemoryFree.cpp", in the same directory, containing the code from the section labelled "MemoryFree.cpp:" on the playground web page. e) Create a subdirectory called "examples", inside the "MemoryFree" directory. f) Create a subdirectory called "FreeMemory", inside the "examples" directory. g) In this new "FreeMemory" directory, create a file "FreeMemory.pde", containing the code from the section labelled "Example sketch:" on the playground web page.

5. Check out the agentuino svn repository

   svn checkout http://agentuino.googlecode.com/svn/trunk/ Agentuino

6. Install the library, by linking your Agentuino development directory to be a sub directory of the directory where Arduino keeps its libraries (/usr/share/arduino/libraries on Linux).

7. You can now develop, in your home directory, as a regular user. The Arduino environment doesn't seem to like writing sketches to the library example directories, claiming they are read-only, when they are not. Hence you will have to use a different text editor to edit the code. Compile and uploas it from with the arduino environment, as for any other example sketch.

Alternatively, you can checkout the Agentuino directory directly into the libraries directory, but you are then working outside your home directory.

Run the sample Agentuino sketch by selecting the menu entry File>Examples>Agentuino>Agent, from within the arduino environment, and uploading it

8. Install the snmpget tool from net-snmp (in Debian "apt-get install snmp")

9. Customise the IP in the Agentuino example sketch.

10. Upload the Agentuino example sketch.

11. Run an SNMP query, for example: snmpget -v 1 -c public 192.168.1.100 1.3.6.1.2.1.1.4.0 The community string, IP address and OID must match the values in the source code of the Agentuino example sketch.