Docks

When multiple products have been connected, with the second charger connected to an expansion port of the first charger and so on, this is known as a Dock. For some operations it may be convenient to treat these two chargers as a single unit, that combines the ports of both chargers.

To access the dock as a single unit, first call cbrx_discover with the parameter docks to obtain the list of docks available. Then call cbrx_connection_open with the ID in question and also specifying "docks".

The dock unit will return the combined total for keys such as nrOfPorts and TotalCurrent_mA. The range of ports is expanded to cover the combined total number of ports for connected products. The product directly connected to the computer will have its ports referenced first followed by those of the charger connected to first charger’s expansion port.

Some keys such as Hardware or Firmware do not combine and so these keys will return the value for the parent charger. If it is desired to get the values of these keys from the downstream charger then it is possible to open and retrieve them from that charger in the usual manner. Opening a charger does not interfere with access to the dock except as to when settings are changed.