I have one use-case where the current API is quite painful to work around, and I think adding support for write-only or read-only opening would help a lot of people.

My scenario:
I need to send Feature Reports to a HID mouse (mostly to control RGB lighting, DPI stages, polling rate, etc. on gaming mice).

On Windows:
The mouse is opened successfully with GENERIC_WRITE access
Writing Feature Reports (via HidD_SetFeature) works perfectly
But Windows refuses to open the same device with GENERIC_READ access.
When I do device.TryOpen(out var stream) in HidSharp, it requests both read and write access and fails.

Feature request / suggestion
An OpenMode / Access option in TryOpen(OpenConfiguration)

Something like:
var config = new OpenConfiguration();
config.SetOption(OpenOption.ReadAccess, true);
config.SetOption(OpenOption.WriteAccess, true);
device.TryOpen(config, out var stream);

This would allow clean write-only usage for exactly the kind of devices that Windows protects from being read (mice, some keyboards, touchpads, etc.) while still letting us send output/feature reports.

Thanks for considering this.

This version fixes a bug in how negative physical and logical ranges on HID items are encoded.

Enjoy!

God bless.

James

It fixes some bugs (one potential crash bug in the VNC client), but mainly, it adds 8-bit color support (ugly) and Zlib support (useful) to the VNC server.

With Zlib support, the VNC server is actually practical to use over the Internet. It uses about 10X less bandwidth, at least when using normal desktop applications. CPU usage is a bit higher when using Zlib, but you can always turn off compression in the VNC client if this is a problem.

Enjoy!

God bless.

James

It drastically speeds up the VNC server, and fixes some bugs in it as well. Basic Hextile support is in, so 16x16 regions which are a solid color now take 5 bytes to transfer instead of 1024. This helps on text-heavy pages.

Enjoy!

God bless.

James

Thanks for this library. There's a problem in the report descriptor parsing with signed values for axis (PhysicalMinimum and LogicalMinimum).

When a negative value is found, it is forced to 0 in Reports/Encoding/EncodedItems, line 160 and 162 :

Changing the following two lines fixes the bug:

EncodedItem.cs : L160 change
{ DataValue = (uint)(sbyte)value; if (value < 0) { Data.Add(0); } }
to
{ DataValue = (uint)(sbyte)value; }

and EncodedItem:L162 change
{ DataValue = (uint)(short)value; if (value < 0) { Data.Add(0); Data.Add(0); } }
to
{ DataValue = (uint)(short)value; }

I don't understand what is the purpose of these 2 tests, and if it is a correct fix. Currently I'm stuck in the development of a plugin for a software that uses this library in a dll because of this bug.

This is a simple Linux differential copy utility that operates over SSH. Mostly it is useful for backing up virtual machine images over the Internet.

I wrote it in 2010, and posted it on SourceForge briefly -- it appears to be gone now -- but never made a proper release of it. At any rate, this version uses SHA-256 hashes instead of SHA-1 and has some basic versioning in the protocol so I can improve it in the future if I want to. Documentation is included.

Enjoy!

God bless.

James

This version improves the shutdown behavior on Windows, Mac, and Linux. It also adds a ManualShutdown() method to trigger that shutdown behavior. If you're doing some custom behavior loading and unloading assemblies, this version should be a great improvement for you.

Enjoy!

God bless.

James

It adds support for 16-bit color mode. I found one of my virtual machines used this mode, and RemoteViewing did not previously support it.

It also fixes mouse coordinate scaling on the Windows Forms control. Thanks to mike10 for reporting this bug!

Enjoy!

God bless.

James

I've been using HIDSharp for device testing and programming through Raspberry Pi devices, so Linux support is greatly improved by this version:

HidDevice.GetSerialPorts() lets you get the serial ports corresponding to a USB composite HID device.
HidDevice.GetUsbPort() lets you get information about the USB port to which the HID device is connected. You can use this for visual displays where you have a number of USB devices connected to the same hub, and don't want the connected device list dancing around.
SerialDevice.GetManufacturerName(), GetProductName(), and GetSerialNumber() all work on Linux now.

There are other improvements and bug fixes as well.

Enjoy!

God bless.

James

Thanks for the great HidSharp library, I find it very useful. I am using it in one C# project to communicate with a specific device and want to be able to write unit tests for it. Unfortunately, the library currently makes use of concrete types with no interfaces. This makes it hard to mock/fake for testing.

Is there any chance an `IHidDevice` interface could be added to the NuGet package please? I would be happy to contribute it myself, if you are accepting outside contributions and can tell me how best to share my code with you, as it isn't hosted on GitHub.

I envisage something like this:

```
public interface IHidDevice
{
    Stream Open();
    int ProductID { get; }
    int VendorID { get; }
}
```

Thanks for your effort in developing this.

I am currently trying to implement a VNC client in a C# form using this. I tried VNCSharp previously but found the performance to be poor. RemoteViewing seems much better in that respect. However I find that if I use any sizemode other than AutoSize then the mouse scaling seems incorrect - i.e. I cannot reach the bottom X amount of the screen, depending on how much the size of the control differs from that used by autosize.

If I use Autosize the problem I have is that the control is then bigger than the form in which I need to display it. I added a panel and made this the parent of the control so I at least get scrollbars and everything works but not userfriendly! Anyideas on a better solution?

TIA

Mike

I have a USB scanner for bar codes/QR codes/MRZ.
I have a user manual from the manufacturer, which contains a set of QR codes that allow me to configure the device.
For example by scanning the following values:

$>:S01010F.<$ (Enter Setup)
$>: S0F0516.<$ (USB HID POS)
$>:S01000F.<$ (Exit Setup)

I was able to switch the device to "USB HID POS" mode. (default mode being "USB HID-KBW" in which the scanner behaves like a keyboard)
In this mode I am able to read scanned data using the HidSharp library.

However I also need to be able to change the settings of the device programmatically. But when I call stream.Write, I always get the following exception:

System.IO.IOException: 'Operation failed early: The parameter is incorrect'

Stack trace:
at HidSharp.Platform.Windows.NativeMethods.OverlappedOperation(IntPtr ioHandle, IntPtr eventHandle, Int32 eventTimeout, IntPtr closeEventHandle, Boolean overlapResult, NativeOverlapped* overlapped, UInt32& bytesTransferred)

There's an inner exception that just says Win32Exception: 'The parameter is incorrect' (no stack trace)

Info about the device:

// hdev.ToString() + " | " + hdev.DevicePath
Linux 3.10.14 with dwc2-gadget hidpos 00000000 (VID 4619, PID 33287, version 3.10) | \\?\hid#vid_120b&pid_8207#7&52366e0&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}

(the device itself has "Linux" in the name, I'm currently running Windows 10)

The following is an enumeration over the device's Reports:

Max Lengths: Input 64, Output 64, Feature 0
Serial Ports:
1 device items found.
Usage: 8C0001 9175041
Input: ReportID=2, Length=64, Items=1
63 Elements x 8 Bits, Units: None, Expected Usage Type: 0, Flags: Variable, BufferedBytes, Usages: 8C00FE 9175294
Output: ReportID=4, Length=64, Items=1
63 Elements x 8 Bits, Units: None, Expected Usage Type: 0, Flags: Variable, Relative, Nonlinear, Volatile, Usages: 8C0000 9175040

What I'm trying to do:

Assuming the device supports receiving setup commands, and that these are the same as the commands from the QR codes, I've been trying to send the following commands to the device (one at a time):

01010F (Enter Setup)
0C0814 (Set external illumination to "Always on")
01000F (Exit Setup)

NOTE: I've tried sending it in the format $>:S01010F.<$ and S01010F, but I suspect those are just some tags telling the QR parser it's a command, and the actual command is the 6 digit hex string.

I've tried creating the input buffer diretly:
var enterSetupBuffer = Encoding.ASCII.GetBytes("01010F");

I've tried creating a byte array of size 64 and setting the first few bytes in the array:
var someBuffer = new byte[64];
someBuffer[0] = 0x01;
someBuffer[1] = 0x01;
someBuffer[2] = 0x0F;
(and some variations on this)

no matter what I do, I get the same error: Operation failed early: The parameter is incorrect.
Some more details: I try to write using the HidStream.Write(buffer). I attempt the write before I start reading from the device. stream.CanWrite is returning true.

As you've probably guessed, I'm not good with hardware. I'm primarily a business application developer. All my attempts so far have been pretty much guesswork. I don't even know if it's the device rejecting my attempts at communication, or if there's something else I don't even know about tripping me up before the data is even sent to the device.

Any help would be greatly appreciated.

I have no troubles with 8-bit. Just with 16-bit joystick I'm having troubles with.

Here's the code:

static void Main()
{
    var list = DeviceList.Local;
    
    var joystick = list.GetHidDeviceOrNull(productID: 12345);

    if (joystick != null)
    {
        using (var stream = joystick.Open())
        {
            var inputReportBuffer = new byte[joystick.GetMaxInputReportLength()];
            while (true)
            {
                try
                {
                    int length = stream.Read(inputReportBuffer, 0, inputReportBuffer.Length);
                    Console.Write($"Worked!\n");
                    Thread.Sleep(1000);
                }
                catch (Exception ex)
                {
                    Console.Write($"Crashed!\n");
                    Console.WriteLine($"Exception: {ex.Message}\n{ex.StackTrace}");
                }

            }
        }
    }
    else
    {
        Console.WriteLine("Joystick not found.");
    }
}

Please help me. I really appreciate any kind of help.