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.
• BlueSolar MPPT chargers (but untested in production).
• Orion Smart DC/DC chargers/converters.

Installation

• Before installing, you need to have python3 installed, with a working venv module.
  • On Debian/Ubuntu/Raspbian, this means installing the python3-venv package.
• 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.