1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
|
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/input/dlg,da7280.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Dialog Semiconductor DA7280 Low Power High-Definition Haptic Driver
maintainers:
- Roy Im <roy.im.opensource@diasemi.com>
properties:
compatible:
const: dlg,da7280
reg:
maxItems: 1
description: I2C address of the device.
interrupts:
maxItems: 1
dlg,actuator-type:
enum:
- LRA # Linear Resonance Actuator type
- ERM-bar # Bar type Eccentric Rotating Mass
- ERM-coin # Coin type Eccentric Rotating Mass
dlg,const-op-mode:
$ref: /schemas/types.yaml#/definitions/uint32
enum:
- 1 # Direct register override (DRO) mode triggered by i2c (default)
- 2 # PWM data source mode controlled by PWM duty
description:
Haptic operation mode for FF_CONSTANT
dlg,periodic-op-mode:
$ref: /schemas/types.yaml#/definitions/uint32
enum:
- 1 # Register triggered waveform memory(RTWM) mode, the pattern
# assigned to the PS_SEQ_ID played as much times as PS_SEQ_LOOP
- 2 # Edge triggered waveform memory(ETWM) mode, external GPI(N)
# control are required to enable/disable and it needs to keep
# device enabled by sending magnitude (X > 0),
# the pattern is assigned to the GPI(N)_SEQUENCE_ID below
default: 1
description:
Haptic operation mode for FF_PERIODIC.
The default value is 1 for both of the operation modes.
For more details, please see the datasheet
dlg,nom-microvolt:
minimum: 0
maximum: 6000000
description:
Nominal actuator voltage rating
dlg,abs-max-microvolt:
minimum: 0
maximum: 6000000
description:
Absolute actuator maximum voltage rating
dlg,imax-microamp:
minimum: 0
maximum: 252000
default: 130000
description:
Actuator max current rating
dlg,impd-micro-ohms:
minimum: 0
maximum: 1500000000
description:
Impedance of the actuator
pwms:
maxItems: 1
dlg,ps-seq-id:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 15
description:
The PS_SEQ_ID(pattern ID in waveform memory inside chip)
to play back when RTWM-MODE is enabled
dlg,ps-seq-loop:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 15
description:
The PS_SEQ_LOOP, Number of times the pre-stored sequence pointed to by
PS_SEQ_ID or GPI(N)_SEQUENCE_ID is repeated
dlg,gpi0-seq-id:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 15
description:
the GPI0_SEQUENCE_ID, pattern to play when gpi0 is triggered
dlg,gpi1-seq-id:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 15
description:
the GPI1_SEQUENCE_ID, pattern to play when gpi1 is triggered
dlg,gpi2-seq-id:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 15
description:
the GPI2_SEQUENCE_ID, pattern to play when gpi2 is triggered
dlg,gpi0-mode:
enum:
- Single-pattern
- Multi-pattern
description:
Pattern mode for gpi0
dlg,gpi1-mode:
enum:
- Single-pattern
- Multi-pattern
description:
Pattern mode for gpi1
dlg,gpi2-mode:
enum:
- Single-pattern
- Multi-pattern
description:
Pattern mode for gpi2
dlg,gpi0-polarity:
enum:
- Rising-edge
- Falling-edge
- Both-edge
description:
gpi0 polarity, Haptic will work by this edge option in case of ETWM mode
dlg,gpi1-polarity:
enum:
- Rising-edge
- Falling-edge
- Both-edge
description:
gpi1 polarity, Haptic will work by this edge option in case of ETWM mode
dlg,gpi2-polarity:
enum:
- Rising-edge
- Falling-edge
- Both-edge
description:
gpi2 polarity, Haptic will work by this edge option in case of ETWM mode
dlg,resonant-freq-hz:
minimum: 50
maximum: 300
default: 205
dlg,bemf-sens-enable:
$ref: /schemas/types.yaml#/definitions/flag
description:
Enable for internal loop computations
dlg,freq-track-enable:
$ref: /schemas/types.yaml#/definitions/flag
description:
Enable for resonant frequency tracking
dlg,acc-enable:
$ref: /schemas/types.yaml#/definitions/flag
description:
Enable for active acceleration
dlg,rapid-stop-enable:
$ref: /schemas/types.yaml#/definitions/flag
description:
Enable for rapid stop
dlg,amp-pid-enable:
$ref: /schemas/types.yaml#/definitions/flag
description:
Enable for the amplitude PID
dlg,mem-array:
$ref: /schemas/types.yaml#/definitions/uint32-array
minItems: 100
description:
Customized waveform memory (patterns) data downloaded to the device during initialization.
Each entry value must be included between 0 and 255.
required:
- compatible
- reg
- interrupts
- dlg,actuator-type
- dlg,const-op-mode
- dlg,periodic-op-mode
- dlg,nom-microvolt
- dlg,abs-max-microvolt
- dlg,imax-microamp
- dlg,impd-micro-ohms
additionalProperties: false
examples:
- |
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/interrupt-controller/irq.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
haptics@4a {
compatible = "dlg,da7280";
reg = <0x4a>;
interrupt-parent = <&gpio6>;
interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
dlg,actuator-type = "LRA";
dlg,const-op-mode = <1>;
dlg,periodic-op-mode = <1>;
dlg,nom-microvolt = <2000000>;
dlg,abs-max-microvolt = <2000000>;
dlg,imax-microamp = <170000>;
dlg,resonant-freq-hz = <180>;
dlg,impd-micro-ohms = <10500000>;
dlg,freq-track-enable;
dlg,rapid-stop-enable;
dlg,mem-array = <0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00>;
};
};
|
