cluon-lwe450

Copyright 2021 RISE Research Institute of Sweden - Maritime Operations. Licensed under the Apache License Version 2.0. For details, please contact Fredrik Olsson (fredrik.x.olsson(at)ri.se).

A libcluon-based microservice for listening in on a multicast-based LWE450 network. This software does not perform any parsing or validation of the LWE450 messages, merely acts as a one-way bridge from a LWE450 transmission group to the libcluon group.

How do I get it?

Each release of cluon-lwe450 is published as a docker image here and is publicly available.

Can also be used as a standalone commandline tool. No pre-built binaries are, however, provided for this purpose.

Example docker-compose setup

version: '2'
services:
    listener_1:
        # TGTD transmission group
        container_name: cluon-lwe450-listener-1
        image: ghcr.io/rise-mo/cluon-lwe450:v0.3.0
        restart: on-failure
        network_mode: "host"
        command: "--cid 111 --id 1 gather -a 239.192.0.2 -p 60002"
    listener_2:
        # SATD transmission group
        container_name: cluon-lwe450-listener-1
        image: ghcr.io/rise-mo/cluon-lwe450:v0.3.0
        restart: on-failure
        network_mode: "host"
        command: "--cid 111 --id 2 gather -a 239.192.0.3 -p 60003"

Details

Message set

Makes use of the public message set for maritime applications: https://github.com/MO-RISE/memo

Build from source

This repository makes use of CPM.cmake for dependency resolution as an interal part of the CMake setup. As a result, the only requirements for building from source are:

• a C++17 compliant compiler
• CMake (>=3.14)

As part of the CMake configuration step, the following dependencies are downloaded and configured:

• libcluon
• CLI11

To build (from the root directory of this repo):

cmake -Bbuild -DCMAKE_BUILD_TYPE=Release
cmake --build build -- -j 8

Development setup

This repo contains some configuration files (in the .vscode-folder) for getting started easy on the following setup:

• Ubuntu 20.04 (WSL2 is fine)
• GCC 9
• python 3
• VSCode as IDE, using the following extensions:
  • C/C++ (ms-vscode.cpptools)
  • C/C++ Extension Pack (ms-vscode.cpptools-extension-pack)
  • CMake Tools (ms-vscode.cmake-tools)
  • Python (ms-python.python)

Do the following steps to get started:

• Clone repo
• Create a python virtual environment (python3 -m venv venv) in the root of the repo.
• Open vscode in the repo root (code .)

The provided configuration is very lightweight and should be easily adaptable to other enviroments/setups.