usb 2.17.0 → 3.0.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (207) hide show
  1. package/LICENSE +18 -4
  2. package/README.md +25 -516
  3. package/dist/index.d.ts +67 -13
  4. package/dist/index.js +333 -64
  5. package/index.d.ts +89 -0
  6. package/index.js +583 -0
  7. package/package.json +53 -33
  8. package/CHANGELOG.md +0 -294
  9. package/binding.gyp +0 -128
  10. package/dist/index.js.map +0 -1
  11. package/dist/usb/bindings.d.ts +0 -266
  12. package/dist/usb/bindings.js +0 -10
  13. package/dist/usb/bindings.js.map +0 -1
  14. package/dist/usb/capability.d.ts +0 -13
  15. package/dist/usb/capability.js +0 -17
  16. package/dist/usb/capability.js.map +0 -1
  17. package/dist/usb/descriptors.d.ts +0 -128
  18. package/dist/usb/descriptors.js +0 -3
  19. package/dist/usb/descriptors.js.map +0 -1
  20. package/dist/usb/device.d.ts +0 -100
  21. package/dist/usb/device.js +0 -297
  22. package/dist/usb/device.js.map +0 -1
  23. package/dist/usb/endpoint.d.ts +0 -94
  24. package/dist/usb/endpoint.js +0 -219
  25. package/dist/usb/endpoint.js.map +0 -1
  26. package/dist/usb/index.d.ts +0 -31
  27. package/dist/usb/index.js +0 -116
  28. package/dist/usb/index.js.map +0 -1
  29. package/dist/usb/interface.d.ts +0 -80
  30. package/dist/usb/interface.js +0 -133
  31. package/dist/usb/interface.js.map +0 -1
  32. package/dist/webusb/index.d.ts +0 -64
  33. package/dist/webusb/index.js +0 -295
  34. package/dist/webusb/index.js.map +0 -1
  35. package/dist/webusb/webusb-device.d.ts +0 -54
  36. package/dist/webusb/webusb-device.js +0 -434
  37. package/dist/webusb/webusb-device.js.map +0 -1
  38. package/libusb/.clang-tidy +0 -34
  39. package/libusb/.codespellrc +0 -3
  40. package/libusb/.private/README.txt +0 -5
  41. package/libusb/.private/appveyor_build.sh +0 -26
  42. package/libusb/.private/bm.sh +0 -54
  43. package/libusb/.private/ci-build.sh +0 -92
  44. package/libusb/.private/ci-container-build.sh +0 -67
  45. package/libusb/.private/post-rewrite.sh +0 -32
  46. package/libusb/.private/pre-commit.sh +0 -52
  47. package/libusb/.private/wbs.txt +0 -43
  48. package/libusb/.travis.yml +0 -58
  49. package/libusb/AUTHORS +0 -231
  50. package/libusb/COPYING +0 -504
  51. package/libusb/ChangeLog +0 -365
  52. package/libusb/HACKING +0 -25
  53. package/libusb/INSTALL_WIN.txt +0 -52
  54. package/libusb/KEYS +0 -123
  55. package/libusb/Makefile.am +0 -50
  56. package/libusb/NEWS +0 -2
  57. package/libusb/PORTING +0 -94
  58. package/libusb/README +0 -29
  59. package/libusb/README.git +0 -41
  60. package/libusb/TODO +0 -2
  61. package/libusb/Xcode/common.xcconfig +0 -92
  62. package/libusb/Xcode/config.h +0 -31
  63. package/libusb/Xcode/debug.xcconfig +0 -32
  64. package/libusb/Xcode/libusb.xcconfig +0 -21
  65. package/libusb/Xcode/libusb.xcodeproj/project.pbxproj +0 -1391
  66. package/libusb/Xcode/libusb_debug.xcconfig +0 -21
  67. package/libusb/Xcode/libusb_release.xcconfig +0 -21
  68. package/libusb/Xcode/release.xcconfig +0 -30
  69. package/libusb/android/README +0 -152
  70. package/libusb/android/config.h +0 -55
  71. package/libusb/android/examples/unrooted_android.c +0 -301
  72. package/libusb/android/examples/unrooted_android.h +0 -36
  73. package/libusb/android/jni/Android.mk +0 -23
  74. package/libusb/android/jni/Application.mk +0 -40
  75. package/libusb/android/jni/examples.mk +0 -168
  76. package/libusb/android/jni/libusb.mk +0 -60
  77. package/libusb/android/jni/tests.mk +0 -45
  78. package/libusb/appveyor.yml +0 -108
  79. package/libusb/autogen.sh +0 -10
  80. package/libusb/bootstrap.sh +0 -10
  81. package/libusb/configure.ac +0 -450
  82. package/libusb/doc/Makefile.in +0 -22
  83. package/libusb/doc/doxygen.cfg.in +0 -2571
  84. package/libusb/doc/libusb.png +0 -0
  85. package/libusb/examples/Makefile.am +0 -12
  86. package/libusb/examples/dpfp.c +0 -711
  87. package/libusb/examples/ezusb.c +0 -846
  88. package/libusb/examples/ezusb.h +0 -109
  89. package/libusb/examples/fxload.c +0 -310
  90. package/libusb/examples/hotplugtest.c +0 -147
  91. package/libusb/examples/listdevs.c +0 -73
  92. package/libusb/examples/sam3u_benchmark.c +0 -228
  93. package/libusb/examples/testlibusb.c +0 -312
  94. package/libusb/examples/xusb.c +0 -1254
  95. package/libusb/libusb/Makefile.am +0 -98
  96. package/libusb/libusb/Makefile.am.extra +0 -26
  97. package/libusb/libusb/core.c +0 -2925
  98. package/libusb/libusb/descriptor.c +0 -1558
  99. package/libusb/libusb/hotplug.c +0 -489
  100. package/libusb/libusb/io.c +0 -2865
  101. package/libusb/libusb/libusb-1.0.def +0 -199
  102. package/libusb/libusb/libusb-1.0.rc +0 -53
  103. package/libusb/libusb/libusb.h +0 -2421
  104. package/libusb/libusb/libusbi.h +0 -1535
  105. package/libusb/libusb/os/darwin_usb.c +0 -2977
  106. package/libusb/libusb/os/darwin_usb.h +0 -156
  107. package/libusb/libusb/os/emscripten_webusb.cpp +0 -875
  108. package/libusb/libusb/os/events_posix.c +0 -340
  109. package/libusb/libusb/os/events_posix.h +0 -62
  110. package/libusb/libusb/os/events_windows.c +0 -214
  111. package/libusb/libusb/os/events_windows.h +0 -46
  112. package/libusb/libusb/os/haiku_pollfs.cpp +0 -372
  113. package/libusb/libusb/os/haiku_usb.h +0 -113
  114. package/libusb/libusb/os/haiku_usb_backend.cpp +0 -532
  115. package/libusb/libusb/os/haiku_usb_raw.cpp +0 -231
  116. package/libusb/libusb/os/haiku_usb_raw.h +0 -188
  117. package/libusb/libusb/os/linux_netlink.c +0 -401
  118. package/libusb/libusb/os/linux_udev.c +0 -321
  119. package/libusb/libusb/os/linux_usbfs.c +0 -2829
  120. package/libusb/libusb/os/linux_usbfs.h +0 -221
  121. package/libusb/libusb/os/netbsd_usb.c +0 -617
  122. package/libusb/libusb/os/null_usb.c +0 -111
  123. package/libusb/libusb/os/openbsd_usb.c +0 -700
  124. package/libusb/libusb/os/sunos_usb.c +0 -1619
  125. package/libusb/libusb/os/sunos_usb.h +0 -79
  126. package/libusb/libusb/os/threads_posix.c +0 -126
  127. package/libusb/libusb/os/threads_posix.h +0 -98
  128. package/libusb/libusb/os/threads_windows.c +0 -40
  129. package/libusb/libusb/os/threads_windows.h +0 -113
  130. package/libusb/libusb/os/windows_common.c +0 -923
  131. package/libusb/libusb/os/windows_common.h +0 -424
  132. package/libusb/libusb/os/windows_usbdk.c +0 -724
  133. package/libusb/libusb/os/windows_usbdk.h +0 -106
  134. package/libusb/libusb/os/windows_winusb.c +0 -4766
  135. package/libusb/libusb/os/windows_winusb.h +0 -787
  136. package/libusb/libusb/strerror.c +0 -223
  137. package/libusb/libusb/sync.c +0 -342
  138. package/libusb/libusb/version.h +0 -18
  139. package/libusb/libusb/version_nano.h +0 -1
  140. package/libusb/libusb-1.0.pc.in +0 -11
  141. package/libusb/msvc/Base.props +0 -60
  142. package/libusb/msvc/Configuration.Application.props +0 -7
  143. package/libusb/msvc/Configuration.Base.props +0 -47
  144. package/libusb/msvc/Configuration.DynamicLibrary.props +0 -21
  145. package/libusb/msvc/Configuration.StaticLibrary.props +0 -7
  146. package/libusb/msvc/ProjectConfigurations.Base.props +0 -69
  147. package/libusb/msvc/build_all.ps1 +0 -17
  148. package/libusb/msvc/config.h +0 -58
  149. package/libusb/msvc/dpfp.vcxproj +0 -33
  150. package/libusb/msvc/dpfp_threaded.vcxproj +0 -38
  151. package/libusb/msvc/fxload.vcxproj +0 -46
  152. package/libusb/msvc/getopt/getopt.c +0 -1060
  153. package/libusb/msvc/getopt/getopt.h +0 -180
  154. package/libusb/msvc/getopt/getopt1.c +0 -188
  155. package/libusb/msvc/getopt.vcxproj +0 -33
  156. package/libusb/msvc/hotplugtest.vcxproj +0 -32
  157. package/libusb/msvc/init_context.vcxproj +0 -35
  158. package/libusb/msvc/libusb.sln +0 -542
  159. package/libusb/msvc/libusb_dll.vcxproj +0 -61
  160. package/libusb/msvc/libusb_static.vcxproj +0 -49
  161. package/libusb/msvc/listdevs.vcxproj +0 -32
  162. package/libusb/msvc/sam3u_benchmark.vcxproj +0 -33
  163. package/libusb/msvc/set_option.vcxproj +0 -35
  164. package/libusb/msvc/stress.vcxproj +0 -35
  165. package/libusb/msvc/stress_mt.vcxproj +0 -33
  166. package/libusb/msvc/testlibusb.vcxproj +0 -32
  167. package/libusb/msvc/xusb.vcxproj +0 -38
  168. package/libusb/tests/Makefile.am +0 -40
  169. package/libusb/tests/init_context.c +0 -153
  170. package/libusb/tests/libusb_testlib.h +0 -76
  171. package/libusb/tests/macos.c +0 -130
  172. package/libusb/tests/set_option.c +0 -253
  173. package/libusb/tests/stress.c +0 -172
  174. package/libusb/tests/stress_mt.c +0 -267
  175. package/libusb/tests/testlib.c +0 -184
  176. package/libusb/tests/umockdev.c +0 -1175
  177. package/libusb/tests/webusb-test-shim/index.js +0 -12
  178. package/libusb/tests/webusb-test-shim/package-lock.json +0 -50
  179. package/libusb/tests/webusb-test-shim/package.json +0 -10
  180. package/libusb.gypi +0 -154
  181. package/libusb_config/config.h +0 -1
  182. package/prebuilds/android-arm/node.napi.armv7.node +0 -0
  183. package/prebuilds/android-arm64/node.napi.armv8.node +0 -0
  184. package/prebuilds/darwin-x64+arm64/node.napi.node +0 -0
  185. package/prebuilds/linux-arm/node.napi.armv6.node +0 -0
  186. package/prebuilds/linux-arm/node.napi.armv7.node +0 -0
  187. package/prebuilds/linux-arm64/node.napi.armv8.node +0 -0
  188. package/prebuilds/linux-ia32/node.napi.node +0 -0
  189. package/prebuilds/linux-x64/node.napi.glibc.node +0 -0
  190. package/prebuilds/linux-x64/node.napi.musl.node +0 -0
  191. package/prebuilds/win32-arm64/node.napi.node +0 -0
  192. package/prebuilds/win32-ia32/node.napi.node +0 -0
  193. package/prebuilds/win32-x64/node.napi.node +0 -0
  194. package/src/device.cc +0 -439
  195. package/src/helpers.h +0 -64
  196. package/src/hotplug/hotplug.h +0 -22
  197. package/src/hotplug/libusb.cc +0 -90
  198. package/src/hotplug/windows.cc +0 -168
  199. package/src/node_usb.cc +0 -314
  200. package/src/node_usb.h +0 -131
  201. package/src/thread_name.cc +0 -79
  202. package/src/thread_name.h +0 -11
  203. package/src/transfer.cc +0 -143
  204. package/src/uv_async_queue.h +0 -41
  205. package/test/usb.coffee +0 -250
  206. package/test/webusb.coffee +0 -227
  207. package/test/worker.cjs +0 -13
@@ -1,297 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ExtendedDevice = void 0;
4
- const usb = require("./bindings");
5
- const interface_1 = require("./interface");
6
- const capability_1 = require("./capability");
7
- const isBuffer = (obj) => !!obj && obj instanceof Uint8Array;
8
- const DEFAULT_TIMEOUT = 1000;
9
- class ExtendedDevice {
10
- constructor() {
11
- this._timeout = DEFAULT_TIMEOUT;
12
- }
13
- /**
14
- * Timeout in milliseconds to use for control transfers.
15
- */
16
- get timeout() {
17
- return this._timeout || DEFAULT_TIMEOUT;
18
- }
19
- set timeout(value) {
20
- this._timeout = value;
21
- }
22
- /**
23
- * Object with properties for the fields of the active configuration descriptor.
24
- */
25
- get configDescriptor() {
26
- try {
27
- return this.__getConfigDescriptor();
28
- }
29
- catch (e) {
30
- // Check descriptor exists
31
- const errno = e.errno;
32
- if (errno === usb.LIBUSB_ERROR_NOT_FOUND ||
33
- errno === usb.LIBUSB_ERROR_NO_DEVICE) {
34
- return undefined;
35
- }
36
- throw e;
37
- }
38
- }
39
- /**
40
- * Contains all config descriptors of the device (same structure as .configDescriptor above)
41
- */
42
- get allConfigDescriptors() {
43
- try {
44
- return this.__getAllConfigDescriptors();
45
- }
46
- catch (e) {
47
- // Check descriptors exist
48
- const errno = e.errno;
49
- if (errno === usb.LIBUSB_ERROR_NOT_FOUND ||
50
- errno === usb.LIBUSB_ERROR_NO_DEVICE) {
51
- return [];
52
- }
53
- throw e;
54
- }
55
- }
56
- /**
57
- * Contains the parent of the device, such as a hub. If there is no parent this property is set to `null`.
58
- */
59
- get parent() {
60
- return this.__getParent();
61
- }
62
- /**
63
- * Open the device.
64
- * @param defaultConfig
65
- */
66
- open(defaultConfig = true) {
67
- this.__open();
68
- // The presence of interfaces is used to determine if the device is open
69
- this.interfaces = [];
70
- if (defaultConfig === false) {
71
- return;
72
- }
73
- const len = this.configDescriptor ? this.configDescriptor.interfaces.length : 0;
74
- for (let i = 0; i < len; i++) {
75
- this.interfaces[i] = new interface_1.Interface(this, i);
76
- }
77
- }
78
- /**
79
- * Close the device.
80
- *
81
- * The device must be open to use this method.
82
- */
83
- close() {
84
- this.__close();
85
- this.interfaces = undefined;
86
- }
87
- /**
88
- * Set the device configuration to something other than the default (0). To use this, first call `.open(false)` (which tells it not to auto configure),
89
- * then before claiming an interface, call this method.
90
- *
91
- * The device must be open to use this method.
92
- * @param desired
93
- * @param callback
94
- */
95
- setConfiguration(desired, callback) {
96
- this.__setConfiguration(desired, error => {
97
- if (!error) {
98
- this.interfaces = [];
99
- const len = this.configDescriptor ? this.configDescriptor.interfaces.length : 0;
100
- for (let i = 0; i < len; i++) {
101
- this.interfaces[i] = new interface_1.Interface(this, i);
102
- }
103
- }
104
- if (callback) {
105
- callback.call(this, error);
106
- }
107
- });
108
- }
109
- /**
110
- * Enable/disable libusb's automatic kernel driver detachment
111
- * When this is enabled libusb will automatically detach the kernel driver on an interface when claiming the interface, and attach it when releasing the interface
112
- *
113
- * The device must be open to use this method.
114
- */
115
- setAutoDetachKernelDriver(enable) {
116
- return this.__setAutoDetachKernelDriver(enable ? 1 : 0);
117
- }
118
- /**
119
- * Perform a control transfer with `libusb_control_transfer`.
120
- *
121
- * Parameter `data_or_length` can be an integer length for an IN transfer, or a `Buffer` for an OUT transfer. The type must match the direction specified in the MSB of bmRequestType.
122
- *
123
- * The `data` parameter of the callback is actual transferred for OUT transfers, or will be passed a Buffer for IN transfers.
124
- *
125
- * The device must be open to use this method.
126
- * @param bmRequestType
127
- * @param bRequest
128
- * @param wValue
129
- * @param wIndex
130
- * @param data_or_length
131
- * @param callback
132
- */
133
- controlTransfer(bmRequestType, bRequest, wValue, wIndex, data_or_length, callback) {
134
- const isIn = !!(bmRequestType & usb.LIBUSB_ENDPOINT_IN);
135
- const wLength = isIn ? data_or_length : data_or_length.length;
136
- if (isIn) {
137
- if (wLength < 0) {
138
- throw new TypeError('Expected size number for IN transfer (based on bmRequestType)');
139
- }
140
- }
141
- else {
142
- if (!isBuffer(data_or_length)) {
143
- throw new TypeError('Expected buffer for OUT transfer (based on bmRequestType)');
144
- }
145
- }
146
- // Buffer for the setup packet
147
- // http://libusbx.sourceforge.net/api-1.0/structlibusb__control__setup.html
148
- const buf = Buffer.alloc(wLength + usb.LIBUSB_CONTROL_SETUP_SIZE);
149
- buf.writeUInt8(bmRequestType, 0);
150
- buf.writeUInt8(bRequest, 1);
151
- buf.writeUInt16LE(wValue, 2);
152
- buf.writeUInt16LE(wIndex, 4);
153
- buf.writeUInt16LE(wLength, 6);
154
- if (!isIn) {
155
- buf.set(data_or_length, usb.LIBUSB_CONTROL_SETUP_SIZE);
156
- }
157
- const transfer = new usb.Transfer(this, 0, usb.LIBUSB_TRANSFER_TYPE_CONTROL, this.timeout, (error, buf, actual) => {
158
- if (callback) {
159
- if (isIn) {
160
- callback.call(this, error, buf.slice(usb.LIBUSB_CONTROL_SETUP_SIZE, usb.LIBUSB_CONTROL_SETUP_SIZE + actual));
161
- }
162
- else {
163
- callback.call(this, error, actual);
164
- }
165
- }
166
- });
167
- try {
168
- transfer.submit(buf);
169
- }
170
- catch (e) {
171
- if (callback) {
172
- process.nextTick(() => callback.call(this, e, undefined));
173
- }
174
- }
175
- return this;
176
- }
177
- /**
178
- * Return the interface with the specified interface number.
179
- *
180
- * The device must be open to use this method.
181
- * @param addr
182
- */
183
- interface(addr) {
184
- if (!this.interfaces) {
185
- throw new Error('Device must be open before searching for interfaces');
186
- }
187
- addr = addr || 0;
188
- for (let i = 0; i < this.interfaces.length; i++) {
189
- if (this.interfaces[i].interfaceNumber === addr) {
190
- return this.interfaces[i];
191
- }
192
- }
193
- throw new Error(`Interface not found for address: ${addr}`);
194
- }
195
- /**
196
- * Perform a control transfer to retrieve a string descriptor
197
- *
198
- * The device must be open to use this method.
199
- * @param desc_index
200
- * @param callback
201
- */
202
- getStringDescriptor(desc_index, callback) {
203
- // Index 0 indicates null
204
- if (desc_index === 0) {
205
- callback();
206
- return;
207
- }
208
- const langid = 0x0409;
209
- const length = 255;
210
- this.controlTransfer(usb.LIBUSB_ENDPOINT_IN, usb.LIBUSB_REQUEST_GET_DESCRIPTOR, ((usb.LIBUSB_DT_STRING << 8) | desc_index), langid, length, (error, buffer) => {
211
- if (error) {
212
- return callback(error);
213
- }
214
- callback(undefined, isBuffer(buffer) ? buffer.toString('utf16le', 2) : undefined);
215
- });
216
- }
217
- /**
218
- * Perform a control transfer to retrieve an object with properties for the fields of the Binary Object Store descriptor.
219
- *
220
- * The device must be open to use this method.
221
- * @param callback
222
- */
223
- getBosDescriptor(callback) {
224
- if (this._bosDescriptor) {
225
- // Cached descriptor
226
- return callback(undefined, this._bosDescriptor);
227
- }
228
- if (this.deviceDescriptor.bcdUSB < 0x201) {
229
- // BOS is only supported from USB 2.0.1
230
- return callback(undefined, undefined);
231
- }
232
- this.controlTransfer(usb.LIBUSB_ENDPOINT_IN, usb.LIBUSB_REQUEST_GET_DESCRIPTOR, (usb.LIBUSB_DT_BOS << 8), 0, usb.LIBUSB_DT_BOS_SIZE, (error, buffer) => {
233
- if (error) {
234
- // Check BOS descriptor exists
235
- if (error.errno === usb.LIBUSB_TRANSFER_STALL)
236
- return callback(undefined, undefined);
237
- return callback(error, undefined);
238
- }
239
- if (!isBuffer(buffer)) {
240
- return callback(undefined, undefined);
241
- }
242
- const totalLength = buffer.readUInt16LE(2);
243
- this.controlTransfer(usb.LIBUSB_ENDPOINT_IN, usb.LIBUSB_REQUEST_GET_DESCRIPTOR, (usb.LIBUSB_DT_BOS << 8), 0, totalLength, (error, buffer) => {
244
- if (error) {
245
- // Check BOS descriptor exists
246
- if (error.errno === usb.LIBUSB_TRANSFER_STALL)
247
- return callback(undefined, undefined);
248
- return callback(error, undefined);
249
- }
250
- if (!isBuffer(buffer)) {
251
- return callback(undefined, undefined);
252
- }
253
- const descriptor = {
254
- bLength: buffer.readUInt8(0),
255
- bDescriptorType: buffer.readUInt8(1),
256
- wTotalLength: buffer.readUInt16LE(2),
257
- bNumDeviceCaps: buffer.readUInt8(4),
258
- capabilities: []
259
- };
260
- let i = usb.LIBUSB_DT_BOS_SIZE;
261
- while (i < descriptor.wTotalLength) {
262
- const capability = {
263
- bLength: buffer.readUInt8(i + 0),
264
- bDescriptorType: buffer.readUInt8(i + 1),
265
- bDevCapabilityType: buffer.readUInt8(i + 2),
266
- dev_capability_data: buffer.slice(i + 3, i + buffer.readUInt8(i + 0))
267
- };
268
- descriptor.capabilities.push(capability);
269
- i += capability.bLength;
270
- }
271
- // Cache descriptor
272
- this._bosDescriptor = descriptor;
273
- callback(undefined, this._bosDescriptor);
274
- });
275
- });
276
- }
277
- /**
278
- * Retrieve a list of Capability objects for the Binary Object Store capabilities of the device.
279
- *
280
- * The device must be open to use this method.
281
- * @param callback
282
- */
283
- getCapabilities(callback) {
284
- const capabilities = [];
285
- this.getBosDescriptor((error, descriptor) => {
286
- if (error)
287
- return callback(error, undefined);
288
- const len = descriptor ? descriptor.capabilities.length : 0;
289
- for (let i = 0; i < len; i++) {
290
- capabilities.push(new capability_1.Capability(this, i));
291
- }
292
- callback(undefined, capabilities);
293
- });
294
- }
295
- }
296
- exports.ExtendedDevice = ExtendedDevice;
297
- //# sourceMappingURL=device.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"device.js","sourceRoot":"","sources":["../../tsc/usb/device.ts"],"names":[],"mappings":"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"}
@@ -1,94 +0,0 @@
1
- import { EventEmitter } from 'events';
2
- import { LibUSBException, Transfer, Device } from './bindings';
3
- import { EndpointDescriptor } from './descriptors';
4
- /** Common base for InEndpoint and OutEndpoint. */
5
- export declare abstract class Endpoint extends EventEmitter {
6
- protected device: Device;
7
- address: number;
8
- /** Endpoint direction: `"in"` or `"out"`. */
9
- abstract direction: 'in' | 'out';
10
- /** Endpoint type: `usb.LIBUSB_TRANSFER_TYPE_BULK`, `usb.LIBUSB_TRANSFER_TYPE_INTERRUPT`, or `usb.LIBUSB_TRANSFER_TYPE_ISOCHRONOUS`. */
11
- transferType: number;
12
- /** Sets the timeout in milliseconds for transfers on this endpoint. The default, `0`, is infinite timeout. */
13
- timeout: number;
14
- /** Object with fields from the endpoint descriptor -- see libusb documentation or USB spec. */
15
- descriptor: EndpointDescriptor;
16
- constructor(device: Device, descriptor: EndpointDescriptor);
17
- /** Clear the halt/stall condition for this endpoint. */
18
- clearHalt(callback: (error: LibUSBException | undefined) => void): void;
19
- /**
20
- * Create a new `Transfer` object for this endpoint.
21
- *
22
- * The passed callback will be called when the transfer is submitted and finishes. Its arguments are the error (if any), the submitted buffer, and the amount of data actually written (for
23
- * OUT transfers) or read (for IN transfers).
24
- *
25
- * @param timeout Timeout for the transfer (0 means unlimited).
26
- * @param callback Transfer completion callback.
27
- */
28
- makeTransfer(timeout: number, callback: (error: LibUSBException | undefined, buffer: Buffer, actualLength: number) => void): Transfer;
29
- }
30
- /** Endpoints in the IN direction (device->PC) have this type. */
31
- export declare class InEndpoint extends Endpoint {
32
- /** Endpoint direction. */
33
- direction: 'in' | 'out';
34
- protected pollTransfers: Transfer[];
35
- protected pollTransferSize: number;
36
- protected pollPending: number;
37
- pollActive: boolean;
38
- transferAsync: (length: number) => Promise<Buffer | undefined>;
39
- constructor(device: Device, descriptor: EndpointDescriptor);
40
- /**
41
- * Perform a transfer to read data from the endpoint.
42
- *
43
- * If length is greater than maxPacketSize, libusb will automatically split the transfer in multiple packets, and you will receive one callback with all data once all packets are complete.
44
- *
45
- * `this` in the callback is the InEndpoint object.
46
- *
47
- * The device must be open to use this method.
48
- * @param length
49
- * @param callback
50
- */
51
- transfer(length: number, callback: (error: LibUSBException | undefined, data?: Buffer) => void): InEndpoint;
52
- /**
53
- * Start polling the endpoint.
54
- *
55
- * The library will keep `nTransfers` transfers of size `transferSize` pending in the kernel at all times to ensure continuous data flow.
56
- * This is handled by the libusb event thread, so it continues even if the Node v8 thread is busy. The `data` and `error` events are emitted as transfers complete.
57
- *
58
- * The device must be open to use this method.
59
- * @param nTransfers
60
- * @param transferSize
61
- * @param callback
62
- */
63
- startPoll(nTransfers?: number, transferSize?: number, callback?: (error: LibUSBException | undefined, buffer: Buffer, actualLength: number, cancelled: boolean) => void): Transfer[];
64
- protected startPollTransfers(nTransfers: number | undefined, transferSize: number | undefined, callback: (error: LibUSBException | undefined, buffer: Buffer, actualLength: number) => void): Transfer[];
65
- /**
66
- * Stop polling.
67
- *
68
- * Further data may still be received. The `end` event is emitted and the callback is called once all transfers have completed or canceled.
69
- *
70
- * The device must be open to use this method.
71
- * @param callback
72
- */
73
- stopPoll(callback?: () => void): void;
74
- }
75
- /** Endpoints in the OUT direction (PC->device) have this type. */
76
- export declare class OutEndpoint extends Endpoint {
77
- /** Endpoint direction. */
78
- direction: 'in' | 'out';
79
- transferAsync: (buffer: Buffer) => Promise<number>;
80
- constructor(device: Device, descriptor: EndpointDescriptor);
81
- /**
82
- * Perform a transfer to write `data` to the endpoint.
83
- *
84
- * If length is greater than maxPacketSize, libusb will automatically split the transfer in multiple packets, and you will receive one callback once all packets are complete.
85
- *
86
- * `this` in the callback is the OutEndpoint object.
87
- *
88
- * The device must be open to use this method.
89
- * @param buffer
90
- * @param callback
91
- */
92
- transfer(buffer: Buffer, callback?: (error: LibUSBException | undefined, actual: number) => void): OutEndpoint;
93
- transferWithZLP(buffer: Buffer, callback: (error: LibUSBException | undefined) => void): void;
94
- }
@@ -1,219 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.OutEndpoint = exports.InEndpoint = exports.Endpoint = void 0;
4
- const events_1 = require("events");
5
- const bindings_1 = require("./bindings");
6
- const util_1 = require("util");
7
- const isBuffer = (obj) => obj && obj instanceof Buffer;
8
- /** Common base for InEndpoint and OutEndpoint. */
9
- class Endpoint extends events_1.EventEmitter {
10
- constructor(device, descriptor) {
11
- super();
12
- this.device = device;
13
- /** Sets the timeout in milliseconds for transfers on this endpoint. The default, `0`, is infinite timeout. */
14
- this.timeout = 0;
15
- this.descriptor = descriptor;
16
- this.address = descriptor.bEndpointAddress;
17
- this.transferType = descriptor.bmAttributes & 0x03;
18
- }
19
- /** Clear the halt/stall condition for this endpoint. */
20
- clearHalt(callback) {
21
- return this.device.__clearHalt(this.address, callback);
22
- }
23
- /**
24
- * Create a new `Transfer` object for this endpoint.
25
- *
26
- * The passed callback will be called when the transfer is submitted and finishes. Its arguments are the error (if any), the submitted buffer, and the amount of data actually written (for
27
- * OUT transfers) or read (for IN transfers).
28
- *
29
- * @param timeout Timeout for the transfer (0 means unlimited).
30
- * @param callback Transfer completion callback.
31
- */
32
- makeTransfer(timeout, callback) {
33
- return new bindings_1.Transfer(this.device, this.address, this.transferType, timeout, callback);
34
- }
35
- }
36
- exports.Endpoint = Endpoint;
37
- /** Endpoints in the IN direction (device->PC) have this type. */
38
- class InEndpoint extends Endpoint {
39
- constructor(device, descriptor) {
40
- super(device, descriptor);
41
- /** Endpoint direction. */
42
- this.direction = 'in';
43
- this.pollTransfers = [];
44
- this.pollTransferSize = 0;
45
- this.pollPending = 0;
46
- this.pollActive = false;
47
- this.transferAsync = (0, util_1.promisify)(this.transfer).bind(this);
48
- }
49
- /**
50
- * Perform a transfer to read data from the endpoint.
51
- *
52
- * If length is greater than maxPacketSize, libusb will automatically split the transfer in multiple packets, and you will receive one callback with all data once all packets are complete.
53
- *
54
- * `this` in the callback is the InEndpoint object.
55
- *
56
- * The device must be open to use this method.
57
- * @param length
58
- * @param callback
59
- */
60
- transfer(length, callback) {
61
- const buffer = Buffer.alloc(length);
62
- const cb = (error, _buffer, actualLength) => {
63
- callback.call(this, error, buffer.slice(0, actualLength));
64
- };
65
- try {
66
- this.makeTransfer(this.timeout, cb).submit(buffer);
67
- }
68
- catch (e) {
69
- process.nextTick(() => callback.call(this, e));
70
- }
71
- return this;
72
- }
73
- /**
74
- * Start polling the endpoint.
75
- *
76
- * The library will keep `nTransfers` transfers of size `transferSize` pending in the kernel at all times to ensure continuous data flow.
77
- * This is handled by the libusb event thread, so it continues even if the Node v8 thread is busy. The `data` and `error` events are emitted as transfers complete.
78
- *
79
- * The device must be open to use this method.
80
- * @param nTransfers
81
- * @param transferSize
82
- * @param callback
83
- */
84
- startPoll(nTransfers, transferSize, callback) {
85
- const transferDone = (error, transfer, buffer, actualLength) => {
86
- if (!error) {
87
- this.emit('data', buffer.slice(0, actualLength));
88
- }
89
- else if (error.errno !== bindings_1.LIBUSB_TRANSFER_CANCELLED) {
90
- if (this.pollActive) {
91
- this.emit('error', error);
92
- this.stopPoll();
93
- }
94
- }
95
- if (this.pollActive) {
96
- startTransfer(transfer);
97
- }
98
- else {
99
- this.pollPending--;
100
- if (this.pollPending === 0) {
101
- this.pollTransfers = [];
102
- this.pollActive = false;
103
- this.emit('end');
104
- if (callback) {
105
- const cancelled = (error === null || error === void 0 ? void 0 : error.errno) === bindings_1.LIBUSB_TRANSFER_CANCELLED;
106
- callback(cancelled ? undefined : error, buffer, actualLength, cancelled);
107
- }
108
- }
109
- }
110
- };
111
- const startTransfer = (transfer) => {
112
- try {
113
- transfer.submit(Buffer.alloc(this.pollTransferSize), (error, buffer, actualLength) => {
114
- transferDone(error, transfer, buffer, actualLength);
115
- });
116
- }
117
- catch (e) {
118
- this.emit('error', e);
119
- this.stopPoll();
120
- }
121
- };
122
- this.pollTransfers = this.startPollTransfers(nTransfers, transferSize, function (error, buffer, actualLength) {
123
- transferDone(error, this, buffer, actualLength);
124
- });
125
- this.pollTransfers.forEach(startTransfer);
126
- this.pollPending = this.pollTransfers.length;
127
- return this.pollTransfers;
128
- }
129
- startPollTransfers(nTransfers = 3, transferSize = this.descriptor.wMaxPacketSize, callback) {
130
- if (this.pollActive) {
131
- throw new Error('Polling already active');
132
- }
133
- this.pollTransferSize = transferSize;
134
- this.pollActive = true;
135
- this.pollPending = 0;
136
- const transfers = [];
137
- for (let i = 0; i < nTransfers; i++) {
138
- const transfer = this.makeTransfer(0, callback);
139
- transfers[i] = transfer;
140
- }
141
- return transfers;
142
- }
143
- /**
144
- * Stop polling.
145
- *
146
- * Further data may still be received. The `end` event is emitted and the callback is called once all transfers have completed or canceled.
147
- *
148
- * The device must be open to use this method.
149
- * @param callback
150
- */
151
- stopPoll(callback) {
152
- if (!this.pollActive) {
153
- throw new Error('Polling is not active.');
154
- }
155
- for (let i = 0; i < this.pollTransfers.length; i++) {
156
- try {
157
- this.pollTransfers[i].cancel();
158
- }
159
- catch (error) {
160
- this.emit('error', error);
161
- }
162
- }
163
- this.pollActive = false;
164
- if (callback)
165
- this.once('end', callback);
166
- }
167
- }
168
- exports.InEndpoint = InEndpoint;
169
- /** Endpoints in the OUT direction (PC->device) have this type. */
170
- class OutEndpoint extends Endpoint {
171
- constructor(device, descriptor) {
172
- super(device, descriptor);
173
- /** Endpoint direction. */
174
- this.direction = 'out';
175
- this.transferAsync = (0, util_1.promisify)(this.transfer).bind(this);
176
- }
177
- /**
178
- * Perform a transfer to write `data` to the endpoint.
179
- *
180
- * If length is greater than maxPacketSize, libusb will automatically split the transfer in multiple packets, and you will receive one callback once all packets are complete.
181
- *
182
- * `this` in the callback is the OutEndpoint object.
183
- *
184
- * The device must be open to use this method.
185
- * @param buffer
186
- * @param callback
187
- */
188
- transfer(buffer, callback) {
189
- if (!buffer) {
190
- buffer = Buffer.alloc(0);
191
- }
192
- else if (!isBuffer(buffer)) {
193
- buffer = Buffer.from(buffer);
194
- }
195
- const cb = (error, _buffer, actual) => {
196
- if (callback) {
197
- callback.call(this, error, actual || 0);
198
- }
199
- };
200
- try {
201
- this.makeTransfer(this.timeout, cb).submit(buffer);
202
- }
203
- catch (e) {
204
- process.nextTick(() => cb(e));
205
- }
206
- return this;
207
- }
208
- transferWithZLP(buffer, callback) {
209
- if (buffer.length % this.descriptor.wMaxPacketSize === 0) {
210
- this.transfer(buffer);
211
- this.transfer(Buffer.alloc(0), callback);
212
- }
213
- else {
214
- this.transfer(buffer, callback);
215
- }
216
- }
217
- }
218
- exports.OutEndpoint = OutEndpoint;
219
- //# sourceMappingURL=endpoint.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../tsc/usb/endpoint.ts"],"names":[],"mappings":"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"}
@@ -1,31 +0,0 @@
1
- import { ExtendedDevice } from './device';
2
- import * as usb from './bindings';
3
- interface EventListeners<T> {
4
- newListener: keyof T;
5
- removeListener: keyof T;
6
- }
7
- interface DeviceIds {
8
- idVendor: number;
9
- idProduct: number;
10
- }
11
- declare module './bindings' {
12
- interface Device extends ExtendedDevice {
13
- }
14
- interface DeviceEvents extends EventListeners<DeviceEvents> {
15
- attach: Device;
16
- detach: Device;
17
- attachIds: DeviceIds;
18
- detachIds: DeviceIds;
19
- }
20
- function addListener<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
21
- function removeListener<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
22
- function on<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
23
- function off<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
24
- function once<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
25
- function listeners<K extends keyof DeviceEvents>(event: K): ((arg: DeviceEvents[K]) => void)[];
26
- function rawListeners<K extends keyof DeviceEvents>(event: K): ((arg: DeviceEvents[K]) => void)[];
27
- function removeAllListeners<K extends keyof DeviceEvents>(event?: K): void;
28
- function emit<K extends keyof DeviceEvents>(event: K, arg: DeviceEvents[K]): boolean;
29
- function listenerCount<K extends keyof DeviceEvents>(event: K): number;
30
- }
31
- export = usb;