The iDigi Connector for Android implements the iDigi protocol in an embedded 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.

Before starting with the installation process, make sure the embedded device is powered on and connected to the using an Ethernet cable.

The first step is to connect the embedded device with the Android Debug Bridge (ADB). There are two ways to connect with the ADB: using Digi ESP for Android or from a command line console.

Connect to ADB using Digi ESP for Android

In the main Digi ESP for Android window, click the Device Manager button from the Workbench's main toolbar:

Select the configuration you created previously. The Debug Connection Status displays Disconnected.

Click Connect to connect the embedded device with the ADB.

The Debug Connection Status displays Connected now.

Connect to ADB using a command line console

If you are working in Linux, issue this command in a shell console:

If you are working in Windows, execute this command in a command line console:

Where <android_sdk_path> is the path where the Android SDK is installed and <device_ip_address> is the IP address of the device to connect. To retrieve your Android device's IP address, read Tips & Tricks > Retrieving device IP Address

Depending on the operating system you are using, 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 to install the iDigi Connector for Android. To do so 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.

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 to install the iDigi Connector for Android. To do so 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.

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

   ./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.

5. 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 the remote management of the device, and data exchange between the device and the iDigi server.

Follow these steps to register your embedded device in your iDigi account:

1. Verify that your embedded device has internet access activated (Wireless or Ethernet).
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.