##################################################################################################################################
WINDOWS Application Installation : 
##################################################################################################################################

----------------------------------------------------------------------------
Preliminary: 
You should have the following setup installed :
    - 2 downloads : 'GTK# for .NET' (lower button) AND MONODEV 64-bits (upper button) available on http://www.mono-project.com/download/#download-win
    - USB DRIVER : 
	- Download https://partphys.unige.ch/~favrey/AFE/FW/fx3/UnigeWin7-Driver.zip and unzip to local dir
	- Plug the board into USB3 port and force windows to point to the driver local dir

	The 1st time you install the FX3 FW for Unige VID/PID, you'll need to tell to windows the driver path :
	- copy locally and unzip 'UnigeDriver.zip'
 	- connect the USB device
	WIN7:
  		- If 'WestBridge' or 'AUG' is not shown in the device manager, uninstall the driver for the FX3 BootLoader Device and Reconnect the device on USB 
		- Update 'WestBridge' driver by selecting the win7 directory on the path where you unzip the 'UnigeDriver.zip'
		- Accept the warning from windows and install driver

	WIN10:
		- If 'WestBridge' or 'AUG' is not shown in the device manager, uninstall the driver for the FX3 BootLoader Device and Reconnect the device on USB 
		- In win10/x64 : Double click on the test_certificate.cer file and click on Install Certificates
		- Click Next
		- Choose Place all certificates in the following store and click Browse
		- Choose Trusted Root Certification Authorities (Autorités de certification racines de confiance) and click OK
		- Click Next and Finish
		- Then again re-click on Install Certificates
		- Click Next
		- Choose Place all certificates in the following store and click Browse
		- Choose Trusted Publishers (Editeurs approuvés) and click OK
		- Click Next and Finish		


----------------------------------------------------------------------------
Installation new application version:
1- Choose zip file for the version you want
2- Unzip it into a local directory

----------------------------------------------------------------------------
How to get back your old settings (last files/directories):

1- In the New version installed directory: 
	Save 'app-settings-defaults.json' AS 'app-settings.json'

2- Upgrade 'app-settings.json' from the file/directory list found in 'app-settings.json' of the old version

NB : 
 - 'app-settings.json' = file used by the application
 - 'app-settings-defaults.json' = best template settings file compatible with the current application (e.g. with new parameters)

##################################################################################################################################



##################################################################################################################################
LINUX Installation : 
##################################################################################################################################

***************************************************************************************
1-PRELIMINARIES : 
***************************************************************************************

First be sure to update your Linux distrib!  
Check version with terminal conmand: 		
	lsb_release -a


----------------------------------------
INSTALL MONODEVELOP (only once on a dedicated machine)
----------------------------------------

https://www.monodevelop.com/download/#fndtn-download-lin

On 16.04
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
sudo apt install apt-transport-https
echo "deb https://download.mono-project.com/repo/ubuntu vs-xenial main" | sudo tee /etc/apt/sources.list.d/mono-official-vs.list
sudo apt-get update
sudo apt update
sudo apt-get install monodevelop

On 18.04 ; 
sudo apt install apt-transport-https dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb https://download.mono-project.com/repo/ubuntu vs-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-vs.list
sudo apt-get update
sudo apt update
sudo apt-get install monodevelop

----------------------------------------
INSTALL USB (only once on a dedicated machine)
----------------------------------------

You'll find the file in :
	https://partphys.unige.ch/~favrey/AFE/SW/Linux/InstallUSB/
	(or lib/UnigeFrontEnd/thirdparty/InstallUSB for SVN developper)


Install libUSB: 
	sudo apt-get install libusb-1.0-0-dev

NB: with centOS, the distro provides both libusb (version 0.1.5, which is actually the new name, but it's stuck at an older version) and 
libusbx (version 1.0, which is the older name, but newer version), a different name than expected.
I think libusbdotnet looks for the 1.0 version, so you just have to install the development package for that:
# yum install libusbx libusbx-devel




As root, create a file called 89-bmfeb.rules in /etc/udev/rules.d/ containing these lines to make sure that the USB device is accessible by a non-privileged user:
	SUBSYSTEMS=="usb", ATTRS{idVendor}=="206b", GROUP="wheel", MODE="0660"
	SUBSYSTEMS=="usb", ATTRS{idVendor}=="04b4", GROUP="wheel", MODE="0660"

(this will work if the user is part of the "wheel" group, which is the default group for administrators in most linux distros. 
You can check by running 'groups' from a terminal. You can modify it with a different group name if needed)

Reboot the machine or run as root 'udevadm control --reload-rules && udevadm trigger' to force the computer to reload the device rules.

To check that the board was connected to a USB3 host, you can run 
	'dmesg | grep xhci' from a terminal. You should see a line in the output similar to:

	[78125.235770] usb 2-2: new SuperSpeed USB device number 12 using xhci_hcd

this means the new USB device is recognized as a SuperSpeed device using the right kernel module.


***************************************************************************************
2- APPLICATION
***************************************************************************************

1- Choose zip file for the version you want
2- Unzip it into a local directory
3- Launch the application with 'sudo mono UnigeFrontEnd.exe'

----------------------------------------------------------------------------
How to get back your old settings (last files/directories):

a- In the New version installed directory: 
	Save 'app-settings-defaults.json' AS 'app-settings.json'

b- Upgrade 'app-settings.json' from the file/directory list found in 'app-settings.json' of the old version

NB : 
 - 'app-settings.json' = file used by the application
 - 'app-settings-defaults.json' = best template settings file compatible with the current application (e.g. with new parameters)