Configuration

The deviceConfig stores the state of the device in the API and can be updated with getDeviceConfig(). From deviceConfig the parameters can only be read. To set them you need to call loadIniConfig() or setIniConfig(). An other and more pythonesque way to change them is to use the commands defined in the Device directly. This document will give you an overview about the configuration parameters and there corresponding functions or constants, where their values and/or their maximum and minimum are defined.

Note

If you encounter any issues reading a config.ini file enable the config log level in the system.ini. The file location is shown at the firs log entry: ‘loadSettingsIni: e:\path\to\system.ini’.

Parameter Description

Read only parameters

Read only from deviceConfig (can’t set via loadIniConfig() or setIniConfig())

Name	Object / Reference	Description
DeviceType	DeviceType	real Hardware or File Device
FileDevicePath	string	path to the ptu file
ID	string	serial number
Index	int	index number of the device in the list of deviceIDs (only valid after getDeviceIDs())
Model	string	model name
PartNo	string	part number
Version	string	version number
BaseResolution	double	base resolution in ps (timing resolution in T2 mode)
Resolution	double	current resolution (histogram bin width) in ps (not meaningful in T2 mode)
Binning	int	current binning code (multiplier for BaseResolution) - (not meaningful in T2 mode)
NumChans	int	number of input channels (without sync)
NumMods	int	number of installed modules
MeasMode	MeasMode	Histogram, T2, T3
RefSource	RefSource	source of the reference clock

INI Device Section

INI Section: [Device]

Name	Object / Reference	Description
SyncDivider	setSyncDiv()	sync rate divider
SyncTrigMode	setSyncTrigMode()	Edge or CFD trigger
SyncEdgeTrig, SyncTrigLvl , SyncTrigEdge	setSyncEdgeTrig()	sets both parameters at once: trigger level and edge
SyncCFD, SyncDiscrLvl , SyncZeroXLvL	setSyncCFD()	sets both parameters at once: discriminator- and zero cross level
SyncChannelOffset	setSyncChannelOffset()	sync timing offset in ps
SyncChannelEnable	setSyncChannelEnable()	enable state of the sync channel
SyncDeadTime	setSyncDeadTime()	dead-time in ps
HystCode	setInputHysteresis()	input hysteresis
StopCount	setStopOverflow()	stop count for histogram
Binning	setBinning()	binning factor
Offset	setOffset()	histogram time offset in ns
LengthCode, NumBins	setHistoLength()	number of bins
TriggerOutput	setTriggerOutput()	programmable trigger output period in ns
MarkerHoldoffTime	setMarkerHoldoffTime()	marker hold of time to remove glitches in ns
HoldTime	setOflCompression()	low data rates

INI Channel Section

INI Section: [All_Channels] | [Channel_N]

Name	Object / Reference	Description
TrigMode	setInputTrigMode()	Edge or CFD trigger
EdgeTrig, TrigLvl , TrigEdge	setInputEdgeTrig()	sets both values at once: trigger level and edge
CFD, DiscrLvl , ZeroXLvl	setInputCFD()	sets both values at once: discriminator- and zero cross level
ChanOffs	setInputChannelOffset()	input channel offset timing offset in ps
ChanEna	setInputChannelEnable()	enable state of the input channel
DeadTime	setInputDeadTime()	dead-time in ps

Example of the deviceConfig

{
"DeviceType": 0,
"FileDevicePath": "",
"ID": "1045483",
"Index": 0,
"Model": "MultiHarp 150 4P",
"PartNo": "930043",
"Version": "1.0",
"BaseResolution": 5.0,
"Resolution": 5.0,
"BinSteps": 24,
"NumChans": 4,
"NumMods": 2,
"SyncDivider": 1,
"SyncTrigMode": "Edge",
"SyncTrigLvl": -50,
"SyncTrigEdge": 1,
"SyncDiscrLvl": -50,
"SyncZeroXLvL": 0,
"SyncChannelOffset": 0,
"SyncChannelEnable": 1,
"SyncDeadTime": 800,
"HystCode": 0,
"StopCount": 4294967295,
"Binning": 1,
"Offset": 0,
"lengthCode": 6,
"NumBins": 65536,
"MeasControl": 0,
"StartEdge": 1,
"StopEdge": 1,
"TrigOutput": 0,
"HoldoffTime": 0,
"HoldTime": 0,
"MarkerEdges": [
    0,
    0,
    0,
    0
],
"MarkerEna": [
    0,
    0,
    0,
    0
],
"ModsCfg": [
    {
    "Index": 0,
    "ModelCode": 1010,
    "VersionCode": 16843029
    },
    {
    "Index": 1,
    "ModelCode": 1000,
    "VersionCode": 17694997
    }
],
"ChansCfg": [
    {
    "Index": 0,
    "TrigLvl": 100,
    "TrigEdge": 1,
    "DiscrLvl": 100,
    "ZeroXLvl": 0,
    "ChanOffs": 0,
    "ChanEna": 1,
    "DeadTime": 800
    },
    {
    "Index": 1,
    "TrigLvl": -120,
    "TrigEdge": 1,
    "DiscrLvl": -120,
    "ZeroXLvl": 1,
    "ChanOffs": 0,
    "ChanEna": 1,
    "DeadTime": 800
    }
],
"MeasMode": 0,
"RefSource": 0
}

Example of the device ini file

[Device]
HystCode = 0
SyncDiv = 1
SyncEdgeTrig = -50,1
SyncChannelOffset = 0
SyncChannelEnable = 1
SyncDeadTime = 0
StopOverflow = 4294967295
Binning = 1
Offset = 0
MeasControl = 0
StartEdge = 1
StopEdge = 1
TriggerOutput = 0

[All_Channels]
InputEdgeTrig = -50,1
InputChannelOffset = 0
SetInputChannelEnable = 1
InputDeadTime = 0

[Channel_0]
InputEdgeTrig = -10,1
InputChannelOffset = 100

[Channel_1]
InputEdgeTrig = -120,1