Fixposition SDK: Running pre-built apps

Overview

Docker images with pre-built binaries of the Fixposition SDK: Apps are provided along with a stand-alone script to run those apps easily on a Linux machine (requires Docker).

No Fixposition SDK: Build and installation is required.

Setup

Download the fpsdk.sh script and make it executable:

curl -o fpsdk.sh https://raw.githubusercontent.com/fixposition/fixposition-sdk/refs/heads/main/fpsdk.sh
chmod +x fpsdk.sh

To run the apps the script automatically pulls thee Docker image with the pre-built binaries on first run from the package registry. The -u flag can be used to pull the image again in order to update it. Images for for ROS1, ROS2 and "no ROS" are provided. Note that downloading the image may take some time.

./fpsdk.sh fpltool -V

This should download the image and then execute fpltool -V, which should print the version information.

Command line help

 
Run Fixposition SDK apps
 
This uses Docker images with pre-build binaries of the Fixposition SDK apps.
 
Usage: ./fpsdk.sh [-d] [-u] [-i <image>] [-v <volume> ...] <command> ...
 
Where:
 
    -d          Enable debug output (of this script)
    -u          Update (pull) the necessary Docker <image>
    -t          Executes <command> with docker run --tty
    -i <image>  Specifies which Docker image to use (default: bookworm). Available images are:
                bookworm  -- Debian Bookworm (no ROS, some functionality not available)
                noetic    -- ROS1 Noetic (additional ROS1 functionality available)
                humble    -- ROS2 Humble (additional ROS2 functionality available)
                jazzy     -- ROS2 Jazzy (additional ROS2 functionality available)
    -v <dir>    Additional directory to mount as volumes in docker (see examples below)
    <command>   The command to run,
    ...         and its arguments (if any)
 
Examples:
 
    Show version information:
 
        ./fpsdk.sh fpltool -V
 
    Extract .fpl to ROS1 .bag file in current directory:
 
        ./fpsdk.sh -i noetic fpltool rosbag some.fpl
 
    If the .fpl file is in another directory, we must mount that explicitly:
 
        ./fpsdk.sh -i noetic -v ~/Downloads fpltool rosbag ~/Downloads/some.fpl
 
    User fpltool to extract a .fpl file and then use the parsertool to extract the
    NMEA and FP_A messages from the output messages:
 
        ./fpsdk.sh fpltool extract some.fpl
        ./fpsdk.sh parsertool -f NMEA,FP_A -c some_userio.raw > some_userio.txt
 
    Run an interactive shell:
 
        ./fpsdk.sh -t -i noetic bash