Victron energy Color Control GX Installation guide

2020-10-15 20:48 1/8 Color Control GX FAQ
Victron Energy - https://www.victronenergy.com/live/
Color Control GX FAQ
Q1: I cannot switch my Multi/Quattro system on or off
To solve the problem, first find out how the system is connected, and then follow the right step by
step instruction below. There are two ways to connect a Multi/Quattro system to a Color Control GX. In
most systems they will be connected directly to the VE.Bus port on the back of the CCGX. And, option
two, in some systems they are connected to the Color Control GX using a VE.Bus to VE.Can interface.
Step by step instructions when connected to VE.Bus port on the CCGX
Update the Color Control to the latest available version. See our blog posts in the1.
https://www.victronenergy.com/blog/category/firmware-software/.
Do you have a Digital Multi Control or VE.Bus BMS in the system? In that case it is normal that2.
on/off is disabled. See also the VE.Bus related notes in the CCGX manual
In case you have had a Digital Multi Control or VE.Bus BMS connected to your system, the Color3.
Control remembers it and even when those accessories have been removed the On/off switch
will still be disabled. To clear the memory, execute a Redetect system, the option is in the Multi
or Quattro section of the Color Control GX menu.
For parallel/three phase systems consisting of more than 5 units: depending on temperature4.
and other circumstances, it might not be possible to switch a system back on after switching it
off with the CCGX. As a work around you'll need to unplug the VE.Bus cable from the back of the
Ccgx. And plug it back in after starting the VE.Bus system. The real resolution is to install the
“CCGX dongle for large VE.Bus systems”, partnumber BPP900300100. For details, read its
connection instruction.
Step by step instructions when connected to CCGX via VE.Can
Update the Color Control to the latest available version. See our blog posts in the firmware1.
category.
Update the VE.Bus to VE.Can interface to the latest version. The easiest way to do that is by2.
using Remote firmware update: having a special piece of hardware, the CANUSB, is then not
necessary.
Do you have a Digital Multi Control or VE.Bus BMS in the system? In that case it is normal that3.
on/off is disabled. See also the VE.Bus related notes in the CCGX manual
In case you have had a Digital Multi Control or VE.Bus BMS connected to your system, and it is4.
now no longer connected, the Canbus interface remembers it. Therefore, even after those
accessories have been removed, the On/off switch will still be disabled. Clearing this memory is
unfortunately not possible yourself, please contact us so we can help you.
Q2: Do I need a BMV to see proper battery state of charge?
Moved here.

Last update: 2020-10-15 10:33 ccgx:ccgx_faq https://www.victronenergy.com/live/ccgx:ccgx_faq
https://www.victronenergy.com/live/ Printed on 2020-10-15 20:48
Q3: I have no internet, where can I insert a sim-card?
There is no 3G modem in the Color Control, and therefore also no slot for a sim-card. Go to a local
store and buy a 3G router with Ethernet ports. More information in the blog post link below and
particularly in the comments section, as more users try differing equipment:
https://www.victronenergy.com/blog/2014/03/09/off-grid-color-control-gx-to-vrm-portal-connectivity/
Note that it is not possible to use a VGR2 or VER for this. Also it will not be possible in the foreseeable
future.
Q4: Can I connect both a Color Control and a VGR2/VER to a
Multi/Inverter/Quattro?
No. Also, instead of this combination, we recommend to use the Color Control GX, and add a 3G or
similar mobile router. See the Internet Connectivity chapter in the CCGX manual.
Q5: Can I connect multiple Color Controls to a Multi/Inverter/Quattro?
No.
Q6: I see incorrect current (amps) or power readings on my CCGX
Examples are:
I know that a load is drawing 40W from the Multi, but the CCGX shows 10W or even 0W.
I see that the Multi is supplying a load with 2000W, while in inverter mode, but from the battery
only 1850W is being taken. Is those 150W coming out of nowhere?
The general answer is: the Multi and Quattros are not measurement instruments, they are
inverter/chargers, and the measurements shown are a best effort delivery.
In more detail, there are several causes for measurement inaccuracies:
Part of the power taken from a battery by the inverter is being lost in the inverter, converted1.
into heat: efficiency losses.
The Multi does not really measure the power being drawn from the battery. It measures the2.
current at the output of the inverter, and then makes an assumption of the power being drawn
from the battery.
Watts vs VA: depending on the Multi/Quattro firmware version and also the CCGX firmware3.
version, you are either looking at VAs (the result of calculating AC voltage * AC current) or
looking at a Watts measurement. To see WATTS on the CCGX, update your CCGX to the latest
version (v1.21 or newer). Also make sure the firmware version in your Multi supports Watts
readout, minimum versions are xxxx154, xxxx205 and xxxx300.
Multis/Quattros connected to the CCGX via a VE.Bus to VE.Can interface will always reports VAs,4.
not (yet) Watts.
If a current sensor assistant is loaded in a Multi/Quattro and no sensor is connected it will return5.

2020-10-15 20:48 3/8 Color Control GX FAQ
Victron Energy - https://www.victronenergy.com/live/
invalid power / kWh values.
If a current sensor assistant is loaded in a Multi/Quattro make sure the position is set correctly6.
and the scale match with the dipswitches on the sensor itself.
A current sensor assistant measures and reports VAs, not Watts.7.
Notes for systems with multiple units in parallel:
Ccgx version prior to v1.20 use the power and current reported by the master of a phase and1.
multiplied that by the number of devices in that phase. Since version v1.20 the values of all
device is summed per phase and hence should be more accurate.
This revealed a bug for in the firmware of the multi when running in parallel. Ccgx v1.211.
workarounds this, by falling back to the original behavior when it sees an affected firmware
version. For better readings the multi's should be updated. The bug has been fixed in VE.Bus
firmware version xxxx159, xxxx209, xxxx306. That firmware was released on February 17th
2015.
Multi firmware versions since 26xx207 / xxxx300 can also freeze the Power values at a certain1.
moment in time.
Tips to prevent measurement problems:
Do not connect VEConfigure while the CCGX is connected1.
VE.Bus is not a 100% plug and play system: if you disconnect the CCGX from one Multi, and2.
very quickly connect it to another, it can result it wrong values. To make sure that this is not the
case, use the 'redetect system' option in the Multi/Quattro menu on the CCGX.
Q7: There is a menu entry named "Multi" instead of the VE.Bus product name
A VE.Bus system can be completely turned off, including its communication. If you turn a VE.Bus
system off, and thereafter reset the CCGX, the CCGX cannot obtain the detailed product name and
shows “Multi” instead.
To get the proper name again, go into the Multi menu on the CCGX and set the Switch menu entry to
On or in case a Digital Multi Control is present, set the physical switch to On. Note that when there is
a BMS, above procedure only works when within battery working voltages.
Q8: There is a menu entry named "Multi", while there is no Inverter, Multi or
Quattro connected
If a CCGX ever saw a VE.Bus BMS or Digital Multi Control (DMC), it will remember them, until
'Redetect system' is started from the CCGX menu.
After a minute, restart the CCGX: Settings → General → Reboot.
Q10: I have multiple Solar chargers MPPT 150/70 running in parallel. From
which one will I see the relay status in the CCGX menu?
From a random one.

Last update: 2020-10-15 10:33 ccgx:ccgx_faq https://www.victronenergy.com/live/ccgx:ccgx_faq
https://www.victronenergy.com/live/ Printed on 2020-10-15 20:48
Q11: How long should an automatic update take?
The size of the download typically is around 90MB. After download it will install the files which can
take up to 5 minutes.
Q12: I have a VGR with IO Extender, how can I replace this with a Color
Control GX?
It is not yet possible to replace the IO Extender functionality.
Q13: Can I use Remote VEConfigure, as I was doing with the VGR2?
Yes, see VE Power Setup manual
Q14: The Blue Power Panel could be powered through the VE.Net network,
can I also do that with a Color Control GX?
No, a Color Control GX always needs to be powered itself.
Q15: What type of networking is used by the Color Control GX (TCP and UDP
ports)?
Basics:
The Color Control GX needs to get a valid IP address from a DHCP server, including a working
DNS server and gateway, or a static IP configuration.
DNS port 53 UDP and TCP
NTP (time sync) UDP port 123
VRM Portal:
Data to the VRM Portal is sent via HTTP POST and GET requests to
https://ccgxlogging.victronenergy.com on port 443, with a user configurable override to use
plain HTTP on port 80. Note that, even when configured to use plain HTTP, some outgoing
requests will always use HTTPS on port 443.
Firmware updates:
The CCGX connects to https://updates.victronenergy.com/ on port 443.
Remote support (default disabled):
When enabled, an outbound SSH connection to supporthosts.victronenergy.com is maintained.
The CCGX will try to connect on port 22, 80 and 443, and the first that works is maintained.
Enabling Remote Support also enables the sshd daemon, listening for incoming SSH requests on
port 22. See below FAQ entry for more information about the Remote Support functionality.

2020-10-15 20:48 5/8 Color Control GX FAQ
Victron Energy - https://www.victronenergy.com/live/
Two way communication (Remote VEConfig and Remote Firmware updates):
Pre-v2.20: Uses HTTPS (port 443) to the Pubnub servers
v2.20 and later: connects to mqtt-rpc.victronenergy.com on port 443
MQTT (default disabled):
When enabled, a local MQTT broker is started, which accepts TCP connections on port 1883. The
CCGX will also try to connect to a victron MQTT cloud server ranging from
mqtt0.victronenergy.com to mqtt127.victronenergy.com), on port 443, using SSL. It uses port
443 to reduce the chance of using blocked outgoing ports.
Remote Console on VRM (default disabled):
Remote Console on VRM uses the same reverse ssh tunnel as is used for Remote Support:
outbound connection to supporthosts.victronenergy.com on port 22, 80 or 443. No port
forwarding in routers is necessary to use Remote Console on VRM. Note that
supporthosts.victronenergy.com resolves to multiple IP addresses: 84.22.108.49,
84.22.107.120, 3.25.10.245, 13.244.154.199 or 35.165.124.40, depending on where you are.
Remote console also relies on the data connection to the VRM portal using HTTPS (port 443), as
describe above.
For troubleshooting, refer to the Remote Console on VRM trouble shooting guide.
Remote Console on LAN (default disabled):
Remote Console on LAN requires port 80 (small website hosted on local hiawatha webserver on
CCGX). And also requires port 81, which is the listening port for the websocket tunnel to VNC.
Modbus TCP (default disabled):
ModbusTCP server uses port 502
Q16: What is the functionality behind the menu item Remote support (SSH),
in the Ethernet menu?
When enabled, the Color Control will open a SSH connection to our secure server, with a reverse
tunnel back to the Color Control. Through this tunnel, Victron engineers can login to your Color
Control GX and perform remote support. This works when the Color Control GX is installed on an
internet connection. The connection will even work when installed behind a firewall. The SSH
connection will be outbound, to port 80, 22 or 443 at supporthost.victronenergy.com. Remote support
function is by default disabled.
Q17: I don’t see support for VE.Net products in the list, is that still coming?
No.
Q18: What is the data usage of the Color Control GX?

Last update: 2020-10-15 10:33 ccgx:ccgx_faq https://www.victronenergy.com/live/ccgx:ccgx_faq
https://www.victronenergy.com/live/ Printed on 2020-10-15 20:48
Data usage depends heavily on amount of connected products, and behavior and usage of those
products. The measurements below are an indication only, and taken from a system with one Color
Control GX, one Multi, one BMV and one MPPT. Log interval set to 15 minutes. If you are on an
expensive data-plan, do make some fail-safe.
Data consumption per month:
VRM logging: 15MB download, 45MB upload
Remote support: 22MB download, 40MB upload
Update checks: 8MB download, 0.3MB upload (This does not include the update itself)
2 way communication: 26MB download, 48MB upload
Mentioned megabytes do not include the download of a Color Control firmware update. Firmware
updates of 60MB are not uncommon.
Q19: How many AC Current Sensors can I connect in one VE.Bus system?
The current maximum is 9 sensors (since CCGX v1.31). Note that each need to be configured
separately with an assistant in the Multi or Quattro to which it is wired.
Q20: Issues with Multi not starting when CCGX is connected / Caution when
powering the CCGX from the AC-out terminal of a VE.Bus Inverter, Multi or
Quattro
NOTES:
We recommend to power a GX device from the battery. Not from the AC-out. In case you still1.
power it from AC-out, carefully read this FAQ item.
This FAQ item applies to Venus GX, CCGX, and all other GX Devices, but not the Cerbo GX. It2.
has an improved design due to which its no longer recommended to cut pin 7 of the VE.Bus
cable when powering the GX device on the AC-out port.
Make sure that the GX device and MultiPlus is running the latest firmware version.3.
If you power the CCGX from an AC adaptor connected to the AC-out port of any VE.Bus product
(Inverter, Multi or Quattro), then a deadlock can occur after the VE.Bus products are powered-down
for any reason (after any operational fault or during a black start). The VE.Bus devices will not boot-up
until the CCGX has power …but the CCGX will not boot-up until it has power.
This deadlock can be rectified by briefly unplugging the CCGX VE.Bus cable at which point you will
observe the VE.Bus products will immediately begin to boot-up.
This deadlock can be avoided in two ways:
Power the CCGX from the battery; or
Cut pin 7 in the VE.Bus cable connected to the CCGX
Cutting/Removing pin 7 of the VE.Bus cable to the CCGX (brown/white according to standard RJ45
ethernet cable colour coding) allows the VE.Bus products to start up without waiting for the CCGX to
boot up first.

2020-10-15 20:48 7/8 Color Control GX FAQ
Victron Energy - https://www.victronenergy.com/live/
Note that when using a Redflow ZBM2/ZCell battery, pin 7 should be cut even if the CCGX is DC
powered, to avoid the same deadlock at times when the Redflow battery cluster is at 0% SoC.
The disadvantage of cutting pin 7 is that switching the VE.Bus device off will be less effective:
although it will stop charging and inverting, it will still be in standby mode and therefore drawing
more current from the battery than if pin 7 had been left in place. Typically this is only relevant in
Marine or Automotive systems where it's normal to regularly switch the VE.Bus device off. For those
types of systems we recommend that you do not cut pin 7, but simply power the CCGX from the
battery.
Q21: I love Linux, programming, Victron and the Color Control GX. Can I do
more?
Yes you can! We intend to release almost all code as open source, but we are not that far yet. What
we can offer today is that many parts of the software are in script or other non-precompiled
languages, such as Python and QML, and therefore available on your Color Control GX and easy to
change. Root password and more information is available here.
Q22: How do I change the logo

Last update: 2020-10-15 10:33 ccgx:ccgx_faq https://www.victronenergy.com/live/ccgx:ccgx_faq
https://www.victronenergy.com/live/ Printed on 2020-10-15 20:48
Typic the following address into the web browser of a device connected to the same network. Using
this address as a template: http://[ip-here]/logo.php (inserting your device’s IP address between the
square brackets). The IP address can be found by going to Settings > Ethernet or Wifi. Once the page
is loaded, Choose an image file from your device. Re-boot the GX device.
Q23: Multi restarts all the time (after every ~10sec)
Please check the remote switch connection on the Multi control PCB. There should be a wire bridge
between the left and middle terminal. The CCGX switches a line which enables the power of the Multi
control board. After 10 seconds this line is released and the Multi should take over from there. When
the remote switch connection is not wired the Multi is unable to take over it's own supply. The CCGX
will retry, the Multi will boot and after 10 seconds stop, and so on.
Q24: What is Error #42?
If the GX Device shows an Error 42 - Hardware fault. In that case, the flash storage on the device is
corrupt. As a result, settings will not be saved (rebooting resets back to default) and other problems
will rise.
This error is not recoverable in the field or by repair departments. Contact your dealer for a
replacement.
Firmware versions until v2.30 did not report the error. Since v2.30; its visible on the device itself (in
the GUI) and on the VRM Portal.
GPL Note
The software included in this product contains copyrighted software that is licensed under the GPL.
You may obtain the Corresponding Source code from us for a period of three years after our last
shipment of this product.
From:
https://www.victronenergy.com/live/ - Victron Energy
Permanent link:
https://www.victronenergy.com/live/ccgx:ccgx_faq
Last update: 2020-10-15 10:33