(Added example config file)
|(One intermediate revision by one user not shown)|
|Line 74:||Line 74:|
SensMon is currently at version 0.
SensMon is currently at version 0.. can be acquired at [http://gitorious.org/sensor-monitor http://gitorious.org/sensor-monitor]
Latest revision as of 23:44, 9 March 2011
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.
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:
Here is a screenshot of the user-interface for monitoring sensors over network socket (socat or nc), text file or hardware:
 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
 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.
 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
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.
 Tested Distributions
The sensor monitor has been tested on SHR unstable and Debian sid only.