This repository was archived by the owner on Feb 27, 2025. It is now read-only.
forked from gvalkov/python-evdev
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathff.py
More file actions
196 lines (161 loc) · 4.87 KB
/
ff.py
File metadata and controls
196 lines (161 loc) · 4.87 KB
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
# encoding: utf-8
import ctypes
from evdev import ecodes
_u8 = ctypes.c_uint8
_u16 = ctypes.c_uint16
_u32 = ctypes.c_uint32
_s16 = ctypes.c_int16
_s32 = ctypes.c_int32
class Replay(ctypes.Structure):
'''
Defines scheduling of the force-feedback effect
@length: duration of the effect
@delay: delay before effect should start playing
'''
_fields_ = [
('length', _u16),
('delay', _u16),
]
class Trigger(ctypes.Structure):
'''
Defines what triggers the force-feedback effect
@button: number of the button triggering the effect
@interval: controls how soon the effect can be re-triggered
'''
_fields_ = [
('button', _u16),
('interval', _u16),
]
class Envelope(ctypes.Structure):
'''
Generic force-feedback effect envelope
@attack_length: duration of the attack (ms)
@attack_level: level at the beginning of the attack
@fade_length: duration of fade (ms)
@fade_level: level at the end of fade
The @attack_level and @fade_level are absolute values; when applying
envelope force-feedback core will convert to positive/negative
value based on polarity of the default level of the effect.
Valid range for the attack and fade levels is 0x0000 - 0x7fff
'''
_fields_ = [
('attach_length', _u16),
('attack_level', _u16),
('fade_length', _u16),
('fade_level', _u16),
]
class Constant(ctypes.Structure):
'''
Defines parameters of a constant force-feedback effect
@level: strength of the effect; may be negative
@envelope: envelope data
'''
_fields_ = [
('level', _s16),
('ff_envelope', Envelope),
]
class Ramp(ctypes.Structure):
'''
Defines parameters of a ramp force-feedback effect
@start_level: beginning strength of the effect; may be negative
@end_level: final strength of the effect; may be negative
@envelope: envelope data
'''
_fields_ = [
('start_level', _s16),
('end_level', _s16),
('ff_envelope', Envelope),
]
class Condition(ctypes.Structure):
'''
Defines a spring or friction force-feedback effect
@right_saturation: maximum level when joystick moved all way to the right
@left_saturation: same for the left side
@right_coeff: controls how fast the force grows when the joystick moves to the right
@left_coeff: same for the left side
@deadband: size of the dead zone, where no force is produced
@center: position of the dead zone
'''
_fields_ = [
('right_saturation', _u16),
('left_saturation', _u16),
('right_coeff', _s16),
('left_coeff', _s16),
('deadband', _u16),
('center', _s16),
]
class Periodic(ctypes.Structure):
'''
Defines parameters of a periodic force-feedback effect
@waveform: kind of the effect (wave)
@period: period of the wave (ms)
@magnitude: peak value
@offset: mean value of the wave (roughly)
@phase: 'horizontal' shift
@envelope: envelope data
@custom_len: number of samples (FF_CUSTOM only)
@custom_data: buffer of samples (FF_CUSTOM only)
'''
_fields_ = [
('waveform', _u16),
('period', _u16),
('magnitude', _s16),
('offset', _s16),
('phase', _u16),
('envelope', Envelope),
('custom_len', _u32),
('custom_data', ctypes.POINTER(_s16)),
]
class Rumble(ctypes.Structure):
'''
Defines parameters of a periodic force-feedback effect
@strong_magnitude: magnitude of the heavy motor
@weak_magnitude: magnitude of the light one
Some rumble pads have two motors of different weight. Strong_magnitude
represents the magnitude of the vibration generated by the heavy one.
'''
_fields_ = [
('strong_magnitude', _u16),
('weak_magnitude', _u16),
]
class EffectType(ctypes.Union):
_fields_ = [
('ff_constant_effect', Constant),
('ff_ramp_effect', Ramp),
('ff_periodic_effect', Periodic),
('ff_condition_effect', Condition * 2), # one for each axis
('ff_rumble_effect', Rumble),
]
class Effect(ctypes.Structure):
_fields_ = [
('type', _u16),
('id', _s16),
('direction', _u16),
('ff_trigger', Trigger),
('ff_replay', Replay),
('u', EffectType)
]
class UInputUpload(ctypes.Structure):
_fields_ = [
('request_id', _u32),
('retval', _s32),
('effect', Effect),
('old', Effect),
]
class UInputErase(ctypes.Structure):
_fields_ = [
('request_id', _u32),
('retval', _s32),
('effect_id', _u32),
]
# ff_types = {
# ecodes.FF_CONSTANT,
# ecodes.FF_PERIODIC,
# ecodes.FF_RAMP,
# ecodes.FF_SPRING,
# ecodes.FF_FRICTION,
# ecodes.FF_DAMPER,
# ecodes.FF_RUMBLE,
# ecodes.FF_INERTIA,
# ecodes.FF_CUSTOM,
# }