First Steps

This guide will provide you all the steps to download, import and run the BenchImage application, which can be used to demonstrate MpOS functionalities for both Android and Windows Phone platforms.

Required Technologies:

  • Windows 8.1 (x64) Professional (for Linux and Mac OS X users, only Android will work)
  • Android:
    • Eclipse Platform 4.2.1v with ADT 23.0.x
    • Oracle Java SDK 8.x (for any OS)
    • Android SDK installed (API 19 or above)
  • Windows Phone:
    • Visual Studio Professional 2013 (with Update 4) or Community 2013 (not tested)
    • Visual Studio SDK 2013 (with Update 4)
    • Windows Phone emulators (need Win 8.1 x64 Pro with client Hyper-V installed)

1) Download the MpOS source code: Download Page

2) Import Android components on Eclipse ADT

  1. Import -> Android -> Existing Android Code Into Workspace
  2. Browse the path where the project is located. Choose ‘/android’ and click on ‘OK’ button
  3. Select the ‘BenchImage2’ and ‘MpOS API’ projects to import and click on ‘Finish’ button (You will see the projects on your Eclipse workspace)
  4. Update the target Android version for each project: Properties -> Android -> Selected “Target Name: Android 4.x” and click on ‘OK’ button.

Note: In order to test the ‘BenchImage’ application, it is recommended to use a device with Android 4.0.X or above, because of the multicast-based discovery system. Emulator is not recommend either.

3) Import Windows Phone components on Visual Studio 2013

  1. Browse the path where the project is located
  2. Enter in the “windows_phone” folder
  3. Click on “MpOS.sln” in order to open the project on VS 2013

Note: In order to test BenchImage app is recommended to use a device with Windows Phone 8.x or above.

4) Run MpOS Platform

  1. Browse the path where the project is located
  2. Navigate to “plataform” folder, then “executables” folder
  3. Configure the machine’s IP on the config.properties (“cloudlet.interface.ip”)
  4. Using the terminal/console, navigate again to “executables” folder
  5. Run the mpos_platform.jar file: java -jar mpos_plataform.jar

Note: You should check the firewall permissions to allow mpos_plataform.jar to run properly. And also if the wireless access point supports multicast.

5) Execute BenchImage

  1. Execute BenchImage on Android using the Eclipse ADT and/or on Windows Phone using the VS 2013.
  2. Once the application is loaded, selected the filter type on “Filtro” field (e.g., Original, …, Cartoonizer) and the execution environment on “Processamento” field (Local, Cloudlet or Internet).
  3. Click on “Inicia” button to apply the chosen filter on the image. If the execution environment is differente from “Local”, the offloading system will be executed.

Note: On MpOS Plataform CLI, you’ll be able to see the multicast and deployment services working. And you’ll also able to see a high network activity when the offloading system is working. Depending on the mobile device, execution environment and network conditions, the filter should be executed faster outside of the mobile device (Cloudlet or Internet).

Android screen

Android screen

Windows Phone screen

Windows Phone screen