MCA-3K Data Server (sipm-MDS) Reference

eMorpho

Introduction

USB driver

bpi_device

Data structures

Overview

Module Constants

FPGA Data structures

Controls

Statistics

Results

Histogram

List Mode

Oscilloscope Trace

Summation Weights

Time Slices

Two-bank List Mode

ARM Data structures

Version

Status

Controls

Calibration

API

Overview

MCA-3K Data Structure: fpga_results

Summary

The fpga_results data structure contains FPGA version and telemetry data..

Data structure

For fpga_results there are 16 'register' and a larger number of named 'field' data in use. All register data are 16-bit unsigned int16 (uint16_t).

fpga_results registers and fields
Register number and field nameDescription
RR0: temperature13-bit 2's complement no.; 1LSB = 1/16 K
RR1: dc_offset16-bit DC offset; 1LSB = 1/64 mV
RR2: statusDAQ status register
RR3, RR4: anode_currentuint32_t anode current = RR3 + 65536*RR4
RR5: roi_avguint16_t average energy deposited in ROI (16x average mca bin)
RR6: adc_srADC sampling rate in MHz
RR7[0:7]: versionFPGA firmware version (major)
RR7[8:15]: adc_bitsNumber of ADC bits
RR8: customCustomization number
RR9: buildBuild number
RR10: rr_10Results register 10, uint16_t; LED average if LED is present.
RR11: rr_11Results register 11, uint16_t; Customized content.
RR12: rr_12Results register 12, uint16_t; Customized content.
The 16-bit fpga_results registers; RRn denotes results register number n, with n=0...15 . Registers not listed are zero.

The user dictionary is used to convert fpga_results register contents into physical quantities, and a few status indicators.

fpga_results user dictionary
KeyDescription
temperatureTemperature in degree Celsius as measured by a sensor connected to the FPGA.
dc_offsetDC-offset at the ADC input in Volt; diagnostic use only.
histo_doneHistogram acquisition has completed and is stopped now.
lm_doneList mode acquisition has completed and is stopped now.
trace_doneTrace acquisition has completed and is stopped now.
impedanceSelected transimpedance of the I →V converter.
max_voltMaximum measurable pulse height above baseline.
max_currentMaximum measurable pulse current.
anode_currentAverage SiPM anode current.
adc_srFPGA ADC sampling rate in Hz.
The fpga_results user dictionary.