Haptic Pen Validation Guide

  • Article

This article will guide you through using the Haptic Pen Validation Tool to validate both required (Test Cases 1 and 2) and optional (Test Cases 3 and 4) haptic pen features.

Test Prerequesites

Install the Haptic Pen Validation Tool

  1. Download the Haptic Pen Validation Tool
  2. Right-click on the downloaded HapticPenValidationTool.appx file
  3. Select Properties
  4. Select the Digital Signatures tab
  5. Select the signature in the list
  6. Press the Details button
  7. Press the View Certificate button
  8. Press the Install Certificate... button
  9. Select Local Machine and press the Next button
  10. Select Place all certificates in the following store and press the Browse... button
  11. Select Trusted People and press the OK button
  12. Press the Next button
  13. Press the Finish button
  14. Double-click on HapticPenValidationTool.appx and press the Install button

Test Cases

Follow the steps below to run tast cases for each scenario.

Test Case 1: Verifying the pen properly reports required haptic capabilities

  1. Launch the Haptic Pen Validation tool and navigate to the “Check Required Waveforms” tab
  2. Bring the pen within range of the main canvas

Expected results for Test Case 1

The below text is shown:

SUCCESS: Click supported

SUCCESS: InkContinuous supported

Successfully passing the Required Waveforms test

Failure cases for Test Case 1

Error Case Error Reason
"FAILURE: Current device is not a pen" text is shown The current pointer device is not recognized as a pen
"FAILURE: Advanced pen features not supported" text is shown The current pen does not support advanced features, such as tactile feedback
"FAILURE: This pen does not provide tactile feedback" text is shown The current pen does not support haptics
"FAILURE: Click not supported" text is shown The current pen does not support the WAVEFORM_CLICK
"FAILURE: InkContinuous not supported" text is shown The current pen does not support the WAVEFORM_ INKCONTINUOUS

Example failure message:

Failing the Required Waveforms test

Test Case 2: Verifying required interactions

  1. Successfully pass Test 1
  2. Navigate to the “Check Required Interactions” tab of the validation tool
  3. Use the pen to tap the “Send Click Feedback” button
  4. Place the pen in the box in the InkContinuous Test and move it for more than one second while keeping the tip in contact with the screen
  5. Place the pen in the box in the Inking and Interaction Feedback Test and move it for one second while keeping the tip in contact with the screen
  6. Once the Click waveform is felt, hold the pen in place with the pen continuing to touch the screen but not moving for one second
  7. Continue moving the pen in the box

Expected results for Test Case 2

  1. The “Click” waveform is played by the pen upon tapping the button in Step 3.
  2. The “InkContinuous” waveform is played, starting when the pen tip comes down in Step 4 and then stops after one second of the pen being in contact with the screen.
  3. The “InkContinuous” waveform is played, starting when the pen tip makes contact with the screen in Step 5.
  4. The “Click” waveform is played after one second of dragging the pen in the box in Step 5.
  5. The “InkContinuous” waveform is played once the pen is moved in Step 7.

Failure cases for Test Case 2

Error Case Error Reason
No haptic feedback is felt when the button is tapped with the pen in Step 3 The pen did not properly play the WAVEFORM_CLICK waveform
No haptic feedback is felt when the pen is moved during Step 4 The pen did not properly play the WAVEFORM_INKCONTINUOUS waveform
Haptic feedback does not stop after one second of movement during Step 4 The pen did not properly respond to WAVEFORM_STOP
No haptic feedback is felt when the pen is moved during Step 5 The pen did not properly play the WAVEFORM_INKCONTINUOUS waveform
The “Click” waveform is not played after one second of movement in Step 5 The pen did not properly play the WAVEFORM_CLICK waveform
No haptic feedback is felt when the pen is moved during Step 7 If haptic feedback was felt during Step 3 and Step 5, this indicates that the pen does not properly resume an Inking waveform when interrupted by an Interaction waveform. If not, this indicates that that the pen did not properly play the WAVEFORM_INKCONTINUOUS waveform.

Test Case 3: Verifying optional waveforms

The tests included in this section are optional and should only be used if the current pen supports the relevant waveforms.

  1. Successfully pass Test 1 and Test 2
  2. Navigate to the “Check Optional Waveforms” tab of the validation tool
  3. Choose a Continuous waveform to test in the dropdown in the Optional Continuous Waveforms section
  4. Place the pen in the box in the Optional Continuous Waveforms section and move around
  5. Lift the pen from the screen
  6. Choose an Interaction waveform to test in the dropdown in the Optional Interaction Waveforms section
  7. Use the pen to tap the “Send Interaction Feedback” button

Expected results for Test Case 3

  1. The chosen waveform is played, starting when the pen tip comes down in Step 4 and then stops when the pen is lifted in Step 5.
  2. The chosen waveform is played by the pen upon tapping the button in Step 7.

Failure cases for Test Case 3

Error Case Error Reason
No haptic feedback is felt when the pen is moved during Step 4 The pen did not properly play the chosen waveform
Haptic feedback does not stop when lifted from the screen in Step 5 The pen did not properly react to the pen tip being lifted from the screen by stopping the waveform playback
No haptic feedback is felt when the button is tapped with the pen in Step 7 The pen did not properly play the chosen waveform

Test Case 4: Verifying optional interactions

The tests included in this section are optional and should only be used if the current pen supports the relevant features.

  1. Successfully past Test 1 and Test 2
  2. Navigate to the “Check Optional Interactions” tab of the validation tool
  3. Use the pen to press the “Send Click Feedback With Intensity” button
  4. Change the Intensity slider
  5. Use the pen to press the “Send Click Feedback With Intensity” button again
  6. Place the pen in the left box in the Automatically Stop Continuous Feedback Test and move it around
  7. Lift the pen out of range from the screen
  8. Place the pen tip down in the right box in the Automatically Stop Continuous Feedback Test and move it around
  9. Use the pen to press the “Send Repeated Feedback” button
  10. Use the pen to press the “Send Repeated Feedback With One Second Pause” button

Expected results for Test Case 4

  1. The Click waveform is played at 100% intensity when the button is pressed in Step 3.
  2. The Click waveform is played at the chosen intensity when the button is pressed in Step 5.
  3. The “InkContinuous” waveform is played, starting when the pen tip makes contact with the screen in Step 6.
  4. The “InkContinuous” waveform stops when the pen is lifted from the screen in Step 7.
  5. The “InkContinuous” waveform does not play when the pen tip placed in the right box and moved around in Step 8.
  6. The Click waveform is played three times when the button is pressed in Step 9.
  7. The Click waveform is played three times with a one second pause between each when the button is pressed in Step 10.

Failure cases for Test Case 4

Error Case Error Reason
The Click waveform did not play at the chosen intensity when the button is pressed in Step 5 The pen did not properly implement the Intensity feature
No haptic feedback is felt when the pen is moved during Step 6 The pen did not properly play the WAVEFORM_INKCONTINUOUS waveform
Haptic feedback does not stop when lifted from the screen in Step 7 The pen did not properly react to the pen tip being lifted from the screen by stopping the waveform playback
The InkContinuous waveform is played when the pen is placed during Step 8 The pen did not properly clear its waveform state when leaving range of the screen
The Click waveform did not play for three times when the button is pressed in Step 9 The pen did not properly implement the Repeat Count feature
The Click waveform did not have a one second pause between each playback when the button is pressed in Step 10 The pen did not properly implement the Retrigger Period feature