.. raw:: html

   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=G-8C92JK83ML"></script>
   <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-8C92JK83ML');
   </script>

   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=G-DDB7LGBSKS"></script>
   <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-DDB7LGBSKS');
   </script>

Getting Started
******************

Front panel
===============

.. formating https://knowyourtoolset.com/2018/02/controlling-the-width-of-a-table-with-read-the-docs/

.. figure:: fig/front.png
   :alt: Positive
   :align: center

|
|

.. |DC12V| image:: fig/DC12V.png
.. |SDcard| image:: fig/SDcard.png
.. |leds| image:: fig/leds.png
.. |usb| image:: fig/usb.png
.. |eth| image:: fig/eth.png
.. |usb_serial| image:: fig/usb_serial.png

.. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
   :class: tight-table

   * - Symbol
     - Description
   * - |DC12V|
     -  DC 12 V Power Barrel Connector Jack 2.10mm ID (0.083"), 5.50mm OD (0.217"). Power consumption is max. 15W.
   * - |SDcard|
     - microSD card connector. Firmware and software storage device. 
   * - |leds|
     - LEDs. From the left: Sys, CPU, F2, F1. The state of F2 LED corresponds to  the **LOGIC IN** input state. The state of F1 LED corresponds to analog signal coverage on any channel.
   * - |usb|
     - miniUSB 2.0 compatible with USB gadget mode. Connecting the digitizer via this connector to a computer will create a new network interface on this computer and set up a local network on it. DPP static IP is 192.168.3.1  
   * - |eth|
     - 1GbE RJ45 Ethernet socket. The Ethernet cable should be connected before powering on the device for proper network initialization over DHCP.
   * - |usb_serial|
     - miniUSB 2.0 Linux terminal (115200 8N1) based on the CP2102N. Download USB to UART Bridge VCP Drivers: https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers

Back panel
===============

.. image:: fig/back.png
   :alt: Positive
   :align: center

|
|

.. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
   :class: tight-table

   * - Output
     - Description
   * - **SYNC**
     - MCX, 3.3V CMOS logic external trigger input for synchronization.
   * - **CH0 IN**
     - MCX, Channel 0 analog input.
   * - **CH1 IN**
     - MCX, Channel 1 analog input.
   * - **LOGIC IN**
     - MCX, 3.3V CMOS logic input.
   * - **CH0 HV**
     - SHV, Channel 0 photomultiplier power supply output.
   * - **CH1 HV**
     - SHV, Channel 1 photomultiplier power supply output.
   * - **CHO SiPM & GPIO**
     - IDC16, Channel 0 SiPM power supply and GPIO connector.
   * - **CH1 SiPM & GPIO**
     - IDC16, Channel 0 SiPM power supply and GPIO connector.

.. warning:: Do not disconnect HV cables and SiPM power supply cable during operation!

SiPM & GPIO connector pinout
------------------------------

.. image:: fig/idc.png
   :alt: Positive
   :align: center

|
|

.. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
   :class: tight-table

   * - Pin
     - Description
   * - 1
     - SiPM power supply output.
   * - 3
     - +5 V power supply output.
   * - 5
     - -5 V power supply output.
   * - 7
     - analog temperature sensor input.
   * - 9
     - analog temperature sensor power supply output.
   * - 10
     - 12 V power supply output.
   * - 11
     - GPIO power supply output.
   * - 13
     - GPIO0
   * - 14
     - GPIO1
   * - 15
     - GPIO2
   * - 16
     - GPIO3
   * - 2
     - Ground pin.
   * - 4
     - Ground pin.
   * - 6
     - Ground pin.
   * - 8
     - Ground pin.
   * - 12
     - Ground pin.


DPP communication interfaces
==============================

Nucliflare digitizer is a stand-alone device based on the Linux operating system. Communication with the system is mainly based on the client/server model and network communication.

.. NOTE:: | Default DPP Username and Password:
   | Username: nucliflare
   | Password: nucliflare   


.. _DEBUG_INTERFACE:

Debug interface
-------------------

Connect DPP to the PC using |usb_serial|, check the serial port number, and open any serial terminal software. 

.. image:: fig/com_putty.png
   :alt: Positive
   :align: center

|

.. _USB_GADGET:

USB 2.0 Gadget interface
-------------------------
Connect DPP to the PC using |usb|, local network between DPP and PC will be established. Run Nucliflare DPP software. DPP static IP is 192.168.3.1

Ethernet connection
---------------------
Connect DPP to local network using |eth| connector. Check IP address using :ref:`DEBUG_INTERFACE` or :ref:`USB_GADGET` and ssh connection.

.. NOTE:: The IP address of a device on a local network usually remains constant for the next power cycles.

Running digitizer & quick start
================================

| 1. Connect DPP to local network |eth| 
| 2. Plug in power adapter  |DC12V|
| 3. Check IP address using :ref:`DEBUG_INTERFACE` or :ref:`USB_GADGET` and ssh connection. 
| 5. Run :ref:`DPP_SOFTWARE`.