Skip to content

Latest commit

 

History

History
45 lines (36 loc) · 2.59 KB

InstructionsForCasualUsers.md

File metadata and controls

45 lines (36 loc) · 2.59 KB

The intention of this page is to provide a few simple instructions that new or casual users can use to quickly demonstrate the operation of a small DAQ system that uses emulators instead of real electronics.

The steps fall into a few general categories (setup the environment, generate the sample system configuration, and use nanorc to run the sample system), and they draw on more detailed instructions from other repositories, for example, daq-buildtools and nanorc.

Here are the steps that should be used when you first create your local software working area (i.e. <work_dir>):

  1. log into a system that has access to /cvmfs/dunedaq.opensciencegrid.org/
  2. source /cvmfs/dunedaq.opensciencegrid.org/setup_dunedaq.sh
  3. setup_dbt dunedaq-v3.0.0
  4. dbt-create -c dunedaq-v3.0.0 <work_dir>
  5. cd <work_dir>
  6. dbt-workarea-env
  7. download a raw data file, either by running "curl -o frames.bin -O https://cernbox.cern.ch/index.php/s/0XzhExSIMQJUsp0/download" or clicking on the CERNBox link) and put it into <work_dir>
  8. daqconf_multiru_gen -d $PWD/frames.bin -o . -s 10 daq_fake
  9. nanorc daq_fake boot ${USER}-test init conf start 101 wait 60 stop scrap terminate
  10. examine the contents of the HDf5 file with commands like the following:
  • h5dump-shared -H -A swtest_run000101_0000_*.hdf5
  • and
  • hdf5_dump.py -n 3 -p all -f swtest_run000101_0000_*.hdf5

When you return to this work area (for example, after logging out and back in), you can skip the 'setup' steps in the instructions above. For example:

  1. cd <work_dir>
  2. source ./dbt-env.sh
  3. dbt-workarea-env
  4. nanorc daq_fake boot ${USER}-test init conf start 102 wait 60 stop scrap terminate

More detailed explanations on how to create different configurations can be found in Instructions for different configurations for first-time users

If and when you are ready to start looking at existing code and possibly modifying it, you can use steps like the following:

  1. cd <work_dir>
  2. source ./dbt-env.sh
  3. dbt-workarea-env
  4. cd sourcecode
  5. git clone https://github.com/DUNE-DAQ/<package_name>.git -b develop
    • e.g. git clone https://github.com/DUNE-DAQ/dfmodules.git -b develop
    • the full list of available repository is here
  6. cd ..
  7. dbt-build
  8. dbt-workarea-env
  9. continue as described above...