The PEPITA test software
========================

The GUI
-------
.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - File type
     - Function

   * - .ui.qml
     - Description of the GUI: switchs, buttons, sliders...
     
   * - .qml
     - Handle the logic of the GUI with JavaScript

   * - .py
     - Main thread, handles the GUI and call Pyrame
	 
	 
.. caution:: JavaScript uses IEEE-754 double-precision (64 bit) floating points. But due to some restrictions only 32 bits integers are without risk. 
             That's why the JavaScript GUI passes and receives values to/from Python as binary strings.
			 
			 
Changing GUI colors
~~~~~~~~~~~~~~~~~~~

In pepita_gui.py:


``os.environ["QT_QUICK_CONTROLS_STYLE"] = "Material"``
``os.environ["QT_QUICK_CONTROLS_MATERIAL_THEME"] = "Light"``
``os.environ["QT_QUICK_CONTROLS_MATERIAL_ACCENT"] = "Blue"``
	
and in pepita_gui.qml:

``property color textColor:"#1e90ff"``

See

https://doc.qt.io/qt-5/qtquickcontrols2-material.html


MATIS panel
~~~~~~~~~~~

.. figure:: networkPanel.png
    :figwidth: 60%
    :align: center


.. figure:: matisPanel.png
    :figwidth: 40%
    :align: center


.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - Control/Indicator
     - Function

   * - 1. Connect switch
     - 

   * - 2. Power switch
     -  Switch ON the MATIS board, see :doc:`powerOn`

   * - 3. Multiplexer channel switch
     - Set the multiplexer channel (ch 1 = MATIS, ch 2, ASIC)

Registers panel
~~~~~~~~~~~~~~~

Channel panel
~~~~~~~~~~~~~

.. figure:: channel.png
    :figwidth: 90%
    :align: center

.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - Control/Indicator
     - Function

   * - 1. Channel ID
     - Self explanatory

   * - 2. Analog state switch
     - Switch ON or OFF the analog part of the channel

   * - 3. Low threshold selector
     - | Set the threshold value (low value) in Volt 
       | for one of the two comparators. see :doc:`architecture`

   * - 4. High threshold selector
     - | Set the threshold value (high value) in Volt 
       | for one of the two comparators. see :doc:`architecture`

   * - 5. Common selector
     -

Override power
**************

.. figure:: OridePower.png
    :figwidth: 27%
    :align: center

.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - Control/Indicator
     - Function

   * - 1. OFF/ON switch
     - Disable or enable the analog part in every channel

   * - 2. Get Power State button
     - Return the analog part state for every channel

DAC Voltage
***********

.. figure:: DACPanel.png
    :figwidth: 29%
    :align: center

.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - Control/Indicator
     - Function

   * - 1. VDAC Max selector
     - | Set the maximum voltage in V for the main DAC. 
       | Max is 3.3 V. Must be superior to VDAC Min.
       | - and + decrease and incease by 0.1 V.

   * - 2. VDAC Min selector
     - | Set the minimum voltage in V for the main DAC. 
       | Min is 0 V. Must be inferior to VDAC Max.

   * - 3. Threshold step size display
     - Show the voltage step size in mV given by

   * - 4. Common step size display
     - Show the common voltage step size in mV given by

Override Voltage
****************

.. caution:: Global settings

.. figure:: OrideVoltagePanel.png
    :figwidth: 27%
    :align: center

.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - Control/Indicator
     - Function

   * - 1. Low selector
     - Set the low threshold value for all channel comparators 
   * - 2. High selector
     - Set the high threshold value for all channel comparators 
   * - 3. CM (Common) selector
     - Function   

DAQ panel
~~~~~~~~~

.. figure:: daqPanel.png
    :figwidth: 100%
    :align: center

.. list-table:: 
   :widths: 7 7 
   :align: center
   :header-rows: 1

   * - Control/Indicator
     - Function

   * - 1. Reading Mode
     - Set the reading mode, see Readout for more info

   * - 2. Channel selectoion
     - Use with on demande mode
	 
   * - 3. Number of acquisition
     - Loop until the number.
	 
   * - 4. Wait for trigger signal
     - Not used at this time.
	 	 
   * - 5. Number of hitted channels
     - Self explanatory
	 
   * - 6. Hitted channels
     - Self explanatory. If hitted = green light
	 
   * - 7. Test with random data
     - Plot window. WORK IN PROGRESS	 
	  
   * - 8. Save plot
     - Self explanatory
	  
Bench
~~~~~

This part will control the PEPITES test bench. Not implemented.