Commit bcc7d4b6 authored by Emmanuel Papillon's avatar Emmanuel Papillon
Browse files

* complete beamviewer doc usage + config

parent 3222f0e6
Pipeline #16043 failed with stages
in 2 minutes and 54 seconds
......@@ -13,9 +13,9 @@ beamviewers.
ESRF "Standards" beamviewers (EBV) are composed by:
* a Control Box (ISG made)
* a fixed giga-ethernet basler camera+ lens
* a fixed giga-ethernet basler camera+lens
* powered by the Control box
* an extractable head that can be moved in or out of the beam
* an extractable head that can be moved in or out of the beam (called *screen*)
* pneumatic-mounted mirror+scintillator
* scintillator
* diamond for white beam
......@@ -23,75 +23,73 @@ ESRF "Standards" beamviewers (EBV) are composed by:
* Energy dependent for pink beam
* a diode read by novelec module providing an output in frequency.
* a LED that can be swiched ON and OFF.
* on MX beamlines: a foil to attenuate beam
* optionnaly a foil to attenuate beam (on MX beamlines)
## Usage
Usage of an EBV is described here: [Beamviewer Usage](using_beamviewer.md).
## Control
Control is implemented through the Beamviewer Tango device server.
* EBV is controlled in BLISS via `tango_bpm` class from: `bliss/controllers/tango_bpm.py`
* This control is implemented throughthe *Beamviewer Tango
device server* (see: http://wikiserv.esrf.fr/bliss/index.php/Basler)
Control is implemented using 2 bliss objects:
* **EBV** bliss object controls the wago box (screen, led, foil, diode)
* **LIMA** bliss object controls the basler camera and the associated BPM counters computed on images
## Wagobox modules:
"standard" for 1 BVB:
Two type of wago box exist:
* 750-436: 8-channel digital input; 24VDC, 3.0ms 1-conductor connection; low-side switching
* 750-530: 8-channel digital output; 24 VDC; 0.5 A
* 750-479: 2-channel analog input module (ADC)
* 1-EBV wagobox able to control only one EBV :
- *750-436* : 8-channel digital input; 24VDC
- *750-530* : 8-channel digital output; 24 VDC; 0.5 A
- *750-479* : 2-channel analog input module (ADC)
* 2-EBV wagobox able to control up to 2 EBV:
- *750-436* : 8-channel digital input; 24VDC
- *750-530* : 8-channel digital output; 24 VDC; 0.5 A
- *750-530* : 8-channel digital output; 24 VDC; 0.5 A
- *750-479* : 2-channel analog input module (ADC)
## Configuration
If the EBV has a foil to attenuate beam (MX case), two additionnal wago modules are added:
BVB is controled via a Standard Lima Basler device server with the Beamviewer
plugin: http://wikiserv.esrf.fr/bliss/index.php/Basler
- *750-436* : 8-channel digital input; 24VDC
- *750-504* : 4 Channel Digital Output
beamviewer plugin is installed with bpm-server package:
```
Control
Tango
Server
bpm-server
```
Wago Tango DS configuration:
```
Modbus/iphost: 160.103.XX.YY
Protocol: TCP
TCPTimeout: 1000
Wago/config: 750-436,bv1scr_in,bv1scr_out,bv1sled_on,bv1sgain_enab
750-530,bv1out,bv1in,bv1ledon,bv1ledoff,bv1gain1,bv1gain2,bv1gain3,bv1gain4
750-479,bv1curr
```
## Configuration
Wago Tango DS configuration for 2 BVB:
#### Configuration example
```
Wago/config: 750-436,bv2scr_in,bv2scr_out,bv2sled_on,bv2sgain_enab,bv3scr_in,bv3scr_out,bv3sled_on,bv3sgain_enab
750-530,bv2out,bv2in,bv2ledon,bv2ledoff,bv2gain1,bv2gain2,bv2gain3,bv2gain4
750-530,bv3out,bv3in,bv3ledon,bv3ledoff,bv3gain1,bv3gain2,bv3gain3,bv3gain4
750-479,bv2curr,bv3curr
plugin: bliss (mandatory)
name: mywbv (mandatory)
class: EBV (mandatory)
modbustcp: (mandatory)
url: wcidxxa (mandatory)
single_model: False
has_foil: False
channel: 0
counter_name: mydiode
```
`modbustcp / url` defines the wago control box host as in standard wago controller.
#### Configuration optionnal parameters
* `single_model`
- default value : `False`
- define which model of wago is used : if `single_model` is `True`, the wago box is a 1-EBV model otherwise it is 2-EBV model. Note that some 2-EVB models can be installed even if it controls only one BVB.
* `has_foil`
- default value : `False`
- define if a foil attenuator can be controlled or not
* `channel`
- default value : `0`
- in case of a 2-EBV wago box model, defines which EBV is used : 1st one or 2nd one.
* `counter_name`
- default value : `diode`
- counter name of diode current reading when EBV is used in counts/scans
Beamviewer Tango DS properties:
* wago_ip: 160.103.XX.YY
* wago_index: position of wago controller
* 0: only 1 BPM
* 1: 1st BPM out of two controlled on the same wagobox
* 2: 2nd BPM out of two controlled on the same wagobox
* has_foils: controls the intensity accessory (NB: note the '''s''')
* 0: no foil (default)
* 1: can insert/extract a foil
* acquisition_rate:
* port:
* beam_x:
* beam_y:
* ccd_ip:
......@@ -39,7 +39,7 @@ BLISS [25]: myebv.led_status
### FOIL control
If EBV has no foils, you'll get:
If EBV has no foil, you'll get:
```
BLISS [26]: myebv.foil_status
Out [26]: 'NONE'
......@@ -87,7 +87,7 @@ BLISS [44]: myebv.diode_range
Out [44]: '100uA'
```
You can also access the floating value of gain to convert used to convert reading to **mA**:
You can also access the floating value of gain used to convert reading to **mA**:
```
BLISS [44]: myebv.diode_range
Out [44]: '100uA'
......@@ -120,7 +120,7 @@ Tue Oct 22 18:17:36 2019
diode = -2.44140625e-07 (-2.44140625e-06/s)
```
Default counter is *diode* but can be changed in configuration.
Default counter name is *diode* but can be changed in configuration.
Counter object is accessible though `myebv.diode`.
So either `myebv` or `myebv.diode` can be added to measurement group (ebv hold only one sampling counter).
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment