This is a plugin for the Homebridge server, which maps API keys of a Signal K server to matching HomeKit devices.
Use this plugin to read and in case of switches and dimmers even control your boat's devices from your iPhone, iPad, Apple Watch, Apple TV or HomePod. Having an Apple TV 4 or HomePod in your LAN you can read and control even remotely.
The plugin fills the gap between Homebridge and Signal K, so you need both up and running:
The plugin maps the following Signal K API keys to suitable HomeKit devices:
The following Signal K standard keys are mapped to temperature and humidity sensors:
/environment/outside/temperature/
/environment/inside/temperature/
/environment/inside/engineRoom/temperature/
/environment/inside/mainCabin/temperature/
/environment/inside/refrigerator/temperature/
/environment/inside/freezer/temperature/
/environment/inside/heating/temperature/
/environment/water/temperature/
/propulsion/port/temperature/
/propulsion/starboard/temperature/
/environment/outside/humidity/
/environment/inside/humidity/
/environment/inside/engineRoom/relativeHumidity/
/environment/inside/mainCabin/relativeHumidity/
/environment/inside/refrigerator/relativeHumidity/
/environment/inside/freezer/relativeHumidity/
/environment/inside/heating/relativeHumidity/
The following Signal K standard keys for tanks are mapped to humidity sensors:
/tanks/*
HomeKit does not support tank sensors yet, so a humidity sensor is the best matching device showing percentages. Tanks on low level (freshwater, fuel, lubrication, live well, gas, ballast) or high level (wastewater, blackwater) show a low battery warning.
The following Signal K standard keys for batteries and chargers are mapped to humidity sensors and switches:
/electrical/batteries/*
/electrical.chargers.<#>.mode
/electrical.chargers.<#>.capacity.stateOfCharge
HomeKit does not support batteries as stand alone devices yet, so a humidity sensor is the best matching device showing percentages representing the state of charge. Batteries on low level show a low battery warning.
Keys generated by the Signal K EmpirBus NXT plugin are mapped to switches and dimmers:
/electrical/switches/empirBusNxt-instance-dimmer/
/electrical/switches/empirBusNxt-instance-switch/
EmpirBus NXT switches connected to sensors can be mapped to HomeKit leak sensors by marking as device type leak sensor (see section optional parameters deviceTypes).
Keys generated by the Signal K Venus plugin are mapped to switches and dimmers:
/electrical/switches/venus-0/
/electrical/switches/venus-1/
Know issue: Venus GX meta data is not processed.
Keys generated by the Signal K Raspberry Pi Temperature plugin are mapped to temperature sensors:
/cpu/temperature/
Signal K Raspberry Pi Temperature plugin
The plugin awaits and accepts the following settings in the Homebridge config.json file:
"platform" : "SignalK"
"host": "127.0.0.1:3000" IP address and port of Signal K server
"name" : "NameOfVessel"
"ssl": false Set to true if Signal K server is awaiting connections via SSL
"securityToken": "your.signalk.token.here" Signal K server security token (usually needed for write access)
"emptyBatteryVoltage" : "22.5" Battery SOC shown as 0% (ignored if SOC is reported from battery itself)
"lowBatteryVoltage" : "23.5" Low battery warning if battery voltage is at or below
"fullBatteryVoltage" : "26.5" Battery SOC shown as 100% (ignored if SOC is reported from battery itself)
"chargingBatteryVoltage" : "27.5"Battery shown as charging if battery voltage is at or above
"lowFreshWaterLevel" : "25.0" Low tank (battery) warning if tank level is at or below
"highWasteWaterLevel" : "75.0" Low battery warning if tank level is at or above
"highBlackWaterLevel" : "75.0" Low battery warning if tank level is at or above
"lowFuelLevel" : "50.0" Low tank (battery) warning if tank level is at or below
"lowLubricationLevel" : "50.0" Low tank (battery) warning if tank level is at or below
"lowLiveWellLevel" : "50.0" Low tank (battery) warning if tank level is at or below
"lowGasLevel" : "50.0" Low tank (battery) warning if tank level is at or below
"lowBallastLevel" : "50.0" Low tank (battery) warning if tank level is at or below
"removeDevicesNotPresent": false If set to true devices which are not present in API keys (after restart of Signal K server) are removed from HomeKit (at start of Homebridge server). Set to false to prevent devices disappearing after rebooting Raspberry Pi in case homebridge loads faster than the Signal K tree is filled.
"ignoredPaths": ["key","key"] List of API keys for which you don't want to have a device in HomeKit. Devices will be deleted from HomeKit if already present.
"displayNames": {"key":"Display Name","key":"Display Name"} List of API keys and respective display names to display for them in HomeKit. Saves the effort to rename devices in HomeKit manually. Spaces and Umlauts are allowed.
"deviceTypes": {"key":"device type","key":"device type"} List of API keys and respective device types to be mapped to in HomeKit. Currently only EmpirBus NXT keys are processed and device type can be leakSensor only.
To monitor communication with Signal K start HomeBridge with DEBUG environment variable:
DEBUG=* homebridge
DEBUG=homebridge-signalk:http Signal K API requests
DEBUG=homebridge-signalk:websocket Signal K WebSocket updates
Use #homebridge channel on the Signal K Slack.