Table of contents

• Description
• Dependencies
• Build
  1. Windows
  2. Linux
  3. MAC OSx
• Authors
• License

Description

This folder contains the source code of a sample demo program exploiting Fing SDK for network scanning and device recognition.

The Fing SDK for Device Recognition (Fing Kit) is a software designed to provide device scanning and device recognition technology.

It consists of two components:

1. The local scanner, which scans the network for devices
2. The device recognition API, providing the recognition technology

The Fing SDK is delivered as a library for Windows, Linux and MAC OSx.

While the kit has been designed mostly for desktop-oriented operating systems, it can be integrated on server-oriented operating system, such as Windows server, Ubuntu server.

Downloads

Below the link for Linux-based operating system:

Name	Description	Link
Windows SDK	Fing Kit for Windows Operating System	Latest
MAC OSx SDK	Fing Kit for Mac OSx	Latest

M1 processor (aarch64) are not supported yet. Please open a ticket if you want to try the SDK for that architecture!

Below the link for Linux-based operating system:

Architecture	Description	Link
AMD64	Fing Kit for Linux x86 64	Latest
i686	Fing Kit for Linux i686	Latest
ARM	Fing Kit for Linux ARM	Latest
ARMHF	Fing Kit for Linux ARM Hard Float	Latest
ARM64	Fing Kit for Linux ARM 64	Latest
MIPS	Fing Kit for Linux MIPS	Latest
MIPS64	Fing Kit for Linux MIPS 64	Latest
MIPSEL	Fing Kit for Linux MIPSEL	Latest
MIPS64EL	Fing Kit for Linux MIPSEL 64	Latest

Fing SDK requires a license key to work. Create a trial license or contact us to get a valid key.

The documentation can download from this link:

Fing Desktop/Embedded SDK

Usage

The include/ folder hold the a portable C header that should be included by the integrator.

The src/ folder contains the demo programs with the source code. On Windows the executable FingKitDemo.bin is called FingKitDemo and the script fingkitdemo is called runFingKitDemo.bat

The Fing SDK contains all the libraries required to make the source program works. It must be downloaded and uncompressed under the root directory of this project.

It contains a lib/ folder with all the dependencies in different format:

• .dll for Windows
• .so for Linux / Unix / OpenWRT
• .dylib for MAC OSx

Dependencies

All the dependencies are available in the Fing SDK:

• boost (v1.58.0)
• protobuf (v2.6.1)
• libpcap (v1.6.2)
• netsnmp (v5.7.3)
• openssl (v1.0.x)
• zlib (v1.2.x)

Build

All the package are built using CMake as build, test and packaging tools. Below the list of CMake variable that can be set:

Variable	Description
C_EXECUTABLE	Name of C Executable
CPP_EXECUTABLE	Name of C++ Executable
CS_EXECUTABLE	Name of C# Executable

Before bulding the project on any platform it's mandatory to copy the content of the lib/ folder of Fing SDK into the lib/ folder of the current project.

The build/ directory contains some utilities to create packages for the variety of supported operating systems.

Windows

From a PC mounting a Windows 7 or greater from the folder run the script:

build\windows-cmake-build-mscv9-solution.bat

It creates a Visual Studio project. The documentation of Visual Studio 9 2008 is available here

Disclaimer:

Please note that the functionality described below has been tested and confirmed to work properly on Visual Studio 9 2008. However, we regret to inform you that it is not currently supported on Visual Studio 16 2019 and later versions. We apologize for any inconvenience caused and recommend using the supported Visual Studio 9 2008 environment for optimal results. Thank you for your understanding.

Linux

cd build
cmake ..
make
DYLD_LIBRARY_PATH=../lib ./devrecog-c

MACOSX

cd build
cmake ..
make
LD_LIBRARY_PATH=../lib ./devrecog-c

Authors

Project Owner

• Carlo Medas (carlo at fing.com)

Contributors

• Giuseppe Badoni (giuseppe at fing.com)
• Tommaso Latini (tommaso at fing.com)

License

Code released under the MIT License.