View source for Contiki Oscilloscope

[[Contiki_tutorials | Back to Contiki Tutorials]]

__TOC__

== Introduction ==

This exercise is to familiarize the user with the collect view app provided in the Contiki OS source code. It basically involves a sink mote and one or more than one source motes. The source motes send their sensor, network, power and node properties to the sink. A java app presents all this compiled data in a graphical manner.

== You Will Learn ==

* How to upload an introductory code for UDP source and sink.
* Things to see on the collect view gui.

== Relevant Directories ==

* /contiki/examples/collect/ - This has the shell code for collect view and the various targets.
* /contiki/examples/ipv6/rpl-collect/ - This has the codes which are to be uploaded to the source and sink motes for UDP communication.
* /contiki/tools/collect-view/ - This contains the java file for the collect view GUI.
* /contiki/apps/collect-view/ - This contains the codes corresponding to the targets mentioned in the examples folder.

== Connect the Tmote Sky ==

Before continuing with the tutorial, plug 2 Tmote Sky into the computer's USB port, one for the source and the other for the sink.

In order to transfer the ownership of the contiki directories use the following command. 

<code><nowiki> sudo chown :user /dev/ttyUSB0 </nowiki></code>

<code><nowiki> sudo chown :user /dev/ttyUSB1 </nowiki></code>

== Using the Source Code ==

=== Step 1 ===

Go to /examples/ipv6/rpl-collect/ directory.

=== Step 2 ===

Now we need to program one mote as the sink and the other as source. We will use a predefined target called z1 to upload the code in the motes.

For sink:

<code><nowiki> make TARGET=z1 MOTES=/dev/ttyUSB0 udp-sink.upload </nowiki></code>

For source:

<code><nowiki> make TARGET=z1 MOTES=/dev/ttyUSB1 udp-sender.upload </nowiki></code>

=== Step 3 ===

Now we would like to see the transfer and depiction of data on the collect-view GUI. For that to happen, go to /tools/collect-view directory and run "ant" to build the collect viewer.

<code><nowiki> ant run </nowiki></code>

'''Note''' - In order to edit GUI java files go to the /src directory.

=== Step 4 ===

To view the data collected at the sink, go to the generated /tools/collect-view/dist and run - 

<code><nowiki> java -jar collect-view-jar /dev/ttyUSB0 </nowiki></code>

=== Step 5 ===

In the collect window from the Tools menu, select "Run Init script" and in the "Node Control" tab and click on "Start Collect." This will enable the communication between the source and the sender and you will be able to see the received statistics in a graphical manner.

== Using the GUI ==

=== Step 1 ===

Once the motes are connected to the USB ports, go to /tools/collect-view directory and run "ant" to build the collect viewer.

<code><nowiki> ant run </nowiki></code>

=== Step 2 ===

Press the "Program Nodes..." button as seen on the GUI.

=== Step 3 ===

Disconnect all except one node from the USB ports. Press the "Connect to serial" button. The disconnected motes should be connected to independent power sources.

=== Step 3 ===

Now in order to collect various statistics, press "Send Collect" button.

=== Step 4 ===

Set the various "Collect Settings" based on how frequently the data is to be collected and then press "Send command to nodes" button.

=== Step 5 ===

Now go through the other tabs on the GUI to study and analyze the statistics plotted.