Getting Started

This tutorial shows how to run MobileInsight inside the phone. Currently MobileInsight supports Android phones with Qualcomm™ and certain MediaTek™ chipsets. This link lists the phone models we have tested. Besides, you can also run MobileInsight on desktops.

Step 1: Download and Install

Download MobileInsight apk here, and install it.

Alternatively, you can download the source codes from our GitHub and build an apk by following the instruction here.

Note

MobileInsight needs the root privilege on Android phones.

Step 2: Run MobileInsight app

The MobileInsight app encapsulates mointoring/analysis codes as plugins. At runtime, it automatically loads plugins from the default folder (located in /sdcard/mobileinsight/) and allows you to choose one. By default, MobileInsight provides three built-in plugins:

  • NetLogger: A basic cellular event logger which saves cellular messages in *.mi2log to /sdcard/mobileinsight/log/. You can configure msg type using /sdcard/mobileinsight/cfg/netlogger.cfg
  • RrcAnalysis: A simple analyzer for 3G/4G radio resource control (RRC) protocols.
  • NasAnalysis: A simple analyzer for 3G/4G mobility and session management protocols (Non-access stratum or NAS).

Note

For some phone models, you may need to run MobileInsight in special boot mode. For example, for Nexus 6/6P, please boot your phone in baseband processing mode (e.g., see this link on how to do it). Note that most phone models do not need this step. Please try it only when MobileInsight reports warnings.

Alternatively, you can write your own plugin. You can go to Settings to change the default setting for each function, and use LogViewer to view stored cellular logs.

_images/mi-app-netlogger.png

Next Step

Now you have learnt how to use MobileInsight app, you can read more topics:

  1. Read the tutorials.
  2. Learn how to write your own plugin and run it inside the phone.
  3. Learn how to use MobileInsight on the desktop for offline analytics.