mirror of
https://github.com/servalproject/serval-dna.git
synced 2024-12-20 05:37:57 +00:00
628fba6208
Add VoMP to list of new technologies Add links to new Wiki Technology Roadmap pages for key technologies Simplify contributor agreement PDF download links Add link to SPI page on Wiki
127 lines
4.4 KiB
Markdown
127 lines
4.4 KiB
Markdown
Serval DNA Build and Test
|
|
=========================
|
|
|
|
To build
|
|
--------
|
|
|
|
In the `serval-dna` directory, run the following commands:
|
|
|
|
autoreconf -f -i
|
|
./configure
|
|
make
|
|
|
|
On Solaris, the system `make` command may not be GNU Make, and the system
|
|
`cc` command may not be GNU Gcc. The following may work:
|
|
|
|
autoreconf -f -i
|
|
CC=gcc ./configure
|
|
CC=gcc gmake
|
|
|
|
Supported Targets
|
|
-----------------
|
|
|
|
The Serval DNA code successfully builds for the following platforms:
|
|
|
|
* Debian Linux, ix86 and x86\_64, kernels 2.6.x and 3.x, [gcc 4.4][] to [gcc 4.7][]
|
|
* [Android 2.2 “Froyo”][], Arm, Linux kernels 2.6.x and 3.x, [gcc 4.4][] supplied as
|
|
part of [Android NDK][] Revision 7b
|
|
* Mac OS X 10.7 “Lion”, x86\_64, [gcc 4.2][] available in [Xcode 4][] 3.2.6
|
|
* Oracle SunOs 5.10 (Solaris), Sparc, [gcc 4.4][]
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
The dependencies for build are expressed in [configure.in](./configure.in).
|
|
Most mandatory dependencies are present by default in a conventional Linux
|
|
development environment.
|
|
|
|
Mandatory dependencies:
|
|
|
|
* standard C library `libc` and standard headers
|
|
* standard math library `libm` and headers `<math.h>` `<float.h>`
|
|
* network services library `libnsl` and headers
|
|
* socket library `libsocket` and headers
|
|
* dynamic link library `libdl` and header `<dlfcn.h>`
|
|
* Native Posix Threads Library `libpthread` and header `<pthread.h>`
|
|
* on Solaris, the realtime library `librt` (for the `nanosleep()` function)
|
|
|
|
Optional:
|
|
|
|
* Java compiler and SDK (mandatory for Android's **libservald.so**)
|
|
* ALSA sound library and headers (only present on Linux not Android)
|
|
|
|
Built artifacts
|
|
---------------
|
|
|
|
The build process produces the following artifacts:
|
|
|
|
* **servald** is the main executable.
|
|
|
|
* **libservald.so** is a shared library built only for Android, which is linked
|
|
into the [batphone][] Java executable at run time to provide the [JNI][]
|
|
entry points to servald.
|
|
|
|
* **directory_service** is the executable for the Serval Infrastructure daemon.
|
|
|
|
* **libmonitorclient.a** and **libmonitorclient.so** are libraries implementing
|
|
the client end of the monitor interface with the servald daemon. They are
|
|
linked into the [batphone][] Java executable at run time and contain [JNI][]
|
|
entry points to functions for managing the client end of a monitor connection
|
|
with the servald daemon.
|
|
|
|
Voice call test
|
|
---------------
|
|
|
|
If the following packages are present then `./configure` will set the
|
|
`HAVE_VOIPTEST` macro and build **servald** with its `phone` command available
|
|
for performing voice call testing:
|
|
|
|
* [Port audio](http://www.portaudio.com)
|
|
* [Secret Rabbit Code](http://www.mega-nerd.com/SRC/) (a.k.a. Sample Rate
|
|
Convert) by Erik de Castro Lopo
|
|
* [SpanDSP](http://www.soft-switch.org/) by Steve Underwood
|
|
* [Codec2](http://www.rowetel.com/blog/?page_id=452) by Dave Rowe of Rowetel
|
|
|
|
The Codec2 source code can be fetched using [Subversion][]:
|
|
|
|
svn checkout https://freetel.svn.sourceforge.net/svnroot/freetel/codec2 codec2
|
|
|
|
The following options can be used to control the `HAVE_VOIPTEST` macro:
|
|
|
|
* `./configure --enable-voiptest` will set `HAVE_VOIPTEST` and fail if the
|
|
necessary packages are not present
|
|
|
|
* `./configure --disable-voiptest` will unset `HAVE_VOIPTEST` and will not
|
|
check for presence of the above packages
|
|
|
|
Test scripts
|
|
------------
|
|
|
|
The scripts in the [tests](./tests/) directory require [Bash][] version 3.2.48
|
|
or later. To run all the tests (except long-running, resource-hungry stress
|
|
tests), build the `servald` executable natively using [GNU make][], then invoke
|
|
them manually:
|
|
|
|
./tests/all
|
|
|
|
There are options to run tests concurrently for faster results, and to select
|
|
subsets of test cases. To see the options, give the `--help` option:
|
|
|
|
./tests/all --help
|
|
|
|
The logs of the most recent test run are in the [testlog/all](./testlog/all/)
|
|
directory.
|
|
|
|
|
|
[batphone]: https://github.com/servalproject/batphone
|
|
[Android 2.2 “Froyo”]: http://developer.android.com/about/versions/android-2.2-highlights.html
|
|
[Android NDK]: http://developer.android.com/tools/sdk/ndk/index.html
|
|
[gcc 4.2]: http://gcc.gnu.org/gcc-4.2/
|
|
[Xcode 4]: https://developer.apple.com/xcode/
|
|
[gcc 4.4]: http://gcc.gnu.org/gcc-4.4/
|
|
[gcc 4.7]: http://gcc.gnu.org/gcc-4.7/
|
|
[JNI]: http://en.wikipedia.org/wiki/Java_Native_Interface
|
|
[Bash]: http://en.wikipedia.org/wiki/Bash_(Unix_shell)
|
|
[GNU make]: http://www.gnu.org/software/make/
|
|
[Subversion]: http://subversion.apache.org/
|