------------------------------------------------------------------------------
  CAEN SpA
  Via Vetraia, 11 - 55049 - Viareggio ITALY
  +390594388398 - www.caen.it
------------------------------------------------------------------------------

------------------------------------------------------------------------------

    Janus 5202 README
    
------------------------------------------------------------------------------

TABLE OF CONTENTS
------------------

A.  SYSTEM REQUIREMENTS
B.  INSTALLATION
C.  SUPPORT


A. SYSTEM REQUIREMENTS
-----------------------
   
  - **OS**: 64-bit only. Microsoft Windows 10 or higher, Linux
 
  - **On Windows**:
    - Python 3.8 or higher (for development or debugging purposes)
    - Tkinter
    - Pillow (with Tkinter support)
    - Visual C++ runtime libraries

  - **On Linux**:
    - g++ with C++17 support
	- make
	- libusb-1.0
	- pkg-config
    - gnuplot (with wxt terminal support)
    - Python 3.8 or higher
    - Tkinter
    - Pillow (with Tkinter support)
    - Superuser privileges to run `sudo` for missing packages


B. INSTALLATION
----------------

### Windows:
 1. **Run**:
    - **For GUI mode**:
        cd bin
        Run `JanusPy.exe`
    - **For console mode**:
        cd bin
        Run `JanusC.exe`

### Linux:
 1. **Installation**:
	./Janus_Install.bash
    - The installation wizard provides four options:
	  0. Full installation 				 
	     (Suggested for Debian-based and Fedora, or when all the requirements are already satisfied. 
		 This option may require sudo privileges)
	  1. Check installation requirements 
	     (Checking packages installation is strongly recommended. Automatically installation of missing packages
		 required sudo and is guaranteed only in Debian-based and Fedora distributions)
	  2. Install FERSlib and Janus 		 
	     (Available on all Linux platform)
	  3. Configure USB permission rules  
	     (Available on all Linux platform. This option may require sudo privileges)

 2. **Run**:
    - **For GUI mode**:
        cd gui
        python3 JanusPy.pyw
         
    - **For console mode**:
        cd bin
        ./JanusC


C. SUPPORT   
-----------
        
For technical support, visit https://www.caen.it/mycaen/support/ (login and MyCAEN+ account required)
