SensMon

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m
 
(2 intermediate revisions by one user not shown)
Line 31: Line 31:
 
[[Image:Sensmonv0.2.png|center|thumb|400px]]
 
[[Image:Sensmonv0.2.png|center|thumb|400px]]
  
==Network Usage==
+
==Usage==
 +
===Network Usage===
  
 
To stream the sensor data from your handheld to the desktop version of SensMon do the following:
 
To stream the sensor data from your handheld to the desktop version of SensMon do the following:
  
* enable logging in the handheld's config file under ~/SensMon (set 'logging=true')
+
* enable logging in the handheld's config file under ~/SensMon (set 'logging_enabled=true')
 
* set the freerunners ip in your desktop pc config
 
* set the freerunners ip in your desktop pc config
 
* First launch "sensmon | nc -l -p 5353" on the handheld
 
* First launch "sensmon | nc -l -p 5353" on the handheld
Line 43: Line 44:
 
* Enjoy
 
* Enjoy
  
==Textfile Usage==
+
===Textfile Usage===
  
 
With SensMon you can persist the sensor data to a text file and replay it whenever you wish. In order to do that you will have to:
 
With SensMon you can persist the sensor data to a text file and replay it whenever you wish. In order to do that you will have to:
  
 
* enable logging in the handheld's config file under ~/SensMon
 
* enable logging in the handheld's config file under ~/SensMon
* Launch "sensmon > test.txt" (or whatever filename you have configured)
+
* Launch "sensmon > test.txt" (or whatever filename you have configured in the config file)
 
* Select your sensors and start sensmon on the handheld.
 
* Select your sensors and start sensmon on the handheld.
 
* Stop sensmon
 
* Stop sensmon
 
* Start sensmon
 
* Start sensmon
 
* Select the "TXT" box of the sensors you have captured on the txt file.
 
* Select the "TXT" box of the sensors you have captured on the txt file.
 +
 +
===Config File Example===
 +
A config file named "config" should be copied into the folder ~/.SensMon/
 +
An example for it is listed in the following
 +
 +
<pre>
 +
[InputSource]
 +
logging_enabled=true
 +
 +
[Network]
 +
client_host=192.168.0.10
 +
client_port=5353
 +
 +
[File]
 +
filename=test.txt
 +
</pre>
  
  
 
==Sources==
 
==Sources==
  
SensMon is currently at version 0.2. The source can be acquired at [http://gitorious.org/sensor-monitor http://gitorious.org/sensor-monitor]
+
SensMon is currently at version 0.21. SensMon 0.21 and its dependency libsensmon can both be acquired at [http://gitorious.org/sensor-monitor http://gitorious.org/sensor-monitor] or in the SHR-unstable feeds.
  
 
===Tested Distributions===
 
===Tested Distributions===

Latest revision as of 22:44, 9 March 2011

Contents

[edit] Description

SensMon is a Vala-based monitor for sensors that can be used to visualize the sensor values on the handheld (but not only). The software is very experimental and does not include any kind of exception handling. You are using it at your own risk :) Its main purpose is to test the sensors included in the Freerunner Navigation Board and Freerunner Navigation Board v2.


[edit] Supported Sensors

The monitor has been developed in order to easily add arbitrary sensors as sources. The monitor uses GTK and Cairo for drawing.

Included sensors comprise:

  • ADS1115 Analog Digital converter
  • HMC5843 digital 3D compass
  • ITG3200 digital 3D gyroscope
  • LIS302DL accelerometers via spi (GTA02) and i2c interface (N900)
  • BMP085 pressure sensor
  • Senserion SHT21 humidity sensor
  • Logged input from text file
  • Streaming sensor data over TCP from the freerunner to e.g. your desktop or another freerunner

IMPORTANT: You need to load the corresponding kernel modules to read from the sensors except for the network and file input source. The corresponding modules can be either found in the kernel tree or under http://gitorious.org/freerunner-navigation-board.

NOTE: The Ads1115 is controlled via i2c-dev kernel module.

[edit] Screenshots

This is a screenshot of the application monitoring the X and Y gyro-axis as well as the X-axis of the digital compass included in the navigation board:

Sensmon-screen.png

Here is a screenshot of the user-interface for monitoring sensors over network socket (socat or nc), text file or hardware:

Sensmonv0.2.png

[edit] Usage

[edit] Network Usage

To stream the sensor data from your handheld to the desktop version of SensMon do the following:

  • enable logging in the handheld's config file under ~/SensMon (set 'logging_enabled=true')
  • set the freerunners ip in your desktop pc config
  • First launch "sensmon | nc -l -p 5353" on the handheld
  • Then launch sensmon on the desktop
  • Then select "Net" checkboxes for the desired sensor on the window of the monitor on your desktop and press the "Start" button
  • Select arbitraty sensors to monitor from the list on your freerunner and press the "Start" button
  • Enjoy

[edit] Textfile Usage

With SensMon you can persist the sensor data to a text file and replay it whenever you wish. In order to do that you will have to:

  • enable logging in the handheld's config file under ~/SensMon
  • Launch "sensmon > test.txt" (or whatever filename you have configured in the config file)
  • Select your sensors and start sensmon on the handheld.
  • Stop sensmon
  • Start sensmon
  • Select the "TXT" box of the sensors you have captured on the txt file.

[edit] Config File Example

A config file named "config" should be copied into the folder ~/.SensMon/ An example for it is listed in the following

[InputSource]
logging_enabled=true

[Network]
client_host=192.168.0.10
client_port=5353

[File]
filename=test.txt


[edit] Sources

SensMon is currently at version 0.21. SensMon 0.21 and its dependency libsensmon can both be acquired at http://gitorious.org/sensor-monitor or in the SHR-unstable feeds.

[edit] Tested Distributions

The sensor monitor has been tested on SHR unstable and Debian sid only.

Personal tools

Description

SensMon is a Vala-based monitor for sensors that can be used to visualize the sensor values on the handheld (but not only). The software is very experimental and does not include any kind of exception handling. You are using it at your own risk :) Its main purpose is to test the sensors included in the Freerunner Navigation Board and Freerunner Navigation Board v2.


Supported Sensors

The monitor has been developed in order to easily add arbitrary sensors as sources. The monitor uses GTK and Cairo for drawing.

Included sensors comprise:

  • ADS1115 Analog Digital converter
  • HMC5843 digital 3D compass
  • ITG3200 digital 3D gyroscope
  • LIS302DL accelerometers via spi (GTA02) and i2c interface (N900)
  • BMP085 pressure sensor
  • Senserion SHT21 humidity sensor
  • Logged input from text file
  • Streaming sensor data over TCP from the freerunner to e.g. your desktop or another freerunner

IMPORTANT: You need to load the corresponding kernel modules to read from the sensors except for the network and file input source. The corresponding modules can be either found in the kernel tree or under http://gitorious.org/freerunner-navigation-board.

NOTE: The Ads1115 is controlled via i2c-dev kernel module.

Screenshots

This is a screenshot of the application monitoring the X and Y gyro-axis as well as the X-axis of the digital compass included in the navigation board:

Sensmon-screen.png

Here is a screenshot of the user-interface for monitoring sensors over network socket (socat or nc), text file or hardware:

Sensmonv0.2.png

Network Usage

To stream the sensor data from your handheld to the desktop version of SensMon do the following:

  • enable logging in the handheld's config file under ~/SensMon (set 'logging=true')
  • set the freerunners ip in your desktop pc config
  • First launch "sensmon | nc -l -p 5353" on the handheld
  • Then launch sensmon on the desktop
  • Then select "Net" checkboxes for the desired sensor on the window of the monitor on your desktop and press the "Start" button
  • Select arbitraty sensors to monitor from the list on your freerunner and press the "Start" button
  • Enjoy

Textfile Usage

With SensMon you can persist the sensor data to a text file and replay it whenever you wish. In order to do that you will have to:

  • enable logging in the handheld's config file under ~/SensMon
  • Launch "sensmon > test.txt" (or whatever filename you have configured)
  • Select your sensors and start sensmon on the handheld.
  • Stop sensmon
  • Start sensmon
  • Select the "TXT" box of the sensors you have captured on the txt file.


Sources

SensMon is currently at version 0.2. The source can be acquired at http://gitorious.org/sensor-monitor

Tested Distributions

The sensor monitor has been tested on SHR unstable and Debian sid only.