Difference between revisions of "Nomenclature Conventions"

From PolWiki
Jump to: navigation, search
(New page: === Conventions followed in the Firmware === The number of pins is numbered starting from 1 whereas the pin numbers are numbered starting from 0. chc: Compton Hall C s1: slave 1 s2: s...)
 
(Conventions followed in the Firmware)
Line 1: Line 1:
 
=== Conventions followed in the Firmware ===
 
=== Conventions followed in the Firmware ===
  
The number of pins is numbered starting from 1 whereas the pin numbers are numbered starting from 0.
+
All physical entities are numbered from 1(not from 0), though in software, all counts start from 0.
  
 
  chc: Compton Hall C
 
  chc: Compton Hall C
  s1: slave 1
+
  s1: slave 1 v1495
  s2: slave 2
+
  s2: slave 2 v1495
  s3: slave 3
+
  s3: slave 3 v1495
   
+
 
patch1: the topmost group of 32 strips in all 4 detector planes
+
The diamond based electron detector setup uses 4 planes of the detector. The detector plane on the upstream side is termed 'plane 1' and the plane counts up, with the last plane termed plane 4.
  patch2: the middle group of 32 strips in all 4 detector planes
+
 
  patch3: the bottommost group of 32 strips in all 4 detector planes
+
Each detector has a total of 96 strips, which are being processed in groups of 32 strips each, termed as the top, middle and bottom groups of 32 strips go to s1, s2 and s3 respectively.
+
 
 +
Among the strips of the detector, the strip which is closest to the main beam is termed 'strip 1' and is counted upwards.
 +
 
 +
In the electron detector Flags file, for setting the appropriate mask values, you would need to know:
 +
  p1t : plane 1, top 32 strips    (going to A-port, slave 1)
 +
p1m : plane 1, middle 32 strips (going to A-port, slave 2)
 +
p1b : plane 1, bottom 32 strips (going to A-port, slave 3)
 +
p2t : plane 2, top 32 strips    (going to B-port, slave 1)
 +
p2m : plane 2, middle 32 strips (going to B-port, slave 2)
 +
p2b : plane 2, bottom 32 strips (going to B-port, slave 3)
 +
p3t : plane 3, top 32 strips    (going to D-port, slave 1)
 +
p3m : plane 3, middle 32 strips (going to D-port, slave 2)
 +
p3b : plane 3, bottom 32 strips (going to D-port, slave 3)
 +
p4t : plane 4, top 32 strips    (going to E-port, slave 1)
 +
  p4m : plane 4, middle 32 strips (going to E-port, slave 2)
 +
p4b : plane 4, bottom 32 strips (going to E-port, slave 3)
 +
   
 +
a value of '1' enables the strip, '0' disables it.
 +
The mask values are set in groups of 32, it can be entered in either hex or integer value (but not binary)
 +
example:
 +
  If strip 1 is to be masked off on plane 1,
 +
  strip 24 is to be masked off on plane 2
 +
  strip 47 is to be masked off on plane 3
 +
  all strips on plane 4 to be left active
 +
  leaving all other strips active on all planes; then we have to put:
 +
----
 +
  p1b = 0xfffffffe, p1m = 0xffffffff, p1t = 0xffffffff
 +
  p2b = 0xfff7ffff, p2m = 0xffffffff, p2t = 0xffffffff
 +
  p3b = 0xffffffff, p3m = 0xffffbfff, p3t = 0xffffffff
 +
----
 
  cluster: a group of 8 strips being ORed together to get a trigger decision.  
 
  cluster: a group of 8 strips being ORed together to get a trigger decision.  
  
 +
The following short-hands have been used very often in parameters/variable names that a User may deal with.
 
  PW: Pulse Width          Rd: read
 
  PW: Pulse Width          Rd: read
 
  TL: Trigger Logic        Wr: Write
 
  TL: Trigger Logic        Wr: Write

Revision as of 14:00, 2 June 2010

Conventions followed in the Firmware

All physical entities are numbered from 1(not from 0), though in software, all counts start from 0.

chc: Compton Hall C
s1: slave 1 v1495
s2: slave 2 v1495
s3: slave 3 v1495

The diamond based electron detector setup uses 4 planes of the detector. The detector plane on the upstream side is termed 'plane 1' and the plane counts up, with the last plane termed plane 4.

Each detector has a total of 96 strips, which are being processed in groups of 32 strips each, termed as the top, middle and bottom groups of 32 strips go to s1, s2 and s3 respectively.

Among the strips of the detector, the strip which is closest to the main beam is termed 'strip 1' and is counted upwards.

In the electron detector Flags file, for setting the appropriate mask values, you would need to know:

p1t : plane 1, top 32 strips    (going to A-port, slave 1)
p1m : plane 1, middle 32 strips (going to A-port, slave 2)
p1b : plane 1, bottom 32 strips (going to A-port, slave 3)
p2t : plane 2, top 32 strips    (going to B-port, slave 1)
p2m : plane 2, middle 32 strips (going to B-port, slave 2)
p2b : plane 2, bottom 32 strips (going to B-port, slave 3)
p3t : plane 3, top 32 strips    (going to D-port, slave 1)
p3m : plane 3, middle 32 strips (going to D-port, slave 2)
p3b : plane 3, bottom 32 strips (going to D-port, slave 3)
p4t : plane 4, top 32 strips    (going to E-port, slave 1)
p4m : plane 4, middle 32 strips (going to E-port, slave 2)
p4b : plane 4, bottom 32 strips (going to E-port, slave 3)
   

a value of '1' enables the strip, '0' disables it. The mask values are set in groups of 32, it can be entered in either hex or integer value (but not binary) example:

 If strip 1 is to be masked off on plane 1, 
 strip 24 is to be masked off on plane 2
 strip 47 is to be masked off on plane 3
 all strips on plane 4 to be left active
 leaving all other strips active on all planes; then we have to put: 

 p1b = 0xfffffffe, p1m = 0xffffffff, p1t = 0xffffffff
 p2b = 0xfff7ffff, p2m = 0xffffffff, p2t = 0xffffffff
 p3b = 0xffffffff, p3m = 0xffffbfff, p3t = 0xffffffff

cluster: a group of 8 strips being ORed together to get a trigger decision. 

The following short-hands have been used very often in parameters/variable names that a User may deal with.

PW: Pulse Width          Rd: read
TL: Trigger Logic        Wr: Write
DL: Delay Line           clk: clock
HO: HoldOff              DIN: Data Input
GE: Good Event           Buf: Buffer
MB: Master Board         Stat: statistics