Haptic Service
Overview
The haptic service allows direct integration with the haptics engine. The service accepts a sequence of waveform effects to be played back. Developers can use this service for submitting hatpic feedback to the remote from their application.
GATT Characteristics
The following are the proprietary service characteristcs for this service.
- Nexus Base UUID: 9A9B0000-B1EA-49BE-A682-634D01A3CC09
- Service UUID: 0x0100
- Characteristic UUID: 0x0101 (Writeable without Response)
Feedback Characteristic
The feedback characteristic accepts an eight byte array. Each byte in the array represents a single waveform to be played by the haptic driver. It’s acceptable to combine waveforms together in a squence to play advanced haptic patterns. Review the index below for the list of 124 waveforms that can be played.
Example 1: Single Waveform Effect
Byte 1
- Effect Number: 27
- Effect Name: Short Double Click Strong 1 – 100%
array = { 0xB1, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
Example 2: Multi Waveform Seqeunce
In this example, multiple effects are submitted in a sequence. When played back by the haptic driver, the user will fill a more complex virbation pattern.
Byte 1
- Effect Number: 83
- Effect Name: Transition Ramp Up Long Smooth 2
Byte 2
- Effect Number: 1
- Effect Name: Strong Click - 100%
array = { 0x54, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
Waveform Effect Index
Effect ID | Description |
---|---|
0 | End Effect |
1 | Strong Click - 100% |
2 | Strong Click - 60% |
3 | Strong Click - 30% |
4 | Sharp Click - 100% |
5 | Sharp Click - 60% |
6 | Sharp Click - 30% |
7 | Soft Bump - 100% |
8 | Soft Bump - 60% |
9 | Soft Bump - 30% |
10 | Double Click - 100% |
11 | Double Click - 60% |
12 | Triple Click - 100% |
13 | Soft Fuzz - 60% |
14 | Strong Buzz - 100% |
15 | 750ms Alert 100% |
16 | 1000ms Alert 100% |
17 | Strong Click 1 - 100% |
18 | Strong Click 2 - 80% |
19 | Strong Click 3 - 60% |
20 | Strong Click 4 - 30% |
21 | Medium Click 1 - 100% |
22 | Medium Click 2 - 80% |
23 | Medium Click 3 - 60% |
24 | Sharp Tick 1 - 100% |
25 | Sharp Tick 2 - 80% |
26 | Sharp Tick 3 - 60% |
27 | Short Double Click Strong 1 - 100% |
28 | Short Double Click Strong 2 - 80% |
29 | Short Double Click Strong 3 - 60% |
30 | Short Double Click Strong 4 - 30% |
31 | Short Double Click Medium 1 - 100% |
32 | Short Double Click Medium 2 - 80% |
33 | Short Double Click Medium 3 - 60% |
34 | Short Double Sharp Tick 1 - 100% |
35 | Short Double Sharp Tick 2 - 80% |
36 | Short Double Sharp Tick 3 - 60% |
37 | Long Double Sharp Click Strong 1 - 100% |
38 | Long Double Sharp Click Strong 2 - 80% |
39 | Long Double Sharp Click Strong 3 - 60% |
40 | Long Double Sharp Click Strong 4 - 30% |
41 | Long Double Sharp Click Medium 1 - 100% |
42 | Long Double Sharp Click Medium 2 - 80% |
43 | Long Double Sharp Click Medium 3 - 60% |
44 | Long Double Sharp Tick 1 - 100% |
45 | Long Double Sharp Tick 2 - 80% |
46 | Long Double Sharp Tick 3 - 60% |
47 | Buzz 1 - 100% |
48 | Buzz 2 - 80% |
49 | Buzz 3 - 60% |
50 | Buzz 4 - 40% |
51 | Buzz 5 - 20% |
52 | Pulsing Strong 1 - 100% |
53 | Pulsing Strong 2 - 60% |
54 | Pulsing Medium 1 - 100% |
55 | Pulsing Medium 2 - 60% |
56 | Pulsing Sharp 1 - 100% |
57 | Pulsing Sharp 2 - 60% |
58 | Transition Click 1 - 100% |
59 | Transition Click 2 - 80% |
60 | Transition Click 3 - 60% |
61 | Transition Click 4 - 40% |
62 | Transition Click 5 - 20% |
63 | Transition Click 6 - 10% |
64 | Transition Hum 1 - 100% |
65 | Transition Hum 2 - 80% |
66 | Transition Hum 3 - 60% |
67 | Transition Hum 4 - 40% |
68 | Transition Hum 5 - 20% |
69 | Transition Hum 6 - 10% |
70 | Transition Ramp Down Long Smooth 1 - 100 to 0% |
71 | Transition Ramp Down Long Smooth 2 - 100 to 0% |
72 | Transition Ramp Down Medium Smooth 1 - 100 to 0% |
73 | Transition Ramp Down Medium Smooth 2 - 100 to 0% |
74 | Transition Ramp Down Short Smooth 1 - 100 to 0% |
75 | Transition Ramp Down Short Smooth 2 - 100 to 0% |
76 | Transition Ramp Down Long Sharp 1 - 100 t0 0% |
77 | Transition Ramp Down Long Sharp 2 - 100 to 0% |
78 | Transition Ramp Down Medium Sharp 1 - 100 to 0% |
79 | Transition Ramp Down Medium Sharp 2 - 100 to 0% |
80 | Transition Ramp Down Short Sharp 1 - 100 to 0% |
81 | Transition Ramp Down Short Sharp 2 - 100 to 0% |
82 | Transition Ramp Up Long Smooth 1 - 0 to 100% |
83 | Transition Ramp Up Long Smooth 2 - 0 to 100% |
84 | Transition Ramp Up Medium Smooth 1 - 0 to 100% |
85 | Transition Ramp Up Medium Smooth 2 - 0 to 100% |
86 | Transition Ramp Up Short Smooth 1 - 0 to 100% |
87 | Transition Ramp Up Short Smooth 2 - 0 to 100% |
88 | Transition Ramp Up Long Sharp 1 - 0 to 100% |
89 | Transition Ramp Up Long Sharp 2 - 0 to 100% |
90 | Transition Ramp Up Medium Sharp 1 - 0 to 100% |
91 | Transition Ramp Up Medium Sharp 2 - 0 to 100% |
92 | Transition Ramp Up Short Sharp 1 - 0 to 100% |
93 | Transition Ramp Up Short Sharp 2 - 0 to 100% |
94 | Transition Ramp Down Long Smooth 1 - 50 to 0% |
95 | Transition Ramp Down Long Smooth 2 - 50 to 0% |
96 | Transition Ramp Down Medium Smooth 1 - 50 to 0% |
97 | Transition Ramp Down Medium Smooth 2 - 50 to 0% |
98 | Transition Ramp Down Short Smooth 1 - 50 to 0% |
99 | Transition Ramp Down Short Smooth 2 - 50 to 0% |
100 | Transition Ramp Down Long Sharp 1 - 50 to 0% |
101 | Transition Ramp Down Long Sharp 2 - 50 to 0% |
102 | Transition Ramp Down Medium Sharp 1 - 50 to 0% |
103 | Transition Ramp Down Medium Sharp 2 - 50 to 0% |
104 | Transition Ramp Down Short Sharp 1 - 50 to 0% |
105 | Transition Ramp Down Short Sharp 2 - 50 to 0% |
106 | Transition Ramp Up Long Smooth 1 - 0 to 50% |
107 | Transition Ramp Up Long Smooth 2 - 0 to 50% |
108 | Transition Ramp Up Medium Smooth 1 - 0 to 50% |
109 | Transition Ramp Up Medium Smooth 2 - 0 to 50% |
110 | Transition Ramp Up Short Smooth 1 - 0 to 50% |
111 | Transition Ramp Up Short Smooth 2 - 0 to 50% |
112 | Transition Ramp Up Long Sharp 1 - 0 to 50% |
113 | Transition Ramp Up Long Sharp 2 - 0 to 50% |
114 | Transition Ramp Up Medium Sharp 1 - 0 to 50% |
115 | Transition Ramp Up Medium Sharp 2 - 0 to 50% |
116 | Transition Ramp Up Short Sharp 1 - 0 to 50% |
117 | Transition Ramp Up Short Sharp 2 - 0 to 50% |
118 | Long buzz for programmatic stopping - 100% |
119 | Smooth Hum 1 (No kick or brake pulse) - 50% |
120 | Smooth Hum 2 (No kick or brake pulse) - 40% |
121 | Smooth Hum 3 (No kick or brake pulse) - 30% |
122 | Smooth Hum 4 (No kick or brake pulse) - 20% |
123 | Smooth Hum 5 (No kick or brake pulse) - 10% |