Additional information

Cambrionix Connect Recorder Service

The Recorder service is an optional installation component, which can record events such as device health, charging history and connection events. These can subsequently be viewed in client software.

Stopping the API service

• Windows

If you wish to stop the Cambrionix Hub API service from running then open Task Manager, then click through to services and right click the 'CambrionixAPIService' and click 'Stop'

• Linux and macOS

If you wish to stop the Cambrionix Hub API service from running then issue the following command

sudo /usr/bin/CambrionixApiService --remove

Starting the API Service

• Windows

To start the Cambrionix Hub API service from running then open Task Manager, then click through to services and right click the 'CambrionixAPIService' and click 'Start'

• Linux and macOS

If you wish to start the Cambrionix Hub API service from running then issue the following command

sudo /usr/bin/CambrionixApiService --install

Limitations

The API provides a means of controlling most of the features of Cambrionix products, however there are some limitations. The API can only be used with the following products.

Preventing Windows from Assigning New COM Ports to Identical USB Devices

When you connect multiple USB devices with the same hardware to a Windows PC, the operating system typically identifies each device by its unique hardware serial number. Windows uses this serial number to assign a new COM port for each device, even if they are identical in terms of hardware. Over time, this can result in a long list of COM ports being assigned, which clutters the device manager and can make managing devices more difficult and confusing.

To prevent this, you can instruct Windows to ignore the hardware serial number for specific USB devices. By doing so, Windows will treat all devices with the same Vendor ID (VID) and Product ID (PID) as a single device and allocate only one COM port, no matter how many of these identical devices are connected over time. This stops the COM port list from unnecessarily filling up.

The following registry entry ensures that Windows ignores the hardware serial number for a USB device with the specific VID 0403 and PID 6015:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags]
"IgnoreHWSerNum04036015"=hex:01

• IgnoreHWSerNum04036015: This entry instructs Windows to ignore the hardware serial number for devices with a Vendor ID (0403) and Product ID (6015). These IDs refer to a specific USB device model.

• hex:01: This value enables the behaviour, telling Windows to treat all devices with this VID and PID as if they have the same serial number.

With this registry setting applied, Windows will no longer assign a new COM port each time an identical device (with the same VID and PID) is connected. Instead, it will reuse the same COM port, preventing the list of COM ports from unnecessarily expanding. This makes it easier to manage USB devices that connect through COM ports, particularly in environments where multiple identical devices are frequently connected and disconnected. It prevents the clutter and confusion caused by having a large number of assigned but unused COM ports.

This solution is particularly useful in scenarios such as:

• Development environments where multiple USB hubs are connected and disconnected.

• Production setups where identical devices are frequently used, and preventing an accumulation of redundant COM ports is necessary.

• Device testing environments where serial communication is crucial, but the aim is to avoid an ever-expanding list of COM ports