.. INSTALL.rst --- 
.. 
.. Description: 
.. Author: Hongyi Wu(吴鸿毅)
.. Email: wuhongyi@qq.com 
.. Created: 六 2月  3 20:52:33 2024 (+0800)
.. Last-Updated: 二 3月 25 19:35:23 2025 (+0800)
..           By: Hongyi Wu(吴鸿毅)
..     Update #: 33
.. URL: http://wuhongyi.cn 

=================================   
程序安装
=================================   

本程序安装要求依赖 boost、OpenSSL、Qt5、ROOT6 等第三方库。以下版本经过测试。

* OS
    - Ubuntu 20.04/22.04/24.04
    - Fedora 40
    - Rocky 9  
* boost >= 1.67
    - 1.71.0
    - 1.74.0
    - 1.75.0  
    - 1.83.0
* OpenSSL
    - 1.1.1
    - 3.0.2
    - 3.0.7
    - 3.0.13
    - 3.2.2  
* Qt 5
    - 5.12.8
    - 5.15.3
    - 5.15.9  
    - 5.15.13
    - 5.15.17  
* ROOT 6
    - 6.24.08 some bug
    - 6.26.16 
    - 6.30.06 some bug 
    - 6.32.04 some bug

  
**本程序测试过的系统包含 Ubuntu20.04/22.04/24.04、Fedora40、Rocky9。 支持各种 LINUX 操作系统编译。如果您的操作系统编译不通过请联系吴鸿毅。**

.. code-block:: bash

  # Ubuntu20.04 依赖安装
  sudo apt -y install libboost-dev libboost-all-dev libssl-dev openssl qt5-default qtcreator libqt5charts5-dev 
  # Ubuntu22.04 依赖安装
  sudo apt -y install libboost-dev libboost-all-dev libssl-dev openssl libqt5charts5-dev 
  # Ubuntu24.04 依赖安装
  sudo apt -y install libboost-dev libboost-all-dev libssl-dev openssl libqt5charts5-dev 
  # Fedora 40  依赖安装
  sudo dnf -y install redhat-lsb-core boost boost-devel openssl openssl-devel qt5-qtcharts qt5-qtcharts-devel qt5-qtbase qt5-qtbase-devel
  # Rocky 9  依赖安装
  sudo dnf -y install boost boost-devel openssl openssl-devel qt5-qtcharts qt5-qtcharts-devel qt5-qtbase qt5-qtbase-devel
  # ROOT 6 推荐 6.26.16

  
---------------------------------
软件安装步骤
---------------------------------

* 删除个人目录下的老版本PKUCAENDAQ文件夹
* 将本程序包解压缩到个人目录中($HOME)
* 编译安装 driver 文件夹内驱动

.. code-block:: bash

  cd driver
  tar -zxvf CAENDGTZ-USB-Drv-1.3.tgz
  cd 27xx-digitizer-usb-driver/
  sudo ./install.sh

  cd ..
  tar -zxvf caen_felib-v1.3.1.tar.gz 
  cd caen_felib-v1.3.1/
  ./configure --disable-assert
  make
  sudo make install
  sudo ldconfig

  cd ..
  tar -zxvf caen_dig2-v1.7.0.tar.gz   
  cd caen_dig2-v1.7.0/
  ./configure --disable-assert
  make
  sudo make install
  sudo ldconfig


* 编译 GUI 软件

.. code-block:: bash
  
  cd GUI
  chmod +x makefile.sh.x
  ./makefile.sh.x
  # 等待编译结束，编译通过之后，文件夹内将生成可执行文件 gddaq
  # 检查是否生成可执行文件 gddaq, 如有则编译成功。如果没有，请联系吴鸿毅。


		
---------------------------------
LINUX 系统中每个模块使用注册
---------------------------------

由于某些 Linux 发行版无法自动检索数字化仪 USB 名称，因此第一次使用该模块时，需要先进行注册操作。模块注册需要逐个模块进行。即在进行注册操作时，仅能有一个模块通过 USB 连接到 LINUX 系统。

将 USB3.0 线缆 type-C 端连接到模块，另一端连接到电脑。然后在浏览器中输入 CAENDGTZ-USB-{PIDNUMBER}，这里 {PIDNUMBER} 替换为使用的模块的 PID 码，例如：CAENDGTZ-USB-25480 。看是否能访问，如果不能访问，说明还未对该模块进行驱动注册。

在 USB 驱动安装包内，例如 CAENDGTZ-USB-Drv-1.2 里面，有驱动注册脚本文件 regPID.sh，通过以下命令运行。执行之后会看到注册成功的提示。

.. code-block:: bash

  sudo ./regPID.sh
		
之后，再通过网页访问  CAENDGTZ-USB-{PIDNUMBER}，即可看到以下登陆页面，默认用户名、密码均为 admin。

.. image:: /_static/img/usblogin.png

登陆之后界面如下所示，左侧菜单栏中，可以进行网络设置。如果想通过网线进行数据获取，则通过该页面进行 IP 设置。根据实验室网络情况，选择 DHCP 自动分配 IP 或者 Manual 手动配置 IP。进行 IP 设置之后，在浏览器中输入模块的 IP，则也可以访问该设置页面。
	   
.. image:: /_static/img/caendgtz-usb-home.png




	   

	   
.. 
.. INSTALL.rst ends here