freeboard-sk-helper

Freeboard-SK-Helper:

Signal K Server helper plugin for Freeboard-SK that acts as an API provider for the Signal K paths that are required to support Freeboard-SK operation and which may not be serviced by a Signal K server or installed plugins:

---

Note: this plugin may be used from time to time to provide functionality for experimental features that may become part of Feeboard-SK in the future.

---

Serviced Signal K Paths:

Course Data:

Provider to support the setting of an Active Route or Waypoint / Location as the current Destination.

Used in conjunction with the Derived Data plugin this enables the display of data related to the current destination.

HTTP: (GET/PUT)

./vesels/self/navigation/courseGreatCircle/activeRoute/href

./vesels/self/navigation/courseGreatCircle/activeRoute/startTime

./vesels/self/navigation/courseGreatCircle/nextPoint/position

./vesels/self/navigation/courseGreatCircle/nextPoint/arrivalCircle

Stream:

vessels.self.navigation.courseGreatCircle.activeRoute.href

vessels.self.navigation.courseGreatCircle.activeRoute.startTime

vessels.self.navigation.courseGreatCircle.nextPoint.position

vessels.self.navigation.courseGreatCircle.nextPoint.arrivalCircle

Deltas: (sent for the following paths)

navigation.courseGreatCircle.activeRoute.href

navigation.courseGreatCircle.activeRoute.startTime

navigation.courseGreatCircle.nextPoint.position

navigation.courseGreatCircle.nextPoint.arrivalCircle

Arrival Alarm:

Serves as a provider for the path navigation.courseGreatCircle.nextPoint.arrivalCircle to enable the radius of the circle surrounding the active destination to be defined.

This radius is then used to send a notification using the path navigation.arrivalCircleEntered to notify that the vessel has entered the arrival circle.

Notifications: (sent for the following paths)

navigation.arrivalCircleEntered

---

Experiments:

GRIB2JSON file provision:

Serves the content of JSON formatted GRIB data produced by the GRIB2JSON tool at the path ./resources/grib.

To make the GRIB JSON file available place the json file in the /home/<user>/.signalk/freeboard-sk-helper/grib folder of your Signal K server.

GRIB JSON data can be viewed in the following ways using the HTTP API:

1. List summary of available GRIB data: ./resources/grib
2. List contents of the most current GRIB file: ./resources/grib/latest
3. List contents of a GRIB file: ./resources/grib/id where id is the id of the GRIB file returned in 1).
4. List only the specific sections of a GRIB file: ./resources/grib/id:n where id is the id of the GRIB file and n is the index of the section in the file.

Example: get contents of GRIB file 2019101200 ./resources/grib/2019101200

Example: get first section of GRIB file 2019101200 ./resources/grib/2019101200:0

Example: get first and third section of GRIB file 2019101200 ./resources/grib/2019101200:0-2

Changelog

v1.3.1

• fix: Issue where null value would raise arrival alarm notification.