You copied the Doc URL to your clipboard.

Building the gator daemon

To communicate with the target device, Streamline requires the gator daemon, gatord, to be installed on the device.

For full functionality, gatord requires an accompanying gator driver, gator.ko. When gatord is used together with gator.ko, this is referred to as kernel space gator. gatord can run without gator.ko on Linux 3.4 or later, but is restricted to using user-space APIs and does not support all Streamline features. This is referred to as user space gator. Your DS-5 installation includes a pre-built gatord binary, located in <DS-5_install_directory>/arm/gator/, which you can install and run on a Linux or Android target by clicking Setup target... in the Connection Browser dialog. Alternatively, you can build gatord yourself following the steps outlined in this topic. For more information, see the readme included in the gator directory.

Note

It is not possible to build gatord or gator.ko on a Windows host.

To build gatord, follow these steps:

Procedure

  1. Enter the following command to extract the archive that contains the gatord source: tar xzf <DS-5_install_directory>/arm/gator/daemon-src/gator-daemon.tar.gz

    Note

    Make sure you extract this file into a directory in which you have write privileges.
  2. Change to the newly created gator-daemon directory. This step varies depending on whether you are running Linux or Android.
    • For Linux, enter:

      cd gator-daemon

    • For Android, enter:

      mv gator-daemon jni

  3. Issue the commands to build gatord.
    • To build gatord for a Linux target, enter:

      make CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-linux-gnueabihf-

      Note

      To do this, you must have a g++-enabled build host toolchain. If the target is g++-enabled, you can build directly on it. On a Linaro Ubuntu target, you must enter the following command to install g++:

      sudo apt-get install g++

    • To build gatord for Android, enter:

      <NDK_install_directory>/ndk-build

      Note

      Before you do this, you must have installed the Android NDK. For information, see the Android NDK website, http://developer.android.com/sdk/ndk.
  4. If you did not build gatord on the target, transfer it to the target and then move it to the appropriate directory. Which directory is appropriate is dependent on the target.
  5. Make gatord executable by entering the following command: chmod +x gatord
Was this page helpful? Yes No