STU SigCaptX
The following sections contain a selection of technical support questions and answers:
Samples do not work in my browser
Problem
Having opened STU SigCaptX samples in the browser nothing appears to work
Solution
Confirm that PortCheck successfully indicates: 'SigCaptX detected'. If this is not the case:
Was the browser installed after installing SigCaptX? - if so uninstall/reinstall SigCaptX
Confirm that the STU tablet is connected and operational.
Use STU Utilities to test the tablet:
Identify.exe - to establish a connection
PenData.exe - to verify pen input
Run PortCheck.html from the samples - it should report as follows:
SigCaptX Web Service: ready
SigCaptX DCA: readyIf the DCA shows as "not detected" this is probably caused by either anti-virus or a port conflict.
To handle port conflicts please see Handling Port Conflicts with STU SigCaptX
If that doesn't work please try temporary disabling you anti-virus software.
Please note that after making any changes to anti-virus or port numbers it is best to reboot.
Samples do not work in Firefox because of a connection error
Problem
Firefox reports 'Unable to establish connection to SigCaptX'
Solution
Verified in Firefox version 99.
STU SigCaptX requires access to https://localhost:9000 by default. It is possible to configure a different port number, but this doesn't cure the problem described below.
Firefox considers the attempted connection to localhost to be a security breach and refuses to allow it.
In order to remedy this it is necessary to tell Firefox to ignore the security risk as described below:
Navigate to https://localhost:9000 in the Firefox browser.
An error message should appear saying that there is a potential security risk ahead - see first screenshot below
Click on the "Advanced" button at the bottom right of the dialog box to display the window shown in the second screenshot below
On the second dialog window click the button labelled "Accept the Risk and Continue"
It will look as if nothing is happening apart from a moving blue dot at the top left-hand corner of the Firefox tablet
Reload the sample into Firefox and it should work
Samples do not work in Firefox because of an insecure connection
Problem
Firefox reports 'Your connection is not secure'
Solution
Verified in Firefox Quantum (version 61).
STU SigCaptX requires access to https://localhost:9000 by default. It is possible to configure a different port number, but this doesn't cure the problem described below.
Firefox considers the attempted connection to localhost to be a security breach and refuses to allow it.
In order to remedy this it is necessary to add a security exception to Firefox as described below.
- Navigate to https://localhost:9000 in the Firefox browser.
- An error message should appear saying that the connection is not secure because the owner of localhost has not configured their Web site properly (see below).
- Click on the button labelled "Add Exception..." at the bottom of the error page.
- When the "Add Security Exception" dialogue box appears it should be auto-populated with the localhost port number so click on the "Confirm Security Exception" button at the bottom of the window (see below right).
- Close and restart Firefox.
Demobuttons sample not working in Edge and Internet Explorer
This error is seen by the fact that nothing happens when you click on the "Start Demo" button after loading the demobuttons.html sample into Edge or IE.
If you press F12 in Edge you will see the following error message:
WebSocket Error: SECURITY_ERR, Cross zone connection not allowed
If you try pressing F12 in IE you will see no messages at all in the console.
This error is fixed by clicking the "Unblock" check-box on the "Properties" of the file using File Explorer as shown below.
Handling Port Conflicts with STU SigCaptX
By default STU SigCaptX uses a service port number of 9000.
This can occasionally cause problems on systems where other applications are also using the same port number or where firewall or anti-virus software is restricting access to it.
If STU SigCaptX cannot gain access to port 9000 then it will not run.
If the access is being prevented by security software (this has been experienced particularly with Kaspersky) then one solution is to change the settings in the security software so that it allows access to that port.
An alternative solution is to change the port number which STU SigCaptX uses - this requires coding and a registry setting change as described below.
1. Registry setting
For more details please see the SigCaptX installation guide
Location: HKEY_LOCAL_MACHINE\SOFTWARE\Wacom\SigCaptXSTU or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Wacom\SigCaptXSTU
Port 9000
Change the Port number from 9000 to another number which you believe is less likely to cause a conflict.
2. Coding:
Location: Please search in your code for anywhere where a reference is made to the service port, e.g. in wgssStuSdk.js as follows:
var defPort = 9000;
Having found this line of code change the value "9000" to be the same as the new value which you have set up in the registry for "Port".
So if you have specified a Port value of 14500 then the code would now read:
var defPort = 14500;
You may also need to change references elsewhere as for example in our sample Web page PortCheck.html where "9000" will need to be changed to "14500":
Service port: <input type="text" id="portText" value="9000">
STU SigCaptX Logging
The registry location is: HKLM\Software\(Wow6432Node\)Wacom\SigCaptXSTU
Two registry values are required in this location:
Name | Type | Value |
---|---|---|
ArbitratorLog | REG_SZ | [path to service log file] e.g. "C:\Users\jsmith\documents\STUSigCaptX-Arbitrator.log" |
DeviceCtlLog | REG_SZ | [path to server log file] e.g. "C:\Users\jsmith\documents\STUSigCaptX-DeviceCtl.log" |
The PC should be rebooted after creating the above entries.
ArbitratorLog and DeviceCtlLog must be absolute path names to log files, not a log directory.