Skip to content

tkrofta/signalk-squid-sailing-plugin

 
 

Repository files navigation

squid-sailing-signalk

SignalK Plugin to inject forecast data from Squid Sailing service

Install & Use

Note: To use this plugin you need to request an apikey, see also https://www.squid-sailing.com/doc-api/ to get started.

Install the plugin through the SignalK plugin interface. After installation you may want to 'Activate' it through the SignalK Plugin Config interface, enter your pre-requested apikey and configure the output data you want to receive as new SignalK-values (environment.forecast.*), such as:

  • Wind at an elevation of 10m, includes wind gusts at groundlevel
  • Temperature at an elevation of 2m
  • Pressure at mean sea level
  • Relative humidity at an elevation of 2m
  • Total cloud coverage
  • Convective potential energy and lifted index
  • Combined wave height, current and water temperature (BETA only)
  • Snow coverage (BETA only)
  • Precipitation rate / accumulated (BETA only)

Forecast Data

Forecast data is purely based on position - hence navigation.position needs to be present. Data will be queried on position change and/or regularily on an hourly-basis. For consistency navigation.gnss.antennaAltitude (GPS altitude) wil be captured and used to more accurately compensate atmospheric pressure data to the appropriate elevation; default is altitude = 0 (sea level). It may take the plugin a couple of minutes before showing output data, as it will need to get a position before requesting data from the squid-sailing API. By default the plugin will update forecast information every hour based on the latest position with a potential given hourly offset. No information will be stored or tracked. The plugin shall adhere to meta-data units according to the SignalK definition.

API Note

While the squid-sailing software is functional and can be subscribed, the API-layer is still in BETA.

*** UPDATE *** Since beginning of 2024, the API-servers don't seem to be reachable any more.

Release Notes

  • v0.1 - initial version
  • v0.2 - dependencies update

About

Plugin to inject forecast data from SquidSailing service

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%