cluon-raw-udp

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 any kind of udp connection and forwarding the received packages into a OD4 session using a "raw" message.

How do I get it?

Each release of cluon-raw-udp 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

The example below showcases a setup with two gatherers (listening on two separate stream (one UDP and one TCP)) and one logger that aggregates published messages from the gatherers into a single file.

version: '2'
services:    
    listener:
        container_name: cluon-raw-udp-1
        image: ghcr.io/rise-mo/cluon-raw-udp:v0.1.0
        restart: on-failure
        network_mode: "host"
        command: "--cid 111 --id 1 -a 239.192.0.2 -p 60002 -f 10.0.0.20"

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.