How to get your Nexus 7 ready

Prepare your device

The following tutorial is based on the Nexus 7. The app and all of its features were tested with the two configurations mentioned in the next steps (3G and Wifi model). Beacuse of its nature it is highly possible, that the app and all steps are more or less transferable to another android device. However, keep in mind that the ManiacLib was built with Google API 17 - therefore your device must also support this API version.

1. First of all your android device should be rooted, because the ManiacLib depends on OLSRD, which itself depends on the Open-Source APP ManetManager, which can be downloaded via Google Play Store (https://play.google.com/store/apps/details?id=org.span&hl=de) or via GitHub (https://github.com/ProjectSPAN/android-manet-manager). If you never rooted a Android device before, there are several tutorials on the internet. A nice tool, which can help you on the way is the Google Nexus 7 Toolkit (only for Windows XP/Vista/7/8). Of course you can use whatever you want.

2. After successfully rooting your device, the next step is to install the actual CyanogenMod depending on the version. During the development of the ManiacLib the version 4.2.2 (grouper aka WiFi Model) and 4.2.1 (tiladia aka 3G Model) were used. We expect some updates within the next few weeks, because none of the used version are stable by actual date (May 15th). We keep you updated, in case there are critical updates, which eventually should not be applied to the devices. The installation of CynanogeMod is done in Recovery Mode, which is available after rooting. A tutorial (specialized for Nexus 7 grouper) can be found here: http://wiki.cyanogenmod.org/w/Install_CM_for_grouper. The next step requires a complete installation and maybe updated CynanogenMod firmware.

3. The next step includes a custom kernel from SPAN (https://github.com/monk-dot/SPAN/tree/master/kernels/ASUS%20Nexus%207) and SuperSu 1.25 (http://forum.xda-developers.com/showthread.php?t=1538053), which is supposed to be installed via Recovery Mode. Additionally (although not needed) add the Google Apps - also installed via Recovery Mode.

4. If you installed the Google Apps and added an Google-account head over to the Play Store and install the ManetManager (https://play.google.com/store/apps/details?id=org.span&hl=de). Alternatively you can install it using the GitHub repo here: https://github.com/ProjectSPAN/android-manet-manager.

5. Restart your device once (or mayyybe twice ;)

6. Congratulations, your device is ready!

Installing and using the ManiacLib and App

The ManiacLib release contains a predefined App and also the isolated API. For installation you can use the predefined ManiacLib APP. Inthis case all you have to do is install the APP on your device. This can be done for example via eclipse. If you want to use the API without our APP it would be wise to read the documentation and maybe have a look at the structure of the predefined APP to get informations about the structure.

1. Download the API

2. Download the Eclipse Android Development Bundle here: http://developer.android.com/sdk/index.html

3. Import the API into eclipse.

4. Implement the interface ManiacStrategyInterface (see Doc).

Note: When Mothership processes a packet, it calls the appropriate function on your strategy. Make sure that any time or resource consuming actions you want to take are running in a seperate thread so Mothership is not delayed in the packet processing when calling your strategy.

5. To start the program in an app, make a new Mothership object and call setStrategy().

6. Call .start() on the Mothership object.

7. Make sure MANET manager is running and WIFI is OFF.