update version to handle hidapi 0.14.0

Project.toml

@@ -1,7 +1,7 @@
 name = "HidApi"
 uuid = "39e74766-396e-420b-955c-dcb1d9319e05"
 authors = ["Gerhard Aigner <[email protected]>"]
-version = "1.2.0"
+version = "1.3.0"
 
 [deps]
 hidapi_jll = "fc16ec7e-3cba-5ca4-a17a-1acd8165bbee"

README.md

@@ -6,6 +6,8 @@ This is a high level, cross platform wrapper of the `hidapi` library <https://gi
 Julia. It comes with _batteries included_ and can be used to communicate with HID devices on _Linux, Mac and Windows_.
 
 ### Changelog
+- 1.3.0
+  - Added `hid_get_report_descriptor(...)` call
 - 1.2.0
   - Added doc strings for low level api
   - Updated to use hidapi library version 0.13.1

gen/Project.toml

@@ -0,0 +1,3 @@
+[deps]
+Clang = "40e3b903-d033-50b4-a0cc-940c62c95e31"
+hidapi_jll = "fc16ec7e-3cba-5ca4-a17a-1acd8165bbee"

src/api.jl

@@ -370,6 +370,28 @@ function hid_get_indexed_string(dev, string_index, string, maxlen)
     @ccall hidapi.hid_get_indexed_string(dev::Ptr{hid_device}, string_index::Cint, string::Ptr{Cwchar_t}, maxlen::Csize_t)::Cint
 end
 
+"""
+    hid_get_report_descriptor(dev, buf, buf_size)
+
+Get a report descriptor from a HID device.
+
+Since version 0.14.0, HID_API_VERSION >= HID\\_API\\_MAKE\\_VERSION(0, 14, 0)
+
+User has to provide a preallocated buffer where descriptor will be copied to.	The recommended size for preallocated buffer is HID_API_MAX_REPORT_DESCRIPTOR_SIZE bytes.
+
+` API`
+
+### Parameters
+* `dev`: A device handle returned from hid\\_open().
+* `buf`: The buffer to copy descriptor into.
+* `buf_size`: The size of the buffer in bytes.
+### Returns
+This function returns non-negative number of bytes actually copied, or -1 on error.
+"""
+function hid_get_report_descriptor(dev, buf, buf_size)
+    @ccall hidapi.hid_get_report_descriptor(dev::Ptr{hid_device}, buf::Ptr{Cuchar}, buf_size::Csize_t)::Cint
+end
+
 """
     hid_error(dev)
 

src/common.jl

@@ -1,3 +1,8 @@
+"""
+    hid_api_version
+
+A structure to hold the version numbers.
+"""
 struct hid_api_version
     major::Cint
     minor::Cint