Skip to content

Latest commit

 

History

History
105 lines (64 loc) · 1.92 KB

README.md

File metadata and controls

105 lines (64 loc) · 1.92 KB
Raw

srslib - A library and command line client for SRS FEC & VMM3

Introduction

Why?

  • dependency free
  • simple, pure C (mostly C89)
  • maintainable, 2k lines of code
  • does not assume any specific (linux) environment
  • strict separation between library and application

Included

  • control/monitoring for SRS FEC & VMM3a hybrids
  • readout of data

Not included:

  • calibration routines
  • graphical user interface
  • sophisticated data transport

Building

git clone https://github.com/bl0x/srslib
cd srslib
make

The executable programs are compiled in the build directory:

./build_*/bin/

The shared library object is

./build_*/libsrs.so

srscli - The control program

Configure FEC + attached VMMs

./srscli

Note: srscli assumes that the FEC has an IP address of 10.0.0.2.

Start acquisition

./srscli --acq-on

Stop acquisition

./srscli --acq-off

Common options

-v/--verbose: Increase verbosity, can be given multiple times.
-h/--help:    Show help.

Custom configuration

There is no support (yet) for reading a custom configuration from a config file. Instead, the user needs to modify the fec_custom_config() function in apps/srscli/main.c. Using configuration files is most probably the next feature on the roadmap.

srsread - Reading data from a FEC

srsread is a simple readout loop for SRS/FEC. Use the -o/--output option to store data to an output file.

./srsread -o /tmp/srs_fec_vmm3.dat

Data is stored as is from the FEC in binary format. No modifications are done.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgements

  • A lot of information was used from the existing codebase of the VMM slow control software vmmsc.

Authors:

  • Bastian Löher - Initial work