You copied the Doc URL to your clipboard.

Building the gator module

To get the full functionality of Streamline, you must build the gator driver, gator.ko, and place it in the target file system.

If you do not build the gator.ko driver, Streamline uses user space gator, which provides a subset of the functionality that kernel space gator provides. User space gator requires Linux 3.4 or later. For more information, see the readme included in the gator directory.

DS-5 provides the source code for gator.ko in an archive called gator-driver.tar.gz.

Procedure

  1. Enter the following command to extract the source code: tar xzf <DS_install_directory>/arm/gator/driver-src/gator-driver.tar.gz

    Note

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

      cd gator-driver

    • For Android, enter:

      mv gator-driver jni

  3. Assuming that you have all of the required tools for building kernel modules, you can build gator.ko either by using a build command or by integrating it into the kernel build system. The build command to use depends on whether you are building on a Linux host or a target. Use one of the following ways to build gator.ko:
    • On a Linux host, use the following build command:

      make -C <kernel_build_dir> M=`pwd` ARCH=arm CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-linux-gnueabihf- modules

      Note

      You must remove the comment hashtag from the following line in the makefile of the gator module to enable kernel stack unwinding:

      # EXTRA_CFLAGS += -DGATOR_KERNEL_STACK_UNWINDING
    • On a target, use the following build command:

      make -C <kernel_build_dir> M=`pwd`

    • To integrate gator.ko into the kernel build system, use the following instructions:

      cd <kernel_build_dir>
      cd drivers
      mkdir gator
      cp -r <path_to_gator_driver_src>/* gator

      Add the following line to the end of Makefile in the kernel drivers folder:

      obj-$(CONFIG_GATOR) += gator/

      Add the following line before the last endmenu in Kconfig in the kernel drivers folder:

      source "drivers/gator/Kconfig"

      This enables you to select and rebuild gator when using menuconfig to configure the kernel.

    To add support for an ARM® Mali™-based processor, you must specify some additional options when building the gator module.

Related reference

Was this page helpful? Yes No