OPENAMBIT ========= The openambit source repository consists of several parts. Each part is briefly described below. Most people would like to use both the device communication library (libambit) and the GUI (openambit). The build / install scripts described below make your life easier if you are like most people. You can choose to run the GUI from the build folder or install it to your system. Some developer oriented extras are available as well. A small example application, a protocol dissector for use with wireshark, a script to compare against Moveslink2 log files and another one to turn the openambit log files into GPX format. BUILD SCRIPT ============ Builds libambit and openambit in one command > cd YOUR/git/REPO/location > ./build.sh BUILD AND INSTALL SCRIPT ======================== Builds and install libambit and openambit in one command. Note that the script will try to run sudo to install things. > cd YOUR/git/REPO/location > ./install.sh DEPENDENCIES ============ To be able to build libambit and openambit the following libraries (and their header files) need to be available: - libudev - libusb - libqjson For debian-based systems: > sudo apt-get install libudev-dev libusb-1.0-0-dev libqjson-dev src/libambit ============ The "driver" library as a shared object. Written in C. Build instructions: > mkdir libambit-build > cd libambit-build > cmake ../src/libambit > make Optionally: > sudo make install src/openambit ============= The GUI application. Uses the libambit library. Build instructions: First build libambit as instructed above > mkdir openambit-build > cd openambit-build > cmake ../src/openambit > make Optionally: > sudo make install Run the application without installing: > cd openambit-build > LD_LIBRARY_PATH=../libambit-build ./openambit src/example =========== A small example application that shows basic information, log entries and a single move. Uses the libambit library. Build instructions: > mkdir example-build > cd example-build > cmake ../src/example > make Run the example without installating: > LD_LIBRARY_PATH=../libambit-build ./ambitconsole wireshark_dissector =================== To ease the parsing of the protocol a wireshark dissector is maintained. This dissector parses pcap-files made with usbpcap. The parts of the protocol that is known atm should be present in the latest dissector. Build instructions: > mkdir dissector-build > cd dissector-build > cmake ../wireshark_dissector > make To make wireshark find the plugin: > cp ambit.so ~/.wireshark/plugins tools/movescountXmlDiff.pl ========================== Small Perl-script to compare XML-files generated by openambit and Suuntos Moveslink. Basically a diff with added floating point round errors ignored. tools/openambit2gpx.py ====================== Small Python utility to convert openambit XML log files into GPS eXchange Format (GPX).