/dashboard_tactics_pi

OpenCPN dashboard built-in plugin merger with external tactics_pi plugin

Primary LanguageC++GNU General Public License v3.0GPL-3.0


DashT - an OpenCPN plug-in with Dashboard, Tactics, Race, Engine/Energy, Signal K, Time Series DB and Line Graphs

Codacy Badge Documentation Status

dashboard_tactics_pi in your OpenCPN plug-in catalog.

Introduction

DashT v1.5.11 was a forerunner in diversifying the data connectivity of a OpenCPN plug-in to enable direct network connections to resources available in a modern boat's computer and network infrastructure. This version, of which you can find installation packages in Releases continues this philosophy and presents new features by collecting timestamped open data and making it available to external applications and data retrieval systems.

Like DashT, the OpenCPN itself is embracing, from the v5.2 onwards the open marine data format Signal K. This hopefully encourage you to consider to install the fast, ubiquitous and reliable Signal K data format source in your boat's infrastructure: Signal K server node. As before, it is fully supported by DashT as an alternative and direct data source, allowing the creation of enhancements which are not present in the traditional OpenCPN Dashboard:

Features

  • OpenCPN's Dashboard integrated

  • Tactics and performance functions integrated

    • No need to swap between the two plug-ins!
  • Race start line and windward/leeward assistance

    • Wind shifts, Zero Burn, ladder rungs, laylines, current, all!

Dashboard and Tactics instruments do not require Signal K data but they work also with NMEA-0183 data from OpenCPN like Dashboard/Tactics. But read below:

  • Signal K data input streaming

    • Direct connection to the delta channel of a Signal K server node providing shortest possible path for:

      • Maximum volume of data ;
      • Lowest possible latency ;
      • Time stamps at source ;
      • Access to Engine, Energy and Status data from NMEA-2000, Bluetooth LE, GPIO over a single interface.
  • Engine and Energy dials

    • Provides Signal K engine and energy data on dials built using latest web techniques but fully integrated in OpenCPN Dashboard
  • Influx DB 2.0 ouput streaming and export

    • Time series based databases are essential with the data volumes and rates produced by Signal K enabled servers

    • Real-time storage and retrieval allows long-term monitoring and historical data browsing using external tools such as Grafana

    • Short-term historical data line graphs provided and integrated in OpenCPN Dashboard for race time or performance run real-time monitoring of key parameters

    • An all-received-data containing file can be registered to feed, off-line or after race InfluxDB v2.0 time series database

      • Enhances post-race analysis and off-line polar calculations with high sampling rate and accurately timestamped data
  • Over 100 pages of documentation is waiting you in HTML/PDF/EPUB format at readthedocs

    • Developer's information with performance analysis and debugging tips in same format within this repository

Installation

readthedocs

Configuration

readthedocs

Compiling

  • git clone git://github.com/canne/dashboard_tactics_pi.git

Windows build

This build is tested with Visual Studio 2019 on Windows 10

Please get first the library file "opencpn.lib". It is located in the build directory of OpenCPN after having built it; or your can search it from the various processes of CI (continuous integration) of this plug-in. Or try this one.

Starting from v2.0 this plug-in has moved, in Windows entirely to use vcpkg for dependencies - hence the directive below. As usual the most annoying part is the wxWidgets package which cannot be STL-enabled, unfortunately in OpenCPN - in DashT it can: to help in this dilemma, there is a non-STL port with CMake find-script available here. Of course, one can install wxWidgets manually in C: - by no means DashT depends on its location; vcpkg is only for build process on Windows to provide libraries readily available on a Linux system:

  • cd build
  • cp ....\mydirectory\opencpn.lib .
  • cmake -G "Visual Studio 16 2019" -A Win32 -DCMAKE_TOOLCHAIN_FILE=C:\vcpkg\scripts\buildsystems\vcpkg.cmake ..
  • cmake --build . --target package --config release

Debian/Linux style build

  • cd build
  • cmake ..
  • make
  • make package
  • sudo gdebi packagename-version-etc.deb

License

The project is licensed under the terms of the GPL v3. The networked parts of the project are derived from and licensed under MIT license.