-
Notifications
You must be signed in to change notification settings - Fork 109
Expand file tree
/
Copy pathDevice.java
More file actions
104 lines (97 loc) · 3.02 KB
/
Device.java
File metadata and controls
104 lines (97 loc) · 3.02 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
/*
* Copyright 2013 Klaus Reimer <[email protected]>
* See LICENSE.md for licensing information.
*
* Based on libusb <http://libusb.info/>:
*
* Copyright 2001 Johannes Erdfelt <[email protected]>
* Copyright 2007-2009 Daniel Drake <[email protected]>
* Copyright 2010-2012 Peter Stuge <[email protected]>
* Copyright 2008-2013 Nathan Hjelm <[email protected]>
* Copyright 2009-2013 Pete Batard <[email protected]>
* Copyright 2009-2013 Ludovic Rousseau <[email protected]>
* Copyright 2010-2012 Michael Plante <[email protected]>
* Copyright 2011-2013 Hans de Goede <[email protected]>
* Copyright 2012-2013 Martin Pieuchot <[email protected]>
* Copyright 2012-2013 Toby Gray <[email protected]>
*/
package org.usb4java;
/**
* Structure representing a USB device detected on the system.
*
* This is an opaque type for which you are only ever provided with a pointer,
* usually originating from {@link LibUsb#getDeviceList(Context, DeviceList)}.
*
* Certain operations can be performed on a device, but in order to do any I/O
* you will have to first obtain a device handle using
* {@link LibUsb#open(Device, DeviceHandle)}.
*
* Devices are reference counted with {@link LibUsb#refDevice(Device)} and
* {@link LibUsb#unrefDevice(Device)}, and are freed when the reference count
* reaches 0. New devices presented by
* {@link LibUsb#getDeviceList(Context, DeviceList)} have a reference count of
* 1, and {@link LibUsb#freeDeviceList(DeviceList, boolean)} can optionally
* decrease the reference count on all devices in the list.
* {@link LibUsb#open(Device, DeviceHandle)} adds another reference which is
* later destroyed by {@link LibUsb#close(DeviceHandle)}.
*
* @author Klaus Reimer ([email protected])
*/
public final class Device
{
/** The native pointer to the device structure. */
private long devicePointer;
/**
* Package-private constructor to prevent manual instantiation. Devices are
* always created by JNI.
*/
Device()
{
// Empty
}
/**
* Returns the native pointer to the device structure.
*
* @return The native pointer to the device structure.
*/
public long getPointer()
{
return this.devicePointer;
}
@Override
public int hashCode()
{
final int prime = 31;
int result = 1;
result = (prime * result)
+ (int) (this.devicePointer ^ (this.devicePointer >>> 32));
return result;
}
@Override
public boolean equals(final Object obj)
{
if (this == obj)
{
return true;
}
if (obj == null)
{
return false;
}
if (this.getClass() != obj.getClass())
{
return false;
}
final Device other = (Device) obj;
if (this.devicePointer != other.devicePointer)
{
return false;
}
return true;
}
@Override
public String toString()
{
return String.format("libusb device 0x%x", this.devicePointer);
}
}