When trying to open a COM port, I receive an error “Windows error #31 – A device attached to the system is not functioning” or similar

When trying to open a COM port, I receive an error “Windows error #31 – A device attached to the system is not functioning” or similar

Applies to: Docklight / Docklight Scripting (all versions), Article ID: dl_prb032

Some serial driver implementations, e.g for USB devices that add a virtual COM port on the PC, do not allow to set the “classic” RS232 communication settings like IOCTL_SERIAL_SET_BAUD_RATE. For many of these applications, the serial data settings are indeed not necessary but the driver accepts them and does not report an error. In case your device driver DOES produce an error and Docklight cannot open the COM port, please use the Project Setting ‘Baud Rate = None’, available in Docklight V2.0 and higher.

NOTE: A specific example for the above behavior seems to be the Microchip CDC sample implementation. If the following definition is commented out (not defined):
‘#define USB_CDC_SUPPORT_ABSTRACT_CONTROL_MANAGEMENT_CAPABILITIES_D1’,
then the device can only be opened with Docklight using the ‘Baud Rate = None’ setting:

Docklight Downloads