victronconnect:start
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
victronconnect:start [2019-09-08 10:30] – [BlueSolar MPPT Charge controllers] mvader | victronconnect:start [2020-07-01 15:24] – [9.2 Updating to a self-supplied firmware file] evandromr | ||
---|---|---|---|
Line 6: | Line 6: | ||
VictronConnect is available for Android, iOS, Windows, and macOS X. | VictronConnect is available for Android, iOS, Windows, and macOS X. | ||
- | It can connect to Victron products via Bluetooth, USB and WiFi/ | + | It can connect to Victron products via Bluetooth, USB and WiFi/ |
=== Documentation === | === Documentation === | ||
- | See the table of contents for all information covered in this document. | + | See the table of contents for all general VictronConnect |
- | Other relevant documents are: | + | Other product specific |
- | * [[https:// | + | [[https:// |
- | * [[https://docs.victronenergy.com/ | + | |
+ | [[https:// | ||
+ | |||
+ | [[https:// | ||
===== 2. Download and installation ===== | ===== 2. Download and installation ===== | ||
VictronConnect is available to users of Windows PCs, macOS X, iOS and Android phones, as well as tablets. | VictronConnect is available to users of Windows PCs, macOS X, iOS and Android phones, as well as tablets. | ||
+ | |||
+ | Also, [[https:// | ||
+ | |||
+ | See [[# | ||
===== 3. Connecting ===== | ===== 3. Connecting ===== | ||
Line 26: | Line 32: | ||
There are three ways to connect to a Victron product: | There are three ways to connect to a Victron product: | ||
^ Method | ^ Method | ||
- | | Products with built-in | + | | Products with built-in |
| [[ve.direct: | | [[ve.direct: | ||
| [[https:// | | [[https:// | ||
Line 37: | Line 43: | ||
==== 3.1 Bluetooth Smart - Pairing and Connecting ==== | ==== 3.1 Bluetooth Smart - Pairing and Connecting ==== | ||
- | - Enable the Bluetooth setting on your device, but do not pair outside of VictronConnect. | + | To connect to your Victron product, over Bluetooth, always connect from within |
- | - Open VictronConnect | + | |
- | - On your Phone or Tablet: pull down the screen, or tap the refresh button to initiate a scan. | + | Here is how to connect: |
- | - On your Computer or Laptop: click the "Scan or Refresh" | + | |
- | - The first time you attempt | + | |
- | - Connection is complete. | + | |
- | If connection was not successful please refer to section [[#9._Troubleshooting|9. Troubleshooting]] below. | + | - Enable the Bluetooth on your phone. |
+ | - Open VictronConnect, | ||
+ | - On a phone or tablet, pull down the screen, or tap the refresh button | ||
+ | - On a computer or laptop: click the "Scan or Refresh" | ||
+ | - The first time you attempt to connect the phone will ask to pair with the Victron product. Enter the PIN code. The default PIN code is 000000 | ||
+ | - The connection is complete. | ||
- | Note: Always connect from within VictronConnect. Do not connect from the device' | + | If the connection was not successful please refer to section [[# |
==== 3.2 Bluetooth Smart - Changing the PIN code ==== | ==== 3.2 Bluetooth Smart - Changing the PIN code ==== | ||
- | **To prevent unauthorised connections to your device we recommend you change the PIN code. Avoid using obvious PIN codes such as 111111 or 123456.** | ||
- | To change the PIN code, first complete your connection. Then go to the **Product info** page. To access that page, click the button on the upper right. For some products it will be the settings icon: {{: | + | To prevent unauthorised connections to your Victron product we recommend you change the PIN code. Avoid using obvious PIN codes such as 111111 or 123456. |
+ | |||
+ | To change the PIN code, first, complete your connection. Then go to the **Product info** page. To access that page, click the button on the upper right. For some products, it will be the settings icon: {{: | ||
For other products you'll find the {{: | For other products you'll find the {{: | ||
- | On this page, select the change | + | On this page, select the change |
- | Note that after changing the pin code, all other phones, tablets, and laptops | + | Note that after changing the PIN code, all other phones connected to the Victron product need to have their pairing information refreshed; and first, the old pairing information needs to be removed. See [[#3.4 Bluetooth Smart - Removing from the list of paired devices |
==== 3.3 Bluetooth Smart - Resetting the PIN code ==== | ==== 3.3 Bluetooth Smart - Resetting the PIN code ==== | ||
Line 70: | Line 79: | ||
=== Blue Smart Chargers IP22 === | === Blue Smart Chargers IP22 === | ||
- | On the device list: Press and hold the product description | + | On the device list: tap or click the three-dots menu on the right side of the product description. A menu will pop up offering a 'Reset PIN code' option. Click that, and enter the PUK code. The PUK code can be found on the product label, on the back of the product. |
- | + | ||
- | On a desktop (Windows, Mac), 'right click' the product description instead of pressing and holding. | + | |
It can also be done on the charger itself:\\ | It can also be done on the charger itself:\\ | ||
Line 78: | Line 85: | ||
=== Blue Smart Chargers IP67 === | === Blue Smart Chargers IP67 === | ||
- | On the device list: Press and hold the product description | + | On the device list: tap or click the three-dots menu on the right side of the product description. A menu will pop up offering a 'Reset PIN code' option. Click that, and enter the PUK code. The PUK code can be found on the product label, on the back of the product. |
- | + | ||
- | On a desktop (Windows, Mac), 'right click' the product description instead of pressing and holding. | + | |
=== Smart Solar Charger === | === Smart Solar Charger === | ||
- | On the device list: Press and hold the product description | + | On the device list: tap or click the three-dots menu on the right side of the product description. A menu will pop up offering a 'Reset PIN code' option. Click that, and enter the PUK code. The PUK code can be found on the product label, on the back of the product. |
- | + | ||
- | On a desktop (Windows, Mac), 'right click' the product description instead of pressing and holding. | + | |
=== BMV-712 Smart === | === BMV-712 Smart === | ||
- | On the device list: Press and hold the product description | + | On the device list: tap or click the three-dots menu on the right side of the product description. A menu will pop up offering a 'Reset PIN code' option. Click that, and enter the PUK code. The PUK code can be found on the product label, on the back of the product. |
- | + | ||
- | On a desktop (Windows, Mac), 'right click' the product description instead of pressing and holding. | + | |
=== Smart LiFePO4 Batteries === | === Smart LiFePO4 Batteries === | ||
- | On the device list: Press and hold the product description | + | On the device list: tap or click the three-dots menu on the right side of the product description. A menu will pop up offering a 'Reset PIN code' option. Click that, and enter the PUK code. The PUK code can be found on the product label, on the back of the product. |
- | + | ||
- | On a desktop (Windows, Mac), 'right click' the product description instead of pressing and holding. | + | |
+ | === SmartShunts === | ||
+ | On the device list: tap or click the three-dots menu on the right side of the product description. A menu will pop up offering a 'Reset PIN code' option. Click that, and enter the PUK code. The PUK code can be found on the product label, on the back of the product. | ||
==== 3.4 Bluetooth Smart - Removing from the list of paired devices ==== | ==== 3.4 Bluetooth Smart - Removing from the list of paired devices ==== | ||
- | You may want or need to remove a product from the list of Bluetooth paired devices on your phone/ | + | You may want or need to remove a product from the list of Bluetooth paired devices on your phone. For example, if the PIN code of your product has been changed on a different |
- | To remove the pairing information you will need to go to your device's Bluetooth settings. Watch the videos below to learn how to remove the pairing information from iOS and Android devices: | + | To remove the pairing information you will need to go to your phone's Bluetooth settings. Watch the videos below to learn how to remove the pairing information from iOS and Android devices: |
=== Remove Bluetooth pairing on iOS devices: === | === Remove Bluetooth pairing on iOS devices: === | ||
Line 115: | Line 116: | ||
===== 4. Phone, tablet and laptop compatibility ===== | ===== 4. Phone, tablet and laptop compatibility ===== | ||
==== 4.1 Windows PC === | ==== 4.1 Windows PC === | ||
- | Windows 7, Windows 8, Windows 10 | ||
- | *(Downloads for VictronConnect for users of Windows XP / Vista are still available in archive - but unsupported.) | ||
- | On Windows, | + | VictronConnect requires |
- | ==== 4.2 macOS X === | + | |
- | The earliest supported macOS version is: 10.10 (OS X Yosemite). | + | Note that on Windows, |
- | *(Downloads for VictronConnect | + | |
- | To connect to a Victron device over Bluetooth, rather then via USB, the Mac needs to have Bluetooth 4.0 aka Bluetooth Smart. | + | ==== 4.2 macOS X === |
- | ==== 4.3 Android devices | + | |
- | The minimum required Android | + | Todays |
- | The minimum required Android | + | For the older macOS 10.11/ |
- | Required hardware is ARMv7 and later, as well as x86. | + | To connect to a Victron product with Bluetooth, the Apple Laptop needs to have Bluetooth 4.0 aka Bluetooth Smart. |
+ | ==== 4.3 Android devices === | ||
- | === Android | + | Android |
- | You may find that USB On-The-Go (USB OTG) does work on devices with Android 4.1 or 4.2. | + | An older version of VictronConnect |
- | Even though some devices have Bluetooth 4.0 aka Bluetooth Smart hardware, | + | The required |
- | === Android | + | === Notes for Android |
+ | Android 5 devices with a 64bit CPU will experience a crash at startup due to an issue in the libraries we use to develop VictronConnect. This is not expected to be fixed. A workaround for this issue is to manually install the VictronConnect APK that can be downloaded in the [[https:// | ||
- | No known issues. | + | The pairing does not work on some phones running Android 5. The PIN code popup does not appear, or it appears without a text field to enter the PIN code. If you have this situation, your phone might report that it has been paired with the Victron product - but it has not. |
- | === Android 5 === | + | Unfortunately, this is a bug in Android over which we have no control, and are therefore unable to fix. |
- | The pairing does not work on some devices running Android 5. The pin code popup does not appear, or it appears without a text field to enter the PIN code. If you have this situation on your device, the phone/ | + | |
- | + | ||
- | Unfortunately | + | |
Devices where we have seen this issue are: | Devices where we have seen this issue are: | ||
Line 153: | Line 148: | ||
* Medion tablet with Android 5.0 | * Medion tablet with Android 5.0 | ||
- | === Android 6 and later === | + | === Notes for Android 6 and later === |
No known issues, when Access to Locations services are enabled. | No known issues, when Access to Locations services are enabled. | ||
- | === Access to location services required? === | + | === Why is Access to location services required? === |
- | Android 5 and later requires access permission for VictronConnect to the (coarse) location services. Otherwise it can not scan for the Bluetooth | + | Android 5 and later requires access permission for VictronConnect to the (coarse) location services. Otherwise it can not scan for the Bluetooth |
Besides permitting access to its data, the location services also need to be enabled in many (but not all) cases. | Besides permitting access to its data, the location services also need to be enabled in many (but not all) cases. | ||
- | Note that after enabling location services, the GPS itself, can be switched off again: the Android location services are more than GPS. Bluetooth, and WiFi-, scan results can technically also be used to approximate the devices | + | Note that after enabling location services, the GPS itself, can be switched off again: the Android location services are more than GPS. Bluetooth, and WiFi-, scan results can technically also be used to approximate the phone' |
- | Despite above, you can be sure that Victron is not interested in, nor tracking your location. | + | Despite |
- | Being sensitive to privacy issues at Victron ourselves, we are not happy with this requirement. But there is nothing we can do about it unfortunately. | + | Being sensitive to privacy issues at Victron ourselves, we are not happy with this requirement. But there is nothing we can do about it, unfortunately. More information |
- | + | ||
- | More information [[https:// | + | |
=== List of known non-compatible Android devices === | === List of known non-compatible Android devices === | ||
Line 187: | Line 180: | ||
Google Nexus 6P; LG G4; Sony Xperia Z5; HTC One M9; HTC One S9; OnePlus 3T; Asus Zenfone 2; Samsung Galaxy S5; Samsung Galaxy S5 mini; Samsung Galaxy S7; Samsung Galaxy S8; Samsung Galaxy Tab E 9.6. | Google Nexus 6P; LG G4; Sony Xperia Z5; HTC One M9; HTC One S9; OnePlus 3T; Asus Zenfone 2; Samsung Galaxy S5; Samsung Galaxy S5 mini; Samsung Galaxy S7; Samsung Galaxy S8; Samsung Galaxy Tab E 9.6. | ||
- | *Assumes the device | + | *Assumes the phone runs the latest firmware released by the manufacturer. |
==== 4.4 Apple iOS iPhones and iPads === | ==== 4.4 Apple iOS iPhones and iPads === | ||
- | VictronConnect works on the following iPhones and iPads, which have Bluetooth 4.0 (BT LE).\\ (iOS 8 or later required): | + | VictronConnect works on the following iPhones and iPads running |
- | * iPhone | + | * iPhone |
- | * iPad, 3rd generation and later | + | * iPad mini 2 and later |
+ | * iPad (5th generation) and later | ||
+ | * iPod touch (6th generation) and later | ||
Unfortunately Apple iPhone/iPad doesn' | Unfortunately Apple iPhone/iPad doesn' | ||
+ | |||
+ | ==== 4.5 Linux ==== | ||
+ | |||
+ | Details [[https:// | ||
+ | |||
+ | ==== 4.6 Archive of previous versions ==== | ||
+ | |||
+ | It would be nice to forever support all existing versions of Android, iOS, Windows, and other systems. But unfortunately, | ||
+ | |||
+ | In such a situation, we recommend updating your phone to the latest OS. For situations where that is not possible we make these older versions available: | ||
+ | |||
+ | **Warning: | ||
+ | |||
+ | |**OS Version** | **Download link** | | ||
+ | | Windows XP and Windows Vista | [[https:// | ||
+ | | Android 4.3 to 4.4.4 armv7 architecture | [[https:// | ||
+ | | Android 4.3 to 4.4.4 x86 architecture | ||
+ | | macOS 10.9 (OS X Mavericks) | [[https:// | ||
+ | | macOS 10.10, 10.11 & 10.12 (OS X Yosemite / Sierra) | [[https:// | ||
+ | |||
===== 5. Application overview ===== | ===== 5. Application overview ===== | ||
Line 200: | Line 215: | ||
**Device list**\\ | **Device list**\\ | ||
- | This page shows all the Victron products that have been discovered by your device, and to which a connection can be made. Click on the desired product. | ||
- | {{: | + | LOCAL - This page shows all the Victron products that have been discovered by your phone, and to which a connection can be made. Click on the desired product. |
+ | |||
+ | {{: | ||
+ | |||
+ | VRM - This page will show a GX product if it is connected to your VRM account. | ||
+ | |||
+ | {{: | ||
**Battery Monitor pages**:\\ | **Battery Monitor pages**:\\ | ||
- | Clicking on ' | + | Clicking on ' |
*To access ' | *To access ' | ||
From ' | From ' | ||
Line 221: | Line 241: | ||
Clicking on your Solar Charge Controller product allows you to view the current charging status. | Clicking on your Solar Charge Controller product allows you to view the current charging status. | ||
*To access ' | *To access ' | ||
- | ' | + | ' |
For a full explanation of the Solar Charge Controller options follow [[https:// | For a full explanation of the Solar Charge Controller options follow [[https:// | ||
Line 236: | Line 256: | ||
**Phoenix Inverter pages**\\ | **Phoenix Inverter pages**\\ | ||
- | Clicking on the Phoenix Inverter allows you to view dynamic data such as power-draw of connected loads; a power bar will show how hard your inverter is working; and you will find information such as battery voltage etc. | + | Clicking on the Phoenix Inverter allows you to view dynamic data such as power-draw of connected loads; a power bar will show how hard your inverter is working, and you will find information such as battery voltage, etc. |
*To access ' | *To access ' | ||
- | ' | + | ' |
{{: | {{: | ||
Line 245: | Line 265: | ||
**Blue Smart IP65 charger pages**\\ | **Blue Smart IP65 charger pages**\\ | ||
- | The Blue Smart IP65 battery charger comes with Bluetooth already built in. When the Blue Smart charger is powered-up it will be discoverable using the VictronConnect app on your device. (Except Windows PC - See **3.1 Windows PC**, above). | + | The Blue Smart IP65 battery charger comes with Bluetooth already built-in. When the Blue Smart charger is powered-up it will be discoverable using the VictronConnect app on your phone. (Except Windows PC - See **3.1 Windows PC**, above). |
- | The ' | + | The ' |
*To access ' | *To access ' | ||
Line 258: | Line 278: | ||
**Lithium Batteries Smart**\\ | **Lithium Batteries Smart**\\ | ||
- | Lithium Batteries Smart have Bluetooth built-in. Clicking on the Lithium battery from the Device list will allow you to view live data about the battery status, voltage and temperature. You will also see the voltage of each cell - which is an essential guide to battery health. | + | Lithium Batteries Smart have Bluetooth built-in. Clicking on the Lithium battery from the Device list will allow you to view live data about the battery status, voltage, and temperature. You will also see the voltage of each cell - which is an essential guide to battery health. |
*To access ' | *To access ' | ||
From ' | From ' | ||
Line 271: | Line 291: | ||
**Windows**\\ | **Windows**\\ | ||
- | Here is a VictronConnect app screenshot from a device | + | Here is a VictronConnect app screenshot from a PC using a version of the Microsoft Windows operating system showing information from an MPPT. |
{{: | {{: | ||
Line 277: | Line 297: | ||
**macOS X**\\ | **macOS X**\\ | ||
- | Here is a VictronConnect app screenshot from a device | + | Here is a VictronConnect app screenshot from a PC running the Mac Operating System showing information from an MPPT. |
{{: | {{: | ||
Line 285: | Line 305: | ||
**Blue Smart IP65 Charger ** | **Blue Smart IP65 Charger ** | ||
- | This video will show you how to download the VictronConnect app onto a smart phone (in the video we use an iPhone). It will also show you how to use the app to view information and control the settings of a BlueSmart | + | This video will show you how to download the VictronConnect app onto a smart phone (in the video we use an iPhone). It will also show you how to use the app to view information and control the settings of a Blue Smart IP65 charger. |
Line 298: | Line 318: | ||
{{youtube> | {{youtube> | ||
- | ==== 5.3 Renaming your devices | + | ==== 5.3 Renaming your products |
- | It is possible to change the name of your devices | + | It is possible to change the name of your Victron product |
- | To change the name: First complete your connection; then go to the **Product info** page. To access that page, click the button on the upper right. For some products it will be the settings icon: {{: | + | To change the name: First, complete your connection; then go to the **Product info** page. To access that page, click the button on the upper right. For some products, it will be the settings icon: {{: |
For other products you'll find the {{: | For other products you'll find the {{: | ||
Line 311: | Line 331: | ||
- | ==== 5.4 Importing | + | ==== 5.4 How to disable |
- | VictronConnect for Mac OSX and Windows | + | All our products that have Bluetooth built-in, have a feature that allows |
- | {{: | + | In most cases, it's also possible to re-enable Bluetooth after disabling. For example by using a VE.Direct cable. |
- | {{:victronconnect: | + | There are, however, a few exceptions: |
+ | * The [[# | ||
+ | * The [[# | ||
- | This feature is not available in the iOS mobile version of VictronConnect. | + | === Finding |
+ | First, complete your connection; then go to the **Product info** page by clicking the button on the upper right: | ||
+ | |||
+ | * For some products, it will be the settings icon: {{: | ||
+ | * For other products you'll find the {{: | ||
+ | |||
+ | If the product has the feature that Bluetooth can be disabled, you will see the field " | ||
+ | |||
+ | For some products, a Disable button is shown instead of a toggle switch. | ||
+ | |||
+ | === How to re-enable Bluetooth === | ||
+ | |||
+ | // | ||
+ | |||
+ | There are a few different ways to re-enable Bluetooth depending on your product, always check the manual of your product for more detailed instructions: | ||
+ | |||
+ | == Re-enable Bluetooth using VE.Direct == | ||
+ | |||
+ | Connect the product with a VE.Direct to USB cable to your phone and use VictronConnect to re-enable Bluetooth in the **Product Info** page (see [[# | ||
+ | |||
+ | == Re-enable Bluetooth using the MODE button on the product == | ||
+ | |||
+ | Press and hold the MODE button on the product for 10 seconds will perform a Bluetooth reset. This means that the following actions will be executed: | ||
+ | * Bluetooth will be re-enabled | ||
+ | * The connected Bluetooth product will be disconnected | ||
+ | * The PIN code is reset to its [[# | ||
+ | * The pairing information is cleared; this requires [[victronconnect: | ||
+ | |||
+ | == Lithium Smart batteries == | ||
+ | The product page can be found [[https:// | ||
+ | Once Bluetooth is disabled, it is disabled **permanently** and is **irreversible**. This means that VictronConnect will ask for a confirmation code displayed in the dialogue; if you are sure that you want to permanently disable Bluetooth, enter the code displayed, and choose " | ||
+ | |||
+ | == Phoenix Smart IP43 Chargers == | ||
+ | The product page can be found [[https:// | ||
+ | Once Bluetooth is disabled, there are multiple ways to re-enable it again: | ||
+ | - Using the [[# | ||
+ | - Using a [[# | ||
+ | |||
+ | == Blue Smart IP22 Chargers == | ||
+ | The product page can be found [[https:// | ||
+ | Once Bluetooth is disabled, it can be re-enabled with the [[# | ||
+ | |||
+ | == Blue Smart IP65 Chargers == | ||
+ | The product page can be found [[https:// | ||
+ | Once Bluetooth is disabled, it can be re-enabled with the [[# | ||
+ | |||
+ | == Blue Smart IP67 Chargers == | ||
+ | The product page can be found [[https:// | ||
+ | For these chargers there are two options: | ||
+ | * Disable Bluetooth **permanently**. This option is **irreversible** and VictronConnect will ask for a confirmation code displayed in the dialogue; if you are sure that you want to permanently disable Bluetooth, enter the code displayed and choose " | ||
+ | * Enable Bluetooth for 30 seconds at power-up. This allows you to connect to the product and to perform a firmware update or re-enable Bluetooth. If you do not connect within the first 30 seconds Bluetooth will be disabled. | ||
+ | |||
+ | == SmartSolar MPPTs == | ||
+ | The product page can be found [[https:// | ||
+ | Bluetooth can be re-enabled by connecting a VE.Direct to USB cable to your phone and following [[# | ||
+ | |||
+ | **Smart Battery Protect**\\ | ||
+ | The product page can be found [[https:// | ||
+ | Bluetooth can be disabled/ | ||
+ | |||
+ | **Smart BMV-712**\\ | ||
+ | The product page can be found [[https:// | ||
+ | The BMV-712' | ||
+ | |||
+ | **Smart BMS**\\ | ||
+ | The product page can be found [[https:// | ||
+ | Bluetooth is temporarily enabled at power-up for 30 seconds. You can connect within these 30 seconds to perform a firmware update or re-enable Bluetooth. If you do not connect within the first 30 seconds Bluetooth will be disabled. | ||
+ | |||
+ | **Smart Shunt**\\ | ||
+ | The product page can be found [[https:// | ||
+ | Bluetooth can be re-enabled by connecting a VE.Direct to USB cable to your phone and following [[# | ||
+ | ==== 5.5 Importing and converting a GX Product Family database File ==== | ||
+ | |||
+ | VictronConnect for Mac OSX and Windows allows you to import and convert the database log file (that is created by the VenusOS on the GX Product Family) to a Microsoft Excel XLSX file. This can be useful if the site is remote and without an internet connection to upload the file to the [[https:// | ||
+ | |||
+ | {{: | ||
+ | |||
+ | {{: | ||
+ | This feature is not available in the iOS and Android mobile versions of VictronConnect. | ||
Line 332: | Line 432: | ||
===== 7. Settings files ===== | ===== 7. Settings files ===== | ||
+ | |||
+ | ==== 7.1 Save, load, share and manage settings ==== | ||
This feature allows you to save product settings to a file so that they can be loaded onto the Victron product you are connected to ...or another product, at a later time. | This feature allows you to save product settings to a file so that they can be loaded onto the Victron product you are connected to ...or another product, at a later time. | ||
Line 337: | Line 439: | ||
** Save settings ** | ** Save settings ** | ||
- | Connect your device | + | Connect your phone to the Victron product, go to the ' |
{{: | {{: | ||
Line 344: | Line 446: | ||
** Load settings ** | ** Load settings ** | ||
- | Connect your device | + | Connect your phone to the Victron product, go to the ' |
- | When the file is loaded the changes | + | When the file is loaded, the changes |
{{: | {{: | ||
Line 355: | Line 457: | ||
** Share settings ** | ** Share settings ** | ||
- | The 'Share settings' | + | The 'Share settings' |
Also, settings you have already saved using VictronConnect are stored in a settings file and can be shared with other products through the ' | Also, settings you have already saved using VictronConnect are stored in a settings file and can be shared with other products through the ' | ||
** Settings file manager ** | ** Settings file manager ** | ||
- | The Settings file manager is located in the main menu. | + | The Settings file manager is located in the main menu, and shows all stored settings: |
{{: | {{: | ||
- | From here files can be opened, shared or removed. | + | From here files can be opened, shared or removed: |
{{: | {{: | ||
- | ** Open settings file ** | ||
- | When opening a file from the settings file manager a snapshot of the product at the point the setting file was saved is shown. | + | ==== 7.2 Settings files and the demo library ==== |
- | There is a constraint | + | The demo library can be a great tool for an installer to create a set of settings, and then share it to a customer whom can then apply it to their product. |
+ | |||
+ | Note that whilst saving settings from the demo library is possible, loading settings from within the demo library is not possible. | ||
+ | |||
+ | ==== 7.3 Limitation in opening | ||
+ | |||
+ | There are two methods to open a previously stored settings-file: | ||
+ | |||
+ | - From the settings file manager, as in the above screenshot, to see the settings without having to be connected to the product. A snapshot of all data, including voltage readings, history data, and so forth, will be loaded and visible to inspect. | ||
+ | - From the product settings pages, | ||
+ | |||
+ | Note that the first method only works when the settings | ||
- | This constraint only applies when opening files from the settings file manager for inspection. Loading files from a product settings page to restore it is always possible as long as VictronConnect version is equal or greater | ||
===== 8. Demo feature ===== | ===== 8. Demo feature ===== | ||
Line 382: | Line 493: | ||
The demo feature can be used to: | The demo feature can be used to: | ||
* Learn about the settings which are available on your Victron product. By exploring the library' | * Learn about the settings which are available on your Victron product. By exploring the library' | ||
- | * Create a specific product setup, save it ...and then send it to a customer so that they have those settings on their device, and can install them on their Victron product. | + | * Create a specific product setup, save it ...and then send it to a customer so that they have those settings on their phone, and can install them on their Victron product. |
* Besides loading products from the standard library, it is also possible to load them from a saved file using the ' | * Besides loading products from the standard library, it is also possible to load them from a saved file using the ' | ||
* Review settings made to your installations, | * Review settings made to your installations, | ||
Line 394: | Line 505: | ||
{{: | {{: | ||
- | To load a saved settings file as a demo, go to the ' | + | To load a saved settings file as a demo, go to the ' |
{{: | {{: | ||
===== 9. Firmware updates===== | ===== 9. Firmware updates===== | ||
==== 9.1 Introduction & automatic updates ==== | ==== 9.1 Introduction & automatic updates ==== | ||
+ | |||
+ | __What about updating Firmware on VE.Bus products such as MultiPlus and Quattro?__ | ||
+ | |||
+ | Please follow this [[https:// | ||
__How can I see what firmware version is available? | __How can I see what firmware version is available? | ||
- | Connect | + | First, connect to the product, then go to the **Product info** page. Under the Firmware version if you will see a text informing you if you are using the latest available version or if there is an update available. If a new version is available you can start the update process by pressing the " |
+ | |||
+ | Some firmware versions are mandatory, when you connect | ||
- | Or, when not close to the product, open the Demo library and select the product. The Product info page will show the latest available version that is shipped with VictronConnect. | + | Or, when not close to the product, open the Demo library, and select the product. The Product info page will show the latest available version that is shipped with VictronConnect. |
__Do I need to be connected to the internet for updating firmware?__ | __Do I need to be connected to the internet for updating firmware?__ | ||
- | No. Updating firmware does **not** require an internet connection, the latest Firmware files are already loaded inside VictronConnect, | + | No. Updating firmware does **not** require an internet connection, the latest Firmware files are already loaded inside VictronConnect, |
__How does it work?__ | __How does it work?__ | ||
- | After connecting your product, VictronConnect will automatically check whether | + | After connecting your product, VictronConnect will automatically check whether |
- | A firmware | + | If an update |
- | __Will I need to reconfigure my device after the update?__ | + | A firmware update |
- | + | ||
- | No. The settings of your product will not be affected by the firmware update | + | |
+ | __Will I need to reconfigure my MPPT or BMV after the update?__ | ||
+ | No. The settings of your VE.direct and Bluetooth products will not be affected by the firmware update ...and so you will not need to reconfigure your product after the update. Also, the History data of BMVs and MPPTs will be preserved throughout a firmware update. | ||
==== 9.2 Updating to a self-supplied firmware file ==== | ==== 9.2 Updating to a self-supplied firmware file ==== | ||
- | The previous chapter explained how VictronConnect will automatically update to the latest | + | The previous chapter explained how VictronConnect will automatically update to the latest firmware version. Besides that, it is also possible to update a product with a file that you supply |
This is not needed very often. Some reasons to do so could be: | This is not needed very often. Some reasons to do so could be: | ||
- | * Update to a very recent version, | + | * Update to a very recent version, |
- | * Update a product to a special version, such as the required to disable Bluetooth in the Lithium batteries. See the files in [[https:// | + | * Update a product to a special |
=== Instructions for Windows and MacOS computers === | === Instructions for Windows and MacOS computers === | ||
- | With your device | + | With your phone and Victron product |
+ | |||
+ | There is no need to worry about using a wrong file - VictronConnect will always first check if the file matches the product. And if wrong, it will show a "wrong firmware file error". | ||
{{: | {{: | ||
Line 441: | Line 560: | ||
=== Instructions for Android and iOS phones and tablets === | === Instructions for Android and iOS phones and tablets === | ||
- | Due to limitations on a mobile device the process is slightly different from the Windows/MacOS routine. | + | The process is slightly different from the Windows/macOS routine, as there is no file browser on a mobile device. |
- | Firstly, you need to add the desired firmware file to the VictronConnect firmware library. Firmware files can be added to the library from: an email attachment; web browser; Dropbox; file browser | + | Firstly, you need to add the desired firmware file to the VictronConnect firmware library. Firmware files can be added to the library from an email attachment, web browser, Dropbox, file browser, and any kind of app that can handle files. For both iOS and Android the procedure to add the file is the same: go to the app that contains the firmware file, tap on it, and open it with VictronConnect. VictronConnect will be opened and show: "File added to the firmware library" |
- | **Note | + | If the message doesn' |
- | **Note for Android**: VictronConnect needs to be running before opening files. | + | In case you are not sure which file to use, it is not a problem to add multiple files to the library. In the next step, VictronConnect will automatically only show the files that match with the connected product. |
- | Open VictronConnect and, without closing | + | |
+ | * **Note for iOS**: The current version of Google Chrome for iOS fails to download " | ||
+ | * **Note for Android**: VictronConnect needs to be running before opening files. | ||
+ | Open VictronConnect and, without closing it, switch to the app containing the file, select it, and choose to open it with VictronConnect. | ||
- | + | Here are screenshot showing | |
- | On both iOS and Android, go to the app that contains the firmware file, tap on it, and open it with VictronConnect. | + | |
{{: | {{: | ||
Line 458: | Line 578: | ||
{{: | {{: | ||
- | VictronConnect will be opened and should read: "File added to the firmware | + | Now, after adding the firmware file to the library, |
- | + | ||
- | Go to the " | + | |
{{: | {{: | ||
{{: | {{: | ||
- | Select the desired file from the list. | + | Select the desired file from the list, see next screenshot - it shows one entry in the list: |
- | The update mechanism will detect-and-reject firmware files which are not targeted for the current product | + | Note that the update mechanism will detect-and-reject firmware files which are not targeted for the current product: there is no need to worry about loading a wrong firmware |
{{: | {{: | ||
- | Once selected you will be guided through the update process. | + | Once selected you will be guided through the update process: |
{{: | {{: | ||
Line 478: | Line 596: | ||
==== 9.3 Troubleshooting firmware updates ==== | ==== 9.3 Troubleshooting firmware updates ==== | ||
- | A troubleshooting guide relevant to firmware updates can be found in chapter | + | A troubleshooting guide relevant to firmware updates can be found in [[# |
==== 9.4 Error codes ==== | ==== 9.4 Error codes ==== | ||
- | In spite of our painstaking efforts, sometimes errors occur. In the following list you can check possible errors and descriptions. | + | |
+ | In spite of our painstaking efforts, sometimes errors occur. | ||
+ | |||
+ | In most cases, errors are caused by communication problems. Always make sure to check all cable connections and, if you are using Bluetooth, stay as close to the product as possible and check that the Bluetooth function is enabled on your phone/ | ||
+ | Sometimes you may need to [[# | ||
+ | |||
+ | In the following list, you can check possible errors and descriptions. | ||
+ | |||
+ | Check [[# | ||
**VE.Direct products** | **VE.Direct products** | ||
^Error | ^Error | ||
- | | 3 | No VE.Direct product(s) found. | | + | | D3 | No VE.Direct product(s) found. | |
- | | 4 | Unknown error occurred. Try again and check the product settings once updated. | | + | | D4 | Unknown error occurred. Try again and check the product settings once updated. | |
- | | 10 | Error closing com port. | | + | | D10 | Error closing com port. | |
- | | 20 | Could not start updating, no updatable product found. | | + | | D20 | Could not start updating, no updatable product found. | |
- | | 26 | Updating failed, communication lost. Product | + | | D26 | Updating failed, communication lost. The product |
- | | 29 | Could not start updating, the firmware file is corrupt. | | + | | D29 | Could not start updating, the firmware file is corrupt. | |
- | | 31 | Updating failed, product is unusable. Try again and check the product settings once updated. | | + | | D31 | Updating failed, |
- | | 32 | Could not start updating, entering boot mode failed. | | + | | D32 | Could not start updating, entering boot mode failed. | |
- | | 33 | Could not start updating, the firmware file is not found. | | + | | D33 | Could not start updating, the firmware file is not found. | |
- | | 90 | Could not start updating, firmware is not for this product. | | + | | D90 | Could not start updating, |
- | | 91 | Could not start updating, unknown product found. | | + | | D91 | Could not start updating, |
- | | 92 | Updating failed, erasing firmware failed. | + | | D92 | Updating failed, erasing firmware failed. |
- | | 93 | Error starting firmware after updating. Power cycle (off/on) your product and if that does not help\\ try updating again, and check the product settings once updated. | | + | | D93 | Error starting firmware after updating. Power cycle (off/on) your product and if that does not help\\ try updating again, and check the product settings once updated. | |
- | | 94 | Could not start updating, error reading | + | | D94 | Product updated successfully, but an error occurred |
- | | 95 | Product updated successfully, | + | | D95 | Product updated successfully, |
- | | 96 | Updating failed due to version | + | | D96 | Updating failed due to version |
- | | 97 | Dup executable too old. | | + | | D97 | Dup executable too old. | |
- | | 98 | Firmware file is not a valid dup file. | | + | | D98 | Firmware file is not a valid dup file. | |
- | | 99 | Product updated successfully, | + | | D99 | Product updated successfully, |
- | | 100 | Cannot migrate settings because the application is not active. Manual action required. | | + | | D100 | Cannot migrate settings because the application is not active. Manual action required. | |
** Blue Smart Charger, SmartLithium, | ** Blue Smart Charger, SmartLithium, | ||
^Error ^Description^ | ^Error ^Description^ | ||
- | | 1 | Error reading file. | | + | | B1 | Error reading file. | |
- | | 2 | Victron BLE service not found. Please remove the product from the list of paired devices and retry. | | + | | B2 | Victron BLE service not found. Please remove the product from the list of paired devices and retry. | |
- | | 3 | Dfu BLE service not found. Please remove the product from the list of paired devices and retry. | | + | | B3 | Dfu BLE service not found. Please remove the product from the list of paired devices and retry. | |
- | | 4 | The product disconnected unexpectedly. Perhaps the bond information is no longer valid? Please remove\\ | + | | B4 | The product disconnected unexpectedly. Perhaps the bond information is no longer valid? Please remove\\ |
- | | 5 | A write to the device failed. | | + | | B5 | A write to the device failed. | |
- | | 6 | The product did not activate its bootloader - although it should have. | | + | | B6 | The product did not activate its bootloader - although it should have. | |
- | | 7 | The product did not disconnect - although it should. | | + | | B7 | The product did not disconnect - although it should. | |
- | | 8 | Timeout waiting for access to the Victron BLE service. | | + | | B8 | Timeout waiting for access to the Victron BLE service. | |
- | | 9 | Timeout waiting for access to the Dfu BLE service. | | + | | B9 | Timeout waiting for access to the Dfu BLE service. | |
- | | 10 | Timeout waiting for a response. | | + | | B10 | Timeout waiting for a response. | |
- | | 11 | Timeout while writing to product. Perhaps a pairing | + | | B11 | Timeout while writing to the product. Perhaps a pairing |
- | | 96 | An internal error occurred (Opcode not supported). Please send a service report to Victron Energy. | | + | | B12 | Device was no longer found. Perhaps out of range? Please retry. | |
- | | 97 | The requested encryption is not supported by the product. Please send a service report to Victron Energy. | | + | | B96 | An internal error occurred (Opcode not supported). Please send a service report to Victron Energy. | |
- | | 98 | An internal error occured | + | | B97 | The requested encryption is not supported by the product. Please send a service report to Victron Energy. | |
- | | 99 | The product could not store the firmware in its memory. Please retry, and if the problem persists, please contact Victron Energy. | | + | | B98 | An internal error occurred |
- | | 100 | An internal error occurred (CRC error). Please send a service report to Victron Energy. | | + | | B99 | The product could not store the firmware in its memory. Please retry, and if the problem persists, please contact Victron Energy. | |
- | | 101 | An internal error occurred (Data length error). Please send a service report to Victron Energy. | | + | | B100 | An internal error occurred (CRC error). Please send a service report to Victron Energy. | |
- | | 102 | An internal error occurred (Not allowed). Please send a service report to Victron Energy. | | + | | B101 | An internal error occurred (Data length error). Please send a service report to Victron Energy. | |
+ | | B102 | An internal error occurred (Not allowed). Please send a service report to Victron Energy. | | ||
- | ===== 10. Troubleshooting ===== | + | ** VE.Bus Products ** |
- | ==== 10.1 Common Bluetooth problems and how to solve them === | + | ^Error ^Description^ |
+ | |V2 | No product detected. Please check all the cable connections and try again.| | ||
+ | |V3 | An unexpected timeout was triggered. Please check all the cable connections and try again.| | ||
+ | |V4 | Incomplete vff file. Nonce missing. Please make sure you selected a valid update file and try again.| | ||
+ | |V5 | Incomplete vff file. EEPROM lines missing. Please make sure you selected a valid update file and try again.| | ||
+ | |V6 | The vff file contains more eeprom data than supported. Please make sure you selected a valid update file and try again.| | ||
+ | |V7 | The calibration map in the file exceeds the device calibration map. Please make sure you selected a valid update file and try again.| | ||
+ | |V8 | Device calibration data size bigger than expected. Please make sure you selected a valid update file and try again.| | ||
+ | |V9 | Bootloader did not respond to bootloader setup. Please check all the cable connections and try again.| | ||
+ | |V10 | Bootloader response to version request failed.| | ||
+ | |V11 | Incompatible bootblock. Function version invalid.| | ||
+ | |V12 | Incompatible bootblock. Version invalid.| | ||
+ | |V13 | Bootloader did not start after bootblock update.| | ||
+ | |V14 | Incompatible bootblock type.| | ||
+ | |V15 | No or unexpected response to target id query.| | ||
+ | |V16 | No or unexpected response to eeprom read action.| | ||
+ | |V17 | No or unexpected response to calibration map query.| | ||
+ | |V18 | The supplied firmware contains new unsupported calibration values. \\ The updater does not know how to handle them.| | ||
+ | |V19 | No response received to eeprom write command. Please check all the cable connections and try again.| | ||
+ | |V20 | Invalid response received to eeprom write command. Please check all the cable connections and try again.| | ||
+ | |V21 | No response received to code write command. Please check all the cable connections and try again.| | ||
+ | |V22 | Invalid response received to code write command.| | ||
+ | |V23 | The MK2/MK3 did not respond. Please check all the cable connections and try again.| | ||
+ | |V24 | The connected product does not match the specified model in the file. \\ Please make sure you selected a valid update file and try again.| | ||
+ | |V25 | The hardware revision specific eeprom defaults data is corrupt. \\ Please make sure you selected a valid update file and try again.| | ||
+ | |V26 | Updates can not be performed with a VEBUS BMS connected.| | ||
+ | |V27 | Updates can not be performed with a DMC connected.| | ||
+ | |V40 | Failed to start Update. could not allocate memory. Malloc error.| | ||
+ | |V50 | Failed to start Update. File open error. Please check the file location and access permissions.\\ Make sure you selected a valid update file and try again.| | ||
+ | |V51 | Failed to start Update. File write error. Please check file location and access permissions.\\ Make sure you selected a valid update file and try again.| | ||
+ | |V52 | Failed to start Update. File read error. Please check file location and access permissions.\\ Make sure you selected a valid update file and try again.| | ||
+ | |V53 | Failed to start Update. File checksum error. File corrupted or not a valid VFF file.\\ Please make sure you selected a valid update file and try again.| | ||
+ | |V54 | Failed to start Update. File has an incompatible version number.\\ Please make sure you selected a valid update file and try again.| | ||
+ | |V55 | Failed to start Update. File section not found. File corrupted or not a valid VFF file.\\ Please make sure you selected a valid update file and try again.| | ||
+ | |V56 | Failed to start Update. Format error. File corrupted or not a valid VFF file.\\ Please make sure you selected a valid update file and try again.| | ||
+ | |||
+ | ** All other products (XUP update files)** | ||
+ | ^Error ^Description^ | ||
+ | |X3 |Invalid updater state. Please try again.| | ||
+ | |X4 |Firmware not for Product (Id). Please make sure you selected a valid update file and try again.| | ||
+ | |X5 |Updater (version) too old. | | ||
+ | |X6 |Communication Error. No Callback handler connected. Please check the connection and try again.| | ||
+ | |X7 |Communication Error. Vreg ack-ed with an unexpected error. | ||
+ | |X8 |Update (xup) file format not supported. Please make sure you selected a valid update file and try again.| | ||
+ | |X9 |File Error. No Instance Blob could be found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X10 |File Error. Invalid instance Blob attribute. Please make sure you selected a valid update file and try again.| | ||
+ | |X11 |File Error. Instance Blob defined more than once. Please make sure you selected a valid update file and try again.| | ||
+ | |X12 |File Error. No Firmware Version for instance found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X13 |Communication Error. Unexpected Vreg Ack received. Please check the connection and try again.| | ||
+ | |X14 |Communication Error. The instance could not be reached. Please check the connection and try again.| | ||
+ | |X15 |Fail on Minimum Firmware Version check. Please make sure you selected a valid update file and try again.| | ||
+ | |X16 |Failed to Begin Update. Please check the connection and try again.| | ||
+ | |X17 |File Error. No/invalid Firmware data found for instance in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X18 |Update Error. Invalid ack on non-final Update Data. Please check the connection and try again.| | ||
+ | |X19 |Update Error. Invalid sequence# in Update Data Ack. Please check the connection and try again.| | ||
+ | |X20 |Update Error. Invalid instance# in Update Data Ack. Please check the connection and try again.| | ||
+ | |X21 |Update Error. Invalid ack on final Update Data. Please check the connection and try again.| | ||
+ | |X22 |Verification Error. Invalid Firmware Version Ack. Please check the connection and try again.| | ||
+ | |X23 |Verification Error. Invalid UDF Version Ack. Please check the connection and try again.| | ||
+ | |X24 |Verification Error. Invalid instance field in Minimum Firmware Version Ack. Please check the connection and try again.| | ||
+ | |X25 |Verification Error. Invalid instance field in Firmware Version Ack. Please check the connection and try again.| | ||
+ | |X26 |Verification Error. Invalid instance field in UDF Version Ack.\\ Please check the connection and try again.| | ||
+ | |X27 |Failed to verify Minimum Firmware Version.\\ Please check the connection and try again.| | ||
+ | |X28 |Failed to verify Firmware Version. Please check the connection and try again.| | ||
+ | |X29 |Failed to verify UDF Version. Please check the connection and try again.| | ||
+ | |X30 |Failed on Minimum Firmware Version verification. Please check the connection and try again.| | ||
+ | |X31 |Failed on Firmware Version verification. Please check the connection and try again.| | ||
+ | |X32 |Still in Bootloader Mode after the update. Please try again.| | ||
+ | |X33 |File Error. No Product Id found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X34 |File Error. No VE.Direct baudrates found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X35 |File Error. No Xup Format Version found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X36 |File Error. No Minimum Updater Version found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X37 |File Error. No Firmware (product) Version found in the update file. Please make sure you selected a valid update file and try again.| | ||
+ | |X38 |File Error. The update file does not match XML standard. Please make sure you selected a valid update file and try again.| | ||
+ | |X39 |Communication Error. Vreg Ack timeout. Please check the connection and try again.| | ||
+ | |X40 |Communication Error. No product found. Please check the connection and try again.| | ||
+ | |X41 |Communication Error. Comm port error. Please check the connection and try again.| | ||
+ | |X42 |Update Error. Failed to set baudrate. Please check the connection and try again.| | ||
+ | |X43 |Update Error. Update in progress on another interface.| | ||
+ | |X44 |Update Error. Invalid instance# in Ack. Please check the connection and try again.| | ||
+ | |X45 |Update Error. Vreg Ack error: Invalid instance. Please check the connection and try again.| | ||
+ | |X46 |Update Error. Vreg Ack error. Please check the connection and try again.| | ||
+ | |||
+ | |||
+ | ===== 10. VictonConnect-Remote (VC-R) – Configuration and monitoring via VRM ===== | ||
+ | |||
+ | ==== 10.1 Introduction ==== | ||
+ | |||
+ | VictronConnect-Remote functionality enables Victron devices with a VE.Direct interface to be accessed remotely through a [[https:// | ||
+ | |||
+ | This powerful new feature allows full device configuration and monitoring from practically anywhere in the world using the VictronConnect app. | ||
+ | |||
+ | The user interface experience is just like the devices were connected locally using Bluetooth or a wired VE.Direct to USB interface. | ||
+ | |||
+ | ==== 10.2 Compatibility ==== | ||
+ | |||
+ | The VictronConnect-Remote feature is ONLY compatible with devices connected to a GX Device with a VE.Direct interface. | ||
+ | |||
+ | This includes; | ||
+ | * MPPT solar chargers with a VE.Direct interface (SmartSolar and BlueSolar) | ||
+ | * Battery monitors with a VE.Direct interface (BMV and SmartShunt) | ||
+ | * Specific inverters with a VE.Direct interface (Phoenix Inverter VE.Direct and Phoenix Inverter Smart) | ||
+ | * Specific mains chargers with a VE.Direct interface (Phoenix Smart IP43) | ||
+ | |||
+ | Devices connected with a VE.Bus interface, such as Multiplus/ | ||
+ | |||
+ | Devices connected using a VE.Can interface, such as Lynx Shunt, Skylla chargers and MPPT solar chargers using a VE.Can interface are also NOT compatible and cannot be configured remotely. | ||
+ | |||
+ | ==== 10.3 Setup ==== | ||
+ | |||
+ | === 10.3.1 Minimum Requirements === | ||
+ | |||
+ | * VictronConnect SW: v5.20 | ||
+ | * GX Device - Venus OS FW: v2.40 (However v2.53 recommended for full functionality) | ||
+ | |||
+ | === 10.3.2 VictronConnect === | ||
+ | |||
+ | - Confirm that the phone, tablet or PC has VictronConnect installed and that the software version meets or exceeds the minimum requirements - upgrade if necessary | ||
+ | - Authorize VictronConnect to access your VRM account; | ||
+ | * Open the VictronConnect app | ||
+ | * Swipe across to the VRM tab, then select ‘SIGN IN TO VRM’ | ||
+ | * Complete your email address and VRM password, then select ‘Authorize Victron Connect’ | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | * If using a tablet or PC your browser may also request permission to proceed, if prompted select ‘Open’ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === 10.3.3 GX Device === | ||
+ | |||
+ | 1- Confirm that the GX Device is running Venus OS firmware version that meets or exceeds the minimum requirements - upgrade if necessary | ||
+ | 2- Enable ‘VRM two-way communication’ under Device List > Settings > VRM Online Portal | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ==== 10.4 Local Tab ==== | ||
+ | |||
+ | The local tab displays all devices that are within local Bluetooth and wireless LAN range or physically connected to the phone, tablet or PC with VictronConnect (such as with a VE.Direct to USB or MK3 to USB interface cable) | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ==== 10.5 VRM Tab ==== | ||
+ | |||
+ | The VRM tab displays all VRM installations associated with the VRM user profile. | ||
+ | |||
+ | Any installation can be selected to access the VRM online portal or connected devices. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | When a VRM installation is selected it will take a few seconds for a connection to be made, once the connection is established two tabs will appear, an ‘OVERVIEW’ tab and a ‘DEVICES’ tab. | ||
+ | |||
+ | === 10.5.1 Overview Tab === | ||
+ | |||
+ | The ‘OVERVIEW’ tab has an image of the GX device, the name of the VRM installation and a direct link to the associated [[https:// | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | === 10.5.2 Devices Tab === | ||
+ | |||
+ | The ‘DEVICES’ tab has a list of all compatible devices that are physically connected to the GX device. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | If using a tablet or PC, the ‘DEVICES’ tab is shown as a panel on the right side of the same screen. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ==== 10.6 Remote device access ==== | ||
+ | |||
+ | When a device is selected it will take a few seconds for a connection to be made, once the connection is established live device information/ | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | Immediately after initial connection settings and historical data will be downloaded, during this time a cloud symbol will remain in the upper right corner (this typically takes less than 30 seconds). | ||
+ | |||
+ | Settings cannot be accessed until the cloud symbol is replaced by the normal settings gear symbol. | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | ==== 10.7 Signing out ==== | ||
+ | |||
+ | To disable the link between VictronConnect-Remote and your VRM account, expand the main menu and then select ‘Settings’. | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | In the settings page select ‘SIGN OUT’ and then select ‘OK’ in the prompt window to confirm. | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | After signing out VictronConnect-Remote will no longer have access to the VRM account or any of the associated VRM installations. To reinstate access the log in procedure needs to be repeated. | ||
+ | |||
+ | ==== 10.8 Troubleshooting and FAQ ==== | ||
+ | |||
+ | == Device not found == | ||
+ | |||
+ | * VictronConnect-Remote is only compatible with devices that use a VE.Direct interface to the GX device – see the ‘compatibility’ section. | ||
+ | * Ensure that that the missing device is physically connected to the GX device, with the VE.Direct cable properly installed at both ends. | ||
+ | * Ensure that the device is running a recent firmware version. | ||
+ | |||
+ | == Installation/ | ||
+ | |||
+ | * Confirm that the installation is currently online and communicating with the VRM online portal. | ||
+ | * Ensure that the installation is linked to the VRM account used during initial VictronConnect-Remote sign in to VRM. | ||
+ | * Ensure that ‘VRM two-way communication’ is enabled – see the ‘settings’ section. | ||
+ | * Ensure that the GX device is running the minimum compatible Venus OS firmware version – see the ‘settings’ section. | ||
+ | |||
+ | == VictronConnect has no VRM tab == | ||
+ | |||
+ | * Ensure that the phone, tablet or PC is running the minimum compatible VictronConnect software version – see the ‘settings’ section. | ||
+ | |||
+ | == VRM account == | ||
+ | |||
+ | * It is necessary to have an active VRM account linked to your installation and any others that you intend to monitor or configure using VictronConnect-Remote - creating a new account is quick and easy. | ||
+ | * For further information in relation to VRM (Victron Remote Management) see [[https:// | ||
+ | |||
+ | == Systems with no GX device == | ||
+ | |||
+ | * VictronConnect-Remote functionality is not possible unless the system includes a GX device. A GX device can be easily added to any system and there are a [[https:// | ||
+ | |||
+ | == Installations with no internet connection == | ||
+ | |||
+ | * VictronConnect-Remote functionality is not possible unless GX device at the installation site has an active internet connection. | ||
+ | * For remote sites without an existing internet connection or with mobile installations, | ||
+ | |||
+ | == Large systems == | ||
+ | |||
+ | * The use of the VictronConnect-Remote feature will slightly increase the GX device CPU load. | ||
+ | * In some large/ | ||
+ | * It is important to select a GX device that has sufficient performance capability in relation to the system design, for example a Cerbo GX has significantly more processing power than a Color Control GX and is much better suited to large/ | ||
+ | |||
+ | == VictronConnect Remote troubleshooting == | ||
+ | |||
+ | VictronConnect will report errors encountered during communication attempts with VRM in a message box with an error code. The code can have one of the following value: | ||
+ | |||
+ | ^Error ^Description^ | ||
+ | |-100 | Call to retrieve a list of child devices expired (60 seconds). The most common cause is a bad internet connection. | | ||
+ | | 1 | No link to VRM can be established. Check if the internet is present and try again. | | ||
+ | | 2 | VRM encountered temporary difficulties. Try again in a while. | | ||
+ | | 5 | The local system ran out of resources. Free some system resources and try again. | | ||
+ | | 8 | An error occurred with the network (e.g., the network cable was accidentally plugged out). | | ||
+ | | 13 | Proxy authentication error. VictronConnect does not support communication over proxy. | | ||
+ | | 14 | Failed to establish a secure connection to VRM. | | ||
+ | |65538| VRM MQTT broker is not responding. Please try again in a while. | | ||
+ | |||
+ | There are also other error codes that could be reported. They are a result of internal errors in VictronConnect and/or VRM. In case these errors persist after a retry, please create a " | ||
+ | |||
+ | VictronConnect Remote is establishing communication with a range of services on ' | ||
+ | |||
+ | ===== 11. Troubleshooting ===== | ||
+ | |||
+ | ==== 11.1 Common Bluetooth problems and how to solve them === | ||
+ | |||
+ | The #1 first step before attempting any of the specific troubleshooting advice below is to power down and then restart all related devices. This includes closing the software, restarting the phone, tablet, computer and Victron equipment. This will solve most issues. | ||
+ | |||
+ | For example with Victron MPPTs you must isolate the MPPT from both battery and solar voltage so that no lights appear, before reconnecting it again. | ||
== I cannot find my device listed == | == I cannot find my device listed == | ||
Line 535: | Line 923: | ||
* Make sure your device is in range. | * Make sure your device is in range. | ||
* If a firmware update failed, the device //Custom Name// might have reverted to its original name and serial number, check if that is the case. Once the update is completed, the //Custom Name// will be back. See more tips about troubleshooting firmware updates on [[start# | * If a firmware update failed, the device //Custom Name// might have reverted to its original name and serial number, check if that is the case. Once the update is completed, the //Custom Name// will be back. See more tips about troubleshooting firmware updates on [[start# | ||
+ | * Only one device can be connected to a product at the same time. Make sure that no other device: phone/ | ||
+ | * Make sure you are attempting to connect from //within// VictronConnect - not from the system menu of your phone/ | ||
== I can see but not connect to my device == | == I can see but not connect to my device == | ||
- | | + | |
- | | + | |
- | | + | - Make sure that Bluetooth is still enabled in your phone/ |
- | * Make sure you are attempting to connect from //within// VictronConnect | + | |
- | * Make sure that Bluetooth is still enabled in your phone/ | + | |
- | | + | |
- | | + | === Connection fails around 20% === |
+ | - Make sure you are up to date with the latest version of VictronConnect. | ||
+ | - [[https:// | ||
+ | - Then [[https:// | ||
+ | - Force close the VictronConnect app. Instructions: | ||
+ | - Reconnecting in VictronConnect using the default PIN 000000 | ||
+ | - Then [[https:// | ||
- | ==== 10.2 Bluetooth connection issues on Android devices ==== | + | ==== 11.2 Bluetooth connection issues on Android devices ==== |
=== Step 1: Check that your device is supported === | === Step 1: Check that your device is supported === | ||
Line 560: | Line 956: | ||
=== Step 3: Check that VictronConnect has access to the Location services === | === Step 3: Check that VictronConnect has access to the Location services === | ||
- | On Android 5 and later VictronConnect needs access to the device location services to be able to scan nearby | + | On Android 5 and later VictronConnect needs access to the device location services to be able to scan nearby |
Permission to access location services is requested each time the app starts ...but if you checked the " | Permission to access location services is requested each time the app starts ...but if you checked the " | ||
Line 582: | Line 978: | ||
If you are still experiencing difficulties, | If you are still experiencing difficulties, | ||
- | When successfully connected using another device, VictronConnect will automatically update the firmware in the Victron | + | When successfully connected using another device, VictronConnect will automatically update the firmware in the Victron |
- | ==== 10.3 Problems during firmware updating ==== | + | |
- | First of all, its good to know that you can always restart the firmware update procedure. The update process will be restarted each time you connect to the product. | + | ==== 11.3 Problems during firmware updating ==== |
+ | |||
+ | First of all, it' | ||
Keep your mobile device as close to the product as possible. If the update fails due to Bluetooth connectivity problems, and if your device is already paired to a product, try and remove the pairing completely from your phone/ | Keep your mobile device as close to the product as possible. If the update fails due to Bluetooth connectivity problems, and if your device is already paired to a product, try and remove the pairing completely from your phone/ | ||
Line 612: | Line 1009: | ||
* The firmware update screen will appear again. You should now be able to update the dongle to the latest firmware version. | * The firmware update screen will appear again. You should now be able to update the dongle to the latest firmware version. | ||
- | ==== 10.4 VE.Direct USB driver problem on macOS X 10.9 (Mavericks) ==== | + | ==== 11.4 VE.Direct USB driver problem on macOS X 10.9 (Mavericks) ==== |
The driver included in macOS X 10.9 " | The driver included in macOS X 10.9 " | ||
Line 633: | Line 1030: | ||
VictronConnect should now show the connected products. | VictronConnect should now show the connected products. | ||
- | ==== 10.5 VictronConnect on Windows doesn' | + | ==== 11.5 VictronConnect on Windows doesn' |
VE.Direct USB cable requires a driver to be installed. | VE.Direct USB cable requires a driver to be installed. | ||
Line 639: | Line 1036: | ||
The necessary drivers are available in the [[https:// | The necessary drivers are available in the [[https:// | ||
- | ==== 10.6 VictronConnect on Android doesn' | + | ==== 11.6 VictronConnect on Android doesn' |
- | VictronConnect needs to be running before | + | VictronConnect needs to be running before |
- | Open VictronConnect and without closing it switch to the app containing the file, select it an choose to open it with VictronConnect. | + | Open VictronConnect and without closing it switch to the app containing the file, select it and choose to open it with VictronConnect. |
- | ==== 10.7 How to create a VictronConnect Service Report ==== | + | ==== 11.7 How to create a VictronConnect Service Report ==== |
If you are experiencing issues with VictronConnect or your Victron product, you may be asked to create a " | If you are experiencing issues with VictronConnect or your Victron product, you may be asked to create a " | ||
+ | Please note that this service report is for Victron internal use and is not able to be read or used for any other purpose than developer troubleshooting. | ||
To do this, | To do this, | ||
Line 663: | Line 1061: | ||
{{: | {{: | ||
- | ===== 11. Compatible Victron products ===== | + | If you require more detailed power system diagnostic information, |
+ | ==== 11.8 VE.Bus firmware update fails at 5% on macOS ==== | ||
- | ==== SmartSolar MPPT Charge controllers | + | There is a known issue that makes VE.Bus firmware updates randomly fail on some macOS laptops. We are working on it; a new VictronConnect version fixing this issue is expected in the near future. Meanwhile this is the workaround for this: |
+ | |||
+ | Proceed to update as usual and quickly minimise the VictronConnect window when progress bar is shown because the update starts. After ~20 seconds you can maximise VictronConnect to see the update status. (1) | ||
+ | |||
+ | This issue was introduced in VictronConnect v5.9. | ||
+ | |||
+ | (1) For those with a technical background and wondering how, why and what minimising has to do with this: yes this really works, and relates to a power saving mode that has a side effect on serial communication. | ||
+ | |||
+ | ===== 12. Compatible Victron products ===== | ||
+ | |||
+ | ==== Solar Chargers ==== | ||
+ | |||
+ | === SmartSolar MPPT Charge controllers === | ||
^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | ||
| MPPT 75/10 | [[https:// | | MPPT 75/10 | [[https:// | ||
Line 692: | Line 1103: | ||
The same models, but then with a different part number do support using both the VE.Direct port and the built-in Bluetooth Smart function at the same time. As do all other SmartSolar MPPT models. | The same models, but then with a different part number do support using both the VE.Direct port and the built-in Bluetooth Smart function at the same time. As do all other SmartSolar MPPT models. | ||
- | ==== Blue Smart IP22 Chargers ==== | + | === BlueSolar MPPT Charge controllers === |
- | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | + | |
- | | All Blue Smart IP22 Chargers | No | Yes - Built in | | + | |
- | + | ||
- | ==== Blue Smart IP65 Chargers ==== | + | |
- | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | + | |
- | | All Blue Smart IP65 Chargers | + | |
- | + | ||
- | ==== Blue Smart IP67 Chargers ==== | + | |
- | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | + | |
- | | All Blue Smart IP67 Chargers | + | |
- | + | ||
- | + | ||
- | ==== Battery Monitors ==== | + | |
- | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | + | |
- | | BMV-700 | + | |
- | | BMV-702 | + | |
- | | BMV-700H | [[https:// | + | |
- | | BMV-712 | + | |
- | ==== BlueSolar MPPT Charge controllers | + | |
^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | ||
| MPPT 70/15 | Not compatible || | | MPPT 70/15 | Not compatible || | ||
Line 730: | Line 1122: | ||
+ | ==== Battery Chargers ==== | ||
+ | ^ Blue Smart IP22 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/ | ||
+ | | All Blue Smart IP22 Chargers | ||
+ | ^ Blue Smart IP65 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/ | ||
+ | | Blue Smart IP65 12/25 Charger | ||
+ | | Blue Smart IP65 24/13 Charger | ||
+ | | Other Blue Smart IP65 Chargers | ||
+ | ^ Blue Smart IP67 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/ | ||
+ | | All Blue Smart IP67 Chargers | ||
+ | ^ Phoenix Smart IP43 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/ | ||
+ | | All Phoenix Smart IP43 Chargers | Yes | Yes - Built in | Yes | No | No | | ||
+ | ^ IMPULSE-II Smart ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/ | ||
+ | | All IMPULSE-II Smart Chargers | ||
+ | |||
+ | |||
+ | ==== Orion-Tr Smart DC-DC Charger Isolated ==== | ||
+ | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | ||
+ | | All Orion-Tr Smart DC-DC Isolated Chargers | ||
+ | |||
+ | ==== Battery Monitors ==== | ||
+ | ^ ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ | ||
+ | | BMV-700 | ||
+ | | BMV-702 | ||
+ | | BMV-700H | [[https:// | ||
+ | | BMV-712 | ||
Line 771: | Line 1188: | ||
- | ^ ^ USB via VE.Direct port^ Wireless Via Bluetooth^ | + | |
- | | Phoenix Smart IP43 Charger 12/ | + | |
- | | Phoenix Smart IP43 Charger 12/ | + | |
- | | Phoenix Smart IP43 Charger 24/ | + | |
- | | Phoenix Smart IP43 Charger 24/ | + | |
Line 785: | Line 1198: | ||
==== MultiPlus, EasySolar, Quattro, Phoenix Inverter with VE.Bus, and similar products ==== | ==== MultiPlus, EasySolar, Quattro, Phoenix Inverter with VE.Bus, and similar products ==== | ||
+ | |||
This section applies to MultiPlus, MultiPlus-II, | This section applies to MultiPlus, MultiPlus-II, | ||
Line 793: | Line 1207: | ||
The currently sold generation, VE.Bus firmware 26xxxxx and 27xxxxx is supported. | The currently sold generation, VE.Bus firmware 26xxxxx and 27xxxxx is supported. | ||
- | Mixed systems (1954208 in parallel to 2654208) are not supported by vebus-interface, | + | Mixed systems (1954208 in parallel to 2654208) are not supported by vebus-interface, |
- | To connect via USB, an [[https:// | + | Inverter/ |
- | To connect wirelessly, the [[https:// | + | - Using USB, this requires the [[https:// |
- | + | - Wirelessly, over Bluetooth. Requires | |
- | The supplied | + | |
Note that switching between on/ | Note that switching between on/ | ||
For systems with a [[venus-os: | For systems with a [[venus-os: | ||
- | |||
- | |||
- | |||
- | ===== DISQUS ===== | ||
- | ~~DISQUS~~ |
victronconnect/start.txt · Last modified: 2021-01-11 13:04 by boekel