Dies ist eine alte Version des Dokuments!


flink Userspace Library

This is the user documentation for the flink userspace library in C. It provides a device and bus independent interface to the underlying driver modules. For more information about the inner workings see flink Userspace Library on Github. The API of the library can be found under API

Overview

When flink is used on a Linux based system the flink userspace library offers an simple interface to communicate with the underlying kernel modules. The userspace library is split in two parts.

  • High-Level API: Interface to predefined subdevices, such as PWM or GPIO.
  • Low-Level API: Can be used to access user-defined subdevices.

The library must be built for the target platform architecture.

Requirements

  • Linux based operating system
  • GCC 4.6 or newer
  • CMake 2.8 or newer
  • GNU make

Building

  1. Clone git repository:
    git clone https://github.com/flink-project/flinklib.git
  2. Create a build directory:
    mkdir build-local
  3. Build for the host plattform with:
    make
  • The makefile will switch to the kernel directory, read the current configuration and compile all necessary flink kernel modules for the choosen target plattform.

Installation

  • Move new kernel modules into the default location to /lib/modules/version of the target plattform.
  • Load each module with insmod, e.g.
    insmod flink.ko
  • If dependency files were created beforehand its better to use
    modprobe flink.ko
  • Some kernel module must be loaded with the appropriate arguments according to the target board specifications (see below)