Windows command-line tool for scanning DigiBall devices with Bluetooth LE, and generating images (.png) of tip contact position and statistics when new shots are detected. The images can be used as overlays for streaming software such as OBS. Adding a video delay of 6s (or more) to the main feed will cause the generated graphics to appear slightly before the player shoots. This may be desirable.
Windows 10, BT 4.0 adapter
Download and run the installation file DigiBallScanner/innosetup/Output/DigiBallScannerSetup.exe
- Go to Start and type "devmgmt.msc" to open the Device Manager.
- Find Bluetooth and expand.
- Verify that one entry reads "Microsoft Bluetooth LE Enumerator". If you do not see this then your adapter does not support BLE. A BLE USB dongle can be purchased from a variety of vendors.
- You may need to right-click and disable the classic Bluetooth adapter "Intel(R) Wireless Bluetooth(R)" if it causes a conflict.
DigiBallScanner uses command line arguments. For convenience you can add/create Desktop shortcuts with the appropriate arguments.
DigiBallScanner.exe
DigiBall Console for Windows - Generates realtime ball graphics for streaming software.
Output images will be generated in:
C:\Users\usnrho\AppData\Local\Programs\DigiBallScanner
Usage: DigiBallScanner.exe x y z
x=all: Scans all visible devices
x: Mac Address filter: Least significant 3 bytes (hex) of DigiBall MAC address.
y: (Optional) Mac Address filter of 2nd player cueball.
z=pool: (Optional) Uses pool ball diameter (default)
z=carom: Uses carom ball diameter
Scanning for all DigiBall devices only. Images will not be updated until restarted with a MAC address filter...
- Will show all DigiBall devices found including the hex representation of the GAP advertisement packet. Scan responses are not processed.
- No images are updated in this mode.
DigiBallScanner.exe all
...
05:08:04 383 100625 6C69E6DB9623 10-06-25-1E-3D-7C-2D-FC
05:08:05 384 100732 75A313C51163 10-07-32-1F-6F-C4-56-B1-28
05:08:05 385 100517 496DD525FD88 10-05-17-18-9C-F1-F6
05:08:05 386 100713 5AA28AC761CC 10-07-13-1F-EE-D7-6B-EA-48
05:08:05 387 100625 6C69E6DB9623 10-06-25-1E-3D-7C-2D-FC
05:08:05 388 100732 75A313C51163 10-07-32-1F-6F-C4-56-B1-28
05:08:06 389 12022C F26C5DF3D629 12-02-2C-01-07-11-06-2B-14-DF-EB-31-FA-CE-D6-36-F3-D6-6E-0B-76-01-D2
- Will show all BLE devices found including the hex representation of the GAP advertisement packet. Scan responses are not processed.
- No images are updated in this mode.
- Used for testing BLE adapter.
DigiBallScanner.exe 6EE780
- Least 3 significant bytes of the MAC address were given as the only argument. This can be easily accomplished by appending to the shortcut target.
- Images will be updated in the installation folder. By default this is in C:\Users{username}\AppData\Local\Programs\DigiBallScanner
- Additionally, the argument "carom" can be added to the command line to adjust the math for a carom ball of diameter 61.5mm.
Scan for two DigiBalls (two cueballs are usually used for carom games. The second ball will be drawn as yellow)
DigiBallScanner.exe 485FF2 A7E27B carom
- Two MAC addresses were given, along with the carom keyword to correct for the ball diameter.
- Images will be updated in the installation folder. By default this is in C:\Users{username}\AppData\Local\Programs\DigiBallScanner
- Images for player 1's cue ball start with "digiball1_" and images for player 2's cue ball starts with "digiball2_".
- digiball1_tipOutline.png
- digiball1_tipOutlineContact.png
- digiball1_tipOutlineContactAngle.png
- digiball1_tipOutlineGrid.png
- digiball1_tipOutlineGridContact.png
- digiball1_tipOutlineGridContactAngle.png
- digiball1_stats.png
- digiball2_tipOutline.png
- digiball2_tipOutlineContact.png
- digiball2_tipOutlineContactAngle.png
- digiball2_tipOutlineGrid.png
- digiball2_tipOutlineGridContact.png
- digiball2_tipOutlineGridContactAngle.png
- digiball2_stats.png
https://www.youtube.com/watch?v=FP21fO4wFxw&list=PLkjwxZDtCvmhSuGhGhC9gms-NWCeAy0Ar&pp=gAQBiAQB