From 28f25e8294d9d74c5553b338c3266d56d90d4d1d Mon Sep 17 00:00:00 2001 From: jsaey Date: Tue, 11 Jun 2024 16:57:27 +0200 Subject: [PATCH] Initial version --- EonaCat.HID.sln | 39 ++ EonaCat.HID/Device.cs | 833 ++++++++++++++++++++++++++++++ EonaCat.HID/DeviceAttributes.cs | 21 + EonaCat.HID/DeviceCapabilities.cs | 42 ++ EonaCat.HID/DeviceData.cs | 30 ++ EonaCat.HID/DeviceEventMonitor.cs | 64 +++ EonaCat.HID/Devices.cs | 180 +++++++ EonaCat.HID/Enumerator.cs | 42 ++ EonaCat.HID/EonaCat.HID.csproj | 63 +++ EonaCat.HID/IDevice.cs | 94 ++++ EonaCat.HID/IEnumerator.cs | 16 + EonaCat.HID/NativeMethods.cs | 220 ++++++++ EonaCat.HID/ReadDevice.cs | 81 +++ EonaCat.HID/ReadEnumerator.cs | 44 ++ EonaCat.HID/Report.cs | 85 +++ EonaCat.HID/StateAsync.cs | 17 + EonaCat.HID/icon.ico | Bin 0 -> 254014 bytes EonaCat.HID/icon.png | Bin 0 -> 89562 bytes LICENSE | 213 ++++++-- 19 files changed, 2043 insertions(+), 41 deletions(-) create mode 100644 EonaCat.HID.sln create mode 100644 EonaCat.HID/Device.cs create mode 100644 EonaCat.HID/DeviceAttributes.cs create mode 100644 EonaCat.HID/DeviceCapabilities.cs create mode 100644 EonaCat.HID/DeviceData.cs create mode 100644 EonaCat.HID/DeviceEventMonitor.cs create mode 100644 EonaCat.HID/Devices.cs create mode 100644 EonaCat.HID/Enumerator.cs create mode 100644 EonaCat.HID/EonaCat.HID.csproj create mode 100644 EonaCat.HID/IDevice.cs create mode 100644 EonaCat.HID/IEnumerator.cs create mode 100644 EonaCat.HID/NativeMethods.cs create mode 100644 EonaCat.HID/ReadDevice.cs create mode 100644 EonaCat.HID/ReadEnumerator.cs create mode 100644 EonaCat.HID/Report.cs create mode 100644 EonaCat.HID/StateAsync.cs create mode 100644 EonaCat.HID/icon.ico create mode 100644 EonaCat.HID/icon.png diff --git a/EonaCat.HID.sln b/EonaCat.HID.sln new file mode 100644 index 0000000..960e1d0 --- /dev/null +++ b/EonaCat.HID.sln @@ -0,0 +1,39 @@ +Microsoft Visual Studio Solution File, Format Version 12.00 +# Visual Studio Version 17 +VisualStudioVersion = 17.10.34928.147 +MinimumVisualStudioVersion = 10.0.40219.1 +Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EonaCat.HID", "EonaCat.HID\EonaCat.HID.csproj", "{9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Any CPU = Debug|Any CPU + Debug|Mixed Platforms = Debug|Mixed Platforms + Debug|x64 = Debug|x64 + Debug|x86 = Debug|x86 + Release|Any CPU = Release|Any CPU + Release|Mixed Platforms = Release|Mixed Platforms + Release|x64 = Release|x64 + Release|x86 = Release|x86 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|Any CPU.Build.0 = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|x64.ActiveCfg = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|x64.Build.0 = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Debug|x86.ActiveCfg = Debug|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Release|Any CPU.ActiveCfg = Release|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Release|Any CPU.Build.0 = Release|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Release|Mixed Platforms.Build.0 = Release|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Release|x64.ActiveCfg = Release|Any CPU + {9E8F1D50-74EA-4C60-BD5C-AB2C5B53BC66}.Release|x86.ActiveCfg = Release|Any CPU + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection + GlobalSection(ExtensibilityGlobals) = postSolution + SolutionGuid = {3EA279F1-3C81-4710-A932-87EE335DC024} + EndGlobalSection +EndGlobal diff --git a/EonaCat.HID/Device.cs b/EonaCat.HID/Device.cs new file mode 100644 index 0000000..83088ec --- /dev/null +++ b/EonaCat.HID/Device.cs @@ -0,0 +1,833 @@ +using System; +using System.Runtime.InteropServices; +using System.Threading; +using System.Threading.Tasks; + +namespace EonaCat.HID +{ + public class Device : IDevice + { + public event InsertedEventHandler Inserted; + public event RemovedEventHandler Removed; + + private readonly string _description; + private readonly string _devicePath; + private readonly HidDeviceAttributes _deviceAttributes; + + private readonly HidDeviceCapabilities _deviceCapabilities; + private DeviceMode _deviceReadMode = DeviceMode.NonOverlapped; + private DeviceMode _deviceWriteMode = DeviceMode.NonOverlapped; + private ShareMode _deviceShareMode = ShareMode.ShareRead | ShareMode.ShareWrite; + + private readonly DeviceEventMonitor _deviceEventMonitor; + + private bool _monitorDeviceEvents; + protected delegate DeviceData ReadDelegate(int timeout); + protected delegate HidReport ReadReportDelegate(int timeout); + private delegate bool WriteDelegate(byte[] data, int timeout); + private delegate bool WriteReportDelegate(HidReport report, int timeout); + + internal Device(string devicePath, string description = null) + { + _deviceEventMonitor = new DeviceEventMonitor(this); + _deviceEventMonitor.Inserted += DeviceEventMonitorInserted; + _deviceEventMonitor.Removed += DeviceEventMonitorRemoved; + + _devicePath = devicePath; + _description = description; + + try + { + var hidHandle = OpenDeviceIO(_devicePath, NativeMethods.ACCESS_NONE); + + _deviceAttributes = GetDeviceAttributes(hidHandle); + _deviceCapabilities = GetDeviceCapabilities(hidHandle); + + CloseDeviceIO(hidHandle); + } + catch (Exception exception) + { + throw new Exception(string.Format("EonaCat HID: Error querying HID device '{0}'.", devicePath), exception); + } + } + + public IntPtr ReadHandle { get; private set; } + public IntPtr WriteHandle { get; private set; } + public bool IsOpen { get; private set; } + public bool IsConnected { get { return Devices.IsConnected(_devicePath); } } + public string Description { get { return _description; } } + public HidDeviceCapabilities Capabilities { get { return _deviceCapabilities; } } + public HidDeviceAttributes Attributes { get { return _deviceAttributes; } } + public string DevicePath { get { return _devicePath; } } + + public bool MonitorDeviceEvents + { + get { return _monitorDeviceEvents; } + set + { + if (value & _monitorDeviceEvents == false) + { + _deviceEventMonitor.Init(); + } + + _monitorDeviceEvents = value; + } + } + + public override string ToString() + { + return string.Format("VendorID={0}, ProductID={1}, Version={2}, DevicePath={3}", + _deviceAttributes.VendorHexId, + _deviceAttributes.ProductHexId, + _deviceAttributes.Version, + _devicePath); + } + + public void OpenDevice() + { + OpenDevice(DeviceMode.NonOverlapped, DeviceMode.NonOverlapped, ShareMode.ShareRead | ShareMode.ShareWrite); + } + + public void OpenDevice(DeviceMode readMode, DeviceMode writeMode, ShareMode shareMode) + { + if (IsOpen) + { + return; + } + + _deviceReadMode = readMode; + _deviceWriteMode = writeMode; + _deviceShareMode = shareMode; + + try + { + ReadHandle = OpenDeviceIO(_devicePath, readMode, NativeMethods.GENERIC_READ, shareMode); + WriteHandle = OpenDeviceIO(_devicePath, writeMode, NativeMethods.GENERIC_WRITE, shareMode); + } + catch (Exception exception) + { + IsOpen = false; + throw new Exception("EonaCat HID: Error opening HID device.", exception); + } + + IsOpen = (ReadHandle.ToInt32() != NativeMethods.INVALID_HANDLE_VALUE && + WriteHandle.ToInt32() != NativeMethods.INVALID_HANDLE_VALUE); + } + + + public void CloseDevice() + { + if (!IsOpen) + { + return; + } + + CloseDeviceIO(ReadHandle); + CloseDeviceIO(WriteHandle); + IsOpen = false; + } + + public DeviceData Read() + { + return Read(0); + } + + public DeviceData Read(int timeout) + { + if (IsConnected) + { + if (IsOpen == false) + { + OpenDevice(_deviceReadMode, _deviceWriteMode, _deviceShareMode); + } + + try + { + return ReadData(timeout); + } + catch + { + return new DeviceData(DeviceData.ReadStatus.ReadError); + } + + } + return new DeviceData(DeviceData.ReadStatus.NotConnected); + } + + public void Read(ReadCallback callback) + { + Read(callback, 0); + } + + public void Read(ReadCallback callback, int timeout) + { + var readDelegate = new ReadDelegate(Read); + var asyncState = new StateAsync(readDelegate, callback); + readDelegate.BeginInvoke(timeout, EndRead, asyncState); + } + + public async Task ReadAsync(int timeout = 0) + { + var readDelegate = new ReadDelegate(Read); +#if NET20 || NET35 || NET5_0_OR_GREATER + return await Task.Factory.StartNew(() => readDelegate.Invoke(timeout)); +#else + return await Task.Factory.FromAsync(readDelegate.BeginInvoke, readDelegate.EndInvoke, timeout, null); +#endif + } + + public HidReport ReadReport(int timeout = 0) + { + return new HidReport(Capabilities.InputReportByteLength, Read(timeout)); + } + + public void ReadReport(ReadReportCallback callback, int timeout = 0) + { + var readReportDelegate = new ReadReportDelegate(ReadReport); + var asyncState = new StateAsync(readReportDelegate, callback); + readReportDelegate.BeginInvoke(timeout, EndReadReport, asyncState); + } + + public async Task ReadReportAsync(int timeout = 0) + { + var readReportDelegate = new ReadReportDelegate(ReadReport); +#if NET20 || NET35 || NET5_0_OR_GREATER + return await Task.Factory.StartNew(() => readReportDelegate.Invoke(timeout)); +#else + return await Task.Factory.FromAsync(readReportDelegate.BeginInvoke, readReportDelegate.EndInvoke, timeout, null); +#endif + } + + public HidReport ReadReportSync(byte reportId) + { + byte[] cmdBuffer = new byte[Capabilities.InputReportByteLength]; + cmdBuffer[0] = reportId; + bool bSuccess = NativeMethods.HidD_GetInputReport(ReadHandle, cmdBuffer, cmdBuffer.Length); + DeviceData deviceData = new DeviceData(cmdBuffer, bSuccess ? DeviceData.ReadStatus.Success : DeviceData.ReadStatus.NoDataRead); + return new HidReport(Capabilities.InputReportByteLength, deviceData); + } + + public bool ReadFeatureData(out byte[] data, byte reportId = 0) + { + if (_deviceCapabilities.FeatureReportByteLength <= 0) + { + data = new byte[0]; + return false; + } + + data = new byte[_deviceCapabilities.FeatureReportByteLength]; + + var buffer = CreateFeatureOutputBuffer(); + buffer[0] = reportId; + + IntPtr hidHandle = IntPtr.Zero; + bool success = false; + try + { + if (IsOpen) + { + hidHandle = ReadHandle; + } + else + { + hidHandle = OpenDeviceIO(_devicePath, NativeMethods.ACCESS_NONE); + } + + success = NativeMethods.HidD_GetFeature(hidHandle, buffer, buffer.Length); + + if (success) + { + Array.Copy(buffer, 0, data, 0, Math.Min(data.Length, _deviceCapabilities.FeatureReportByteLength)); + } + } + catch (Exception exception) + { + throw new Exception(string.Format("EonaCat HID: Error accessing HID device '{0}'.", _devicePath), exception); + } + finally + { + if (hidHandle != IntPtr.Zero && hidHandle != ReadHandle) + { + CloseDeviceIO(hidHandle); + } + } + + return success; + } + + public string ReadProduct() + { + if (ReadProduct(out byte[] data)) + { + return System.Text.Encoding.ASCII.GetString(data).Replace("\0", string.Empty); + } + return string.Empty; + } + + public bool ReadProduct(out byte[] data) + { + data = new byte[254]; + IntPtr hidHandle = IntPtr.Zero; + bool success = false; + try + { + if (IsOpen) + { + hidHandle = ReadHandle; + } + else + { + hidHandle = OpenDeviceIO(_devicePath, NativeMethods.ACCESS_NONE); + } + + success = NativeMethods.HidD_GetProductString(hidHandle, data, data.Length); + } + catch (Exception exception) + { + throw new Exception(string.Format("EonaCat HID: Error accessing HID device '{0}'.", _devicePath), exception); + } + finally + { + if (hidHandle != IntPtr.Zero && hidHandle != ReadHandle) + { + CloseDeviceIO(hidHandle); + } + } + + return success; + } + + public string ReadManufacturer() + { + if (ReadManufacturer(out byte[] data)) + { + return System.Text.Encoding.ASCII.GetString(data).Replace("\0", string.Empty); + } + return string.Empty; + } + + public bool ReadManufacturer(out byte[] data) + { + data = new byte[254]; + IntPtr hidHandle = IntPtr.Zero; + bool success = false; + try + { + if (IsOpen) + { + hidHandle = ReadHandle; + } + else + { + hidHandle = OpenDeviceIO(_devicePath, NativeMethods.ACCESS_NONE); + } + + success = NativeMethods.HidD_GetManufacturerString(hidHandle, data, data.Length); + } + catch (Exception exception) + { + throw new Exception(string.Format("EonaCat HID: Error accessing HID device '{0}'.", _devicePath), exception); + } + finally + { + if (hidHandle != IntPtr.Zero && hidHandle != ReadHandle) + { + CloseDeviceIO(hidHandle); + } + } + + return success; + } + + public string ReadSerialNumber() + { + if (ReadSerialNumber(out byte[] data)) + { + return System.Text.Encoding.ASCII.GetString(data).Replace("\0", string.Empty); + } + return string.Empty; + } + + public bool ReadSerialNumber(out byte[] data) + { + data = new byte[254]; + IntPtr hidHandle = IntPtr.Zero; + bool success = false; + try + { + if (IsOpen) + { + hidHandle = ReadHandle; + } + else + { + hidHandle = OpenDeviceIO(_devicePath, NativeMethods.ACCESS_NONE); + } + + success = NativeMethods.HidD_GetSerialNumberString(hidHandle, data, data.Length); + } + catch (Exception exception) + { + throw new Exception(string.Format("EonaCat HID: Error accessing HID device '{0}'.", _devicePath), exception); + } + finally + { + if (hidHandle != IntPtr.Zero && hidHandle != ReadHandle) + { + CloseDeviceIO(hidHandle); + } + } + + return success; + } + + public bool Write(byte[] data) + { + return Write(data, 0); + } + + public bool Write(byte[] data, int timeout) + { + if (IsConnected) + { + if (IsOpen == false) + { + OpenDevice(_deviceReadMode, _deviceWriteMode, _deviceShareMode); + } + + try + { + return WriteData(data, timeout); + } + catch + { + return false; + } + } + return false; + } + + public void Write(byte[] data, WriteCallback callback) + { + Write(data, callback, 0); + } + + public void Write(byte[] data, WriteCallback callback, int timeout) + { + var writeDelegate = new WriteDelegate(Write); + var asyncState = new StateAsync(writeDelegate, callback); + writeDelegate.BeginInvoke(data, timeout, EndWrite, asyncState); + } + + public async Task WriteAsync(byte[] data, int timeout = 0) + { + var writeDelegate = new WriteDelegate(Write); +#if NET20 || NET35 || NET5_0_OR_GREATER + return await Task.Factory.StartNew(() => writeDelegate.Invoke(data, timeout)); +#else + return await Task.Factory.FromAsync(writeDelegate.BeginInvoke, writeDelegate.EndInvoke, data, timeout, null); +#endif + } + + public bool WriteReport(HidReport report) + { + return WriteReport(report, 0); + } + + public bool WriteReport(HidReport report, int timeout) + { + return Write(report.GetBytes(), timeout); + } + + public void WriteReport(HidReport report, WriteCallback callback) + { + WriteReport(report, callback, 0); + } + + public void WriteReport(HidReport report, WriteCallback callback, int timeout) + { + var writeReportDelegate = new WriteReportDelegate(WriteReport); + var asyncState = new StateAsync(writeReportDelegate, callback); + writeReportDelegate.BeginInvoke(report, timeout, EndWriteReport, asyncState); + } + + /// + /// Handle data transfers on the control channel. This method places data on the control channel for devices + /// that do not support the interupt transfers + /// + /// The outbound HID report + /// The result of the tranfer request: true if successful otherwise false + /// + public bool WriteReportSync(HidReport report) + { + + if (null != report) + { + byte[] buffer = report.GetBytes(); + return (NativeMethods.HidD_SetOutputReport(WriteHandle, buffer, buffer.Length)); + } + else + { + throw new ArgumentException("The output report is null, it must be allocated before you call this method", "report"); + } + } + + public async Task WriteReportAsync(HidReport report, int timeout = 0) + { + var writeReportDelegate = new WriteReportDelegate(WriteReport); +#if NET20 || NET35 || NET5_0_OR_GREATER + return await Task.Factory.StartNew(() => writeReportDelegate.Invoke(report, timeout)); +#else + return await Task.Factory.FromAsync(writeReportDelegate.BeginInvoke, writeReportDelegate.EndInvoke, report, timeout, null); +#endif + } + + public HidReport CreateReport() + { + return new HidReport(Capabilities.OutputReportByteLength); + } + + public bool WriteFeatureData(byte[] data) + { + if (_deviceCapabilities.FeatureReportByteLength <= 0) + { + return false; + } + + var buffer = CreateFeatureOutputBuffer(); + + Array.Copy(data, 0, buffer, 0, Math.Min(data.Length, _deviceCapabilities.FeatureReportByteLength)); + + + IntPtr hidHandle = IntPtr.Zero; + bool success = false; + try + { + if (IsOpen) + { + hidHandle = WriteHandle; + } + else + { + hidHandle = OpenDeviceIO(_devicePath, NativeMethods.ACCESS_NONE); + } + + //var overlapped = new NativeOverlapped(); + success = NativeMethods.HidD_SetFeature(hidHandle, buffer, buffer.Length); + } + catch (Exception exception) + { + throw new Exception(string.Format("EonaCat HID: Error accessing HID device '{0}'.", _devicePath), exception); + } + finally + { + if (hidHandle != IntPtr.Zero && hidHandle != WriteHandle) + { + CloseDeviceIO(hidHandle); + } + } + return success; + } + + protected static void EndRead(IAsyncResult ar) + { + var hidAsyncState = (StateAsync)ar.AsyncState; + var callerDelegate = (ReadDelegate)hidAsyncState.CallerDelegate; + var callbackDelegate = (ReadCallback)hidAsyncState.CallbackDelegate; + var data = callerDelegate.EndInvoke(ar); + + if ((callbackDelegate != null)) + { + callbackDelegate.Invoke(data); + } + } + + protected static void EndReadReport(IAsyncResult ar) + { + var hidAsyncState = (StateAsync)ar.AsyncState; + var callerDelegate = (ReadReportDelegate)hidAsyncState.CallerDelegate; + var callbackDelegate = (ReadReportCallback)hidAsyncState.CallbackDelegate; + var report = callerDelegate.EndInvoke(ar); + + if ((callbackDelegate != null)) + { + callbackDelegate.Invoke(report); + } + } + + private static void EndWrite(IAsyncResult ar) + { + var hidAsyncState = (StateAsync)ar.AsyncState; + var callerDelegate = (WriteDelegate)hidAsyncState.CallerDelegate; + var callbackDelegate = (WriteCallback)hidAsyncState.CallbackDelegate; + var result = callerDelegate.EndInvoke(ar); + + if ((callbackDelegate != null)) + { + callbackDelegate.Invoke(result); + } + } + + private static void EndWriteReport(IAsyncResult ar) + { + var hidAsyncState = (StateAsync)ar.AsyncState; + var callerDelegate = (WriteReportDelegate)hidAsyncState.CallerDelegate; + var callbackDelegate = (WriteCallback)hidAsyncState.CallbackDelegate; + var result = callerDelegate.EndInvoke(ar); + + if ((callbackDelegate != null)) + { + callbackDelegate.Invoke(result); + } + } + + private byte[] CreateInputBuffer() + { + return CreateBuffer(Capabilities.InputReportByteLength - 1); + } + + private byte[] CreateOutputBuffer() + { + return CreateBuffer(Capabilities.OutputReportByteLength - 1); + } + + private byte[] CreateFeatureOutputBuffer() + { + return CreateBuffer(Capabilities.FeatureReportByteLength - 1); + } + + private static byte[] CreateBuffer(int length) + { + byte[] buffer = null; + Array.Resize(ref buffer, length + 1); + return buffer; + } + + private static HidDeviceAttributes GetDeviceAttributes(IntPtr hidHandle) + { + var deviceAttributes = default(NativeMethods.HIDD_ATTRIBUTES); + deviceAttributes.Size = Marshal.SizeOf(deviceAttributes); + NativeMethods.HidD_GetAttributes(hidHandle, ref deviceAttributes); + return new HidDeviceAttributes(deviceAttributes); + } + + private static HidDeviceCapabilities GetDeviceCapabilities(IntPtr hidHandle) + { + var capabilities = default(NativeMethods.HIDP_CAPS); + var preparsedDataPointer = default(IntPtr); + + if (NativeMethods.HidD_GetPreparsedData(hidHandle, ref preparsedDataPointer)) + { + NativeMethods.HidP_GetCaps(preparsedDataPointer, ref capabilities); + NativeMethods.HidD_FreePreparsedData(preparsedDataPointer); + } + return new HidDeviceCapabilities(capabilities); + } + + private bool WriteData(byte[] data, int timeout) + { + if (_deviceCapabilities.OutputReportByteLength <= 0) + { + return false; + } + + var buffer = CreateOutputBuffer(); + uint bytesWritten; + + Array.Copy(data, 0, buffer, 0, Math.Min(data.Length, _deviceCapabilities.OutputReportByteLength)); + + if (_deviceWriteMode == DeviceMode.Overlapped) + { + var security = new NativeMethods.SECURITY_ATTRIBUTES(); + var overlapped = new NativeOverlapped(); + + var overlapTimeout = timeout <= 0 ? NativeMethods.WAIT_INFINITE : timeout; + + security.lpSecurityDescriptor = IntPtr.Zero; + security.bInheritHandle = true; + security.nLength = Marshal.SizeOf(security); + + overlapped.OffsetLow = 0; + overlapped.OffsetHigh = 0; + overlapped.EventHandle = NativeMethods.CreateEvent(ref security, Convert.ToInt32(false), Convert.ToInt32(true), ""); + + try + { + NativeMethods.WriteFile(WriteHandle, buffer, (uint)buffer.Length, out bytesWritten, ref overlapped); + } + catch { return false; } + + var result = NativeMethods.WaitForSingleObject(overlapped.EventHandle, overlapTimeout); + + switch (result) + { + case NativeMethods.WAIT_OBJECT_0: + return true; + case NativeMethods.WAIT_TIMEOUT: + return false; + case NativeMethods.WAIT_FAILED: + return false; + default: + return false; + } + } + else + { + try + { + var overlapped = new NativeOverlapped(); + return NativeMethods.WriteFile(WriteHandle, buffer, (uint)buffer.Length, out bytesWritten, ref overlapped); + } + catch { return false; } + } + } + + protected DeviceData ReadData(int timeout) + { + var buffer = new byte[] { }; + var status = DeviceData.ReadStatus.NoDataRead; + IntPtr nonManagedBuffer; + + if (_deviceCapabilities.InputReportByteLength > 0) + { + uint bytesRead; + + buffer = CreateInputBuffer(); + nonManagedBuffer = Marshal.AllocHGlobal(buffer.Length); + + if (_deviceReadMode == DeviceMode.Overlapped) + { + var security = new NativeMethods.SECURITY_ATTRIBUTES(); + var overlapped = new NativeOverlapped(); + var overlapTimeout = timeout <= 0 ? NativeMethods.WAIT_INFINITE : timeout; + + security.lpSecurityDescriptor = IntPtr.Zero; + security.bInheritHandle = true; + security.nLength = Marshal.SizeOf(security); + + overlapped.OffsetLow = 0; + overlapped.OffsetHigh = 0; + overlapped.EventHandle = NativeMethods.CreateEvent(ref security, Convert.ToInt32(false), Convert.ToInt32(true), string.Empty); + + try + { + var success = NativeMethods.ReadFile(ReadHandle, nonManagedBuffer, (uint)buffer.Length, out bytesRead, ref overlapped); + + if (success) + { + status = DeviceData.ReadStatus.Success; // No check here to see if bytesRead > 0 . Perhaps not necessary? + } + else + { + var result = NativeMethods.WaitForSingleObject(overlapped.EventHandle, overlapTimeout); + + switch (result) + { + case NativeMethods.WAIT_OBJECT_0: + status = DeviceData.ReadStatus.Success; + NativeMethods.GetOverlappedResult(ReadHandle, ref overlapped, out bytesRead, false); + break; + case NativeMethods.WAIT_TIMEOUT: + status = DeviceData.ReadStatus.WaitTimedOut; + buffer = new byte[] { }; + break; + case NativeMethods.WAIT_FAILED: + status = DeviceData.ReadStatus.WaitFail; + buffer = new byte[] { }; + break; + default: + status = DeviceData.ReadStatus.NoDataRead; + buffer = new byte[] { }; + break; + } + } + Marshal.Copy(nonManagedBuffer, buffer, 0, (int)bytesRead); + } + catch { status = DeviceData.ReadStatus.ReadError; } + finally { + CloseDeviceIO(overlapped.EventHandle); + Marshal.FreeHGlobal(nonManagedBuffer); + } + } + else + { + try + { + var overlapped = new NativeOverlapped(); + + NativeMethods.ReadFile(ReadHandle, nonManagedBuffer, (uint)buffer.Length, out bytesRead, ref overlapped); + status = DeviceData.ReadStatus.Success; + Marshal.Copy(nonManagedBuffer, buffer, 0, (int)bytesRead); + } + catch { status = DeviceData.ReadStatus.ReadError; } + finally { Marshal.FreeHGlobal(nonManagedBuffer); } + } + } + return new DeviceData(buffer, status); + } + + private static IntPtr OpenDeviceIO(string devicePath, uint deviceAccess) + { + return OpenDeviceIO(devicePath, DeviceMode.NonOverlapped, deviceAccess, ShareMode.ShareRead | ShareMode.ShareWrite); + } + + private static IntPtr OpenDeviceIO(string devicePath, DeviceMode deviceMode, uint deviceAccess, ShareMode shareMode) + { + var security = new NativeMethods.SECURITY_ATTRIBUTES(); + var flags = 0; + + if (deviceMode == DeviceMode.Overlapped) + { + flags = NativeMethods.FILE_FLAG_OVERLAPPED; + } + + security.lpSecurityDescriptor = IntPtr.Zero; + security.bInheritHandle = true; + security.nLength = Marshal.SizeOf(security); + + return NativeMethods.CreateFile(devicePath, deviceAccess, (int)shareMode, ref security, NativeMethods.OPEN_EXISTING, flags, hTemplateFile: IntPtr.Zero); + } + + private static void CloseDeviceIO(IntPtr handle) + { + if (Environment.OSVersion.Version.Major > 5) + { + NativeMethods.CancelIoEx(handle, IntPtr.Zero); + } + NativeMethods.CloseHandle(handle); + } + + private void DeviceEventMonitorInserted() + { + if (!IsOpen) + { + OpenDevice(_deviceReadMode, _deviceWriteMode, _deviceShareMode); + } + + Inserted?.Invoke(); + } + + private void DeviceEventMonitorRemoved() + { + if (IsOpen) + { + CloseDevice(); + } + + Removed?.Invoke(); + } + + public void Dispose() + { + if (MonitorDeviceEvents) + { + MonitorDeviceEvents = false; + } + + if (IsOpen) + { + CloseDevice(); + } + } + } +} diff --git a/EonaCat.HID/DeviceAttributes.cs b/EonaCat.HID/DeviceAttributes.cs new file mode 100644 index 0000000..221afe8 --- /dev/null +++ b/EonaCat.HID/DeviceAttributes.cs @@ -0,0 +1,21 @@ +namespace EonaCat.HID +{ + public class HidDeviceAttributes + { + internal HidDeviceAttributes(NativeMethods.HIDD_ATTRIBUTES attributes) + { + VendorId = attributes.VendorID; + ProductId = attributes.ProductID; + Version = attributes.VersionNumber; + + VendorHexId = "0x" + attributes.VendorID.ToString("X4"); + ProductHexId = "0x" + attributes.ProductID.ToString("X4"); + } + + public int VendorId { get; private set; } + public int ProductId { get; private set; } + public int Version { get; private set; } + public string VendorHexId { get; set; } + public string ProductHexId { get; set; } + } +} diff --git a/EonaCat.HID/DeviceCapabilities.cs b/EonaCat.HID/DeviceCapabilities.cs new file mode 100644 index 0000000..ccc3b74 --- /dev/null +++ b/EonaCat.HID/DeviceCapabilities.cs @@ -0,0 +1,42 @@ +namespace EonaCat.HID +{ + public class HidDeviceCapabilities + { + internal HidDeviceCapabilities(NativeMethods.HIDP_CAPS capabilities) + { + Usage = capabilities.Usage; + UsagePage = capabilities.UsagePage; + InputReportByteLength = capabilities.InputReportByteLength; + OutputReportByteLength = capabilities.OutputReportByteLength; + FeatureReportByteLength = capabilities.FeatureReportByteLength; + Reserved = capabilities.Reserved; + NumberLinkCollectionNodes = capabilities.NumberLinkCollectionNodes; + NumberInputButtonCaps = capabilities.NumberInputButtonCaps; + NumberInputValueCaps = capabilities.NumberInputValueCaps; + NumberInputDataIndices = capabilities.NumberInputDataIndices; + NumberOutputButtonCaps = capabilities.NumberOutputButtonCaps; + NumberOutputValueCaps = capabilities.NumberOutputValueCaps; + NumberOutputDataIndices = capabilities.NumberOutputDataIndices; + NumberFeatureButtonCaps = capabilities.NumberFeatureButtonCaps; + NumberFeatureValueCaps = capabilities.NumberFeatureValueCaps; + NumberFeatureDataIndices = capabilities.NumberFeatureDataIndices; + } + + public short Usage { get; private set; } + public short UsagePage { get; private set; } + public short InputReportByteLength { get; private set; } + public short OutputReportByteLength { get; private set; } + public short FeatureReportByteLength { get; private set; } + public short[] Reserved { get; private set; } + public short NumberLinkCollectionNodes { get; private set; } + public short NumberInputButtonCaps { get; private set; } + public short NumberInputValueCaps { get; private set; } + public short NumberInputDataIndices { get; private set; } + public short NumberOutputButtonCaps { get; private set; } + public short NumberOutputValueCaps { get; private set; } + public short NumberOutputDataIndices { get; private set; } + public short NumberFeatureButtonCaps { get; private set; } + public short NumberFeatureValueCaps { get; private set; } + public short NumberFeatureDataIndices { get; private set; } + } +} diff --git a/EonaCat.HID/DeviceData.cs b/EonaCat.HID/DeviceData.cs new file mode 100644 index 0000000..5144d24 --- /dev/null +++ b/EonaCat.HID/DeviceData.cs @@ -0,0 +1,30 @@ +namespace EonaCat.HID +{ + public class DeviceData + { + public enum ReadStatus + { + Success = 0, + WaitTimedOut = 1, + WaitFail = 2, + NoDataRead = 3, + ReadError = 4, + NotConnected = 5 + } + + public DeviceData(ReadStatus status) + { + Data = new byte[] {}; + Status = status; + } + + public DeviceData(byte[] data, ReadStatus status) + { + Data = data; + Status = status; + } + + public byte[] Data { get; private set; } + public ReadStatus Status { get; private set; } + } +} diff --git a/EonaCat.HID/DeviceEventMonitor.cs b/EonaCat.HID/DeviceEventMonitor.cs new file mode 100644 index 0000000..1ce43fc --- /dev/null +++ b/EonaCat.HID/DeviceEventMonitor.cs @@ -0,0 +1,64 @@ +using System; +using System.Threading; +using System.Threading.Tasks; + +namespace EonaCat.HID +{ + internal class DeviceEventMonitor + { + public event InsertedEventHandler Inserted; + public event RemovedEventHandler Removed; + + public delegate void InsertedEventHandler(); + public delegate void RemovedEventHandler(); + + private readonly Device _device; + private bool _wasConnected; + + public DeviceEventMonitor(Device device) + { + _device = device; + } + + public void Init() + { +#if NET20 || NET35 || NET5_0_OR_GREATER + Task task = Task.Factory.StartNew(() => EventMonitor()); +#else + var eventMonitor = new Action(EventMonitor); + eventMonitor.BeginInvoke(DisposeDeviceEventMonitor, eventMonitor); +#endif + } + + private void EventMonitor() + { + var isConnected = _device.IsConnected; + + if (isConnected != _wasConnected) + { + if (isConnected && Inserted != null) + { + Inserted(); + } + else if (!isConnected && Removed != null) + { + Removed(); + } + + _wasConnected = isConnected; + } + + Thread.Sleep(500); + + if (_device.MonitorDeviceEvents) + { + Init(); + } + } + + private static void DisposeDeviceEventMonitor(IAsyncResult ar) + { + ((Action)ar.AsyncState).EndInvoke(ar); + } + } +} diff --git a/EonaCat.HID/Devices.cs b/EonaCat.HID/Devices.cs new file mode 100644 index 0000000..0548776 --- /dev/null +++ b/EonaCat.HID/Devices.cs @@ -0,0 +1,180 @@ +using System; +using System.Collections.Generic; +using System.Diagnostics; +using System.Linq; +using System.Runtime.InteropServices; + +namespace EonaCat.HID +{ + public class Devices + { + private static Guid _hidClassGuid = Guid.Empty; + + public static bool IsConnected(string devicePath) + { + return EnumerateDevices().Any(x => x.Path == devicePath); + } + + public static Device GetDevice(string devicePath) + { + return Enumerate(devicePath).FirstOrDefault(); + } + + public static IEnumerable Enumerate() + { + return EnumerateDevices().Select(x => new Device(x.Path, x.Description)); + } + + public static IEnumerable Enumerate(string devicePath) + { + return EnumerateDevices().Where(x => x.Path == devicePath).Select(x => new Device(x.Path, x.Description)); + } + + public static IEnumerable Enumerate(int vendorId, params int[] productIds) + { + return EnumerateDevices().Select(x => new Device(x.Path, x.Description)).Where(x => x.Attributes.VendorId == vendorId && + productIds.Contains(x.Attributes.ProductId)); + } + + public static IEnumerable Enumerate(int vendorId, int productId, ushort UsagePage) + { + return EnumerateDevices().Select(x => new Device(x.Path, x.Description)).Where(x => x.Attributes.VendorId == vendorId && + productId == (ushort)x.Attributes.ProductId && (ushort)x.Capabilities.UsagePage == UsagePage); + } + + public static IEnumerable Enumerate(int vendorId) + { + return EnumerateDevices().Select(x => new Device(x.Path, x.Description)).Where(x => x.Attributes.VendorId == vendorId); + } + + public static IEnumerable Enumerate(ushort UsagePage) + { + return EnumerateDevices().Select(x => new Device(x.Path, x.Description)).Where(x => (ushort)x.Capabilities.UsagePage == UsagePage); + } + + internal class DeviceInfo { public string Path { get; set; } public string Description { get; set; } } + + internal static IEnumerable EnumerateDevices() + { + var devices = new List(); + var hidClass = HidClassGuid; + var deviceInfoSet = NativeMethods.SetupDiGetClassDevs(ref hidClass, null, hwndParent: IntPtr.Zero, NativeMethods.DIGCF_PRESENT | NativeMethods.DIGCF_DEVICEINTERFACE); + + if (deviceInfoSet.ToInt64() != NativeMethods.INVALID_HANDLE_VALUE) + { + var deviceInfoData = CreateDeviceInfoData(); + var deviceIndex = 0; + + while (NativeMethods.SetupDiEnumDeviceInfo(deviceInfoSet, deviceIndex, ref deviceInfoData)) + { + deviceIndex += 1; + + var deviceInterfaceData = new NativeMethods.SP_DEVICE_INTERFACE_DATA(); + deviceInterfaceData.cbSize = Marshal.SizeOf(deviceInterfaceData); + var deviceInterfaceIndex = 0; + + while (NativeMethods.SetupDiEnumDeviceInterfaces(deviceInfoSet, ref deviceInfoData, ref hidClass, deviceInterfaceIndex, ref deviceInterfaceData)) + { + deviceInterfaceIndex++; + var devicePath = GetDevicePath(deviceInfoSet, deviceInterfaceData); + var description = GetBusReportedDeviceDescription(deviceInfoSet, ref deviceInfoData) ?? + GetDeviceDescription(deviceInfoSet, ref deviceInfoData); + devices.Add(new DeviceInfo { Path = devicePath, Description = description }); + } + } + NativeMethods.SetupDiDestroyDeviceInfoList(deviceInfoSet); + } + return devices; + } + + private static NativeMethods.SP_DEVINFO_DATA CreateDeviceInfoData() + { + var deviceInfoData = new NativeMethods.SP_DEVINFO_DATA(); + + deviceInfoData.cbSize = Marshal.SizeOf(deviceInfoData); + deviceInfoData.DevInst = 0; + deviceInfoData.ClassGuid = Guid.Empty; + deviceInfoData.Reserved = IntPtr.Zero; + + return deviceInfoData; + } + + private static string GetDevicePath(IntPtr deviceInfoSet, NativeMethods.SP_DEVICE_INTERFACE_DATA deviceInterfaceData) + { + var bufferSize = 0; + var interfaceDetail = new NativeMethods.SP_DEVICE_INTERFACE_DETAIL_DATA { Size = IntPtr.Size == 4 ? 4 + Marshal.SystemDefaultCharSize : 8 }; + + NativeMethods.SetupDiGetDeviceInterfaceDetail(deviceInfoSet, ref deviceInterfaceData, IntPtr.Zero, 0, ref bufferSize, IntPtr.Zero); + + return NativeMethods.SetupDiGetDeviceInterfaceDetail(deviceInfoSet, ref deviceInterfaceData, ref interfaceDetail, bufferSize, ref bufferSize, IntPtr.Zero) ? + interfaceDetail.DevicePath : null; + } + + private static Guid HidClassGuid + { + get + { + if (_hidClassGuid.Equals(Guid.Empty)) + { + NativeMethods.HidD_GetHidGuid(ref _hidClassGuid); + } + + return _hidClassGuid; + } + } + + private static string GetDeviceDescription(IntPtr deviceInfoSet, ref NativeMethods.SP_DEVINFO_DATA devinfoData) + { + unsafe + { + const int charCount = 1024; + var descriptionBuffer = stackalloc char[charCount]; + + var requiredSize = 0; + var type = 0; + + if (NativeMethods.SetupDiGetDeviceRegistryProperty(deviceInfoSet, + ref devinfoData, + NativeMethods.SPDRP_DEVICEDESC, + ref type, + descriptionBuffer, + propertyBufferSize: charCount * sizeof(char), + ref requiredSize)) + { + return new string(descriptionBuffer); + } + + return null; + } + } + + private static string GetBusReportedDeviceDescription(IntPtr deviceInfoSet, ref NativeMethods.SP_DEVINFO_DATA devinfoData) + { + unsafe + { + const int charCount = 1024; + var descriptionBuffer = stackalloc char[charCount]; + + if (Environment.OSVersion.Version.Major > 5) + { + uint propertyType = 0; + var requiredSize = 0; + + if (NativeMethods.SetupDiGetDeviceProperty(deviceInfoSet, + ref devinfoData, + ref NativeMethods.DEVPKEY_Device_BusReportedDeviceDesc, + ref propertyType, + descriptionBuffer, + propertyBufferSize: charCount * sizeof(char), + ref requiredSize, + 0)) + { + return new string(descriptionBuffer); + } + } + + return null; + } + } + } +} diff --git a/EonaCat.HID/Enumerator.cs b/EonaCat.HID/Enumerator.cs new file mode 100644 index 0000000..1c00173 --- /dev/null +++ b/EonaCat.HID/Enumerator.cs @@ -0,0 +1,42 @@ +using System.Collections.Generic; +using System.Linq; + +namespace EonaCat.HID +{ + public class Enumerator : IEnumerator + { + public bool IsConnected(string devicePath) + { + return Devices.IsConnected(devicePath); + } + + public IDevice GetDevice(string devicePath) + { + return Devices.GetDevice(devicePath) as IDevice; + } + + public IEnumerable Enumerate() + { + return Devices.Enumerate(). + Select(d => d as IDevice); + } + + public IEnumerable Enumerate(string devicePath) + { + return Devices.Enumerate(devicePath). + Select(d => d as IDevice); + } + + public IEnumerable Enumerate(int vendorId, params int[] productIds) + { + return Devices.Enumerate(vendorId, productIds). + Select(d => d as IDevice); + } + + public IEnumerable Enumerate(int vendorId) + { + return Devices.Enumerate(vendorId). + Select(d => d as IDevice); + } + } +} diff --git a/EonaCat.HID/EonaCat.HID.csproj b/EonaCat.HID/EonaCat.HID.csproj new file mode 100644 index 0000000..5853fcc --- /dev/null +++ b/EonaCat.HID/EonaCat.HID.csproj @@ -0,0 +1,63 @@ + + + + net20;net35;net40;net45;netstandard2 + true + EonaCat (Jeroen Saey) + Copyright 2024 EonaCat (Jeroen Saey) + + EonaCat.HID + EonaCat.HID + EonaCat (Jeroen Saey) + .NET HID Devices + LICENSE + + icon.png + https://www.nuget.org/packages/EonaCat.HID/ + usb hid; Jeroen;Saey + True + README.md + + + + 1.0.0+{chash:10}.{c:ymd} + true + true + v[0-9]* + true + git + true + true + + + + + + + + + + True + \ + + + True + \ + + + + + + all + runtime; build; native; contentfiles; analyzers; buildtransitive + + + + + + True + \ + + + + diff --git a/EonaCat.HID/IDevice.cs b/EonaCat.HID/IDevice.cs new file mode 100644 index 0000000..dc05a3e --- /dev/null +++ b/EonaCat.HID/IDevice.cs @@ -0,0 +1,94 @@ +using System; +using System.Threading.Tasks; + +namespace EonaCat.HID +{ + public delegate void InsertedEventHandler(); + public delegate void RemovedEventHandler(); + + public enum DeviceMode + { + NonOverlapped = 0, + Overlapped = 1 + } + + [Flags] + public enum ShareMode + { + Exclusive = 0, + ShareRead = NativeMethods.FILE_SHARE_READ, + ShareWrite = NativeMethods.FILE_SHARE_WRITE + } + + public delegate void ReadCallback(DeviceData data); + public delegate void ReadReportCallback(HidReport report); + public delegate void WriteCallback(bool success); + + public interface IDevice : IDisposable + { + event InsertedEventHandler Inserted; + event RemovedEventHandler Removed; + + IntPtr ReadHandle { get; } + IntPtr WriteHandle { get; } + bool IsOpen { get; } + bool IsConnected { get; } + string Description { get; } + HidDeviceCapabilities Capabilities { get; } + HidDeviceAttributes Attributes { get; } + string DevicePath { get; } + + bool MonitorDeviceEvents { get; set; } + + void OpenDevice(); + + void OpenDevice(DeviceMode readMode, DeviceMode writeMode, ShareMode shareMode); + + void CloseDevice(); + + DeviceData Read(); + + void Read(ReadCallback callback, int timeout = 0); + + Task ReadAsync(int timeout = 0); + + DeviceData Read(int timeout); + + void ReadReport(ReadReportCallback callback, int timeout = 0); + + Task ReadReportAsync(int timeout = 0); + + HidReport ReadReport(int timeout = 0); + bool ReadFeatureData(out byte[] data, byte reportId = 0); + + bool ReadProduct(out byte[] data); + + bool ReadManufacturer(out byte[] data); + + bool ReadSerialNumber(out byte[] data); + + void Write(byte[] data, WriteCallback callback); + + bool Write(byte[] data); + + bool Write(byte[] data, int timeout); + + void Write(byte[] data, WriteCallback callback, int timeout); + + Task WriteAsync(byte[] data, int timeout = 0); + + void WriteReport(HidReport report, WriteCallback callback); + + bool WriteReport(HidReport report); + + bool WriteReport(HidReport report, int timeout); + + void WriteReport(HidReport report, WriteCallback callback, int timeout); + + Task WriteReportAsync(HidReport report, int timeout = 0); + + HidReport CreateReport(); + + bool WriteFeatureData(byte[] data); + } +} diff --git a/EonaCat.HID/IEnumerator.cs b/EonaCat.HID/IEnumerator.cs new file mode 100644 index 0000000..cf4c404 --- /dev/null +++ b/EonaCat.HID/IEnumerator.cs @@ -0,0 +1,16 @@ +using System; +using System.Collections.Generic; +using System.Linq; + +namespace EonaCat.HID +{ + public interface IEnumerator + { + bool IsConnected(string devicePath); + IDevice GetDevice(string devicePath); + IEnumerable Enumerate(); + IEnumerable Enumerate(string devicePath); + IEnumerable Enumerate(int vendorId, params int[] productIds); + IEnumerable Enumerate(int vendorId); + } +} diff --git a/EonaCat.HID/NativeMethods.cs b/EonaCat.HID/NativeMethods.cs new file mode 100644 index 0000000..37d46ec --- /dev/null +++ b/EonaCat.HID/NativeMethods.cs @@ -0,0 +1,220 @@ +using System; +using System.Runtime.InteropServices; + +[module: DefaultCharSet(CharSet.Unicode)] + +namespace EonaCat.HID +{ + internal static class NativeMethods + { + internal const int FILE_FLAG_OVERLAPPED = 0x40000000; + internal const short FILE_SHARE_READ = 0x1; + internal const short FILE_SHARE_WRITE = 0x2; + internal const uint GENERIC_READ = 0x80000000; + internal const uint GENERIC_WRITE = 0x40000000; + internal const int ACCESS_NONE = 0; + internal const int INVALID_HANDLE_VALUE = -1; + internal const short OPEN_EXISTING = 3; + internal const int WAIT_TIMEOUT = 0x102; + internal const uint WAIT_OBJECT_0 = 0; + internal const uint WAIT_FAILED = 0xffffffff; + + internal const int WAIT_INFINITE = -1; + + [StructLayout(LayoutKind.Sequential)] + internal struct SECURITY_ATTRIBUTES + { + public int nLength; + public IntPtr lpSecurityDescriptor; + public bool bInheritHandle; + } + + [DllImport("kernel32.dll", SetLastError = true, ExactSpelling = true)] + static internal extern bool CancelIoEx(IntPtr hFile, IntPtr lpOverlapped); + + [DllImport("kernel32.dll", SetLastError = true, ExactSpelling = true)] + static internal extern bool CloseHandle(IntPtr hObject); + + [DllImport("kernel32.dll")] + static internal extern IntPtr CreateEvent(ref SECURITY_ATTRIBUTES securityAttributes, int bManualReset, int bInitialState, string lpName); + + [DllImport("kernel32.dll", SetLastError = true)] + static internal extern IntPtr CreateFile(string lpFileName, uint dwDesiredAccess, int dwShareMode, ref SECURITY_ATTRIBUTES lpSecurityAttributes, int dwCreationDisposition, int dwFlagsAndAttributes, IntPtr hTemplateFile); + + [DllImport("kernel32.dll", SetLastError = true)] + static internal extern bool ReadFile(IntPtr hFile, IntPtr lpBuffer, uint nNumberOfBytesToRead, out uint lpNumberOfBytesRead, [In] ref System.Threading.NativeOverlapped lpOverlapped); + + [DllImport("kernel32.dll")] + static internal extern uint WaitForSingleObject(IntPtr hHandle, int dwMilliseconds); + + [DllImport("kernel32.dll", SetLastError = true)] + static internal extern bool GetOverlappedResult(IntPtr hFile, [In] ref System.Threading.NativeOverlapped lpOverlapped, out uint lpNumberOfBytesTransferred, bool bWait); + + [DllImport("kernel32.dll")] + static internal extern bool WriteFile(IntPtr hFile, byte[] lpBuffer, uint nNumberOfBytesToWrite, out uint lpNumberOfBytesWritten, [In] ref System.Threading.NativeOverlapped lpOverlapped); + + internal const short DIGCF_PRESENT = 0x2; + internal const short DIGCF_DEVICEINTERFACE = 0x10; + internal const int DIGCF_ALLCLASSES = 0x4; + + internal const int SPDRP_ADDRESS = 0x1c; + internal const int SPDRP_BUSNUMBER = 0x15; + internal const int SPDRP_BUSTYPEGUID = 0x13; + internal const int SPDRP_CAPABILITIES = 0xf; + internal const int SPDRP_CHARACTERISTICS = 0x1b; + internal const int SPDRP_CLASS = 7; + internal const int SPDRP_CLASSGUID = 8; + internal const int SPDRP_COMPATIBLEIDS = 2; + internal const int SPDRP_CONFIGFLAGS = 0xa; + internal const int SPDRP_DEVICE_POWER_DATA = 0x1e; + internal const int SPDRP_DEVICEDESC = 0; + internal const int SPDRP_DEVTYPE = 0x19; + internal const int SPDRP_DRIVER = 9; + internal const int SPDRP_ENUMERATOR_NAME = 0x16; + internal const int SPDRP_EXCLUSIVE = 0x1a; + internal const int SPDRP_FRIENDLYNAME = 0xc; + internal const int SPDRP_HARDWAREID = 1; + internal const int SPDRP_LEGACYBUSTYPE = 0x14; + internal const int SPDRP_LOCATION_INFORMATION = 0xd; + internal const int SPDRP_LOWERFILTERS = 0x12; + internal const int SPDRP_MFG = 0xb; + internal const int SPDRP_PHYSICAL_DEVICE_OBJECT_NAME = 0xe; + internal const int SPDRP_REMOVAL_POLICY = 0x1f; + internal const int SPDRP_REMOVAL_POLICY_HW_DEFAULT = 0x20; + internal const int SPDRP_REMOVAL_POLICY_OVERRIDE = 0x21; + internal const int SPDRP_SECURITY = 0x17; + internal const int SPDRP_SECURITY_SDS = 0x18; + internal const int SPDRP_SERVICE = 4; + internal const int SPDRP_UI_NUMBER = 0x10; + internal const int SPDRP_UI_NUMBER_DESC_FORMAT = 0x1d; + + internal const int SPDRP_UPPERFILTERS = 0x11; + + [StructLayout(LayoutKind.Sequential)] + internal struct SP_DEVICE_INTERFACE_DATA + { + internal int cbSize; + internal System.Guid InterfaceClassGuid; + internal int Flags; + internal IntPtr Reserved; + } + + [StructLayout(LayoutKind.Sequential)] + internal struct SP_DEVINFO_DATA + { + internal int cbSize; + internal Guid ClassGuid; + internal int DevInst; + internal IntPtr Reserved; + } + + [StructLayout(LayoutKind.Sequential)] + internal struct SP_DEVICE_INTERFACE_DETAIL_DATA + { + internal int Size; + [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] + internal string DevicePath; + } + + [StructLayout(LayoutKind.Sequential)] + internal struct DEVPROPKEY + { + public Guid fmtid; + public uint pid; + } + + internal static DEVPROPKEY DEVPKEY_Device_BusReportedDeviceDesc = + new DEVPROPKEY { fmtid = new Guid(0x540b947e, 0x8b40, 0x45bc, 0xa8, 0xa2, 0x6a, 0x0b, 0x89, 0x4c, 0xbd, 0xa2), pid = 4 }; + + [DllImport("setupapi.dll")] + public static extern unsafe bool SetupDiGetDeviceRegistryProperty(IntPtr deviceInfoSet, ref SP_DEVINFO_DATA deviceInfoData, int propertyVal, ref int propertyRegDataType, void* propertyBuffer, int propertyBufferSize, ref int requiredSize); + + [DllImport("setupapi.dll", SetLastError = true)] + public static extern unsafe bool SetupDiGetDeviceProperty(IntPtr deviceInfo, ref SP_DEVINFO_DATA deviceInfoData, ref DEVPROPKEY propkey, ref uint propertyDataType, void* propertyBuffer, int propertyBufferSize, ref int requiredSize, uint flags); + + [DllImport("setupapi.dll")] + static internal extern bool SetupDiEnumDeviceInfo(IntPtr deviceInfoSet, int memberIndex, ref SP_DEVINFO_DATA deviceInfoData); + + [DllImport("setupapi.dll")] + static internal extern int SetupDiDestroyDeviceInfoList(IntPtr deviceInfoSet); + + [DllImport("setupapi.dll")] + static internal extern bool SetupDiEnumDeviceInterfaces(IntPtr deviceInfoSet, ref SP_DEVINFO_DATA deviceInfoData, ref Guid interfaceClassGuid, int memberIndex, ref SP_DEVICE_INTERFACE_DATA deviceInterfaceData); + + [DllImport("setupapi.dll")] + static internal extern IntPtr SetupDiGetClassDevs(ref System.Guid classGuid, string enumerator, IntPtr hwndParent, int flags); + + [DllImport("setupapi.dll")] + static internal extern bool SetupDiGetDeviceInterfaceDetail(IntPtr deviceInfoSet, ref SP_DEVICE_INTERFACE_DATA deviceInterfaceData, IntPtr deviceInterfaceDetailData, int deviceInterfaceDetailDataSize, ref int requiredSize, IntPtr deviceInfoData); + + [DllImport("setupapi.dll")] + static internal extern bool SetupDiGetDeviceInterfaceDetail(IntPtr deviceInfoSet, ref SP_DEVICE_INTERFACE_DATA deviceInterfaceData, ref SP_DEVICE_INTERFACE_DETAIL_DATA deviceInterfaceDetailData, int deviceInterfaceDetailDataSize, ref int requiredSize, IntPtr deviceInfoData); + + [StructLayout(LayoutKind.Sequential)] + internal struct HIDD_ATTRIBUTES + { + internal int Size; + internal ushort VendorID; + internal ushort ProductID; + internal short VersionNumber; + } + + [StructLayout(LayoutKind.Sequential)] + internal struct HIDP_CAPS + { + internal short Usage; + internal short UsagePage; + internal short InputReportByteLength; + internal short OutputReportByteLength; + internal short FeatureReportByteLength; + [MarshalAs(UnmanagedType.ByValArray, SizeConst = 17)] + internal short[] Reserved; + internal short NumberLinkCollectionNodes; + internal short NumberInputButtonCaps; + internal short NumberInputValueCaps; + internal short NumberInputDataIndices; + internal short NumberOutputButtonCaps; + internal short NumberOutputValueCaps; + internal short NumberOutputDataIndices; + internal short NumberFeatureButtonCaps; + internal short NumberFeatureValueCaps; + internal short NumberFeatureDataIndices; + } + + [DllImport("hid.dll")] + static internal extern bool HidD_GetAttributes(IntPtr hidDeviceObject, ref HIDD_ATTRIBUTES attributes); + + [DllImport("hid.dll")] + static internal extern bool HidD_GetFeature(IntPtr hidDeviceObject, byte[] lpReportBuffer, int reportBufferLength); + + [DllImport("hid.dll")] + static internal extern bool HidD_GetInputReport(IntPtr hidDeviceObject, byte[] lpReportBuffer, int reportBufferLength); + + [DllImport("hid.dll")] + static internal extern void HidD_GetHidGuid(ref Guid hidGuid); + + [DllImport("hid.dll")] + static internal extern bool HidD_GetPreparsedData(IntPtr hidDeviceObject, ref IntPtr preparsedData); + + [DllImport("hid.dll")] + static internal extern bool HidD_FreePreparsedData(IntPtr preparsedData); + + [DllImport("hid.dll")] + static internal extern bool HidD_SetFeature(IntPtr hidDeviceObject, byte[] lpReportBuffer, int reportBufferLength); + + [DllImport("hid.dll")] + static internal extern bool HidD_SetOutputReport(IntPtr hidDeviceObject, byte[] lpReportBuffer, int reportBufferLength); + + [DllImport("hid.dll")] + static internal extern int HidP_GetCaps(IntPtr preparsedData, ref HIDP_CAPS capabilities); + + [DllImport("hid.dll")] + internal static extern bool HidD_GetProductString(IntPtr hidDeviceObject, byte[] lpReportBuffer, int ReportBufferLength); + + [DllImport("hid.dll")] + internal static extern bool HidD_GetManufacturerString(IntPtr hidDeviceObject, byte[] lpReportBuffer, int ReportBufferLength); + + [DllImport("hid.dll")] + internal static extern bool HidD_GetSerialNumberString(IntPtr hidDeviceObject, byte[] lpReportBuffer, int reportBufferLength); + } +} diff --git a/EonaCat.HID/ReadDevice.cs b/EonaCat.HID/ReadDevice.cs new file mode 100644 index 0000000..ef87930 --- /dev/null +++ b/EonaCat.HID/ReadDevice.cs @@ -0,0 +1,81 @@ +using System.Threading.Tasks; + +namespace EonaCat.HID +{ + public class ReadDevice : Device + { + internal ReadDevice(string devicePath, string description = null) + : base(devicePath, description) { } + + public DeviceData FastRead() + { + return FastRead(0); + } + + public DeviceData FastRead(int timeout) + { + try + { + return ReadData(timeout); + } + catch + { + return new DeviceData(DeviceData.ReadStatus.ReadError); + } + } + + public void FastRead(ReadCallback callback) + { + FastRead(callback, 0); + } + + public void FastRead(ReadCallback callback, int timeout) + { + var readDelegate = new ReadDelegate(FastRead); + var asyncState = new StateAsync(readDelegate, callback); + readDelegate.BeginInvoke(timeout, EndRead, asyncState); + } + + public async Task FastReadAsync(int timeout = 0) + { + var readDelegate = new ReadDelegate(FastRead); +#if NET20 || NET35 || NET5_0_OR_GREATER + return await Task.Factory.StartNew(() => readDelegate.Invoke(timeout)); +#else + return await Task.Factory.FromAsync(readDelegate.BeginInvoke, readDelegate.EndInvoke, timeout, null); +#endif + } + + public HidReport FastReadReport() + { + return FastReadReport(0); + } + + public HidReport FastReadReport(int timeout) + { + return new HidReport(Capabilities.InputReportByteLength, FastRead(timeout)); + } + + public void FastReadReport(ReadReportCallback callback) + { + FastReadReport(callback, 0); + } + + public void FastReadReport(ReadReportCallback callback, int timeout) + { + var readReportDelegate = new ReadReportDelegate(FastReadReport); + var asyncState = new StateAsync(readReportDelegate, callback); + readReportDelegate.BeginInvoke(timeout, EndReadReport, asyncState); + } + + public async Task FastReadReportAsync(int timeout = 0) + { + var readReportDelegate = new ReadReportDelegate(FastReadReport); +#if NET20 || NET35 || NET5_0_OR_GREATER + return await Task.Factory.StartNew(() => readReportDelegate.Invoke(timeout)); +#else + return await Task.Factory.FromAsync(readReportDelegate.BeginInvoke, readReportDelegate.EndInvoke, timeout, null); +#endif + } + } +} diff --git a/EonaCat.HID/ReadEnumerator.cs b/EonaCat.HID/ReadEnumerator.cs new file mode 100644 index 0000000..29532af --- /dev/null +++ b/EonaCat.HID/ReadEnumerator.cs @@ -0,0 +1,44 @@ +using System.Collections.Generic; +using System.Linq; + +namespace EonaCat.HID +{ + public class ReadEnumerator : IEnumerator + { + public bool IsConnected(string devicePath) + { + return Devices.IsConnected(devicePath); + } + + public IDevice GetDevice(string devicePath) + { + return Enumerate(devicePath).FirstOrDefault() as IDevice; + } + + public IEnumerable Enumerate() + { + return Devices.EnumerateDevices(). + Select(d => new ReadDevice(d.Path, d.Description) as IDevice); + } + + public IEnumerable Enumerate(string devicePath) + { + return Devices.EnumerateDevices().Where(x => x.Path == devicePath). + Select(d => new ReadDevice(d.Path, d.Description) as IDevice); + } + + public IEnumerable Enumerate(int vendorId, params int[] productIds) + { + return Devices.EnumerateDevices().Select(d => new ReadDevice(d.Path, d.Description)). + Where(f => f.Attributes.VendorId == vendorId && productIds.Contains(f.Attributes.ProductId)). + Select(d => d as IDevice); + } + + public IEnumerable Enumerate(int vendorId) + { + return Devices.EnumerateDevices().Select(d => new ReadDevice(d.Path, d.Description)). + Where(f => f.Attributes.VendorId == vendorId). + Select(d => d as IDevice); + } + } +} \ No newline at end of file diff --git a/EonaCat.HID/Report.cs b/EonaCat.HID/Report.cs new file mode 100644 index 0000000..623d6bb --- /dev/null +++ b/EonaCat.HID/Report.cs @@ -0,0 +1,85 @@ +using System; + +namespace EonaCat.HID +{ + public class HidReport + { + private byte _reportId; + private byte[] _data = new byte[] {}; + + private readonly DeviceData.ReadStatus _status; + + public HidReport(int reportSize) + { + Array.Resize(ref _data, reportSize - 1); + } + + public HidReport(int reportSize, DeviceData deviceData) + { + _status = deviceData.Status; + + Array.Resize(ref _data, reportSize - 1); + + if ((deviceData.Data != null)) + { + + if (deviceData.Data.Length > 0) + { + _reportId = deviceData.Data[0]; + Exists = true; + + if (deviceData.Data.Length > 1) + { + var dataLength = reportSize - 1; + if (deviceData.Data.Length < reportSize - 1) + { + dataLength = deviceData.Data.Length; + } + + Array.Copy(deviceData.Data, 1, _data, 0, dataLength); + } + } + else + { + Exists = false; + } + } + else + { + Exists = false; + } + } + + public bool Exists { get; private set; } + public DeviceData.ReadStatus ReadStatus { get { return _status; } } + + public byte ReportId + { + get { return _reportId; } + set + { + _reportId = value; + Exists = true; + } + } + + public byte[] Data + { + get { return _data; } + set + { + _data = value; + Exists = true; + } + } + + public byte[] GetBytes() + { + byte[] data = null; + Array.Resize(ref data, _data.Length + 1); + data[0] = _reportId; + Array.Copy(_data, 0, data, 1, _data.Length); + return data; + } + } +} diff --git a/EonaCat.HID/StateAsync.cs b/EonaCat.HID/StateAsync.cs new file mode 100644 index 0000000..806aac5 --- /dev/null +++ b/EonaCat.HID/StateAsync.cs @@ -0,0 +1,17 @@ +namespace EonaCat.HID +{ + public class StateAsync + { + private readonly object _callerDelegate; + private readonly object _callbackDelegate; + + public StateAsync(object callerDelegate, object callbackDelegate) + { + _callerDelegate = callerDelegate; + _callbackDelegate = callbackDelegate; + } + + public object CallerDelegate { get { return _callerDelegate; } } + public object CallbackDelegate { get { return _callbackDelegate; } } + } +} diff --git a/EonaCat.HID/icon.ico b/EonaCat.HID/icon.ico new file mode 100644 index 0000000000000000000000000000000000000000..406f2659ac50172f9307c0af9038f473b50b6598 GIT binary patch literal 254014 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 z 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 IMBDrS02~H<8~^|S literal 0 HcmV?d00001 diff --git a/LICENSE b/LICENSE index 23510b6..ab37379 100644 --- a/LICENSE +++ b/LICENSE @@ -1,73 +1,204 @@ -Apache License -Version 2.0, January 2004 -http://www.apache.org/licenses/ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + https://EonaCat.com/license/ -TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + OF SOFTWARE BY EONACAT (JEROEN SAEY) -1. Definitions. + 1. Definitions. -"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. -"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. -"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. -"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. -"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. -"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. -"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). -"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. -"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." -"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. -2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. -3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. -4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: - (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and - (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and - (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and - (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. - You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. -5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. -6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. -7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. -8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. -9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. -END OF TERMS AND CONDITIONS + END OF TERMS AND CONDITIONS -APPENDIX: How to apply the Apache License to your work. + APPENDIX: How to apply the Apache License to your work. -To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. -Copyright 2024 EonaCat + Copyright [yyyy] [name of copyright owner] -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at -http://www.apache.org/licenses/LICENSE-2.0 + http://www.apache.org/licenses/LICENSE-2.0 -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License. + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License.