User Tools

Site Tools


victronconnect:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
victronconnect:start [2019-11-16 07:19]
guy_stewart [9.1 Introduction & automatic updates]
victronconnect:start [2020-08-22 23:33] (current)
nlakatos [10.8 Troubleshooting and FAQ]
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/LAN/Internet. How to connect depends on the product, some product ranges have bluetooth, some do not. Some product ranges have WiFi, others do not. For details, see chapter 11.+It can connect to Victron products via Bluetooth, USB and WiFi/LAN/Internet. How to connect depends on the product, some product ranges have Bluetooth, some do not. Some product ranges have WiFi, others do not. For details, see chapter 11.
  
  
Line 18: Line 18:
  
 [[https://docs.victronenergy.com/victronconnect-vebus.html|{{:victronconnect:multiplus_ii-24v.png?nolink&100|}}]] - [[https://docs.victronenergy.com/victronconnect-vebus.html| VE.Bus Configuration for MultiPlusses, Quattros, EasySolars and other inverter/chargers.]]  [[https://docs.victronenergy.com/victronconnect-vebus.html|{{:victronconnect:multiplus_ii-24v.png?nolink&100|}}]] - [[https://docs.victronenergy.com/victronconnect-vebus.html| VE.Bus Configuration for MultiPlusses, Quattros, EasySolars and other inverter/chargers.]] 
 +
 +[[https://www.victronenergy.com/live/victronconnect:orion_smart_dc-dc_charger|{{:victronconnect:orion_iso_360w_link_png.png?victronconnect:orion_smart_dc-dc_charger&100|}}]] - [[https://www.victronenergy.com/live/victronconnect:orion_smart_dc-dc_charger| Specific documentation for Orion Smart DC-DC Chargers]].
 ===== 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.  [[https://www.victronenergy.com/support-and-downloads/software#victronconnect-app|Use this link to download the app suitable for your device]].+VictronConnect is available to users of Windows PCs, macOS X, iOS and Android phones, as well as tablets.  [[https://www.victronenergy.com/support-and-downloads/software#victronconnect-app|Use this link to download the app suitable for you]]
 + 
 +Also, [[https://community.victronenergy.com/questions/43667/victronconnect-for-linux-download-instructions.html|it is available for Linux]] - though not officially supported.
  
-See [[#phone_tablet_and_laptop_compatibility|chapter 4]] for details regarding compatible phones, tables and laptops, as well as required minimum Operating System versions.+See [[#phone_tablet_and_laptop_compatibility|chapter 4]] for details regarding compatible phones, tablets and laptops, as well as required minimum Operating System versions.
  
 ===== 3. Connecting ===== ===== 3. Connecting =====
Line 28: Line 32:
 There are three ways to connect to a Victron product: There are three ways to connect to a Victron product:
 ^ Method                                     ^ iOS ^ Android ^ Windows PC ^ macOS X ^ ^ Method                                     ^ iOS ^ Android ^ Windows PC ^ macOS X ^
-| Products with built-in bluetooth           | Yes | Yes     | No | Yes |+| Products with built-in Bluetooth           | Yes | Yes     | No | Yes |
 | [[ve.direct:ve.direct_to_bluetooth_smart_dongle|VE.Direct Bluetooth Smart dongle]] | Yes | Yes     | No | Yes | | [[ve.direct:ve.direct_to_bluetooth_smart_dongle|VE.Direct Bluetooth Smart dongle]] | Yes | Yes     | No | Yes |
 | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct USB interface]] | No  | Yes (1) | Yes | Yes | | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct USB interface]] | No  | Yes (1) | Yes | Yes |
Line 39: Line 43:
 ==== 3.1 Bluetooth Smart - Pairing and Connecting ==== ==== 3.1 Bluetooth Smart - Pairing and Connecting ====
  
-To connect to your Victron product, over Bluetooth, always connect from within VictronConnect. Do not connect from the device's system menu because VictronConnect will not find your Victron product.+To connect to your Victron product, over Bluetooth, always connect from within VictronConnect. Do not connect from the phone's system menu because VictronConnect will not find your Victron product.
  
 Here is how to connect: Here is how to connect:
  
-  - Enable the Bluetooth on your phone, tablet or laptop (device).+  - Enable the Bluetooth on your phone.
   - Open VictronConnect, and scan:   - Open VictronConnect, and scan:
     - On a phone or tablet, pull down the screen, or tap the refresh button to initiate a scan.     - On a phone or tablet, pull down the screen, or tap the refresh button to initiate a scan.
     - On a computer or laptop: click the "Scan or Refresh" button on the left.     - On a computer or laptop: click the "Scan or Refresh" button on the left.
-  - The first time you attempt to connect the phone will ask to pair with the device. Enter the pin code. The default pin code is 000000 +  - 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 
-  - Connection is complete.+  - The connection is complete.
  
-If connection was not successful please refer to section [[#9._Troubleshooting|9. Troubleshooting]] below.+If the connection was not successful please refer to section [[#9._Troubleshooting|9. Troubleshooting]] below.
  
 ==== 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 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: {{:ve.direct:wrench.png?nolink|}}. After opening that menu press {{:victronconnect:vc4_ic_more.png?nolink|}}, and click **Product info**.+To change the PIN code, firstcomplete your connection. Then go to the **Product info** page. To access that page, click the button on the upper right. For some productsit will be the settings icon: {{:ve.direct:wrench.png?nolink|}}. After opening that menu press {{:victronconnect:vc4_ic_more.png?nolink|}}, and click **Product info**.
  
 For other products you'll find the {{:victronconnect:vc4_ic_info.png?nolink|}} button on the upper right, which takes you straight to the Product info page. For other products you'll find the {{:victronconnect:vc4_ic_info.png?nolink|}} button on the upper right, which takes you straight to the Product info page.
  
-On this page, select the change pin code button.+On this page, select the change PIN code button.
  
-Note that after changing the pin code, all other phones, tablets, and laptops 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 | section 3.4]] to learn how to remove the pairing information.+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 | section 3.4]] to learn how to remove the pairing information.
  
 ==== 3.3 Bluetooth Smart - Resetting the PIN code ==== ==== 3.3 Bluetooth Smart - Resetting the PIN code ====
Line 75: Line 79:
  
 === Blue Smart Chargers IP22 === === Blue Smart Chargers IP22 ===
-On the device list: Press and hold the product description for which you would like to reset the PIN code. 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 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 83: Line 85:
  
 === Blue Smart Chargers IP67 === === Blue Smart Chargers IP67 ===
-On the device list: Press and hold the product description for which you would like to reset the PIN code. 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 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 for which you would like to reset the PIN code. 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 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 for which you would like to reset the PIN code. 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 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 for which you would like to reset the PIN code. 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 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/tablet/laptop. For example, if the PIN code of your product has been changed on a different device.+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 phone.
  
-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:
  
-=== Remove Bluetooth pairing on iOS devices: ===+=== Remove Bluetooth pairing on iOS: ===
 (click to play, double-click to enter fullscreen mode) (click to play, double-click to enter fullscreen mode)
  
 {{victronconnect:video_unpair_ios.mp4?175}} {{victronconnect:video_unpair_ios.mp4?175}}
  
-=== Remove Bluetooth pairing on Android devices: ===+=== Remove Bluetooth pairing on Android: ===
 (click to play, double-click to enter fullscreen mode) (click to play, double-click to enter fullscreen mode)
  
Line 123: Line 119:
 VictronConnect requires Windows 7, Windows 8 or Windows 10. For older Windows versions, XP and Vista, check our [[victronconnect:start#archive_of_previous_versions|archive of previous versions]]. VictronConnect requires Windows 7, Windows 8 or Windows 10. For older Windows versions, XP and Vista, check our [[victronconnect:start#archive_of_previous_versions|archive of previous versions]].
  
-Note that on Windows, VictronConnect cannot use Bluetooth Smart to connect to a product. Other connection methods, is USB, or LAN and WiFi do work properly.+Note that on Windows, VictronConnect cannot use Bluetooth Smart to connect to a product. Other connection methods, such as USB, or LAN and WiFi do work properly.
  
 ==== 4.2 macOS X === ==== 4.2 macOS X ===
  
-VictronConnect requires macOS version is 10.12 (OS X Sierra), or later.+Todays version of VictronConnect requires macOS version is 10.12 (OS X Sierra), or later.
  
 For the older macOS 10.11/10.10/10.9 versions, an (unsupported) previous version of VictronConnect is still available in the Apple Store. For the older macOS 10.11/10.10/10.9 versions, an (unsupported) previous version of VictronConnect is still available in the Apple Store.
  
 To connect to a Victron product with Bluetooth, the Apple Laptop needs to have Bluetooth 4.0 aka Bluetooth Smart. To connect to a Victron product with Bluetooth, the Apple Laptop needs to have Bluetooth 4.0 aka Bluetooth Smart.
-==== 4.3 Android devices ===+==== 4.3 Android ===
  
 Android 5.0 is the minimum version required to run VictronConnect. Android 5.0 is the minimum version required to run VictronConnect.
Line 141: Line 137:
  
 === Notes for Android 5 === === Notes for Android 5 ===
-The pairing does not work on some devices running Android 5. The pin code popup does not appear, or it appears without text field to enter the PIN codeIf you have this situation on your device, the phone/tablet might report that it has been paired with the Victron product but it has not.+Android 5 devices with 64bit CPU will experience a crash at startup due to an issue in the libraries we use to develop VictronConnectThis 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://www.victronenergy.com/support-and-downloads/software#victronconnect-app|software section]].
  
-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 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. 
 + 
 +Unfortunatelythis is a bug in Android over which we have no control, and are therefore unable to fix.
  
 Devices where we have seen this issue are: Devices where we have seen this issue are:
Line 156: Line 154:
 === Why is 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 devices.+Android 5 and later requires access permission for VictronConnect to the (coarse) location services. Otherwise it can not scan for the Bluetooth products.
  
 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 location; hence these requirements. +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'location; hence these requirements. 
  
-Despite above, you can be sure that Victron is not interested in, nor tracking your location.+Despite the above, you can be sure that Victron is not interested in, nor tracking your location.
  
-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 about why its needed to enable the location services is [[https://goo.gl/YGHqwU|here]].+Being sensitive to privacy issues at Victron ourselves, we are not happy with this requirement. But there is nothing we can do about itunfortunately. More information about why it is needed to enable the location services is [[https://goo.gl/YGHqwU|here]].
  
 === List of known non-compatible Android devices === === List of known non-compatible Android devices ===
Line 182: 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 runs the latest firmware released by the manufacturer.+*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 running iOS 11 or later: VictronConnect works on the following iPhones and iPads running iOS 11 or later:
Line 192: Line 190:
 Unfortunately Apple iPhone/iPad doesn't support USB OTG. Unfortunately Apple iPhone/iPad doesn't support USB OTG.
  
-==== 4.5 Archive of previous versions ====+==== 4.5 Linux ====
  
-It would be nice to forever support all existing versions of Android, iOS, Windows and other systemsBut unfortunately its impossible to do soTherefore, now and then, a new release of VictronConnect doesn't work any more on your device; whereas the previous version worked perfectly.+Details [[https://community.victronenergy.com/questions/43667/victronconnect-for-linux-download-instructions.html|here]].
  
-In such situation, we recommend to update your phone/laptop to the latest OSFor situations where that is not possible we make these older versions available:+==== 4.6 Archive of previous versions ====
  
-**Warning:** These versions are no longer supported or recommended to use by Victron, only use it as a last resort if you don't have access to a compatible device with the latest VictronConnect release version. Under the download link find the last available VictronConnect version that still works on those older operating systems.+It would be nice to forever support all existing versions of Android, iOS, Windows, and other systems. But unfortunately, it is impossible to do so. Therefore, now and then, a new release of VictronConnect doesn't work anymore on your phone; whereas the previous version worked perfectly. 
 + 
 +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:** These versions are no longer supported or recommended to use by Victron, only use it as a last resort if you don't have access to a compatible phone with the latest VictronConnect release version. Under the download link find the last available VictronConnect version that still works on those older operating systems.
  
 |**OS Version** | **Download link** | |**OS Version** | **Download link** |
Line 204: Line 206:
 | Android 4.3 to 4.4.4 armv7 architecture | [[https://www.victronenergy.com/upload/software/VictronConnect-v5.8-armv7.apk|VictronConnect 5.8]] | | Android 4.3 to 4.4.4 armv7 architecture | [[https://www.victronenergy.com/upload/software/VictronConnect-v5.8-armv7.apk|VictronConnect 5.8]] |
 | Android 4.3 to 4.4.4 x86 architecture  | [[https://www.victronenergy.com/upload/software/VictronConnect-v5.8-x86.apk|VictronConnect 5.8]] | | Android 4.3 to 4.4.4 x86 architecture  | [[https://www.victronenergy.com/upload/software/VictronConnect-v5.8-x86.apk|VictronConnect 5.8]] |
-| macOS 10.9 (OS X Mavericks) | See Apple Store and chapter 4.2 |+| macOS 10.9 (OS X Mavericks) | [[https://nocache.victronenergy.com/upload/software/VictronConnect-3.2.dmg|VictronConnect 3.2]] | 
 +| macOS 10.10, 10.11 & 10.12 (OS X Yosemite / Sierra) | [[https://www.victronenergy.com/upload/software/VictronConnect_v5.8.dmg|VictronConnect 5.8]] |
  
  
Line 212: 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.  
  
-{{:victronconnect:vc5_iphone_discovery.png?direct&175|VictronConnect - Discovery}}+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. 
 + 
 +{{:victronconnect:vc520_iphone_discovery.png?direct&175|VictronConnect - Device List - LOCAL}} 
 + 
 +VRM - This page will show a GX product if it is connected to your VRM account. 
 + 
 +{{:victronconnect:vc520_iphone_discovery_vrm.png?direct&175|VictronConnect - Device List - VRM}}
  
 **Battery Monitor pages**:\\ **Battery Monitor pages**:\\
-Clicking on 'Battery Monitor' will show the current state of chargeand allows you to toggle between screens showing more detailed information concerning the current battery STATUS, and HISTORY data. +Clicking on 'Battery Monitor' will show the current state of chargeand allows you to toggle between screens showing more detailed information concerning the current battery STATUS, and HISTORY data. 
   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.
 From 'Settings' you can change the data concerning your battery storage; set alarms and relays;  change charging parameters; tailor the appearance and quantity of data displayed and set up or join an existing VE.Smart network. From 'Settings' you can change the data concerning your battery storage; set alarms and relays;  change charging parameters; tailor the appearance and quantity of data displayed and set up or join an existing VE.Smart network.
Line 233: 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 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.
-'Settings' will allow access to the extensive range of functions available on your solar charge controller, includingprogramming the charge settings; initiating relays which are triggered by solar time, or by voltage parameters; together with comprehensive history analysis.+'Settings' will allow access to the extensive range of functions available on your solar charge controller, including programming the charge settings; initiating relays which are triggered by solar time, or by voltage parameters; together with comprehensive historical analysis.
  
 For a full explanation of the Solar Charge Controller options follow [[https://www.victronenergy.com/live/victronconnect:mppt-solarchargers|this link]]. For a full explanation of the Solar Charge Controller options follow [[https://www.victronenergy.com/live/victronconnect:mppt-solarchargers|this link]].
Line 248: 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 workingand 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 workingand you will find information such as battery voltageetc. 
   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.
-'Settings' will allow you to set output voltages/frequency; set low voltage shut-downs, and restarts - together with their alarms; set a dynamic cut-off - based on load; together with other setting about which more information can be found [[https://www.victronenergy.com/live/ve.direct:phoenix-inverters-dynamic-cutoff|here]].+'Settings' will allow you to set output voltages/frequency; set low voltage shut-downs, and restarts - together with their alarms; set a dynamic cut-off - based on load; together with other settings about which more information can be found [[https://www.victronenergy.com/live/ve.direct:phoenix-inverters-dynamic-cutoff|here]].
  
 {{:victronconnect:vc5_iphone_phoenix_livedata.png?direct&175| VictronConnect - Phoenix inverter}} {{:victronconnect:vc5_iphone_phoenix_livedata.png?direct&175| VictronConnect - Phoenix inverter}}
Line 257: 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 'home' page shows information about the battery voltage, charge current, and where your battery is in the charging-cycle. +The 'home' page shows information about the battery voltage, charge current, and where your battery is in the charging cycle. 
  
   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.
Line 270: 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, voltageand temperature. You will also see the voltage of each cell - which is an essential guide to battery health.
   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.   *To access 'Settings' click on the cog icon {{:ve.direct:wrench.png?nolink|}} at the top right of the screen.
 From 'Settings' you can change discharge and temperature parameters. From 'Settings' you can change discharge and temperature parameters.
Line 283: Line 291:
  
 **Windows**\\ **Windows**\\
-Here is a VictronConnect app screenshot from a device using a version of the Microsoft Windows operating system showing information from an MPPT.+Here is a VictronConnect app screenshot from a PC using a version of the Microsoft Windows operating system showing information from an MPPT.
  
 {{:victronconnect:vc4_windows_bluesolar_live.png?direct&600|}} {{:victronconnect:vc4_windows_bluesolar_live.png?direct&600|}}
Line 289: Line 297:
  
 **macOS X**\\ **macOS X**\\
-Here is a VictronConnect app screenshot from a device running the Mac Operating System showing information from an MPPT.+Here is a VictronConnect app screenshot from a PC running the Mac Operating System showing information from an MPPT.
  
 {{:victronconnect:vc4_mac_bluesolar_live.png?direct&600|}} {{:victronconnect:vc4_mac_bluesolar_live.png?direct&600|}}
Line 297: 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 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 Blue Smart IP65 charger.
  
  
Line 310: Line 318:
 {{youtube>vZJA4eTd6vw?medium}} {{youtube>vZJA4eTd6vw?medium}}
  
-==== 5.3 Renaming your devices ====+==== 5.3 Renaming your products ====
  
-It is possible to change the name of your devices to make identification easier. This is especially useful if you have multiple devices, such as 3 MPPTs and 2 BMVs. It is not yet possible to change the name of Smart Lithium batteries. This will be available in the future.+It is possible to change the name of your Victron product to make identification easier. This is especially useful if you have multiple products, such as 3 MPPTs and 2 BMV's.
  
-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: {{:ve.direct:wrench.png?nolink|}}. After opening that menu press {{:victronconnect:vc4_ic_more.png?nolink|}}, and click **Product info**.+To change the name: Firstcomplete your connection; then go to the **Product info** page. To access that page, click the button on the upper right. For some productsit will be the settings icon: {{:ve.direct:wrench.png?nolink|}}. After opening that menu press {{:victronconnect:vc4_ic_more.png?nolink|}}, and click **Product info**.
  
 For other products you'll find the {{:victronconnect:vc4_ic_info.png?nolink|}} button on the upper right, which takes you straight to the Product info page. For other products you'll find the {{:victronconnect:vc4_ic_info.png?nolink|}} button on the upper right, which takes you straight to the Product info page.
Line 323: Line 331:
  
  
-==== 5.4 How to disable Bluetooth ====+==== 5.4 How to disable and re-enable Bluetooth ====
  
-All our products that have Bluetooth built-in, have a feature that allows disabling Bluetooth. Typically the reason for doing so is security, nothing more secure than disabling it. For example on unmanned roadside backup power stations; or other more large scale deployments.+All our products that have Bluetooth built-in, have a feature that allows disabling Bluetooth. Typically the reason for doing so is security, even though the Bluetooth connection is protected by a PIN code, there is nothing more secure than disabling it.
  
-In most cases, it's also possible to re-enable Bluetooth after disabling. For example by using a VE.Direct cable. The only exception is the Lithium Smart batteries: once Bluetooth is disabled on them, it is disabled forever.+In most cases, it's also possible to re-enable Bluetooth after disabling. For example by using a VE.Direct cable. 
  
-Here is how to disable Bluetooth: First complete your connection; then go to the **Product info** page. To access that pageclick the button on the upper right. For some productsit will be the settings icon{{:ve.direct:wrench.png?nolink|}}. After opening that menu press {{:victronconnect:vc4_ic_more.png?nolink|}}, and click **Product info**.+There arehowevera few exceptions: 
 +  * The [[#blue_smart_ip67_chargers|Blue Smart IP67 Chargers]] 
 +  * The [[#lithium_smart_batteries|Lithium Smart batteries]]
  
-For other products you'll find the {{:victronconnect:vc4_ic_info.png?nolink|}} button on the upper right, which takes you straight to the Product info page.+=== Finding the Bluetooth menu ===
  
-If the product supports turning Bluetooth offyou will see the field "Bluetooth" with a switch button next to the text "Bluetooth enabled". Toggle the switch to off, the button will turn from light-blue to grey and a dialogue will be displayed to confirm your action. If you choose to "Cancel" the change Bluetooth will remain on and the switch button and text will return the "Bluetooth enabled" position.+Firstcomplete your connection; then go to the **Product info** page by clicking the button on the upper right:
  
-For **most** of our products, Bluetooth can be re-enabled (see below how to re-enabled it)but for our Lithium Smart batteries this change is **__permanent__** and you'll be asked to enter a confirmation code displayed in the dialogue; if you are sure that you want to permanently disable Bluetooth just enter the code displayed and choose "Ok".+  * For some products, it will be the settings icon: {{:ve.direct:wrench.png?nolink|}}. After opening that menu press {{:victronconnect:vc4_ic_more.png?nolink|}}and click **Product info**
 +  * For other products you'll find the {{:victronconnect:vc4_ic_info.png?nolink|}} button on the upper right, which takes you straight to the Product info page.
  
-== How to re-enable Bluetooth == +If the product has the feature that Bluetooth can be disabled, you will see the field "Bluetooth" with a switch button next to the text "Bluetooth enabled". Toggle the switch to off, the button will turn from light-blue to grey and a dialogue will be displayed to confirm your action. If you choose to "Cancel" the change Bluetooth will remain on and the switch button and text will return the "Bluetooth enabled" position.
  
-//__Warning: This section does not apply to the Lithium Smart batteries. Bluetooth cannot be re-enabled on the Lithium Smart batteries.__//  +For some products, a Disable button is shown instead of a toggle switch. 
 + 
 +=== How to re-enable Bluetooth ===  
 + 
 +//__Warning: This section does not apply to the [[#lithium_smart_batteries|Lithium Smart batteries]]. Bluetooth cannot be re-enabled on the Lithium Smart batteries.__//  
  
 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: 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:
  
-**Via VE.Direct:** Connect the product with a VE.Direct to USB cable to your PC or Android device and use VictronConnect to re-enable Bluetooth in the **Product Info** page (see instructions above on how to reach the Product info page).+== Re-enable Bluetooth using VE.Direct ==
  
-**Smart Chargers:** In all smart chargers, Bluetooth is temporarily enabled at power-up for 30 secondsYou 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.+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 [[#finding_the_bluetooth_menu|here]] on how to reach the Product info page).
  
-//Chargers with a MODE button: //  +== Re-enable Bluetooth using the MODE button on the product ==
  
-Press and hold the MODE button for 10s will reset Bluetooth+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
-  - Disconnect active device +  * Bluetooth will be re-enabled 
-  - Reset PIN code +  * The connected Bluetooth product will be disconnected 
-  - Clear bonding information +  * The PIN code is reset to its [[#bluetooth_smart_-_pairing_and_connecting|default value]] 
-  - Enable Bluetooth +  * The pairing information is cleared; this requires [[victronconnect:start#bluetooth_smart_-_removing_from_the_list_of_paired_devices|removing the product from the list of the paired devices]] as well.
-  - This applies to: +
-    - Phoenix Smart IP43 +
-    - Blue Smart IP22 +
-    Blue Smart IP65+
  
-**Smart Battery Protect:** Bluetooth can be disabled/re-enabled by connecting the PROG pin to ground and +== Lithium Smart batteries == 
-selecting **F** (enable) or **h** (disable)Check the product manual for more details.+The product page can be found [[https://www.victronenergy.com/batteries/lithium-battery-12-8v|here]].\\ 
 +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 "Ok".
  
-**Smart BMV-712:** The BMV-712'on-board Bluetooth module can be turned on or off +== Phoenix Smart IP43 Chargers == 
-through the settings menu. Check the product manual for more details.+The product page can be found [[https://www.victronenergy.com/chargers/phoenix-smart-ip43-charger|here]].\\ 
 +Once Bluetooth is disabled, there are multiple ways to re-enable it again: 
 +  - Using the [[#re-enable_bluetooth_using_the_mode_button_on_the_product|MODE button]]. 
 +  - Using a [[#re-enable_bluetooth_using_vedirect|VE.Direct to USB cable]] to your phone. 
 + 
 +== Blue Smart IP22 Chargers == 
 +The product page can be found [[https://www.victronenergy.com/chargers/blue-smart-ip22-charger|here]].\\ 
 +Once Bluetooth is disabled, it can be re-enabled with the [[#re-enable_bluetooth_using_the_mode_button_on_the_product|MODE button]]. 
 + 
 +== Blue Smart IP65 Chargers == 
 +The product page can be found [[https://www.victronenergy.com/chargers/blue-smart-ip65-charger|here]].\\ 
 +Once Bluetooth is disabled, it can be re-enabled with the [[#re-enable_bluetooth_using_the_mode_button_on_the_product|MODE button]]. 
 + 
 +== Blue Smart IP67 Chargers == 
 +The product page can be found [[https://www.victronenergy.com/chargers/blue-smart-ip67-charger-waterproof|here]].\\ 
 +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 "Ok"
 +  * 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://www.victronenergy.com/solar-charge-controllers|here]].\\ 
 +Bluetooth can be re-enabled by connecting a VE.Direct to USB cable to your phone and following [[#re-enable_bluetooth_using_vedirect|these]] instructions. 
 + 
 +**Smart Battery Protect**\\ 
 +The product page can be found [[https://www.victronenergy.com/battery_protect/smart-battery-protect|here]].\\ 
 +Bluetooth can be disabled/re-enabled by connecting the PROG pin to ground and selecting **F** (enable) or **h** (disable). Check the product manual for more details. 
 + 
 +**Smart BMV-712**\\ 
 +The product page can be found [[https://www.victronenergy.com/battery-monitors/bmv-712-smart|here]].\\ 
 +The BMV-712'onboard Bluetooth module can be turned on or off through the settings menu (setting #71). Check the product manual for more details
 + 
 +**Smart BMS**\\ 
 +The product page can be found [[https://www.victronenergy.com/battery-management-systems/smart%20bms%20current%20limiter|here]].\\ 
 +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://www.victronenergy.com/battery-monitors/smart-battery-shunt|here]].\\ 
 +Bluetooth can be re-enabled by connecting a VE.Direct to USB cable to your phone and following [[#re-enable_bluetooth_using_vedirect|these]] instructions.
 ==== 5.5 Importing and converting a GX Product Family database File ==== ==== 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 of devices) 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://vrm.victronenergy.com|VRM Portal]].+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://vrm.victronenergy.com|VRM Portal]].
  
 {{:victronconnect:vc_log_coverter.jpg?direct&400|}} {{:victronconnect:vc_log_coverter.jpg?direct&400|}}
Line 373: Line 422:
  
 This feature is not available in the iOS and Android mobile versions of VictronConnect. This feature is not available in the iOS and Android mobile versions of VictronConnect.
- 
- 
  
  
Line 385: 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 390: Line 439:
 ** Save settings **  ** Save settings ** 
  
-Connect your device to the Victron product, go to the 'Settings' page and click on the floppy disc icon {{:victronconnect:vc4_floppy.png?nolink&32|}}.+Connect your phone to the Victron product, go to the 'Settings' pageand click on the floppy disc icon {{:victronconnect:vc4_floppy.png?nolink&32|}}.
  
 {{:victronconnect:vc4_saving_settings.png?direct&150|}} {{:victronconnect:vc4_saving_settings.png?direct&150|}}
Line 397: Line 446:
 ** Load settings **  ** Load settings ** 
  
-Connect your device to the Victron product, go to the 'Settings' page and click load icon {{:victronconnect:vc4_load.png?nolink&32|}}, and then select a file from the list.+Connect your phone to the Victron product, go to the 'Settings' pageand click on the load icon {{:victronconnect:vc4_load.png?nolink&32|}}, and then select a file from the list.
  
-When the file is loaded the changes will not immediately be applied. In order that you may review the changes before applying them, the differences between the product's //current// settings, and the //new// settings contained in the loaded file, will be marked-up in orange.+When the file is loadedthe changes are not immediately applied to make it possible to review them first. The differences between the product's //current// settings, and the //new// settings contained in the loaded file, will be marked-up in orange.
  
 {{:victronconnect:vc4_settings_loaded_changes_overview.png?direct&150|}} {{:victronconnect:vc4_settings_loaded_changes_overview.png?direct&150|}}
Line 408: Line 457:
 ** Share settings ** ** Share settings **
  
-The 'Share settings' feature allows you to share the current product settings with other products, using your device.+The 'Share settings' feature allows you to share the current product settings with other products, using your phone.
 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'. 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 ** ** 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:
  
 {{:victronconnect:vc4_settings_file_manager.png?direct&150|}} {{:victronconnect:vc4_settings_file_manager.png?direct&150|}}
  
-From here files can be opened, shared or removed.+From here files can be opened, shared or removed:
  
 {{:victronconnect:vc4_settings_file_manager_options.png?direct&150|}} {{:victronconnect:vc4_settings_file_manager_options.png?direct&150|}}
  
-** 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 constraint for opening files in this modeThe settings file must have been created using the same VictronConnect version that the one running on your phone/computerThis means that if VictronConnect v5.0 is installed in your phone only settings files created with VictronConnect v5.0 can be opened.+The demo library can be 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 older settings files ==== 
 + 
 +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 productA snapshot of all data, including voltage readings, history data, and so forth, will be loaded and visible to inspect. 
 +  - From the product settings pages, only possible when connected to a product. 
 + 
 +Note that the first method only works when the settings file is created with the exact same VictronConnect version that was used to store the fileTo open a file made with an older VictronConnect version, use the second method: connect the same product, and then load 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  than the one used to create the settings file. 
  
 ===== 8. Demo feature ===== ===== 8. Demo feature =====
Line 435: 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's example-settings you will discover the full capability of your product.   * Learn about the settings which are available on your Victron product. By exploring the library's example-settings you will discover the full capability of your product.
-  * 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 'Settings file manager'.   * Besides loading products from the standard library, it is also possible to load them from a saved file using the 'Settings file manager'.
   * Review settings made to your installations, make changes, and then send them to whoever is on-site so that they can apply them.   * Review settings made to your installations, make changes, and then send them to whoever is on-site so that they can apply them.
Line 447: Line 505:
 {{:victronconnect:vc4_demo_library_solar_chargers.png?direct&150|}} {{:victronconnect:vc4_demo_library_solar_chargers.png?direct&150|}}
  
-To load a saved settings file as a demo, go to the 'Settings file manager', click on the file menu button, and select "Open".+To load a saved settings file as a demo, go to the 'Settings file manager', click on the file'menu button, and select "Open".
  
 {{:victronconnect:vc4_settings_file_manager_options.png?direct&150|}} {{:victronconnect:vc4_settings_file_manager_options.png?direct&150|}}
Line 453: Line 511:
 ==== 9.1 Introduction & automatic updates ==== ==== 9.1 Introduction & automatic updates ====
  
-__What about updating Firmware on VE.Bus devices such as MultiPlus and Quattro?__+__What about updating Firmware on VE.Bus products such as MultiPlus and Quattro?__
  
 Please follow this [[https://docs.victronenergy.com/victronconnect-vebus.html#firmware-updates|seperate Firmware guide for updating products such as MultiPlus and Quattro that use a VE.Bus connection]] via an MK3-USB adaptor, instead of VE.direct or Bluetooth. Please follow this [[https://docs.victronenergy.com/victronconnect-vebus.html#firmware-updates|seperate Firmware guide for updating products such as MultiPlus and Quattro that use a VE.Bus connection]] via an MK3-USB adaptor, instead of VE.direct or Bluetooth.
Line 459: Line 517:
 __How can I see what firmware version is available?__ __How can I see what firmware version is available?__
  
-Connect to the product: VictronConnect will prompt to update in case there is a new version available.+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 "Update" button.
  
-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.+Some firmware versions are mandatory, when you connect to the product VictronConnect will prompt to update immediately in case there is a mandatory version available. 
 + 
 +Or, when not close to the product, open the Demo libraryand 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, on your phone/tablet/laptop. When updating the app, all firmware files are updated as well automatically.+No. Updating firmware does **not** require an internet connection, the latest Firmware files are already loaded inside VictronConnect, on your phone. When updating the app, all firmware files are updated as well automatically.
  
 __How does it work?__ __How does it work?__
  
-After connecting your product, VictronConnect will automatically check whether your product is running on the latest firmware version. If there is a newer version, you will be guided through the update procedure before doing anything else.+After connecting your product, VictronConnect will automatically check whether a mandatory update is available, and in that case, you will be guided through the update procedure before doing anything else.
  
-A firmware update - when available - will need to be completed in order to continue using VictronConnect.+If an update is available but is not mandatory, you will be able to see your product's overview page, but you won't be able to change any settings and the **Settings** page will prompt you to update the product. You can start the update to the latest version via the dialog on the **Settings** page, or going to the **Product Info** page and pressing the "Update" button. 
 + 
 +A firmware update - when available - will need to be completed in order to change settings on your Victron product using VictronConnect.
  
 __Will I need to reconfigure my MPPT or BMV after the update?__ __Will I need to reconfigure my MPPT or BMV after the update?__
Line 479: Line 541:
 ==== 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 recommended firmware version. Besides that, it is also possible to update a product with a file that you supply your-self.+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 yourself.
  
 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, thats already available on [[https://professional.victronenergy.com|Victron Professional]] but not yet shipped with VictronConnect. Note that instead of going throught this effort, you can also wait a bit longer, for a new version of VictronConnect to be released. +  * Update to a very recent version, that'already available on [[https://professional.victronenergy.com|Victron Professional]] but not yet shipped with VictronConnect. Note that instead of going through this effort, you can also wait a bit longer, for a new version of VictronConnect to be released. 
-  * Update a product to a special version, such as the required to disable Bluetooth in the Lithium batteries. See the files in [[https://professional.victronenergy.com|Victron Professional]] for more information about that.+  * Update a product to a special or unreleased version.
  
  
 === Instructions for Windows and MacOS computers === === Instructions for Windows and MacOS computers ===
  
-With your device and Victron product paired via VictronConnect, go to the "Product info" page, click on "Update" and open the correct firmware file.+With your phone and Victron product connected to VictronConnect, go to the "Product info" page, click on "Update" and open the correct firmware file
 + 
 +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".
  
 {{:victronconnect:vc4_mac_firmware_productinfo.png?direct&600|}} {{:victronconnect:vc4_mac_firmware_productinfo.png?direct&600|}}
Line 496: 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.
- +
-Firstlyyou 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.+
  
-**Note for iOS**: The current version of Google Chrome for iOS fails to download ".dupfiles from the Victron Professional website - so we recommended using Safari instead.+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 VictronConnectVictronConnect will be opened and show: "File added to the firmware library".
  
-**Note for Android**: VictronConnect needs to be running before opening files. +If the message doesn't appearrepeat the previous step or try opening from a different App (for example, Dropbox instead of the internetor Email).
-Open VictronConnect andwithout closing it, switch to the app containing the fileselect it and choose to open it with VictronConnect.+
  
 +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.
  
 +  * **Note for iOS**: The current version of Google Chrome for iOS fails to download ".dup" files from the Victron Professional website - so we recommend using Apple Safari, the default browser on iOS, instead.
 +  * **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.
  
-On both iOS and Android, go to the app that contains the firmware file, tap on it, and open it with VictronConnect.+Here are screenshot showing the detailed steps:
  
 {{:victronconnect:vc_ios_firmware_download.png?direct&150|}} {{:victronconnect:vc_ios_firmware_download.png?direct&150|}}
Line 513: Line 578:
 {{:victronconnect:vc_ios_firmware_mail_attachment.png?direct&150|}} {{:victronconnect:vc_ios_firmware_mail_attachment.png?direct&150|}}
  
-VictronConnect will be opened and should read: "File added to the firmware library". If the message doesn't appearrepeat the previous step. +Now, after adding the firmware file to the library, go to the "Product info" page and tap on "Update firmware":
- +
-Go to the "Product info" page and tap on "Update firmware".+
  
 {{:victronconnect:vc4_ios_firmware_settings.png?direct&150|}} {{:victronconnect:vc4_ios_firmware_settings.png?direct&150|}}
 {{:victronconnect:vc4_ios_firmware_productinfo.png?direct&150|}} {{:victronconnect:vc4_ios_firmware_productinfo.png?direct&150|}}
  
-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 - but we strongly recommended that you only attempt to load files with the "Show only compatible firmware" option enabled.+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 file.
  
 {{:victronconnect:vc4_ios_firmware_library.png?direct&150|}} {{:victronconnect:vc4_ios_firmware_library.png?direct&150|}}
  
-Once selected you will be guided through the update process.+Once selected you will be guided through the update process:
  
 {{:victronconnect:vc4_ios_firmware_ready.png?direct&150|}} {{:victronconnect:vc4_ios_firmware_ready.png?direct&150|}}
Line 533: Line 596:
 ==== 9.3 Troubleshooting firmware updates ==== ==== 9.3 Troubleshooting firmware updates ====
  
-A troubleshooting guide relevant to firmware updates can be found in [[#problems_during_firmware_updating|chapter 10.3]]+A troubleshooting guide relevant to firmware updates can be found in [[#problems_during_firmware_updating|chapter 11.3]]
  
 ==== 9.4 Error codes ==== ==== 9.4 Error codes ====
Line 539: Line 602:
 In spite of our painstaking efforts, sometimes errors occur. But don't worry, it is always possible to recover your product.  In spite of our painstaking efforts, sometimes errors occur. But don't worry, it is always possible to recover your product. 
  
-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/tablet/laptop+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 [[#bluetooth_smart_-_removing_from_the_list_of_paired_devices|remove the Bluetooth pairing information from your device]] in order to be able to reconnect with your product.+Sometimes you may need to [[#bluetooth_smart_-_removing_from_the_list_of_paired_devices|remove the Bluetooth pairing information from your phone]] in order to be able to reconnect with your product.
  
 In the following list, you can check possible errors and descriptions. In the following list, you can check possible errors and descriptions.
Line 675: Line 738:
 |X45 |Update Error. Vreg Ack error: Invalid instance. 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.| |X46 |Update Error. Vreg Ack error. Please check the connection and try again.|
-===== 10. Troubleshooting ===== 
  
-==== 10.1 Common Bluetooth problems and how to solve them === 
  
-== I cannot find my device listed ==+===== 10. VictonConnect-Remote (VC-R) – Configuration and monitoring via VRM ===== 
 + 
 +==== 10.1 Introduction ==== 
 + 
 +VictronConnect-Remote functionality enables Victron products with a VE.Direct interface to be accessed remotely through a [[https://www.victronenergy.com/live/venus-os:start|GX product]], via the [[https://vrm.victronenergy.com|VRM online portal]]. 
 + 
 +This powerful feature allows full product configuration and monitoring from practically anywhere in the world using the VictronConnect app. 
 + 
 +The user interface experience is just like the products were connected locally using Bluetooth or a wired VE.Direct to USB interface. 
 + 
 +A video demonstrating the feature is available here: 
 +{{youtube>9P2W4FmTvbY?medium}} 
 + 
 + 
 +==== 10.2 Compatibility ==== 
 + 
 +The VictronConnect-Remote feature is ONLY compatible with products connected to a GX product 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) 
 + 
 +Products connected with a VE.Bus interface, such as Multiplus/Quattro inverter-chargers and larger Phoenix Inverters are NOT compatible. However, another feature [[https://www.victronenergy.com/live/vrm_portal:remote-veconfigure|Remote VEConfigure]] already exists to configure these products remotely. 
 + 
 +Products 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 Product- Venus OS FW: v2.40 (However v2.53 recommended for full functionality) 
 + 
 +=== 10.3.2 VictronConnect === 
 + 
 +  - Confirm that the phone 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’ 
 + 
 +{{:victronconnect:vcr_1.png?direct&200|VictronConnect-Remote - VRM Tab Sign In}} 
 +{{:victronconnect:vcr_2.png?direct&200|VictronConnect-Remote - Login to VRM}} 
 + 
 +  * If using a tablet or PC your browser may also request permission to open VictronConnect, if prompted select ‘Open’ 
 + 
 +{{:victronconnect:vcr_3.png?direct&400|VictronConnect-Remote - Permission}} 
 + 
 +=== 10.3.3 GX Product === 
 + 
 +1- Confirm that the GX Product 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 
 + 
 +{{:victronconnect:vcr_4.png?direct&400|VictronConnect-Remote - GX Product Settings}} 
 + 
 +==== 10.4 Local Tab ==== 
 + 
 +The local tab displays all products that are within local Bluetooth and wireless LAN range or physically connected to the phone with VictronConnect (such as with a VE.Direct to USB or MK3 to USB interface cable) 
 + 
 +{{:victronconnect:vcr_5.png?direct&200|VictronConnect-Remote - Local Tab}} 
 + 
 +==== 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 products. 
 + 
 +{{:victronconnect:vcr_6.png?direct&200|VictronConnect-Remote - VRM Tab}} 
 + 
 +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 product, the name of the VRM installation, and a direct link to the associated [[https://vrm.victronenergy.com|VRM Online Portal]]. 
 + 
 +{{:victronconnect:vcr_7.png?direct&200|VictronConnect-Remote - Installation Connecting}} 
 +{{:victronconnect:vcr_8.png?direct&200|VictronConnect-Remote - Overview Tab}} 
 + 
 +=== 10.5.2 Devices Tab === 
 + 
 +The ‘DEVICES’ tab has a list of all compatible products that are physically connected to the GX product. 
 + 
 +{{:victronconnect:vcr_9.png?direct&200|VictronConnect-Remote - Devices Tab}} 
 + 
 +If using a tablet or PC, the ‘DEVICES’ tab is shown as a panel on the right side of the same screen. 
 + 
 +{{:victronconnect:vcr_10.png?direct&600|VictronConnect-Remote - Tablet View}} 
 + 
 +==== 10.6 Remote product access ==== 
 + 
 +When a product is selected it will take a few seconds for a connection to be made, once the connection is established live product information/data will begin to appear. 
 + 
 +{{:victronconnect:vcr_11a.png?direct&200|VictronConnect-Remote - BMV Device Selection}} 
 +{{:victronconnect:vcr_11.png?direct&200|VictronConnect-Remote - BMV Connecting}} 
 + 
 +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. 
 + 
 +{{:victronconnect:vcr_12.png?direct&200|VictronConnect-Remote - BMV Settings Download}} 
 +{{:victronconnect:vcr_13.png?direct&200|VictronConnect-Remote - BMV Settings Ready}} 
 + 
 +==== 10.7 Signing out ==== 
 + 
 +To disable the link between VictronConnect-Remote and your VRM account, expand the main menu and then select ‘Settings’. 
 + 
 +{{:victronconnect:vcr_14.png?direct&200|VictronConnect-Remote - Sign Out 1}} 
 +{{:victronconnect:vcr_15.png?direct&200|VictronConnect-Remote - Sign Out 2}} 
 + 
 +In the settings page select ‘SIGN OUT’ and then select ‘OK’ in the prompt window to confirm. 
 + 
 +{{:victronconnect:vcr_16.png?direct&200|VictronConnect-Remote - Sign Out 3}} 
 +{{:victronconnect:vcr_17.png?direct&200|VictronConnect-Remote - Sign Out 4}} 
 + 
 +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 ==== 
 + 
 +== Product not found == 
 + 
 +  * VictronConnect-Remote is only compatible with products that use a VE.Direct interface to the GX product – see the ‘compatibility’ section. 
 +  * Ensure that that the missing product is physically connected to the GX product, with the VE.Direct cable properly installed at both ends. 
 +  * Ensure that the product is running a recent firmware version. 
 + 
 +== Installation/GX product not found or offline == 
 + 
 +  * 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 product is running the minimum compatible Venus OS firmware version – see the ‘settings’ section. 
 + 
 +== VictronConnect has no VRM tab == 
 + 
 +  * Ensure that the phone 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://www.victronenergy.com/live/vrm_portal:getting_started|Getting started with VRM]] and the [[https://vrm.victronenergy.com|VRM online portal]] site. 
 + 
 +== Systems with no GX product == 
 + 
 +  * VictronConnect-Remote functionality is not possible unless the system includes a GX product. A GX product can be easily added to any system and there are a [[https://www.victronenergy.com/live/venus-os:start|range of products available]]. 
 + 
 +== Installations with no internet connection == 
 + 
 +  * VictronConnect-Remote functionality is not possible unless the GX product at the installation site has an active internet connection. 
 +  * For remote sites without an existing internet connection or with mobile installations, a [[https://www.victronenergy.com/accessories/gx-gsm|Victron GX GSM modem]] can be easily be added to the system in order to provide an internet connection. 
 + 
 +== Large systems == 
 + 
 +  * The use of the VictronConnect-Remote feature will slightly increase the GX product CPU load. 
 +  * In some large/complex systems (with many products connected to the GX product) the CPU may already be operating at its limit and any additional CPU load could exceed its capability - this will typically be recognisable by slow user interface response and/or unexpected system reboots. 
 +  * It is important to select a GX product 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/complex systems – see the performance section in the [[https://www.victronenergy.com/live/venus-os:start|GX product range comparison table]]. 
 + 
 +== VictronConnect Remote troubleshooting == 
 + 
 +VictronConnect will report errors encountered during communication attempts with VRM in a message box with an error code (e.g. #R999, or #V2). The numeric part of the code can have one of the following value: 
 + 
 +^Error ^Description^ 
 +|999 | 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. It could also indicate issues with your credentials. | 
 +| 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 "Service Report" and submit it for examination. 
 + 
 +VictronConnect Remote is establishing communication with a range of services on the 'victronenergy.com' domain. Please make sure that traffic with this domain is allowed in your firewall and internet security application. 
 + 
 +===== 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, and Victron product. 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 product listed ==
   * Make sure that you have a "Smart" Victron product. It needs to have a Bluetooth symbol.   * Make sure that you have a "Smart" Victron product. It needs to have a Bluetooth symbol.
-  * Make sure your device is in range. +  * Make sure your product 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#problems_during_firmware_updating | section 9.3]]. +  * If a firmware update failed, the product //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#problems_during_firmware_updating | section 9.3]]. 
-  * Only one device can be connected to a product at the same time. Make sure that no other device: phone/tablet/laptop is already connected. +  * Only one phone can be connected to a product at the same time. Make sure that no other phone is already connected. 
-  * Make sure you are attempting to connect from //within// VictronConnect - not from the system menu of your phone/tablet/laptop. If you have connected from the system menu: close VictronConnect, [[start#bluetooth_smart_-_removing_from_the_list_of_paired_devices |remove the pairing information from your device]], and then open and connect to your product from //within// VictronConnect.+  * Make sure you are attempting to connect from //within// VictronConnect - not from the system menu of your phone. If you have connected from the system menu: close VictronConnect, [[start#bluetooth_smart_-_removing_from_the_list_of_paired_devices |remove the pairing information from your phone]], and then open and connect to your product from //within// VictronConnect.
  
-== I can see but not connect to my device ==  +== I can see but not connect to my product ==  
-  - Make sure you are trying to connect to the right device. See [[start#renaming_your_devices | section 4.3]] to learn how you can give your device a //Custom Name//. +  - Make sure you are trying to connect to the right product. See [[start#renaming_your_devices | section 4.3]] to learn how you can give your product a //Custom Name//. 
-  - Make sure your device is in range. It can be that you are close enough to see the device but not close enough to connect to it. +  - Make sure your product is in range. It can be that you are close enough to see the product but not close enough to connect to it. 
-  - Make sure that Bluetooth is still enabled in your phone/tablet/laptop. If Bluetooth was disabled after scanning, you may be able to see your device listed but you won't be able to connect to it. +  - Make sure that Bluetooth is still enabled on your phone. If Bluetooth was disabled after scanning, you may be able to see your product listed but you won't be able to connect to it. 
-  - The Bluetooth bonding information may be outdated. This happens when the PIN code has been changed in the device, or if your Victron device has been connected to too many phones/tablets/Laptops. The device will only remember the last 10 phones/tablets/laptops connected to it. To solve this, remove the pairing completely from your phone/tablet/laptop system menu. Then open VictronConnect and re-pair the product and your device. Watch these instructional videos to learn how to remove the pairing on {{victronconnect:video_unpair_android_cropped.mp4?linkOnly | Android}} or {{victronconnect:video_unpair_ios.mp4?linkOnly | iOS}} devices+  - Bluetooth bonding information may be outdated. This happens when the PIN code has been changed in the product, or if your Victron product has been connected to too many phones. The product will only remember the last 10 phones connected to it. To solve this, remove the pairing completely from your phone system menu. Then open VictronConnect and re-pair the product and your phone. Watch these instructional videos to learn how to remove the pairing on {{victronconnect:video_unpair_android_cropped.mp4?linkOnly | Android}} or {{victronconnect:video_unpair_ios.mp4?linkOnly | iOS}}. 
-  - If you are using an Android phone/tablet, check [[start#bluetooth_connection_issues_on_android_devices| section 9.2]] below for issues particular to Android.+  - If you are using an Android phone, check [[start#bluetooth_connection_issues_on_android_devices| section 11.2]] below for issues particular to Android as well.
  
 === Connection fails around 20% === === Connection fails around 20% ===
  
-[[https://www.victronenergy.com/live/victronconnect:start#bluetooth_smart_-_removing_from_the_list_of_paired_devices|Remove the device from the paired devices list]] in the phones Bluetooth settings. [[https://www.victronenergy.com/live/victronconnect:start#bluetooth_smart_-_changing_the_pin_code|Then change the PIN code.]] +  - Make sure you are up to date with the latest version of VictronConnect. 
-==== 10.2 Bluetooth connection issues on Android devices ====+  - [[https://www.victronenergy.com/live/victronconnect:start#bluetooth_smart_-_removing_from_the_list_of_paired_devices|Remove the product from the paired devices list]] in the phone'Bluetooth settings.  
 +  - Then [[https://www.victronenergy.com/live/victronconnect:start#bluetooth_smart_-_resetting_the_pin_code|Reset the PIN code]] 
 +  - Force close the VictronConnect appInstructions: [[https://support.apple.com/en-us/HT201330|how to for iPhone and iPad]], [[https://support.mobileroadie.com/hc/en-us/articles/200091926-How-To-Force-Quit-Android-Apps|how to for Android]]. If you are unsure how to do this, then uninstalling and re-installing the app works as well) 
 +  - Reconnecting in VictronConnect using the default PIN 000000 
 +  - Then [[https://www.victronenergy.com/live/victronconnect:start#bluetooth_smart_-_changing_the_pin_code| change the PIN code.]]
  
-=== Step 1: Check that your device is supported ===+==== 11.2 Bluetooth connection issues on Android ====
  
-See section [[#android_devices|3.3 Compatibility for Android devices]]+=== Step 1: Check that your phone is supported === 
 + 
 +See section [[#android_devices|3.3 Compatibility for Android]]
  
 === Step 2: Check the Android version === === Step 2: Check the Android version ===
Line 710: Line 960:
 === 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 bluetooth devices. Unless you checked "Don't show again" Victron connect will warn on each discovery attempt when permissions are not granted or location services are disabled.+On Android 5 and later VictronConnect needs access to the phone'location services to be able to scan nearby Bluetooth products. Unless you checked "Don't show again" VictronConnect will warn on each discovery attempt when permissions are not granted or location services are disabled.
  
 Permission to access location services is requested each time the app starts ...but if you checked the "Don't show again" option while denying, the request won't appear again.. You can grant permission by going to the Android settings -> Applications -> VictronConnect -> Permissions, and then enable the "Location" permission. Another way is to uninstall and then reinstall VictronConnect. Permission to access location services is requested each time the app starts ...but if you checked the "Don't show again" option while denying, the request won't appear again.. You can grant permission by going to the Android settings -> Applications -> VictronConnect -> Permissions, and then enable the "Location" permission. Another way is to uninstall and then reinstall VictronConnect.
Line 716: Line 966:
 === Step 4. Enable Location (or GPS) functionality in the system settings === === Step 4. Enable Location (or GPS) functionality in the system settings ===
  
-For Bluetooth scanning to work, the Location (or GPS) functionality on the device needs to be enabled.+For Bluetooth scanning to work, the Location (or GPS) functionality on the phone needs to be enabled.
  
-=== Step 5. Search & connect from within VictronConnect ...NOT from the system Bluetooth menu ===+=== Step 5. Search & connect from within VictronConnect, and NOT from the system Bluetooth menu ===
  
 === Step 6. Pin-code pop-up never shows === === Step 6. Pin-code pop-up never shows ===
  
-On some Android phones, the pin-code pop-up dialog doesn't show. It is hidden into the notifications bar. +On some Android phones, the PIN code pop-up dialog doesn't show. It is hidden into the notifications bar. 
  
 Try to connect and when the connection is stuck at 80%, open the notifications bar and check if the PIN code/Pair request is there, if it the case open it and enter the PIN code. Try to connect and when the connection is stuck at 80%, open the notifications bar and check if the PIN code/Pair request is there, if it the case open it and enter the PIN code.
 +
 +On Android it is also possible that other apps prevent the PIN code pop-up from showing, even when pairing in the Android Bluetooth settings menu. One such an app is "FrSky Free Link", which even blocks pairing with Bluetooth headsets. In this case, the thing to do is remove the problematic app. This can be done by uninstalling apps one by one (starting with apps that use or connect to Bluetooth devices), removing all apps or even resetting the phone to factory defaults. When the Victron products are paired to the phone/tablet, the problematic app can be re-installed.
  
 The default pin-code is 000000, six times zero. The default pin-code is 000000, six times zero.
 +
  
 === Step 7. Try another phone at first === === Step 7. Try another phone at first ===
  
-If you are still experiencing difficulties, having tried the steps above, try connecting using another phone ...preferably an Apple phone or tablet as they work without any issues.+If you are still experiencing difficulties, having tried the steps above, try connecting using another phonepreferably an Apple phone or tablet as they work without any issues.
  
-When successfully connected using another device, VictronConnect will automatically update the firmware in the Victron bluetooth device. After the firmware has been updated you may find that you can use the Android device with which you were experiencing difficulties. +When successfully connected using another phone, VictronConnect will automatically update the firmware in the Victron Bluetooth product. After the firmware has been updated you may find that you can use the Android phone with which you were experiencing difficulties.
-==== 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 ====
  
-Keep your mobile device as close to the product as possibleIf 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/tablet/laptop system menu. Then open VictronConnect and re-pair the product and your device. +First of all, it's good to know that you can always restart the firmware update procedureThe update process will be restarted each time you connect to the product.
-Watch these instructional videos to learn how to remove the pairing on {{ :victronconnect:video_unpair_android_cropped.mp4?linkOnly | Android}} or {{ :victronconnect:video_unpair_ios.mp4?linkOnly | iOs }} devices+
  
-If the firmware update stops at a random percentage during each retry, just keep trying - it will succeed eventually. If the update fails even after many attempts, try using another phone or tablet ...if possible an Apple iOS device - they usually work without any issues. After the update, you may find you can use the phone with which you were having difficulty.+Keep your phone as close to the product as possible. If the update fails due to Bluetooth connectivity problems, and if your phone is already paired to a product, try and remove the pairing completely from your phone's system menu. Then open VictronConnect and re-pair the product and your phone. 
 +Watch these instructional videos to learn how to remove the pairing on {{ :victronconnect:video_unpair_android_cropped.mp4?linkOnly | Android}} or {{ :victronconnect:video_unpair_ios.mp4?linkOnly | iOs }}. 
 + 
 +If the firmware update stops at a random percentage during each retry, just keep trying - it will succeed eventually. If the update fails even after many attempts, try using another phone or tabletif possible an Apple iOS phone - they usually work without any issues. After the update, you may find that you can use the phone with which you were having difficulty.
  
 === Update stops at 4% or earlier === === Update stops at 4% or earlier ===
-When the firmware update fails at 4% or less, VictronConnect cannot make the device switch to the update mode. +When the firmware update fails at 4% or less, VictronConnect cannot make the product switch to the update mode. 
  
 __ Solution for Blue Smart IP65 Chargers __ __ Solution for Blue Smart IP65 Chargers __
Line 762: Line 1016:
   * 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 "Mavericks" doesn't work properly with the VE.Direct USB cable. To fix this issue we recommend updating to a later version of macOS. The driver included in macOS X 10.9 "Mavericks" doesn't work properly with the VE.Direct USB cable. To fix this issue we recommend updating to a later version of macOS.
Line 783: Line 1037:
 VictronConnect should now show the connected products. VictronConnect should now show the connected products.
  
-==== 10.5 VictronConnect on Windows doesn't find VE.Direct USB connected devices ====+==== 11.5 VictronConnect on Windows doesn't find VE.Direct USB connected products ====
  
 VE.Direct USB cable requires a driver to be installed.  VE.Direct USB cable requires a driver to be installed. 
Line 789: Line 1043:
 The necessary drivers are available in the [[https://www.victronenergy.com/support-and-downloads/software#victronconnect-app|software section]]. The necessary drivers are available in the [[https://www.victronenergy.com/support-and-downloads/software#victronconnect-app|software section]].
  
-==== 10.6 VictronConnect on Android doesn't show files oppened from email or file manager apps ====+==== 11.6 VictronConnect on Android doesn't show files opened from email or file manager apps ====
  
-VictronConnect needs to be running before oppening files.+VictronConnect needs to be running before opening files.
  
-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 "VictronConnect Service Report" If you are experiencing issues with VictronConnect or your Victron product, you may be asked to create a "VictronConnect Service Report"
 +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 808: Line 1063:
   - Select Settings   - Select Settings
   - Click or tap CREATE SERVICE REPORT   - Click or tap CREATE SERVICE REPORT
-  - Save, email or copy the file to Victron, via email or the Victron Community.+  - Save, emailor copy the file to Victron, via email or the Victron Community.
  
  
 {{:victronconnect:victronconnect_service_report.jpg?direct&400|}} {{:victronconnect:victronconnect_service_report.jpg?direct&400|}}
  
-==== 10.8 VE.Bus firmware update fails at 5% on macOS ====+If you require more detailed power system diagnostic information, for example, detailed monitoring of battery voltage and state of charge readings over time, this may require connecting a [[https://www.victronenergy.com/live/venus-os:start|GX product]]. 
 +==== 11.8 VE.Bus firmware update fails at 5% on macOS ====
  
 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: 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:
Line 822: Line 1078:
  
 (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. (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.
-===== 11. Compatible Victron products ===== 
  
-==== SmartSolar MPPT Charge controllers ====+===== 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://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]            | Yes - Built in         | | MPPT 75/10             | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]            | Yes - Built in         |
Line 851: Line 1110:
 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  | No             | Yes - Built in                       | +
- +
-==== Blue Smart IP67 Chargers ==== +
-^                               ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ +
-| All Blue Smart IP67 Chargers  | No             | Yes - Built in                       | +
- +
-==== Orion-Tr Smart DC-DC Charger Isolated ==== +
-^                               ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ +
-| All Orion-Tr Smart DC-DC Isolated Chargers   | No             | Yes - Built in                       | +
- +
-==== Phoenix Smart IP43 Charger ==== +
-^                               ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ +
-| All Phoenix Smart IP43 Chargers  | Yes            | Yes - Built in                       | +
- +
- +
- +
- +
-==== Battery Monitors ==== +
-^          ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ +
-| BMV-700  | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]            | [[https://www.victronenergy.com/accessories/ve-direct-bluetooth-smart-dongle|VE.Direct to Bluetooth accessory required]]       | +
-| BMV-702  | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]           | [[https://www.victronenergy.com/accessories/ve-direct-bluetooth-smart-dongle|VE.Direct to Bluetooth accessory required]]       | +
-| BMV-700H | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]           | [[https://www.victronenergy.com/accessories/ve-direct-bluetooth-smart-dongle|VE.Direct to Bluetooth accessory required]]       | +
-| BMV-712  | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]           | Yes - Built in         | +
-==== 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 899: Line 1129:
  
  
 +==== Battery Chargers ====
  
 +^ Blue Smart IP22                 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/off           ^ Charge cycle history       ^ Advanced settings ^
 +| All Blue Smart IP22 Chargers    | No                     | Yes - Built in         | Yes - Since firmware v3.12 | No                         | No                |
 +^ Blue Smart IP65                 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/off           ^ Charge cycle history       ^ Advanced settings ^
 +| Blue Smart IP65 12/25 Charger   | No                     | Yes - Built in         | Yes                        | Yes                        | Yes               |
 +| Blue Smart IP65 24/13 Charger   | No                     | Yes - Built in         | Yes                        | Yes                        | Yes               |
 +| Other Blue Smart IP65 Chargers  | No                     | Yes - Built in         | Yes - Since firmware v3.12 | No                         | No                |
 +^ Blue Smart IP67                 ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/off           ^ Charge cycle history       ^ Advanced settings ^
 +| All Blue Smart IP67 Chargers    | No                     | Yes - Built in         | Yes - Since firmware v3.12 | No                         | No                |
 +^ Phoenix Smart IP43              ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^ Bluetooth on/off           ^ Charge cycle history       ^ Advanced settings ^
 +| 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/off           ^ Charge cycle history       ^ Advanced settings ^
 +| All IMPULSE-II Smart Chargers   | No                     | Yes - Built in         | Yes - Since firmware v3.09 | Yes - Since firmware v3.09 | No                |
 +
 +
 +==== Orion-Tr Smart DC-DC Charger Isolated ====
 +^                               ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^
 +| All Orion-Tr Smart DC-DC Isolated Chargers   | No             | Yes - Built in                       |
 +
 +==== Battery Monitors ====
 +^          ^ USB via VE.Direct port ^ Wireless Via Bluetooth ^
 +| BMV-700  | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]            | [[https://www.victronenergy.com/accessories/ve-direct-bluetooth-smart-dongle|VE.Direct to Bluetooth accessory required]]       |
 +| BMV-702  | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]           | [[https://www.victronenergy.com/accessories/ve-direct-bluetooth-smart-dongle|VE.Direct to Bluetooth accessory required]]       |
 +| BMV-700H | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]           | [[https://www.victronenergy.com/accessories/ve-direct-bluetooth-smart-dongle|VE.Direct to Bluetooth accessory required]]       |
 +| BMV-712  | [[https://www.victronenergy.com/accessories/ve-direct-to-usb-interface|VE.Direct to USB accessory required]]           | Yes - Built in         |
  
  
Line 940: Line 1195:
  
  
-^ ^  USB via VE.Direct port^  Wireless Via Bluetooth^ +
-|  Phoenix Smart IP43 Charger 12/30|  No VE.Direct port|  Yes - Built in| +
-|  Phoenix Smart IP43 Charger 12/50|  No VE.Direct port|  Yes - Built in| +
-|  Phoenix Smart IP43 Charger 24/16|  No VE.Direct port|  Yes - Built in| +
-|  Phoenix Smart IP43 Charger 24/25|  No VE.Direct port|  Yes - Built in|+
  
    
Line 954: Line 1205:
  
 ==== 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, MultiCompact, Multi (the models introduced in 2018), Quattro, EasySolar, EasySolar-II, MultiGrid and ECOMultis. 
  
-In order to keep this section short, all these devices are referred to as VE.Bus products.+This section applies to MultiPlus, MultiPlus-II, MultiCompact, Multi (the models introduced in 2018), Quattro, EasySolar, EasySolar-II, MultiGrid, and ECOMultis. 
 + 
 +In order to keep this section short, all these products are referred to as VE.Bus products.
  
-The minimal required version of the VE.Bus devices is 19xx111 for European units and 20xx111 for 120V, which were released in 2007. Older models, 18xxxxx are not supported.+The minimal required version of the VE.Bus products are 19xx111 for European units and 20xx111 for 120V, which were released in 2007. Older models, 18xxxxx are not supported.
  
 The currently sold generation, VE.Bus firmware 26xxxxx and 27xxxxx is supported.  The currently sold generation, VE.Bus firmware 26xxxxx and 27xxxxx is supported. 
Line 971: Line 1223:
 Note that switching between on/off/charger-only as well as setting the input current limit is not possible when there is a DMC or VE.Bus BMS installed. Note that switching between on/off/charger-only as well as setting the input current limit is not possible when there is a DMC or VE.Bus BMS installed.
  
-For systems with a [[venus-os:start|GX device]] installed, and running firmware version 415 or newer, switching between on/off/charger-only and setting the input current limit IS possible.+For systems with a [[venus-os:start|GX product]] installed, and running firmware version 415 or newer, switching between on/off/charger-only and setting the input current limit IS possible.
victronconnect/start.1573885192.txt.gz · Last modified: 2019-11-16 07:19 by guy_stewart