Skip to content

Effortlessly logs sails, automatically capturing trips, moorages, dockings and anchorages with no additional need to stop/start anything.

License

Notifications You must be signed in to change notification settings

xbgmsharp/signalk-postgsail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Signal K PostgSail plugin

PostgSail effortlessly logs your voyages, automatically capturing your trips, moorages, dockings and anchorages with no additional need to stop/start anything. Built for sailors, motorboats and commercial uses.

Send, monitor, alert, observe all numeric values & positions & status to a self-hosted or cloud instances of PostgSail (PostgreSQL, Grafana).

Description

Signal K server plugin to send all self SignalK numeric data and navigation entry to a PostgSail server.

Demo

demo.mp4

Features

  • Automatically log your voyages without manually starting or stopping a trip.
  • Automatically capture the details of your voyages (boat speed, heading, wind speed, etc).
  • Timelapse video your trips, with or without time control.
  • Add custom notes to your logs.
  • Export to CSV, GPX, GeoJSON, KML and download your logs.
  • Export your logs as image (PNG) or video (MP4).
  • Aggregate your trip statistics: Longest voyage, time spent at anchorages, home ports etc.
  • See your moorages on a global map, with incoming and outgoing voyages from each trip.
  • Monitor your boat (position, depth, wind, temperature, battery charge status, etc.) remotely.
  • History: view trends.
  • Alert monitoring: get notification on low voltage or low fuel remotely.
  • Notification via email or PushOver, Telegram.
  • Offline mode.
  • Low Bandwidth mode.
  • Awesome statistics and graphs.
  • Create and manage your own dashboards.
  • Windy PWS (Personal Weather Station).
  • Engine Hours Logger.
  • Polar performance.
  • Anything missing? just ask!

Optional dependencies

signalk-autostate by @meri-imperiumi. Used to determine the vessel's state based on sensor values, and updates the navigation.state value accordingly.

The signalk-derived-data and signalk-path-mapper plugins are both useful to remap available data to the required canonical paths.

Source data

The following SignalK paths are used by PostgSail to generate logbook and monitoring. SignalK Keys Reference (Vessel)

SignalK path Timeline name Notes
navigation.state use for trip start/end and motoring vs sailing
navigation.courseOverGroundTrue Course
navigation.headingTrue Heading
navigation.speedThroughWater
navigation.speedOverGround Speed
environment.wind.directionTrue Wind
environment.wind.speedTrue Wind
environment.wind.speedOverGround Wind
environment.*.pressure Baro Pressure in zone
environment.*.temperature Temp
environment.*.relativeHumidity Ratio 1 = 100%
environment.water.swell.state Sea
navigation.position Coordinates
navigation.log Log If present, used to calculate distance
propulsion.*.runTime Engine If present, used to calculate engine hour usage
steering.autopilot.state Autopilot changes are logged.
navigation.state If present, used to start and stop automated hourly entries. Changes are logged.
propulsion.*.state Propulsion changes are logged.
electrical.batteries.*.voltage Voltage measured
electrical.batteries.*.current Current measured
electrical.batteries.*.stateOfCharge ratio State of charge, 1 = 100%
electrical.solar.* Solar measured
tanks.*.currentLevel Level of fluid in tank 0-100%
tanks.*.capacity.* Total capacity

The signalk-derived-data and signalk-path-mapper plugins are both useful to remap available data to the required canonical paths.

Cloud

Optional, create a free account on iot.openplotter.cloud.

Self-hosted

Host your own PostgSail server.

Development

Cloud development

A full-featured development environment ready to test and code.

With DevPod

About

Effortlessly logs sails, automatically capturing trips, moorages, dockings and anchorages with no additional need to stop/start anything.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published