TOUCH Development Kit - UHDK5

Why can’t I build the example applications?

If you’re having trouble building and running the example applications make sure you’re following the instructions in the SDK’s included documentation. You can also find more detailed information here.

How do I get an Ultrahaptics device?

You can engage with Ultrahaptics through our Evaluation Program or by purchasing the TOUCH Development Kit. Our Evaluation program gives you access to our flagship Evaluation Kit UHEV1 – capable of creating up to eight control points at up to 16kHz with our Time Point Streaming (TPS) technology – and three days of on-site support.

The TOUCH Development Kit, supporting four control points with Amplitude Modulation, can be purchased through our distributor EBV and, in Japan through Cornes Technologies.

Sign up here to join our Evaluation Program. Alternatively, for those based in Japan, please contact Cornes Technologies at ctl-comm@cornes.jp.

What is the difference between TOUCH Development Kit and Evaluation Program?

Our knowledge base article on the Evaluation Program and TOUCH kit gives a great side-by-side introduction to the features of our current products.

What’s in the TOUCH Development Kit (UHDK5)?

  • User Guide
  • The development kit hardware: 192 (14×14) transducer array and control board, mounted in a cradle with a Leap Motion Controller device
  • Multi-regional power supply
  • Ultrahaptics USB cable
  • Leap Motion USB cable
  • Compliance, warranty and health and safety booklet.

What are the minimum system requirements for using Ultrahaptics?

Modern PCs and laptops should be able to run an Ultrahaptics SDK application without any problem. Most of the processing power is required by the Leap Motion Controller. There may be additional system requirements for applications using 3D processing, such as VR, or using the Unity games engine, e.g. the Ultrahaptics demonstration suite.

Operating System Requirements*:

  • Microsoft Windows 8, 8.1 and 10
  • Apple Mac OS Yosemite (10.10), El Capitan (10.11) and Sierra (10.12)

Minimum UHDK5 SDK requirements**:

  • Intel i3 processor or AMD Phenom II, 2GB RAM, USB 2.0

Recommended Unity requirements (including UHDK5 demo):

  • Intel Core i5 processor or AMD FX, 4GB RAM, USB 2.0
  • Higher powered graphics e.g. Intel Iris Pro or dedicated graphics card.

Leap Motion Controller:

  • View Leap Motion’s recommended system requirements here.

Sensation Editor:

  • As with the SDK (64-bit only) plus OpenGL.

*Linux SDK expected Q4 2017.

**The UHEV1 will have slightly higher requirements since the majority of the algorithmic processing is carried out on the host.

How do I get started with my TOUCH Development Kit?

Simply follow the instructions outlined in the enclosed User Guide:

Register at developer.ultrahaptics.com/register using your serial number.

Download and install the SDK.

Install the Leap Motion V2 drivers https://www.leapmotion.com/setup/desktop.

Connect the hardware, run the installed demo and start experiencing Ultrahaptics!

Download and install the Sensation Editor to begin creating your own sensations.

Where can I find documentation?

A User Guide is provided to help get you started and describes the kit contents, setup and how to register your kit on the Ultrahaptics developers’ site. Once registered you can download the SDK which comes with a complete suite of detailed documentation. After unzipping the downloaded SDK bundle, locate and open ‘Documentation.html’ at the root of the installation bundle. There you will find all the usage, installation instructions and the API. In addition, you will have access to an up-to-date range of Knowledge Base articles on the developer site.

How do I register my TOUCH Development Kit?

Go to developer.ultrahaptics.com/register, enter your serial number and click ‘Check’.

Your serial number should be entered as written on the Control Board, e.g. “UHDK5-”, followed by an 8-digit number (see the User Guide to find your serial number). Fill out the registration form and agree to the terms of the End User Licence Agreement, click SUBMIT and that’s it!

I can’t seem to register my TOUCH Development Kit

Check that you have entered the serial number exactly as written on the back of the Control Board. This is the top line of the label indicated in the TOUCH Development Kit User Guide.

Please note that registrations are limited to five per kit, so check how many times your board has already been registered. If you wish to add more users, or if you’re still having problems, please contact help@ultrahaptics.com.

I can’t get the demo to run

Make sure your host system satisfies the system requirements* and that you have installed the correct SDK for your platform (32 or 64-bit), that your kit is correctly connected and powered on (the TOUCH Development Kit has a separate power switch on the control board). See the User Guide for more details.

Both the Leap Motion Controller and the transducer array require separate USB connections. On starting the demo, you will see the Ultrahaptics splash screen. If you need to connect any hardware the demo will prompt you to do this now.

Please also ensure that you have installed the correct Leap Motion Controller drivers for your platform – we currently support Leap Motion V2 (Leap Motion’s Orion driver is available for Windows users).

*We do not support Windows 7, however you can still install the SDK and run the demo with a suitably powerful machine (you must manually install a separate USB driver). However, some users have reported poor performance due to Leap Motion Controller processing requirements.

I’m using Windows 7 and can’t get the demo to run.

While Windows 7 is not actively supported you can still install and run the Ultrahaptics demo with a suitably powerful machine*. You must follow some additional steps to manually install the USB driver with the Zadig installation tool:

  • Connect your Ultrahaptics array
  • Download Zadig and run with Administrator privileges.
  • Select Options->List All Devices and select your array.
  • Use the up/down arrows to select libusbK.
  • Click either Replace Driver or Install Driver.
  • Power cycle the array and restart the demo.

Our SDK also contains a short video showing these steps.

* Some underpowered Windows 7 machines have exhibited poor performance with the demo due to intermittent Leap Motion failure, unresponsiveness and crashing.

I’m having a problem with my kit? How do I get support?

We hope that you will find all the information to get you up and running here, but if you’re still having problems you can contact us directly by clicking the “Raise a support ticket” button at the bottom of developer homepage*.

Please provide a detailed description of your issue – serial number, platform, nature of the problem and any steps that lead to it – and the Ultrahaptics support team will endeavour to respond to you within two working days.

Evaluation Program (UHEV) members should contact us at support@ultrahaptics.com

 

How should the transducer array be oriented?

There are no restrictions on the orientation of the array itself, but the array must not be covered by any solid materials and the area between array and hand must not be obstructed. The hand will also need to be clearly visible to the tracking camera and, for the optimal Ultrahaptics experience, the palm of the hand should face the array.

Is the TOUCH Development kit limited to a square form factor?

The TOUCH Development kit comes with a 14×14 (192), square transducer board. Ultrahaptics also provides a separate rectangular, 24×8 array board – UHDK5-AA1* – with its own frame and Leap Motion Controller cradle. The SDK comes with alignment files that are automatically detected for the given array.

The transducer placement can be customised for your applications’ environments, for example split around displays, consoles or control areas. The array can then be configured using a custom alignment file at runtime. The array can then be configured using a custom alignment file at runtime. You can read more about form factor customisation here, or contact Ultrahaptics directly to discuss your specific requirements.

*Sold separately through our distributors EBV and Cornes.

Can we create our own products using Ultrahaptics technology?

While the Evaluation Kit and Development Kit are not designed for end-use products, we encourage our customers to use them in their demonstration and proof-of-concept applications. You can find some tips and guidance about doing this here. We provide the Sensation Editor and reference code example, as well as the SDK and API, allowing customers to implement their own sensations and applications. We also provide additional support to customers who wish to integrate Ultrahaptics into end-use products or with developing custom form factors, as part of our NRE services. Contact us at info@ultrahaptics.com for more information.

What is Amplitude Modulation?

Ultrahaptics uses high frequency ultrasound to transmit sensations to the surface of the hand. The surface of the skin is not sensitive to ultrasound alone and is therefore modulated at a much lower frequency, which the hand is sensitive to. This is called Amplitude Modulation (AM).

Ultrahaptics uses Amplitude Modulation to refer to its first-generation modulation scheme. This uses a fixed modulation frequency – control point positions and intensity can be updated at this frequency, requiring less processing power than Time Point Streaming. Many of the sensations used in our demo suite and the Sensation Editor use AM, and is supported by both the Evaluation and Development Kits.

Can I cover or hide the transducer array?

The Ultrahaptics system relies on generating an acoustic field in space using ultrasound. The array should not be obstructed by solid surfaces or anything that interferes with the interaction space.

However, Ultrahaptics provides an additional cover materials kit for the TOUCH Development Kit – UHDK5-CM1 – containing a selection of splash proof gauzes and perforated steel covers to protect the array.

The kit is available through our distributors EBV (Worldwide) and, in Japan, Cornes. We can also evaluate materials for you as part of our engineering services.

What is the minimum number of transducers required to feel a sensation?

The number of transducers required to create a sensation will depend on the specific application. With the existing transducers, the most basic sensations can be felt with approximately 80 transducers. More complex sensations, interaction zone and array form factor arrangements will all affect the minimum number of transducers required. We provide additional NRE services to simulate and design arrays based on your application requirements.

What kind of transducers are used on the Ultrahaptics platforms?

Currently, Ultrahaptics hardware uses Murata through-hole mounted, piezo transducers. These are readily available on the market and used in volume in automotive applications as parking sensors and proximity sonar. The size of the transducers is dictated by piezo technology and output power. Ultrahaptics is investing in researching alternative transducer technologies with a view to reducing size and manufacturing cost, while increasing output power and efficiency.

What size is the Ultrahaptics hardware?

The Evaluation Kit UHEV1 is a square array of 16 x 16 transducers with an area of 17 x 17cm.

The TOUCH Development kit UHDK5 is a square array with 192 transducers (14 x 14 minus four corners) and an area of 14.5 x 14.5cm. We supply the TOUCH UHDK5-AA1 rectangular 24 x 8 board as a separate accessory array for the UHDK5.

The surface of my Ultrahaptics array is very warm. Is this normal?

Because of the nature of the transducers used by Ultrahaptics and the high output levels required, heat can build up if the array is continuously outputting ultrasound. This is quite normal but you should keep in mind that the array should be well ventilated, particularly if building it into an enclosure. The TOUCH Development Kit incorporates a safety mechanism preventing it from overheating that will cut transducer output until a safe temperature is reached.

What is the correct way to connect the logic and transducer boards?

The TOUCH Development Kit (UHDK5) and Evaluation Kit (UHEV1) have separate transducer and logic boards, connected using four board-to-board sockets.

The UHDK5 has keyed sockets and can only be connected in one orientation: with the power and USB sockets and Leap Motion controller facing the same way:

UHDK5 Ports

While the UHEV1 does not have keyed sockets, they are labelled J1_CON1 to J1_CON4 and should be connected to the same on each board. Some kits indicate the correct orientation with a coloured circular sticker in the corner of both boards, which should align when connected.

While incorrect orientation of the UHEV1 transducer board will not cause any damage, it will result in weak haptic output.

When reconnecting the boards ensure both are firmly seated by gently pressing together. Any operations and handling of the boards should be done with appropriate anti-static measures.

My TOUCH Development Kit has stopped working, but is still visible from the host.

Because of the nature of the transducers used by Ultrahaptics heat can build up if the device is continuously outputting ultrasound. The TOUCH Development Kit is designed to detect this and, to protect the device from damage, will stop outputting ultrasound if it exceeds a certain temperature. To continue operating, the device should be allowed time to cool. It should begin working again as normal within 3-5 minutes. If not, you should try power cycling the device.

How much power does the TOUCH Development Kit use?

The TOUCH Development Kit has a rated power supply of 12V@5A (60W). However, power consumption is dependent on the number of control points, intensity and modulation frequency. For example, a single control point at 200Hz and 100% intensity has a current draw of approximately 1.25A, 15W, while a sensation with four control points will draw approximately 3.25A, just under 40W. Idle power consumption is approximately 1W (0.08A). You can read more details about power consumption in all our products here.

How do I update my device’s firmware?

You can identify the firmware your device is using with the Ultrahaptics Firmware Tool. UHFlashTool comes with the SDK. Connect and power on your array, open UHFlashTool and click the refresh button to view the details of your device.To upgrade the firmware on your device, select a firmware image from, either .ufu for UHEV1 or .img for UHDK5, and click the Upgrade button. Please take care when upgrading the flash image that the device is connected directly to the host PC and remains powered during the process.

The UHEV1’s LED will turn blue during the process and green once it has successfully booted.

The UHDK5’s LED8 will flash blue, then solid green before rebooting. Once rebooted, LED6 will flash green indicating normal operation.

Both devices should reboot after the flash process, though you may need to power cycle.You can read more detailed information about upgrading the flash in the SDK documentation section on Device Firmware.