/*********************************************************************/
 *
 *      Y O C T O P U C E    L I B R A R Y    f o r    C + +
 *
 * - - - - - - - - - - - License information: - - - - - - - - - - -
 *
 *  Copyright (C) 2011 and beyond by Yoctopuce Sarl, Switzerland.
 *
 *  Yoctopuce Sarl (hereafter Licensor) grants to you a perpetual
 *  non-exclusive license to use, modify, copy and integrate this
 *  library into your software for the sole purpose of interfacing 
 *  with Yoctopuce products. 
 *
 *  You may reproduce and distribute copies of this library in 
 *  source or object form, as long as the sole purpose of this
 *  code is to interface with Yoctopuce products. You must retain 
 *  this notice in the distributed source file.
 *
 *  You should refer to Yoctopuce General Terms and Conditions
 *  for additional information regarding your rights and 
 *  obligations.
 *
 *  THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT
 *  WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
 *  WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY, FITNESS 
 *  FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO
 *  EVENT SHALL LICENSOR BE LIABLE FOR ANY INCIDENTAL, SPECIAL,
 *  INDIRECT OR CONSEQUENTIAL DAMAGES, LOST PROFITS OR LOST DATA, 
 *  COST OF PROCUREMENT OF SUBSTITUTE GOODS, TECHNOLOGY OR 
 *  SERVICES, ANY CLAIMS BY THIRD PARTIES (INCLUDING BUT NOT 
 *  LIMITED TO ANY DEFENSE THEREOF), ANY CLAIMS FOR INDEMNITY OR
 *  CONTRIBUTION, OR OTHER SIMILAR COSTS, WHETHER ASSERTED ON THE
 *  BASIS OF CONTRACT, TORT (INCLUDING NEGLIGENCE), BREACH OF
 *  WARRANTY, OR OTHERWISE.
 *
 *********************************************************************/


Linux Specific Notes :
======================

Libusb 1.0:
----------

In order to compile the library you have to install the version 1.0 of libusb. 
Take care to use version 1.0 and not version 0.1. To install libusb 1.0 on 
Ubuntu, run "sudo apt-get install libusb-1.0-0-dev".


Configure udev access rights:
----------------------------

In order to work properly, the Yoctopuce VirtualHub and library need write
access to all Yoctopuce devices. By default, Linux access rights for USB 
device are read only for all users, except root. If you want to avoid running 
VirtualHub as root, you need to add a new rule to your udev configuration.

To add a new udev rules to your Linux installation, you need to create a text 
file in the directory "/etc/udev/rules.d" following the naming pattern "##-
arbitraryName.rules". Upon startup, udev will process all files in this 
directory with the extension ".rules" according to there alphabetical order. 
For instance, the file "40-first.rules" will be processed before  the file "50-
udev-default.rules". The file "50-udev-default.rules" is actually used to 
implement the default rules of the system. Therefore, to modify the default 
handling behaviour of the system, you have to create a file that start with a 
number lower than 50. Note that to add a rules to your udev configuration you 
have to be root.

In the sub directory udev_conf we have put two examples of rules that you can 
use as reference for your rules.

Example 1: 40-yoctopuce.rules

This rule will add write access to Yoctopuce USB devices for all users. Access 
rights for all other devices will be left unchanged. If this is what you want, 
copy the file "40-yoctopuce_all.rules" to the directory  "/etc/udev/rules.d" 
and restart your system.

	# udev rules to allow write access to all users for Yoctopuce USB devices
	SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE:="0666",  SYSFS{idVendor}=="24e0"

Example 2: 40-yoctopuce_group.rules

This rule will allow write access to Yoctopuce USB devices for all users of 
the group "yoctogoup". Access right for all other devices will be left 
unchanged. If this is what you want, you need to copy the file "40-
yoctopuce_all.rules" to the directory  "/etc/udev/rules.d" and restart your 
system.

	# udev rules to allow write access to all users of "yoctogroup" 
	# for Yoctopuce USB devices
	SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE:="0664",  GROUP="yoctogroup",  SYSFS{idVendor}=="24e0"

