Programming queries
STU tablet unique ID
Q: How to obtain the unique ID of an STU tablet
Our older tablets (e.g. the STU 500) have a unique ID in the firmware which is set to zero by the factory – it can be set programmatically using the method iTablet.setUid() and it is retrieved using iTablet.getUid().
Our newer tablets (e.g. the 430, 530, 540, 541) have two unique IDs – the ID mentioned above and also a second one which is set by the factory – this can be retrieved using iTablet.getUid2().
If you run the STU tool Identify.exe ( see STU Utilities ) it will display on the screen the current values of the UID or UIDs, depending on which tablet is connected.
In order to retrieve the UID of an individual tablet you must connect to the tablet first before calling getUID() or getUID2().
If you want to connect to a particular tablet by means of its UID then you will need to write a function which cycles around all USB devices and opens each one in turn to check its UID.
As in the sample code demobuttons.js you can retrieve a list of all USB devices as follows:
var usbDevices = createObject("WacomGSS.STU.UsbDevices");
This creates an array of connected USB devices – you can then cycle through the array and look at the properties of each device – see the class IUsbDevice and its properties in the SDK reference pages at the following location:
C:\Program Files (x86)\Wacom STU SDK\COM\doc\interfacewgss_s_t_u_1_1_i_usb_device.html
(depending on where you have installed the SDK).
If you can’t use the properties as an alternative to the UID then you will need to connect to each device as described above to check its UID.