Skip to content

Simple Signal K Node server plugin to read data from Victron devices using Instant Data over BLE

License

Notifications You must be signed in to change notification settings

stefanor/signalk-victron-ble

Repository files navigation

signalk-victron-ble

A SignalK plugin that reads Victron data over Instant Readout Bluetooth Low Energy (BLE) messages.

This is built on top of the victron_ble Python library, by Keshav Varma.

Currently supported:

  • BMV 712 Battery Monitors.
  • Battery Sense.
  • BlueSolar MPPT chargers (with VE.Direct Bluetooth dongle)
  • Inverters (untested).
  • Lynx Smart BMS.
  • MultiPlus inverters (with VE.Bus Bluetooth dongle, untested)
  • Orion Smart DC/DC chargers/converters.
  • Orion XS DC/DC chargers/converters.
  • Smart Lithum batteries.
  • Smart Shunts.
  • Smart Solar MPPT chargers.

Installation

  • Before installing, you need to have python3 installed, with a working venv module.
    • On Debian/Ubuntu/Raspberry Pi OS, this means installing the python3-venv package.
    • Supported Python 3 versions: >= 3.9
  • Install this plugin through SignalK / npm.
  • Use the native Victron app to obtain advertisement keys for communicating with your Victron devices. There are instructions for this here.
  • Configure each Victron device in the SignalK plugin settings:
    • Decide on a SignalK ID for the battery/device/bus, e.g. house.
    • Provide the Bluetooth MAC address of the device.
    • Provide the advertisement key for the device.
    • If appropriate, provide a secondary battery ID. e.g. start for a BMV that is connected to a house bank and start bank.
  • Restart SignalK.

Development

  • clone the plugin from Github
  • npm link in the plugin directory
  • npm link signalk-victron-ble in your server directory

License

Copyright 2022-2023 Stefano Rivera stefano@rivera.za.net

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.