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 249 250 251 252 253 254 255 256 257 258 259 260
| { HIDAPI.pas - Bindings for libhidapi
Copyright (C) 2016 Bernd Kreuss <prof7bit@gmail.com>
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General
Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option)
any later version with the following modification:
As a special exception, the copyright holders of this library give you permission to link this library with
independent modules to produce an executable, regardless of the license terms of these independent modules,and to
copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each
linked independent module, the terms and conditions of the license of that module. An independent module is a module
which is not derived from or based on this library. If you modify this library, you may extend this exception to
your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception
statement from your version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more
details.
You should have received a copy of the GNU Library General Public License along with this library; if not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
}
unit hidapi;
{$mode objfpc}{$H+}
interface
uses
Classes, SysUtils, ctypes;
const
LIBHIDAPI = 'hidapi-libusb';
type
PCWChar = ^TCWChar;
TCWChar = UCS4Char; // wchar_t of size 4 (NOT ON WINDOWS!)
TCWCharArray = array of TCWChar;
{ THidDevice }
PHidDevice = ^THidDevice;
THidDevice = object
function Write(const Data; Length: SizeInt): SizeInt;
function Read(out Data; Length: SizeInt): SizeInt;
function ReadTimeout(out Data; Length: SizeInt; Millis: Integer): SizeInt;
function SetNonBlocking(NonBlock: Integer): Integer;
function SendFeatureReport(const Data; Length: SizeInt): SizeInt;
function GetFeatureReport(out Data; Length: SizeInt): SizeInt;
function GetManufacturerString: UnicodeString;
function GetProductString: UnicodeString;
function GetSerialNumberString: UnicodeString;
function GetIndexedString(Index: Integer): UnicodeString;
procedure Close;
function Open(VID: Word; PID: Word; Serial: UnicodeString): PHidDevice; static;
function OpenPath(Path: String): PHidDevice; static;
end;
{ THidDeviceInfo }
PHidDeviceInfo = ^THidDeviceInfo;
THidDeviceInfo = object
Path: PChar;
VendorID: Word;
ProductID: Word;
SerialNumber: PCWChar;
ReleaseNumber: Word;
ManufacturerString: PCWChar;
ProductString: PCWChar;
UsagePage: Word;
Usage: Word;
InterfaceNumber: cint;
Next: PHidDeviceInfo;
function Enumerate(VID: Word; PID: Word): PHidDeviceInfo; static;
procedure Free;
end;
function HidInit: Integer;
function HidExit: Integer;
function PCWCharToUnicodeString(P: PCWChar): UnicodeString;
implementation
{ imported external API functions }
function hid_init: cint; cdecl; external LIBHIDAPI;
function hid_exit: cint; cdecl; external LIBHIDAPI;
function hid_enumerate(vendor_id: Word; product_id: Word): PHidDeviceInfo; cdecl; external LIBHIDAPI;
procedure hid_free_enumeration(devs: PHidDeviceInfo); cdecl; external LIBHIDAPI;
function hid_open(vendor_id: Word; product_id: Word; serial_number: PCWChar): PHidDevice; cdecl; external LIBHIDAPI;
function hid_open_path(path: PChar): PHidDevice; cdecl; external LIBHIDAPI;
function hid_write(device: PHidDevice; data: Pointer; length: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_read_timeout(device: PHidDevice; data: Pointer; length: SizeInt; millisec: cint): cint; cdecl; external LIBHIDAPI;
function hid_read(device: PHidDevice; data: Pointer; length: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_set_nonblocking(device: PHidDevice; nonblock: cint): cint; cdecl; external LIBHIDAPI;
function hid_send_feature_report(device: PHidDevice; data: Pointer; length: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_get_feature_report(device: PHidDevice; data: Pointer; length: SizeInt): cint; cdecl; external LIBHIDAPI;
procedure hid_close(device: PHidDevice); cdecl; external LIBHIDAPI;
function hid_get_manufacturer_string(device: PHidDevice; str: PCWChar; maxlen: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_get_product_string(device: PHidDevice; str: PCWChar; maxlen: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_get_serial_number_string(device: PHidDevice; str: PCWChar; maxlen: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_get_indexed_string(device: PHidDevice; string_index: cint; str: PCWChar; maxlen: SizeInt): cint; cdecl; external LIBHIDAPI;
function hid_error(device: PHidDevice): PCWChar; cdecl; external LIBHIDAPI;
{ helper functions for dealing with widechar strings }
function PCWCharToUnicodeString(P: PCWChar): UnicodeString;
var
L: Integer;
WS: array of TCWChar;
begin
if not Assigned(P) then
exit('');
// strlen
L := 0;
while P[L] <> 0 do begin
Inc(L);
end;
// make a copy including the terminating zero
Inc(L);
SetLength(WS, L);
Move(P^, WS[0], L * SizeOf(TCWChar));
// for 4-Byte chars we can convert with
// the existing UCS4 function.
// NOT SO ON WINDOWS!
Result := UCS4StringToUnicodeString(WS);
end;
function UnicodeStringToTCWCharNullterminated(S: UnicodeString): TCWCharArray;
begin
// the chars are of size 4, so we
// can use the UCS4 functions
// NOT SO ON WINDOWS!
Result := UnicodeStringToUCS4String(S);
end;
{ Initialize and deinitialize the HIDAPI }
function HidInit: Integer;
begin
Result := hid_init;
end;
function HidExit: Integer;
begin
Result := hid_exit;
end;
{ THidDeviceInfo }
function THidDeviceInfo.Enumerate(VID: Word; PID: Word): PHidDeviceInfo;
begin
Result := hid_enumerate(VID, PID);
end;
procedure THidDeviceInfo.Free;
begin
hid_free_enumeration(@Self);
end;
{ THidDevice }
function THidDevice.Write(const Data; Length: SizeInt): SizeInt;
begin
Result := hid_write(@self, @Data, Length);
end;
function THidDevice.Read(out Data; Length: SizeInt): SizeInt;
begin
Result := hid_read(@Self, @Data, Length);
end;
function THidDevice.ReadTimeout(out Data; Length: SizeInt; Millis: Integer): SizeInt;
begin
Result := hid_read_timeout(@Self, @Data, Length, Millis);
end;
function THidDevice.SetNonBlocking(NonBlock: Integer): Integer;
begin
Result := hid_set_nonblocking(@Self, NonBlock);
end;
function THidDevice.SendFeatureReport(const Data; Length: SizeInt): SizeInt;
begin
Result := hid_send_feature_report(@Self, @Data, Length);
end;
function THidDevice.GetFeatureReport(out Data; Length: SizeInt): SizeInt;
begin
Result := hid_get_feature_report(@Self, @Data, Length);
end;
function THidDevice.GetManufacturerString: UnicodeString;
var
Buf: array[0..255] of TCWChar;
begin
hid_get_manufacturer_string(@Self, @Buf, Length(Buf) - 1);
Result := PCWCharToUnicodeString(@Buf);
end;
function THidDevice.GetProductString: UnicodeString;
var
Buf: array[0..255] of TCWChar;
begin
hid_get_product_string(@Self, @Buf, Length(Buf) - 1);
Result := PCWCharToUnicodeString(@Buf);
end;
function THidDevice.GetSerialNumberString: UnicodeString;
var
Buf: array[0..255] of TCWChar;
begin
hid_get_serial_number_string(@Self, @Buf, Length(Buf) - 1);
Result := PCWCharToUnicodeString(@Buf);
end;
function THidDevice.GetIndexedString(Index: Integer): UnicodeString;
var
Buf: array[0..255] of TCWChar;
begin
hid_get_indexed_string(@Self, Index, @Buf, Length(Buf) - 1);
Result := PCWCharToUnicodeString(@Buf);
end;
procedure THidDevice.Close;
begin
hid_close(@Self);
end;
function THidDevice.Open(VID: Word; PID: Word; Serial: UnicodeString): PHidDevice;
var
WS: TCWCharArray;
begin
WS := UnicodeStringToTCWCharNullterminated(Serial);
if Length(WS) > 1 then
Result := hid_open(VID, PID, @WS[0])
else
Result := hid_open(VID, PID, nil);
end;
function THidDevice.OpenPath(Path: String): PHidDevice;
begin
Result := hid_open_path(PChar(Path));
end;
initialization
HidInit;
finalization
HidExit;
end. |
Partager