ubuntu20.04使用plx9054官方驱动 转载

转载地址http://wuhongyi.cn/PKUXIADAQ/en/INSTALL.html

Installation of Software

Installation for this software is requrired by

  • CERN ROOT 6

    • GCC >= 4.8

  • FFTW3

  • OPENSSL

The operating system tested by this program includes CentOS7 / Scientific Linux 7 / CentOS8 / Ubuntu18.04 / Ubuntu20.04

This package uses PLX9054 driver with version 8.23. The operating systems supported by this version of the driver are CentOS 7 / CentOS 8 / Debian 08 / Debian 09 / Debian 10 / Ubuntu 18.04 / Ubuntu 20.04.

危险

Graphical interface programs and non-graphical interface programs cannot run at the same time!

Graphical interface programs and non-graphical interface programs cannot run at the same time!

Graphical interface programs and non-graphical interface programs cannot run at the same time!

The steps for Installation

  • Delete the old version of the PKUXIADAQ folder in your personal directory

  • Extract this package into your personal directory ($HOME)

  • Set up environment variables

  • Compile Plx9054 driver

  • Compile pixie16 driver API (this API has been modified by Hongyi Wu, driven by unofficial standards)

  • Compile graphical acquisition software

  • Compile non-graphical acquisition software

  • Compile online monitor program

  • Compile data converter program

  • Compile event reconstruction program (optional)

## Set up environment variables


# Add the follwing content into .bashrc file
export PLX_SDK_DIR=$HOME/PKUXIADAQ/PlxSdk

# put PKUXIADAQ.tar.gz(or PKUXIADAQ-master.tar.gz) in the personal directory /home, the position ~/

tar -zxvf PKUXIADAQ.tar.gz
or
tar -zxvf PKUXIADAQ-master.tar.gz
mv PKUXIADAQ-master  PKUXIADAQ

# Acquire PKUXIADAQ directory

## Compile Plx9054 driver

# Open a new terminal
cd ~
cd PKUXIADAQ/
#Delete the undeleted driver that may exist. If there is no such directory, you do not need to execute the command.
rm -rf PlxSdk
tar -xvf PlxSdk823.tar
cd PlxSdk/PlxApi/
make clean
make
# If it succeeds,you will see Library "Library/PlxApi.a" built successfully


cd ../Samples/ApiTest/
make clean
make
#if it succeeds,you will see Application "App/ApiTest" built successfully

# If an error is reported, find the corresponding solution according to the operating system
cd ../../Driver/
./builddriver 9054

# If it succeeds,you will see Driver "Plx9054/Plx9054.ko" built sucessfully

## Compile pixie16

cd ~
cd PKUXIADAQ/software/
make clean
make

# As long as no error is reported, the libPixie16App.a libPixie16Sys.a will be generated in the folder

# Modify settings parameters
cd ~
cd PKUXIADAQ/parset/


# Modify cfgPixie16.txt file。
# The value after CrateID indicates the chassis number, and the value is allowed to be 0-15. If there is only a chassis, the parameter is set freely (usually the default 0 is used). If multiple chassis are running synchronously, make sure that the number of each chassis is set to a different value.
# SettingPars Following is the parameter setting file and write the parameter configuration file to be used.
# ModuleSlot The first value number indicates the number of plugins, and if there are 3 plugins, it is 3. The following numbers are for each plug-in in the slot position of the chassis (the slot position is counted from 2), and there are three plugins followed by 2 3 4 respectively.
#AutoRunModeTimes The following values are the time for automatic switching in automatic operation mode.
# Parameter ModuleSampingRate and ModuleBits only take effect in offline mode. When the main interface is initialized in Offline mode, this parameter is read.


# Modify the Run.config file, the first line in the file is the original data storage path, and the second is the file name.
# Modify the RunNumber file, the value in this file is the run number of the actual run.

## Compile graphical acquisition software

cd ~
cd PKUXIADAQ/GUI/
make clean
make

## Compile non-graphical acquisition software

cd ~
cd PKUXIADAQ/NOGUI/
make clean
make

## Compile online monitor program

cd ~
cd PKUXIADAQ/OnlineStattics/

make clean
make

## Compile data converter program

cd ~
cd PKUXIADAQ/DecodeAndSortAll/

# Modify UserDefine.hh according to the instructions in the program.

make clean
make

## Compile event reconstruction program

cd ~
cd PKUXIADAQ/EventBuilder/

# Modify UserDefine.hh according to the instructions in the program.

make clean
make

Instruction for use

  • Restart the computer after booting the chassis (the computer must be open later than the chassis)

  • Load Plx9054 driver under ROOT permission after opening the chassis

  • Normal acquisition

## Load Plx9054 driver under ROOT permission


cd ~
cd PKUXIADAQ/PlxSdk/Bin/

## CENTOS
su # input ROOT password
./Plx_load 9054
## Ubuntu
## The 18th line of the file Plx_load needs to be modified:  export PLX_SDK_DIR=/home/[user name]/PKUXIADAQ/PlxSdk
sudo ./Plx_load 9054

# You Will see a prompt to load successfully
## CENTOS
exit  #Exit ROOT permission

## Start the graphical interface program

cd ~
cd ~/PKUXIADAQ/GUI
./gddaq

# The graphical interface will pop up.
# You can choose Online/Offline Mode then press Boot to initialize.
# After waiting for initialization, you can modify the output data file path, file name, and run number. Press the Complete button to confirm.
# The LSRunStart button becomes operational at this time. You can start pressing Start and then press Stop for the second time.
# Online Statistics option selections mean sending online statistics
# Update Energy Monitor: Each time you select it, the energy spectrum information is read from the plug-in and sent to the online program (frequent select

## Start the non-graphical interface program

cd ~
cd ~/PKUXIADAQ/NOGUI
./gddaq

## Start online monitor program


cd ~
cd PKUXIADAQ/OnlineStattics/
./online

# The graphical interface will pop up.
# Press RunStart to start monitoring and update the input rate and output rate of each channel every 3 seconds. (The first time you enable the program after opening the chassis, you need to enable it after the acquisition is turned on)
# In the lower right corner of the monitoring interface, there is monitoring of the amount of hard disk usage for writing data.



# EnergyMonitor page is used to view the spectrum. Due to the internal register size limitations of the plug-in, this energy spectrum differs from the actual spectrum in channel range.

## execute data converter program


cd ~
cd PKUXIADAQ/DecodeAndSortAll/

# After the last run of acquisition, we can convert the previous run of data to ROOT format file.

./decodeandsort xxx1 [... xxx2 xxx3 ...]
#xxx indicates Run Number in different ceate

Common installation errors

Ubuntu 22.04

Not tested

Ubuntu 20.04

for file Driver/Source.Plx9000/Driver.c

// add the following 3 lines at the begining of file:
#ifndef INCLUDE_VERMAGIC
#define INCLUDE_VERMAGIC
#endif

for file Driver/Source.Plx9000/SuppFunc.c

// Line 956 is modified as follows:
down_read( &current->mm->mmap_lock );

// Line 969 is modified as follows:
up_read( &current->mm->mmap_lock );

// Comment line 402-410
// if (request_mem_region(
//         pdx->PciBar[BarIndex].Properties.Physical,
//         pdx->PciBar[BarIndex].Properties.Size,
//         PLX_DRIVER_NAME
//         ) == NULL)
// {
//     return (-ENOMEM);
// }
// else

Ubuntu 18.04

The soon-to-be launched upgrade

for file Driver/Source.Plx9000/Driver.c

for file Driver/Source.Plx9000/SuppFunc.c

CentOS8

For CentOS 8, the wrong solution for installing PLX9054 driver:

// Modify Include/Plx_sysdep.h line 153
#if (LINUX_VERSION_CODE < KERNEL_VERSION(4,0,0))

CentOS7

For CentOS / scientific Linux 7.6 / 7.7, the wrong solution for installing PLX9054 driver:

./builddriver 9054

Build: Plx9054

- PLA: CentOS Linux release 7.6.1810 (Core)
- KER: 3.10.0-957.12.2.el7.x86_64
- INC: /lib/modules/3.10.0-957.12.2.el7.x86_64/build/include
- CPU: x86_64 (64-bit Little Endian)
- CMP: Gcc
- TYP: Driver
- PLX: 9054
- CFG: Release

make[1]: Entering directory '/usr/src/kernels/3.10.0-957.12.2.el7.x86_64'
arch/x86/Makefile:166: *** CONFIG_RETPOLINE=y, but not supported by the compiler. Compiler update recommended.。 Stop.
make[1]: Leaving directory '/usr/src/kernels/3.10.0-957.12.2.el7.x86_64'
make: *** [BuildDriver] Error 2

The above is the output prompt when the error occurs.

At this point, the user can modify the file /usr/src/kernels/3.10.0-957.12.2.el7.x86_64/arch/x86/Makefile to avoid this error by cancel the following code.

ifneq ($(RETPOLINE_CFLAGS),)
    KBUILD_CFLAGS += $(RETPOLINE_CFLAGS) -DRETPOLINE
else
    $(error CONFIG_RETPOLINE=y, but not supported by the compiler. Compiler update recommended.)
endif

9054 driver loading error

If you use NI PCIe-8381 and the driver cannot be loaded, as shown in the following figure, check whether the dial CLOCK MODE is ON.

_images/pcie8381.jpg

posted @ 2023-07-17 10:50  eastgeneral  阅读(63)  评论(0)  编辑  收藏  举报