Repository files navigation

Libswiftnav (LSN) is a platform independent library that implements GNSS utility functions for use by software-defined GNSS receivers or software requiring GNSS functionality. It is intended to be as portable as possible and is written in standards compliant C with no dependancies

LSN does not provide any functionality for communicating with Swift Navigation receivers. Seelibsbp to communicate with receivers using Swift Binary Protocol (SBP).

To checkout the library run the following commands in an appropriate directory

git clone git@github.com:swift-nav/libswiftnav.git

Which should checkout the source code

To build the library, run the following commands from the LSN root directory - LSN depends on the latest xcode for MacOSX and cmake

mkdir ./buildcd ./buildcmake ../make -j4

Thelibswiftnav docker image is using a ECR-hosted base imageswift-build that contains most swift build tools.

To be able to pull this base image from ECR, you need to log into AWS (select the SSO-Build-User role) and then intoECR:

aws-google-auth -S 115297745755 -I C02x4yyeb -p default -a -u <username>@swift-nav.com$(aws ecr get-login --no-include-email --region us-west-2 --registry-ids 571934480752)

Alternatively to the AWS/ECR pull, you can build the base image yourself from the Dockerfile.base:(replace <tag> with the one used by Dockerfile's FROM statement, e.g. 2018-12-20)

docker build -t 571934480752.dkr.ecr.us-west-2.amazonaws.com/swift-build:<tag> modules/docker-recipes/swift-build

Now you can build and run the libswiftnav image with

docker-compose build libswiftnavdocker-compose run libswiftnav

make docker

• Starts a shell in a container, with the workspace mounted as /mnt/workspace.

make docker-build

make docker-lint