1. OVERVIEW

Libgprs is an adaptation library for controlling GPRS data connections
in conjunction with Nokia cellular modems. The library offers a low level
API for controlling the ISA GPDS server.

Csd-gprs is a plugin for the Cellular Services Daemon (CSD). The csd-gprs
plugin provides a DBus interface for controlling packet data services.


2. DOCUMENTATION

Doxygen style documentation is used throughout the code for the API 
documentation. The generated docmentation is included in the libgprs-dev
package and can be found under /usr/share/doc/libgprs/html.

The csd-gprs DBus interface is documented in csd-gprs/DBUS-INTERFACE.


3. COMPILING AND INTALLING THE PACKAGES

Execute the following command from the top directory where the sources are 
stored:

dpkg-buildpackage -rfakeroot

The debian package can be built for the x86 environment, or the phone target
in the scratchbox environment. The following packages will be created:

libgprs0_x.y.z-n_ARCH.deb	Runtime shared library 
libgprs-dev_x.y.z-n_ARCH.deb	Development libary
gprs-utils_x.y.z-n_ARCH.deb	Utilities based on the library

These can be installed as usual with "dpkg -i <package>".

Currently, only a static development library is provied. Hence, the runtime
library package is empty.


4. EXAMPLES

Please look at tools/gprs.c and tools/gprs-dbus for examples how to use the GPRS library and the DBus interface, respectively.
