Skip to content

Free Pascal bindings for libhidapi on Windows, Linux, FreeBSD and macOS.

Notifications You must be signed in to change notification settings

ucuccen/HIDAPI.pas

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 

Repository files navigation

HIDAPI.pas

libusb/hidapi Free Pascal bindings, based on HIDAPI.pas, for Linux, Windows, FreeBSD and MacOS.

Usage

Original implementation have chosen the more Pascal-like SomeObject.FooBar(baz) style of porting this API instead of the naked and rather ugly C-ish some_object_foo_bar(some_object, baz) notation for this API. This results in much nicer code when using it. It also allows to convert some unwieldy things like wchar_t* to more convenient UnicodeString on the fly.

The HIDAPI (like most object oriented C-APIs) will use pointers to structs as handles for objects and all API calls (methods of the struct) will expect this pointer as first argument. This is the typical C-style of object oriented programming. Free Pascal allows us to define these structs as Pascal objects and these can have our own methods attached to them (with more Pascalish naming conventions and more Pascalish parameter types) which will then in turn be implemented as wrappers to the original C api functions.

For best experience you should set the modeswitch

{$modeswitch autoderef}

Use the API like this:

var
  Paths: TSringList;
  LinkedList, Item: PHidDeviceInfo;
  
begin
  Paths := TStringList.Create();
  LinkedList := THidDeviceInfo.Enumerate($DEAD, $BEEF);
  Item := LinkedList;
  while Assigned(Item) do begin
    Paths.Append(Item.Path);
    Item := Item.Next;
  end;
  LinkedList.Free;
  
  
  // now you have a list of paths
  
end;

Or when opening a device from a Path you could do it like this:

var
  Device: PHidDevice;
  Buffer: array[0..63] of Byte;
  
begin
  Device := THidDevice.OpenPath(SomePath);
  if Assigned(Device) then begin
    if Device.Read(Buffer, SizeOf(Buffer)) > 0 then begin
      WriteLn('Success, got some Data');
    end;
    
    // do more stuff with the device
    
    Device.Close;
  end;
end;

Without the autoderef modeswitch you would have to write it like Device^.Read or LinkedList^.Free, this looks ugly, the autoderef will dereference the pointer to the object automatically.

About

Free Pascal bindings for libhidapi on Windows, Linux, FreeBSD and macOS.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Pascal 100.0%