NavNet Expert

D5.0

Expertise for the NavNet SignalK server on Distant Shores II - the navigation network that handles GPS, instruments, environmental data, battery monitoring, and autopilot integration.

intermediateCoding & Developmentcodingclaude-skill
Get This Skill on GitHub

Overview


name: navnet-expert description: NavNet SignalK navigation network expertise for Distant Shores II. Use when working with the NavNet SignalK server (192.168.22.16), navigation data integration, environmental sensors, Victron battery/solar monitoring, Raymarine autopilot, AIS, weather data, fuel tracking, or custom plugin development for the navigation network. Covers vessel-specific data paths, installed plugins, data sources, and integration patterns.

NavNet Expert

Expertise for the NavNet SignalK server on Distant Shores II - the navigation network that handles GPS, instruments, environmental data, battery monitoring, and autopilot integration.

Quick Reference

Server Details

SettingValue
HostnameDSIInav
IP Address192.168.22.16
Port80
SignalK Version2.19.1
WebSocketws://192.168.22.16/signalk/v1/stream
TCPtcp://192.168.22.16:8375

Quick Commands

# SSH access
ssh doug@192.168.22.16

# Query API
curl http://192.168.22.16/signalk/v1/api/vessels/self

# Get position
curl http://192.168.22.16/signalk/v1/api/vessels/self/navigation/position

# Get wind data
curl http://192.168.22.16/signalk/v1/api/vessels/self/environment/wind

Vessel Info

PropertyValue
NameDistant Shores II
MMSI316029463
Call SignCFN7093
LOA15.11m (~49.5ft)
Beam4.2m
Draft3m max
Air Height20.42m
AIS TypeSailing (ID 36)

Data Categories

Navigation Paths

PathDescription
navigation.positionGPS position (lat/lon)
navigation.speedOverGroundSOG in m/s
navigation.speedThroughWaterSTW in m/s
navigation.courseOverGroundTrueCOG true in rad
navigation.headingMagneticHeading magnetic in rad
navigation.headingTrueHeading true in rad
navigation.magneticVariationLocal variation in rad
navigation.rateOfTurnROT in rad/s
navigation.attitudePitch/roll/yaw
navigation.gnssGPS satellite info
navigation.tripTrip log data
navigation.logTotal log data

Environment Paths

PathDescription
environment.wind.speedApparentAWS in m/s
environment.wind.angleApparentAWA in rad
environment.wind.speedTrueTWS in m/s
environment.wind.directionTrueTWD in rad
environment.depth.surfaceToTransducerDepth offset
environment.water.temperatureWater temp in K
environment.outside.temperatureAir temp in K
environment.outside.pressureBarometric in Pa
environment.currentCurrent set/drift
environment.tideTide height
environment.sun / environment.moonCelestial data
environment.forecastWeather forecast

Electrical Paths

PathDescription
electrical.batteries.{id}.voltageBattery voltage
electrical.batteries.{id}.currentBattery current
electrical.batteries.{id}.stateOfChargeSOC (0-1)
electrical.solar.{id}.panelPowerSolar panel output
electrical.solar.totalPowerTotal solar power
electrical.solar.yieldTodayToday's solar yield

Battery IDs: 11, 12, 21, 22, 31, 32, 41, 42, 51, 61, 62, 239, 240, 338, 357, 65L, JSE, 6ZT, RJN

Solar IDs: archprt, archstb, fwdprt, fwdstb, archInside, archOutside

Propulsion Paths

PathDescription
propulsion.engine.fuelUsedTotal fuel used (m³)
propulsion.engine.burnRateCurrent burn rate
propulsion.engine.fuelThisSessionSession fuel use

Tank Paths

PathDescription
tanks.fuel.{id}.currentLevelFuel level (0-1)
tanks.freshWater.{id}.currentLevelWater level
tanks.blackWater.{id}.currentLevelHolding tank

Steering/Autopilot

PathDescription
steering.autopilot.stateAP state (standby/auto)
steering.autopilot.engagedAP engaged boolean
steering.autopilot.modeAP mode
steering.autopilot.defaultPilotraymarineN2K

Data Sources

Hardware Sources

SourceDescription
NavNetFuruno NavNet network gateway
raymarineN2KRaymarine autopilot on NMEA 2000
Victron SmartSolar MPPT VESolar charge controllers
Victron Smart Lithium Battery 12Lithium battery BMS

Plugin Sources

SourceDescription
signalk-logbookVoyage logging
autopilot / autopilotApiAutopilot integration
derived-dataCalculated values
openweather-signalkWeather data
anchoralarmAnchor watch
fusionstereoEntertainment system
bt-sensors-plugin-skBluetooth temp sensors
signalk-node-redNode-RED automation
signalk-barometer-trendPressure trend
signalk-autostateState automation
tidesTide data
envirologEnvironmental logging
solarLoggingSolar production logging
fuelUseFuel consumption tracking
sheetsLogGoogle Sheets logging

BT Temperature Sensors

SensorLocation
Main CabinInterior temperature
outsideAmbient temperature
fridgeRefrigerator
freezerFreezer
engineroomEngine room

Custom Plugins Location

/mnt/usb/src/
├── envirolog/
├── fueluse/
├── signalk-openweather-plugin/  (symlinked as openweather-signalk)
├── sheetslog/
└── solarlogging/

Custom Plugin Symlinks

Custom plugins are symlinked into node_modules to survive npm updates:

# Current symlinks
/home/doug/.signalk/node_modules/openweather-signalk -> /mnt/usb/src/signalk-openweather-plugin

Restore Script

After npm install/update operations, run the restore script:

/home/doug/.signalk/restore-plugin-symlinks.sh && sudo systemctl restart signalk

Preventing "Update Available" for Custom Plugins

To prevent SignalK UI showing custom plugins as needing updates, bump the version in the plugin's package.json higher than the npm version:

# Check npm version
npm view openweather-signalk version

# Edit custom plugin's package.json to be higher (e.g., 1.1.0-custom)
# The "-custom" suffix indicates it's a modified fork

See references/custom-plugins.md for full details.

Detailed References

Key Documentation

ResourceURL
SignalK Specificationhttps://signalk.org/specification/latest/
Victron VE.Directhttps://www.victronenergy.com/live/vedirect_protocol:faq
Raymarine SeaTalk NGRaymarine documentation

What This Skill Can Do

AI-generated examples showing real capabilities

Ready to use this skill?

Visit the original repository to get the full skill configuration and installation instructions.

View on GitHub

Related Skills