The iDigi Connector for Android implements the iDigi protocol in an Android device allowing it to be discovered and managed by Digi applications, establish communication with the iDigi Device Cloud Portal for remote management, and exchange data between the device and iDigi.

You can install the iDigi Connector for Android either from Google Play or performing a manual installation.

The iDigi Connector for Android is located in the Google Play. It means that you can install it directly from your Android device, or through this URL:

• https://play.google.com/store/apps/details?id=com.digi.DigiService

You can also install it using the following QR:

The manual installation process of the iDigi Connector for Android in the device is the same for physical and virtual devices. Just make sure the device is ready for the installation:

• Physical device: The device is powered on and connected to the using the cable.
• Android Virtual Device: The is running.

Depending on the operating system you are working on, you will need to follow a different set of instructions to install the iDigi Connector for Android.

Windows

1. Open a Windows command line console. To do so, go to Start and type cmd in the search box, then press <Enter>.

2. Change to the directory where you installed the Android and go to the platform-tools folder. To do so write the following command:

   cd "<path-to-sdk>\platform-tools"

   
   

   Where <path-to-sdk> is the path where the Android is installed.

3. You need to know the ID of the device in order to install the iDigi Connector for Android. To determine this ID issue the following command:

   adb.exe devices

   
   

   You will receive an answer like this:

   List of devices attached <device-id> device <device-id> device

   
   

   Where <device-id> is the ID of the Android devices (virtual and physical) connected to your PC.

4. Now write the following command to install the iDigi Connector for Android:

   adb.exe -s <device-id> install "<path-to-sdk>\platforms\<api-level>\iDigi Connector\iDigiConnectorAndroid.apk"

   
   

   Where <device-id> is the ID of the device where you will install the iDigi Connector for Android, <path-to-sdk> is the path where the Android is installed and <api-level> is the folder of the Android you will use to develop iDigi Android applications.

5. Wait for the installation process to finish. You will see Success in the console when the service is installed successfully.

Linux

1. Open a shell console and kill the current process by executing the following command:

   /<path-to-sdk>/platform-tools/adb kill-server

   
   

   Where <path-to-sdk> is the path where the Android is installed.

2. Restart the process by issuing this command:

   sudo /<path-to-sdk>/platform-tools/adb start-server

   
   

   Where <path-to-sdk> is the path where the Android is installed.

3. To verify that you are the owner of the instead of Eclipse, you should see the following output in the shell:

   * daemon not running. starting it now on port 5037 * * daemon started successfully *

   
   

   If you don't see that output, you should repeat steps 1 and 2.

4. Change to the directory where you installed the Android and go to the platform-tools folder. To do so write the following command:

   cd /<path-to-sdk>/platform-tools

   
   

   Where <path-to-sdk> is the path where the Android is installed.

5. You need to know the ID of the device to install the iDigi Connector for Android. To determine this ID issue the following command:

   ./adb devices

   
   

   You will receive an answer like this:

   List of devices attached <device-id> device <device-id> device

   
   

   Where <device-id> is the ID of the Android devices (virtual and physical) connected to your PC.

6. Now write the following command to install the iDigi Connector for Android application:

   ./adb -s <device-id> install /<path-to-sdk>/platforms/<api-level>/iDigi Connector/iDigiConnectorAndroid.apk

   
   

   Where <device-id> is the ID of the device where you will install the iDigi Connector for Android, <path-to-sdk> is the path where the Android is installed and <api-level> is the folder of the Android you will use to develop iDigi Android applications.

7. Wait for the installation process to finish. You will see Success in the console when the service is installed successfully.

Registering the device in iDigi is a necessary step to allow for remote management of the device, and data exchange between the device and the iDigi server.

Depending on if you are using a physical device or a virtual device, you should follow a different set of instructions.

Follow these steps to register your physical Android device in your iDigi account:

1. Verify that your device has internet access activated (Wireless or 3G).
2. Go to the Android applications and start the iDigi for Android application.

   

3. Press the Register the device option.

   

4. Enter your iDigi credentials into the displayed pop-up, then press Register.

   

5. Activate the iDigi Connector for Android by checking the Activate iDigi option.

   

6. You will know when the iDigi Connector for Android is started because you will see a little iDigi logo in the status bar of the Android.

   

Follow these steps to register your virtual Android device in your iDigi account:

1. Verify that your device has internet access (test it using the device's Internet browser).
   • If the device does not have internet access, you must change the servers your is using to be static as follows:
     • Primary: 8.8.8.8
     • Secondary: 8.8.4.4
   • Then, you should restart your virtual Android device.
2. Go to the Android applications and start the iDigi for Android application.

   

3. Since this is a virtual device, it does not have a address that can be used by the iDigi Connector for Android to generate a unique ID. For that reason, you need to specify a address manually. You can use the address of your Ethernet interface.

   To specify the address for the , press the Emulated address option.

   

4. Write the address of your 's Ethernet interface with the following format: XX:XX:XX:XX:XX.

   

   • If you are working in Windows, you can obtain your Ethernet's MAC address by executing the following command in a command line console: ipconfig -all

     

   • If you are working in Linux, you can obtain your Ethernet's MAC address by executing the following command in a shell console: ifconfig

     

5. Press the Register the device option.

   

6. Enter your iDigi credentials into the displayed pop-up, then press Register.

   

7. Activate the iDigi Connector for Android by checking the Activate iDigi option.

   

8. You will know when the iDigi Connector for Android is started because you will see a little iDigi logo in the status bar of the Android.