Zaurus Monitoring Software Last update: 2005/08/01 -------------------------------------------------------- Sebastien VINCENT Julien MONTAVONT -------------------------------------------------------- This program displays information coming from a PAN, directly by accessing the IPv6 SNMP sensors, or by requesting the data from a database. Presently supported sensors are: -- Temperature and humididty -- Direction -- Acceleration -- GPS The application can run in two modes: - ModeSNMP (default): application runs like a SNMPClient: it gets the data directly with SNMP request to the sensors (requires IPv6 connectivity). You need a modified kernel on your Zaurus that support IPv6. - ClientDB: application gets the data from a database. The application can retrieve maps dynamically from: www.expedia.com www.expedia.co.uk www.expedia.de image.map.yahoo.co.jp - To run the application, launch sensors from application tab (or type "sensors_ipv6" in a console) By default the application runs in SNMPMode. command line: -m, --mode=[MODE] SNMP or DB mode -s, --session=[ID] display information about the session ID -v, --version Output version information -h, --help print help REQUIREMENTS: -- Programs: wget -- Libraries: libnetsnmp, libqwt, libpq (included in tar files) INSTALLATION on Zaurus: - From Binaries: ---------------- -- Retrieve the current snapshot of binaries -- Copy the sensors.tgz file to your Zaurus -- Untar the sensors.tgz file (tar xzvf sensors.tgz) -- Go to sensors directory -- Become root and launch the install script (./install.sh) -- Log out root -- Restart QTopia : menu => settings => shutdown => restart Qtopia -- Go to Application tab and launch sensors (or run sensors_ipv6 from a terminal) - From Sources: --------------- -- To compile from sources, you need an ARM cross-compilation environment (take one from http://www.nautilus6.org/operation/download/cross_install-2.95.tar.bz2) -- Retrieve the sensors_ipv6-x.y-src.tar.bz2 and untar it (tar xjvf sensors_ipv6-x.y.tar.bz2) -- Install cross-compiled libraries: cd script && ./install_libs_cross.sh -- Run ./make_zaurus to make an ARM binary -- Run ./make_ipkg to have an IPKG file INSTALLATION on Linux: -- Retrieve the current snapshot of sources -- Untar the sensors_ipv6-x.y-src.tar.bz2 file (tar xzvf sensors_ipv6-x.y-src.tar.bz2) -- You need to install the following package: * libqt3-mt-dev version 3.3.3-8 (Qt development files) * libqwt-dev version 4.2.0 (Qt widgets library for technical applications (development)) * libsnmp5-dev version 5.1.2-6 (NET Simple Network Management Protocol Development Files) * libpq3 and postgresql-dev version 3.1 (PosgreSQL development Files) -- Run make -- Launch sensors_ipv6 See DOCS to configure the settings SENSORS IMPORTANT: if there is a timeout for a sensor when you start the application, the sensor will not be available until you reload settings (in "Settings" tab) or restart the application. MAPS For Europe and USA use one of the expedia adresses (do not use "image.map.yahoo.co.jp", it will give you blank map if the coordinates are not in Japan !) For Japan, prefer use "image.yahoo.co.jp", or use a Scale of 1 / 197500 or above in order to have a correct positionning and moving. The other parts of the world are not fully covered by expedia so use a scale of 1 / 197500 or above. CONFIGURATION file -- config.xml: * In sensor section: The "Type" of a sensor can be one of the following: - TEMPERATURE_HUMIDITY - DIRECTION - ACCELERATION - GPS For TEMPERATURE_HUMIDITY sensor, always temperature oid first For ACCELERATION sensor, always X oid first For GPS sensor, always latitude oid first * In DataBase section Nothing to say here! * In MapServer section It is the server to request for the maps See DOCS. MAKEFILE Makefiles for Zaurus and for x86 architecture are already done, but if you want to add files to project, you will have to modify these files. In QT project, you have qmake/tmake which build automaticly the makefile with the ".pro" file by parsing recursively the directories. configure_zaurus.sh is used to create Makefile for the Zaurus with sensors_ipv6.pro file. go to the root directory of the application qmake -project -o sensors_ipv6.pro => create the .pro file. qmake -o sensors_ipv6.pro => create the makefile for x86. ./configure_zaurus.sh sensors_ipv6.pro => create the makefile Makefile.arm for Zaurus. however you have to modify the Makefile after. -- For Zaurus: Add in the INCPATH section : -I$(QTEDIR)/include -I$(QPEDIR)/include -I/usr/include/postgresql Add in the LIBS section : -L$(QTEDIR)/lib -L$(QPEDIR)/lib -lqpe -lpq -lnetsnmp -lqwt -- For x86 : Add in the INCPATH section : -I/usr/include/postgresql -I/usr/include/postgresql/8.0 Add in the LIBS section : -lpq -lqwt `net-snmp-config --libs` For demonstrations and complete technical documentation, please refer to http://demo.nautilus6.org/ Zaurus Monitoring Software is licensed under the GPL license, see the COPYING file joined in the archive.