slsDetectorPackage/docs/src/virtualserver.rst

---

Compilation

• Using CMake, turn on the option

  SLS_USE_SIMULATOR=ON

• Using cmk.sh script,

  ./cmk.sh -bsj9 #option s is for simulator

Binaries

eigerDetectorServerMaster_virtual
eigerDetectorServerSlaveTop_virtual
eigerDetectorServerSlaveBottom_virtual
jungfrauDetectorServer_virtual
gotthardDetectorServer_virtual
gotthard2DetectorServer_virtual
mythen3DetectorServer_virtual
moenchDetectorServer_virtual
ctbDetectorServer_virtual

Arguments

The arguments are the same as the normal server arguments<Detector Server Arguments>.

When using multiple modules, use different ports for each virtual server.

# will start control server at port 1912 and stop server at port 1913
jungfrauDetectorServer --port 1912 &

# will start second control server at port 1914 and stop server at port 1915
jungfrauDetectorServer --port 1914 &

Client

# hostname should include the port (if not default)
sls_detector_put hostname localhost:1912+localhost:1914+

# or use virtual command, instead of hostname
# connects to 2 servers at localhost 
# (control servers: 1912, 1914; stop servers: 1913, 1915)
sls_detector_put virtual 2 1912 

Use the same in the config file. Detector API has a method 'isVirtualDetectorServer' to check if on-board detector server is virtual.

Sample Config file

There are sample config files for each detector in slsDetectorPackage/examples folder.

For a Single Module

# connects to control port 1912
hostname localhost:1912+

# connects to receiver at ports 2012
rx_hostname mpc1922:2012+

# sets destination udp ports (not needed, default is 50001)
udp_dstport 50012

# source udp ips must be same subnet at destintaion udp ips
udp_srcip 192.168.1.112

# destination udp ip picked up from rx_hostname (if auto)
udp_dstip auto

# set file path
fpath /tmp

For Multiple Modules

# connects to control ports 1912, 1914 and stop ports 1913, 1915
virtual 2 1912
# or hostname localhost:1912+localhost:1914+

# connects to receivers at ports 2012 and 2014
rx_hostname mpc1922:2012+mpc1922:2013+

# sets differernt destination udp ports
0:udp_dstport 50012
1:udp_dstport 50014

# source udp ips must be same subnet at destintaion udp ips
0:udp_srcip 192.168.1.112
1:udp_srcip 192.168.1.114

# destination udp ip picked up from rx_hostname (if auto)
udp_dstip auto

# set file path
fpath /tmp

Receivers

Same as if you would use an actual detector

For a Single Module

slsReceiver -t2012

For Multiple Modules

# slsMultiReceiver [starting port] [number of receivers] [print each frame header for debugging]
slsMultiReceiver 2012 2 0 

Gui

Same as if you would use an actual detector.
Compile with SLS_USE_GUI=ON in cmake or -g option in cmk.sh script.

slsDetectorGui

Limitations

1. Data coming out of virtual server is fake. Value at each pixel/ channel is incremented by 1.
2. A stop will stop the virtual acquisition only at the start of every new frame.
3. Triggers are counted as number of virtual frames. trigger command to send a software trigger (Mythen3 & Eiger) is not implemented in virtual server.
4. firmware version and serial number will give 0.