Serval Help: Release Notes

Release Notes for Serval Mesh 0.91 “Glossy”

Serval Project, June 2013

These notes accompany the release in June 2013 of version 0.91 (codename “Glossy”) of the Serval Mesh app for Android 2.2 “Froyo” and above.

What's new since 0.90

Reduced importance of root access, and redesigned the way that you connect to other people. While previous versions of the software could operate without root permission, this was not explained very well to new users.

we won't ask for root access unless/until you attempt to test for adhoc support
we won't muck around with your current wifi settings immediately on install
we won't automatically change your wifi mode unless you explicitly choose to allow it.
If we change your hotspot settings, we will try to restore them

Opus audio codec enabled by default. This should result in significant bandwidth savings, without any noticeable impact on call quality.

All new link state routing engine. This routing engine should greatly improve our ability to route packets over complex network topologies. With per-hop retransmission of packets, we should be able to carry a voice call in conditions that would previously have been unusable.

Improved help text within the application.

While it isn't visible from inside the application, we've spent significant effort updating the content and structure of our wiki since our last release.

Known Issues

While rhizome is synchronising content, voice calls are likely to be unusable. However, once all synchronisation is complete everything should recover.

Release Notes for Serval Mesh 0.9 “Shiny”

Serval Project, January 2013

These notes accompany the release in January 2013 of version 0.90 (codename “Shiny”) of the Serval Mesh app for Android 2.2 “Froyo” and above.

This release succeeds version 0.08 that was released in June 2012.

What is Serval Mesh?

Serval Mesh is an app for Android 2.2 “Froyo” and above. It provides free, secure phone-to-phone voice calling, SMS and file sharing over Wi-Fi, without the need for a SIM card or a commercial mobile telephone carrier. In other words, it lets your Android phone call other Android phones running Serval Mesh within Wi-Fi range.

The Serval Mesh Privacy Policy describes how Serval Mesh handles your personal and other sensitive information.

Warnings

Serval Mesh version 0.90 is EXPERIMENTAL SOFTWARE. It has not yet reached version 1.0, and is intended for pre-production, demonstration purposes only. It may not work as advertised, it may lose or alter messages and files that it carries, it may consume a lot of space, speed and battery, and it may crash unexpectedly.

Serval Mesh requests root permission (super-user) on your Android device in order to put Wi-Fi into Ad-Hoc mode. If you grant super-user permission to Serval Mesh, then it will take control of your device’s Wi-Fi and use it to contact other Serval Mesh devices in the vicinity. This will cut off normal Wi-Fi network access.

If your device has no root access or if you deny super-user permission to Serval Mesh, or if no other Ad-Hoc mode devices are nearby, then Serval Mesh will revert to using Wi-Fi in the normal Client mode. This should not interrupt conventional network access, but it could do so. If there is no nearby access point like a home Wi-Fi router or public hot-spot then Serval Mesh will put your device’s Wi-Fi into Access Point mode (turn on personal hotspot). This will give nearby devices access to your mobile data plan, and COULD COST YOU MONEY.

Serval Mesh telephony is a “best effort” service, primarily intended for when conventional telephony is not possible or cost effective, and MUST NOT BE RELIED UPON for emergencies in place of carrier-grade communications systems. The Serval Project cannot be held responsible for any performance or non-performance of the technologies that they provide in good will, and if you use these technologies you must agree to indemnify the Serval Project from any such claims.

The Serval Mesh software copies all files shared using the Rhizome file distribution service to other phones and devices running the Serval Mesh software, regardless of size, content or intended recipient. The Serval Project cannot be held responsible for the legality or propriety of any files received via Rhizome, nor for any loss, damage or offence caused by the transmission or receipt of any content via Rhizome.

See the disclaimers below.

What’s new since 0.08

If you have used version 0.08, the first things you will notice are:

A completely redesigned human interface.
A much smaller APK; faster to download and install.
No need for third-party apps like SMSDroid or WebSMS.

The Main Interface contains a redesigned navigation system:

Call allows you to make calls
Messages allows you to make or view messages
Contacts allows you to see what phones are locally on the Mesh and show your contacts in your Contact List
Maps calls up the Serval Maps interface (if installed)
Share files allows you to share files over our unique Rhizome sharing system, view any received files, see how much storage you are using, or find files shared.
Share Us allows you to share the Serval Mesh software with other users with compatible Android devices.
Settings allows you to adjust any settings (see below)
Switch Off(On) enables you to switch Serval Mesh functionality on or off.
Help is the new support system.

There is a redesigned and more detailed Help System. This contains:

Guide To Interface: A quick guide to the buttons on the Main Interface
Accounts & Contacts: Serval uses Accounts to provide initial identity management. Contacts enables searching for Peers on the Serval Mesh, and adding them to the Contacts list (Android Address Book).
Licence: A link to the GPLv3 Licence used by Serval
Serval Security: Information on the Security features, Permissions used, and the Privacy Policy
About: About the Serval Project - it also leads to the Donate Button, allowing you to support our software development.
Quick Links: Useful links for our software & project

There is a new Settings system.This contains:

Wifi Settings: Allows you to view and change Wifi settings
Accounts Management: View & change various Account settings
View Logs: View the software logs
Redetect Wifi: Redetect the wifi chipset

There have been enormous changes under the hood since 0.08:

The foundations of the Serval Security Framework are now in place. Elliptic curve cryptography is used for identifying, protecting and authenticating subscribers and mesh network traffic.
All Serval-to-Serval traffic (except Rhizome transfers) is now encapsulated in Serval’s new, secure Mesh Datagram Protocol, implemented as an overlay network on standard IP over Wi-Fi.
The original Java implementation of the Rhizome file sharing system has been superseded by a new implementation in C within the serval-dna component, using SQLite as the local storage engine.
Voice calls are now carried over the mesh using Serval’s own Voice over Mesh Protocol, which has been designed to replace SIP and RTP. As a result, call quality and latency have improved.
MeshMS (Serval’s SMS-like service) now uses Rhizome as its transport.
Improved stability and responsiveness.

Supported Devices

This release of Serval Mesh has been extensively used and tested on the following devices with no problems:

Huawei IDEOS X1 u8180, running Android 2.2.2 (rooted) and CyanogenMod 2.3.7
HTC Sensation, running Android 2.3.4 (rooted) and HTC Sense 3.0
HTC One S
Motorola Milestone

Prior releases of Serval Mesh are known to work on the following devices, which is a strong indication that this release may also work:

Huawei IDEOS u8150
Samsung Galaxy Tab 7 inch
Samsung Galaxy Gio S5660, running Android 2.3.6 (rooted)
Samsung Vitality SCH-R720
ZTE Score X500
HTC/Google G1 (“Dream”)

This release of Serval Mesh is known to work on the following devices with minor problems:

Samsung Galaxy S2 GT-I9100, running Android 2.3 (rooted): Ad-Hoc Wi-Fi is not completely compatible with the Ad-Hoc Wi-Fi on other devices, specifically the Huawei IDEOS phones listed above. If the Galaxy S2 is the first device to join the mesh, then IDEOS phones cannot join. However, if an IDEOS phone is the first device, then the Galaxy S2 does join okay.
Google Nexus 1: does not interoperate well with HTC/Google G1.

The following devices have major known problems in this or prior releases:

HTC Wildfire A3335
Samsung Galaxy Nexus: Wi-Fi Ad-Hoc mode does not start; Wi-Fi mode reverts to Off.
Motorola Razr i XT890: Wi-Fi control does not work.
Samsung Galaxy Note 2: does not detect peers. Possibly the same problem as the Galaxy S2 described above, but not tested.

See the Mobile Device Compatability Table for more details and devices.

Known Issues

The following issues are planned to be fixed by version 1.0:

Poor support for multi-hop mesh calls – see serval-dna issue #37. You can successfully call someone who is within Wi-Fi range of your phone, but calls that need to be carried through intermediate phones are unreliable.
Rhizome slowly and gradually consumes all space on your SD Card as you send and receive files – see batphone issue #8 and serval-dna issue #10. You can work around this by deleting the Rhizome database while the Serval Mesh app is not running, or by re-installing the Serval Mesh app. To delete the database, use the adb shell command:
rm -r /sdcard/Android/data/org.servalproject/files/rhizome
Mesh call quality degrades whenever Rhizome file or MeshMS transfers are in progress – see serval-dna issue #1.
The Serval Mesh app works best with Android root permission, because it depends on Wi-Fi Ad-Hoc mode which can only be started with root permision – see batphone issue #47.
Voice call quality is unstable and relatively untested. The inefficient codec used by VoMP consumes more bandwidth than necessary. There is no echo cancellation, so echo may have to be controlled by lowering speaker volume or using earphones. Audio latency (delay) might exceed one second in some situations.
Every time a new MeshMS message is added to a thread, the size of the message transmitted by Rhizome increases, because it re-transmits all the prior messages in the same thread. So every message thread will consume more network bandwidth and SD Card space as it grows – see [serval-dna issue #28][]. This can be worked around by deleting the Rhizome database as described above.
After using the “Unshare” button on a Rhizome file, it does not disappear from the Rhizome file list – see batphone issue #53. Work around: close the list (Back control) and re-open it (“Find” button).

There are more known bugs and issues listed under the GitHub Issues page for batphone issues and serval-dna issues.

Copyright and licensing

Serval Mesh is free software produced by the Serval Project and many contributors. The copyright in all source code is owned by Serval Project Inc., an organisation incorporated in the state of South Australia in the Commonwealth of Australia.

The Java/XML source code of Serval Mesh is licensed to the public under the GNU General Public License version 3. The serval-dna component of Serval Mesh is licensed to the public under the GNU General Public License version 2. All source code is freely available from the Serval Project’s batphone and serval-dna Git repositories on GitHub.

Acknowledgements

Development of Serval Mesh was funded by the New America Foundation’s Open Technology Institute and the Shuttleworth Foundation.

The Serval Project was founded by Dr Paul Gardner-Stephen and Romana Challans, both academic staff at the School of Computer Science, Engineering and Mathematics at Flinders University in South Australia. Their work on the Serval Project is made possible by the ongoing support of the university.

Disclaimer

SERVAL MESH refers to the software, protocols, systems and other goods, tangible and intangible produced by The Serval Project, Serval Project, Inc., and Serval Project Pty Limited.

SERVAL MESH COMES WITH NO WARRANTY, EXPRESSED OR IMPLIED, AND IS NOT FIT FOR MERCHANTABILITY FOR ANY PURPOSE. USE AT YOUR SOLE RISK.

SERVAL MESH WILL REDUCE THE BATTERY LIFE OF DEVICES ON WHICH IT RUNS.

SERVAL MESH MAY CONSUME ALL STORAGE, both LOCAL and EXTERNAL (eg, MICRO SD CARD) ON THE DEVICES ON WHICH IT RUNS.

SERVAL MESH SHOULD NOT BE INSTALLED ON DEVICES WHICH ARE DEPENDED UPON FOR EMERGENCY COMMUNICATION.

SERVAL MESH MAY TRANSMIT SOME DATA, INCLUDING TELEPHONE CALLS, MESSAGES AND OTHER POTENTIALLY PRIVATE DATA IN THE CLEAR.

SERVAL MESH PROTECTIONS against IMPERSONATION or OTHER MISAPPROPRIATION of IDENTITY ESTABLISHING FACTORS MAY BE DEFECTIVE and MAY NOT PERFORM AS EXPECTED.

SERVAL MESH SHOULD NOT BE RELIED UPON IN AN EMERGENCY is it is an INCOMPLETE PROTOTYPE and BEST EFFORT in nature, and may FAIL TO OPERATE.

SERVAL MESH may COST YOU MONEY if you have a MOBILE DATA PLAN by allowing NEARBY DEVICES TO USE YOUR DATA PLAN WITHOUT YOUR KNOWLEDGE OR CONSENT.

SERVAL MESH may REVEAL AND/OR BROADCAST YOUR LOCATION, IDENTITY OR OTHER INFORMATION through its normal operation.

SERVAL MESH is an INCOMPLETE, PRE-PRODUCTION software, experimental in nature and is not to be considered fit for merchantability for any purpose. It has many defects, omissions and errors that will hamper its fulfilling of its intended purposes.