Add Bluetooth COM Port function for Seika and Seika Notetaker Braille display

[moyanming]

Is your feature request related to a problem? Please describe.

I have tested the NVDA 2021.3rc1 with Seika and Seika Notetaker Braille display, the default connection is USB and this works fine, but the "Port" is grey and can't use to select a Bluetooth COM Port which is supported by both Seika and Seika Noteatker Braille display.
We already added supported Seika Notetaker here #12598, the data protocol of the Bluetooth COM Port connection is the same as the USB connection, this means the Bluetooth COM Port or USB should be selectable but not fixed to USB for both Seika and Seika Notetaker Braille display.
If you select "Automatic" when selecting Braille display, the Seika and Seika Notetaker can't connect when no USB cable is connected but the Bluetooth is already connected.

[OzancanKaratas]

Are the Bluetooth and USB protocols using the same hardware ID?

[moyanming]

Hi, @OzancanKaratas
I don't know the meaning of the same hardware ID of Bluetooth and USB.
Bluetooth and USB are not the same types of hardware there maybe not have the same hardware ID.
If I select some other Braille display, there is a list of all Bluetooth and USB VCP com ports, but the Seika and Seika Notetaker's "Port" is grey.

Best Regards,

[moyanming]

I have tested this build, I found the Bluetooth COM port was added, but the Bluetooth COM port can't connect with Seika Notetaker.
There may be a USB HID of Seika Notetaker connected with the PC, but the customer may select Bluetooth COM Port manually in the Braille settings. Please refer to the log file, the USB HID name of Seika Notetaker may be used to connect even user selects COM port manually.
The COM port use: 9600,N,8,1, the data translation protocol of the COM port is the same as USB HID.

Here is the log:
Bluetooth COM Port.log

[feerrenrut]

@moyanming For these issues please upload a debug log with hwIo enabled:

• Set the log level to DEBUG via the general settings panel
• enable hwIo logging in the advanced setting panel

[moyanming]

@moyanming For these issues please upload a debug log with hwIo enabled:

• Set the log level to DEBUG via the general settings panel
• enable hwIo logging in the advanced setting panel

Hi, @feerrenrut
The NVDA 2021.3RC1 has no serial port selection for Seika Notetaker, but this build have added and I have tested it, please find the log file here.

[feerrenrut]

This looks like the same log you have already uploaded, it is not a debug level log, and hwIo isn't enabled.

[feerrenrut]

@cary-rowen It seems like this driver does not register itself to be considered as a bluetooth device. From your log, there are two potential candidates, can you advise if either of these represents the braille device?

DEBUG - hwPortUtils.listComPorts (08:51:58.279) - MainThread (13904):
{'hardwareID': 'BTHENUM\\{00001101-0000-1000-8000-00805f9b34fb}_LOCALMFG&0002', 'port': 'COM3', 'bluetoothAddress': 8757810468, 'bluetoothName': 'TSM 3366', 'friendlyName': '蓝牙链接上的标准串行 (COM3)'}
DEBUG - hwPortUtils.listComPorts (08:51:58.279) - MainThread (13904):
{'hardwareID': 'BTHENUM\\{00001101-0000-1000-8000-00805f9b34fb}_LOCALMFG&0000', 'port': 'COM4', 'bluetoothAddress': 0, 'friendlyName': '蓝牙链接上的标准串行 (COM4)'}

[cary-rowen]

Hi, I am pretty sure that "TSM3366" represents my braille device.
The full content is this line: 'hardwareID': 'BTHENUM\{00001101-0000-1000-8000-00805f9b34fb}_LOCALMFG&0002', 'port': 'COM3', 'bluetoothAddress': 8757810468, 'bluetoothName': 'TSM 3366', 'friendlyName': '蓝牙链接上的标准串行 (COM3)'}

[cary-rowen]

@feerrenrut
Hello, I used the latest TryBuild you provided in #13121 for testing. The Bluetooth function did not work properly, but I can use the Seaka add-on to work normally. Below I will provide two logs. The former represents the test results of TryBuild. The latter represents the test result of 2021.3.1rc1 with Seaka add-on add-on.

TryBuild_Log.txt

2021.3.1RC1_With_Seaka_Add-on.txt

[moyanming]

Hi, @cary-rowen Thanks for your great job.
The Bluetooth serial maybe have two UUIDs: serial com port out, and serial com port in, so there are two Bluetooth COM ports for Seika Notetaker in the PC, but only one Bluetooth COM port can be used for connecting with Seika.

The driver should open the Bluetooth serial COM port one by one and try to connect with Seika, if there has handshake data coming from Seika, this is the right Bluetooth Com port and can be used for communication same as USB-HID does.

[moyanming]

Hi, I am pretty sure that "TSM3366" represents my braille device. The full content is this line: 'hardwareID': 'BTHENUM{00001101-0000-1000-8000-00805f9b34fb}_LOCALMFG&0002', 'port': 'COM3', 'bluetoothAddress': 8757810468, 'bluetoothName': 'TSM 3366', 'friendlyName': '蓝牙链接上的标准串行 (COM3)'}

Hi, @cary-rowen and @feerrenrut
Please note that the Bluetooth name of the Seika devices is "TSM abcd", where the "abcd" is a four-digit number, e.g. "TSM 3366", "TSM 0001", etc. There is a space between "TSM" and "abcd".

[feerrenrut]

@cary-rowen @moyanming Thanks for the extra information, once we sort out the issues with braille in the 2021.3.1 release and merge that back to master I'll take a look at implementing this in alpha builds.