You are here: 52°North>Wiki>SensorWeb Web>SensorPlatformFramework (07 Aug 2013, DanielNuest)Edit Attach

SensorPlatformFramework

The Sensor Platform Framework (SPF) is a software framework to facilitate real-time measurements with mobile sensor platforms, such as the Ifgicopter, and connect them to the sensor web. It is easily extendable by a powerful plug-in mechanism for both incoming and outgoing data.

spf-screen.png

For detailed information (architecture, components, workflow) see also http://52north.org/communities/sensorweb/incubation/ifgicopter/spf/index.html.

Contents

API

The API can be used to implement Input-Plugins, Output-Plugins, Interpolator Implementations and complex data processing units. It provides a bunch of interfaces.

Interfaces: Dependencies: SPF Bindings

Instructions:
  • checkout from SVN
  • run 'mvn install' in the main folder of the API projects (where the pom.xml is located)
  • a JAR file is created in the target-directory. You can use this file inside your projects.
Source Code: https://svn.52north.org/svn/swe/incubation/ifgicopter/spf-api/trunk/

Plugins

The SPF classifies plugins into Input Plugins, i.e. connectors for getting data into the Framework, and Output Plugins, which are used to provide different data dissemination methods. The following lists currently available plugin implementations covering some basic and advanced dissemination methods (GPX, CSV file writers) and input connectors for simulation or playback of existing time series.

Input

Output

Development

Source Code

The SPF's build process is based on Maven. For straightforward integration of the Eclipse IDE, the m2eclipse plugin is recommended. To check out the required resources with Eclipse follow these steps:
  • Open the SVN Repository Exploring perspective
  • Add the repository https://svn.52north.org/svn/swe/incubation/ifgicopter
  • Navigate to the respective project (see below)
  • Right click the trunk folder
  • Select Find / Check out as ...
  • use the New Project Wizard to create a Java project from the sources
  • after checkout, right-click on the project and activate the Maven support (Maven/Enable Dependency Management or Configure/Maven - depending on m2eclipse verison)
  • follow project specific instructions stated in the install.html of the projects root directory

Source Projects

SPF is divided into several source code projects:
  • spf-api: The basic API implemented by spf-core
  • spf-bindings: Libraries that are not available in online repositories
  • spf-core: The implementation of the SPF API
  • JavaMK: Connector to the MikroKopter system
  • spf-mkInputPlugins: The input plugin for JavaMK
  • spf-outputPlugins: A collection of output plugins
  • spf-inputPlugins: A collection of input plugins.

Compiling Projects

spf-core, spf-inputPlugins and spf-outputPlugins have predefined bundling procedures included. Simply run "mvn install assembly:single" in the project's root directory from command line (or m2eclipse). This will create archives of the project (including all dependencies needed) in the /target/assembled-release directory.

Implementing custom Plugins

Detailed guidance on how to write Input- and OutputPlugins can be found on the dedicated subpages:

Download

An executable release version can be downloaded here.

Latest Release: Former Releases: ...

Changelog:

Install and Run SPF

SPF must not be installed, simply unzip the downloaded file (see above). To run SPF use the executable file that fits your operating system:
  • spf.bat for 32bit Windows
  • spf_64bit.bat for 64bit Windows
  • spf.sh for 32bit Linux
  • spf_64bit.sh for 64bit Linux
Prerequisites:
  • An existing JAVA_HOME environment variable, see this website for instructions.

Plugin Installation

Installing the InputPlugins and OutputPlugins is straightforward. Just copy over the contents of the lib-folder or your own jar files into the lib-folder of your SPF installation. Then register the plugin via the main configuration in the file config/spf.properties. InputPlugins are registered using the IInputPlugin key, OutputPlugins using the IOutputPlugin key. You need to specify the full qualified Java class name of the class implementing the respective interface. You find this information in the documentation of the respective plugins, for example FileWriterPlugin or GpxOutputPlugin.

Get Support

Please direct your questions to the Sensor Web community mailing list and forum, or file a bug in 52°North's Bugzilla for SPF.

Roadmap and Tasks

Contributing Developers

Metadata

  • Topic created by: DanielNuest
  • Topic created on: 2011-09-27
-- MatthesRieke - 2012-05-22
Topic attachments
I Attachment Action Size Date Who Comment
SPF-Plugin-SDK_eclipse3.7.zipzip SPF-Plugin-SDK_eclipse3.7.zip manage 14 MB 29 Mar 2012 - 09:40 MatthesRieke Eclipse Project providing templates for Input- and OutputPlugins.
SPFramework-0.5-MK-Edition.tar.gzgz SPFramework-0.5-MK-Edition.tar.gz manage 15 MB 24 Feb 2012 - 12:44 MatthesRieke SPFramework 0.5 - Mikrokopter-Edition
SPFramework-0.5-MK-Edition.zipzip SPFramework-0.5-MK-Edition.zip manage 15 MB 24 Feb 2012 - 12:33 MatthesRieke SPFramework 0.5 - Mikrokopter-Edition
SPFramework-0.5-pluginBundle.tar.gzgz SPFramework-0.5-pluginBundle.tar.gz manage 15 MB 11 Jan 2012 - 09:02 MatthesRieke  
SPFramework-0.5-pluginBundle.zipzip SPFramework-0.5-pluginBundle.zip manage 15 MB 11 Jan 2012 - 09:02 MatthesRieke  
SPFramework-0.5.tar.gzgz SPFramework-0.5.tar.gz manage 13 MB 11 Jan 2012 - 08:59 MatthesRieke  
SPFramework-0.5.zipzip SPFramework-0.5.zip manage 13 MB 11 Jan 2012 - 08:59 MatthesRieke  
SPFramework-api-0.5-with-javadoc.zipzip SPFramework-api-0.5-with-javadoc.zip manage 143 K 25 Jan 2012 - 12:08 MatthesRieke  
spf-inputPlugins-0.5.tar.gzgz spf-inputPlugins-0.5.tar.gz manage 2 MB 11 Jan 2012 - 09:02 MatthesRieke  
spf-inputPlugins-0.5.zipzip spf-inputPlugins-0.5.zip manage 2 MB 11 Jan 2012 - 08:59 MatthesRieke  
spf-outputPlugins-0.5.tar.gzgz spf-outputPlugins-0.5.tar.gz manage 439 K 11 Jan 2012 - 08:59 MatthesRieke  
spf-outputPlugins-0.5.zipzip spf-outputPlugins-0.5.zip manage 439 K 11 Jan 2012 - 08:59 MatthesRieke  
spf-screen.pngpng spf-screen.png manage 104 K 22 Jan 2012 - 19:19 MatthesRieke  
Topic revision: r20 - 07 Aug 2013 10:06:09, DanielNuest - This page was cached on 26 Aug 2016 - 04:29.

This site is powered by FoswikiCopyright &© by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki? Send feedback