Merge branch 'libspnav'

README.md

@@ -9,6 +9,8 @@ Primarily intended for use on Linux (tested on Ubuntu 16.04.6), it does also wor
 
 The plugin includes binary components (cython-hidapi) that are required to access USB devices.
 
+On Linux and MacOS, as an alternative to accessing HID devices, RawMouse can use the libspnav library to access spacemice if that is installed on the system.
+
 ---
 
 ### Limitations
@@ -64,7 +66,8 @@ The configuration file elements are:
 
 **devices** is an array of device definitions, one for each supported device. Each definition is an array whose elements specify the vendor and product USB ids
  for the device, the name of the device profile to use and a description. Optionally, an extra dictionary of additional values can be specified.
- Currently, only *platform*, *usage_page* and *usage* values are recognised and they are used to select a particular HID interface when the device presents multiple interfaces.
+ Currently, only *platform*, *usage_page* and *usage* values are recognised and they are used to select a particular HID interface when the device
+ presents multiple interfaces. This element is not required if libspnav is used to access a spacemouse.
 
 **profiles** is dictionary of profile definitions. Each profile definition defines the axes and buttons the profile knows about.
 
@@ -83,6 +86,8 @@ change the sign.
 **buttons** is a dictionary of button definitions. The element keys are strings that match the button state and the value is a dictionary that specifies *value* and and *target* for the button.
 When a button is activated, the specified target function is passed the value.
 
+**libspnav** on Linux and MacOS, this can be set to the pathname of the libspnav dynamic library. Devices accessed using this library will use the *libspnav* profile.
+
 The Spacemice are configured so that button 1 resets the view (useful when you get lost in space) and button 2 toggles between the Cura prepare and preview screens.
 
 ---
@@ -130,5 +135,7 @@ RawMouse uses [cython-hidapi](https://github.com/trezor/cython-hidapi) to access
 
 1.0.8 - minor tweaks, added Space Mouse Enterprise device.
 
+1.0.9 - added support for libspnav (Linux and MacOS only).
+
 ---