Documentation
From OpenCITT
Contents |
Disclaimer
It is highly dangerous to use a computer while driving a car. The driver should always have his eyes on the road and his hands on the steering wheel. This software is provided under the terms of the GNU General Public License WITHOUT ABSOLUTLY ANY WARRANTY in the hope it will be helpful. Everyone using this software is responsible for what he makes with it himself as long as it is not violating the terms of the GNU GPL. So respect your local regulations for street/traffic safety. If using this software voilates these regulations you MUST NOT use this software. Furthermore there are regulations that restrict doing modifications to a vehicle. If using a computer running this software violates these regulations at your local place you MUST NOT use this software. If you reject to agree to this disclaimer please leave this site now and forget that you have ever been here!
Once again: Everyone is responsible himself for what he makes with this free piece of software! It is recommended that the software is only used by passengers or while the car is stopped in a safe place (i.e. parking lot, a driving lane on a highway is definitly not a safe place), not by the driver himself while driving.
Installation
This Chapter describes how to build, install and run openCITT from a source tarball as released on the download page. (as of 0.1.0-pre2)
You can find some additional instructions on how to build opencitt from svn down below.
openCITT source
Get an openCITT source code tarball from [1]. Extract tarball to a local directory and change to the extracted source. Follow standard installation procedures
./configure make make install (as root)
You may want to adjust installation location (default install prefix is /usr, default sysconfdir is /usr/etc)
./configure --prefix=/usr/local --sysconf=/etc
0.1.0-pre1 annotation: This Version is known to have a problem when not setting sysconf path on configure commandline. So you need to use at lease something like that to configure successfully, otherwise openCITT won't find the configuration file correctly.
./configure --sysconf=/etc
This behaviour has been fixed in 0.1.0-pre2
If configure or make gives you some errors you may need to install some additional libraries and/or headers like libgl libglu libftgl(for OpenGL) libsdl libsdl-ttf libpqxx libx11 libfreetype(all together with their header packages, of course)
OpenGL Support
The OpenGL based display driver is now the default setting in openCITT.
Dataconnector Framework
openCITT has a nice abstraction layer framework for connecting to datasources. It uses it to get data for gps (position data from a local gpsd) and for bordcomputer data display. To get the framework running you have to install (copy for now) the compiled dataconnector libraries to /usr/share/opencitt/lib, otherwise bord computer and navi modules will complain.
Navi Module
Attention: there have been some changes to navi module lately (to make it work using opengl) that make it behave differently. Navi Module now uses a PostgreSQL database. Its not finished yet but you should be able to see something like a moving map, already.
-make sure you have a PostgreSQL server running on localhost (openCITT will expect it there) -create a new database named osm -use planetosm-to-db from the openCITT sources to create the db schema (planetosm-to-db --schema) and import it into osm database -v0.1.0-pre2 finaly got support for map data import. when in navi view press 'o', select import data, import data. this will try to load a osm file in /tmp/planet.osm and import it's data. You will see a progress output in the lower left corner of navi view. -as long as you don't get valid position data from a running gpsd the dataconnector will give you a default position. If this is not within the range of data downloaded from OpenStreetMap you won't see anything on your map. -run openCITT and see the map in GPS-Navigation module -to get actual data from a gps receiver you need a configured gpsd running on localhost:2947. See gpsd homepage for instructions (there are some great tools to check if gpsd is working correctly, e.g. xgps)
Entertainment Module
The Entertainment Module now uses the PostgreSQL DB 'opencitt' to store and read its settings. To get the media player working you need to do some extra steps. Anyhow mediaplayer is under heavy development at the moment so it may not be working.
Running openCITT
Control openCITT using the keys 'i' and 'p' to navigate through menus forward/backward and key 'o' to select highlighted item. From time to time you may need keys '8' and 'u' to select between multiple areas (like in Add Songs Menu).
That's it so far...
Building from SVN
Checkout latest sourc from SVN
svn checkout https://opencitt.svn.sourceforge.net/svnroot/opencitt/openCITT
Change to openCITT trunk directory and create configure script using autotools
make -f Makefile.cvs
Create build directory
mkdir debug
Change to build dir and run configure
cd debug CXXFLAGS="-O0 -g2" ../configure --prefix=YOURPREFIX --sysconf=YOURSYSCONF --enable-debug=full
Now you should be able to build and install openCITT
make make install (as root)
Follow the instructions above for running openCITT
