TRG

Links

• xxx
• https://bitbucket.org/expalpha/trg_firmware - firmware sources on bitbucket

General characteristics

Board schematics

• https://bitbucket.org/expalpha/trg_firmware/src/master/3xFMC_VME_Motherboard.pdf

TRG front panel connections

From top to bottom:

|
| minisas-C - links 8-11
| minisas-D - links 12-15
|
| ethernet sfp - use copper sfp only
| minisas - not used, do not connect
| esata - clock in, trigger out
|
| minisas-A - links 0-3
| minisas-B - links 4-7
|
| LEDs
|

MiniSAS and SATA flail cable connections:

P1 <--> link 3
P2 <--> link 2
P3 <--> link 1
P4 <--> link 0

LEDs:

--PCB-- (left)
LED[0] - trigger out - ag_trig_out
LED[1] - network packet received - sfp_rx_data_valid
LED[2] - Xilinx FPGA boot ok - FMC1_CFG_DONE
LED[3] - not used
(right)

TRG onboard jumpers and switches

• rotary switches: select IP address: 00=192.168.1.50, 11=.51, 22=.52, 33=.53, 44=.54, otherwire=.251

Firmware update procedure

• use quartus to generate the grifc.pof file (use grifc.cof)
• open quartus programmer
• attach grifc.pof to the 1st CFI_512 flash
• mark program/configure for the same flash (3 marks: pof, page_0 and OPTION_BITS
• check that "initiate configuration after programming" is set in tools->options
• say "start"
• should take about 5 minutes
• grifc should reboot into the new firmware

If CFI_512 flash is not visible to the quartus programmer, load correct code into the MaxV CPLD:

• open quartus programmer,
• say "auto detect"
• change file for the 5M2210 device
• use .../boot/maxv_3xfmc_normal.pof from the firmware git repository
• say "program", it should finish in 10-15 seconds
• say "auto detect"
• CFI_512 flash should be visible now.

Firmware revisions

• 0x5bc8f90f - original firmware used for all data

Firmware build

• use quartus 17.1

ALPHA-g trigger functions

Trigger options:

• software trigger
• pulser trigger
• trigger on GRIF16 ADC NIM and ESATA inputs ("external trigger")
• adc16 grand-or
• adc32 grand-or
• adc16 wire multiplicity
• TPC anode wire per-preamp trigger (aw16 section)
  • trigger on coincidences of preamps
  • trigger on multiplicity of preamps
  • trigger on specific topology of preamps (multiplicity of preamp clusters, etc) via the aw16_mlu trigger
• BSC trigger
  • BSC grand_or
  • BSC bar multiplicity
• coincidence trigger - coincidence of external, TPC AW and BSC triggers

software trigger

to programmatically fire the trigger, one should:

• set the conf_enable_sw_trigger bit in conf_trig_enable, this will permit the software trigger to fire the trigger
• write value 0x4 to register 0x2B, this will cause the software trigger to fire

pulser trigger

To use the pulser trigger, one should program:

• pulser period (in clocks)
• pulser width (in clocks, use value 5, the pulser no longer goes outside of the trigger board, so changing the width does not do anything)
• set the run_pulser bit in conf_trig_enable, this will cause the pulser to run
• set the enable_pulser bit in conf_trig_enable, this will cause the pulser to fire the trigger
• set the output_pulser bit in conf_trig_enable, this will cause the pulser to be output from the alphag firmware block (the pulser no longer goes outside of the trigger board, so changing the bit does not do anything)

timeout trigger

The event builder uses event timestamps to assemble physics events. The timestamps are usually 32 bit wide and run at 125 MHz (8 ns) or 62.5 MHz (16 ns). If triggers are generated often (1 per second or more), timestamp wrap around is easily detected by the event builder. If triggers come infrequently, timestamp wrap around may occur while there are no triggers, not be seen by the event builder causing loss of event synchronization.

To avoid this problem in the event builder, a timeout trigger should be generated if no triggers were generated inside a 10 second interval.

The guaranties that even if all physics triggers temporarily stop for any reason, the event builder will stay synchronized. (0.1 Hz timeout trigger frequency).

To enable the timeout trigger:

• program timeout trigger timeout in reg 0x43 in units of 8 ns clock
• enable it in bit 23 of #conf_trig_enable bits

adc16 multiplicity trigger

This trigger is intended for use with the barrel scintillator signals connected to adc16 digitizers. It does not work well with TPC AW signals.

The 16 adc16 trigger bits (16x16=256) are added together to form the hit multiplicity value (adc16_mult, 16 bits, actual range 0 to 256).

Four threshold signals are computed: adc16_mult_1ormore = adc16_mult>=1, 2ormore, 3ormore, 4ormore.

There is a counter for each of these four signals.

Each of these four signals can fire the trigger, see #conf_trig_enable bits.

TPC anode wire triggers

aw16 bus

TPC Anode Wire trigger is based on the aw16[15:0] (xaw16) bus.

Each bit corresponds to one AW preamp. 16 preamps, 16 bits.

The aw16[15:0] bus can be fed by

• adc16_or16[15:0] - or16 of 100 MHz ADCs, 16 ADC sas links
• adc32_or16[15:0] - or16 of 62.5 MHz ADCs, FMC-ADC32 has 32 channels, so 2 bits per ADC: low 16 channels and high 16 channels, sas links 7..0
• adc32_or16[31:16] - or16 of 62.5 MHz ADCs, ditto, sas links 15..8

as selected by conf_enable_aw_adc16, conf_enable_aw_adc32a, conf_enable_aw_adc32b in #conf_control bits

   ///////////////////////////////////////////////////////////
   //           TPC Anode Wire trigger logic (aw16)
   ///////////////////////////////////////////////////////////

   // map adc signals into aw16

   wire [15:0] 		   aw16 = ({16{conf_enable_aw_adc16}} & adc16_or16[15:0]) |
			   ({16{conf_enable_aw_adc32a}} & adc32_or16[15:0]) |
			   ({16{conf_enable_aw_adc32b}} & adc32_or16[31:16]);
   ...
   ag_conditioner cond_adc16_or16_0(.clk(clk), .in(aw16[0]), .out(xxaw16[0]));
   ...
   xaw16 <= xxaw16;

aw16_grand_or

TPC AW "grand or" trigger: use aw16_mult_1ormore

aw16_mult

TPC AW preamp multiplicity trigger: counts how many preamps have hits, fires:

• aw16_mult_1ormore
• aw16_mult_2ormore
• aw16_mult_3ormore
• aw16_mult_4ormore

(256 anode wires, 16 wires per preamp, 16 preamps, 16 aw16 signals)

To enable, set bits conf_enable_aw16_{1,2,3,4}ormore in #conf_trig_enable bits

aw16_coinc

aw16_coinc trigger has 4 identical sections a, b, c and d. each section can trigger on a coincidence of any of the 16 AW preamps in the xaw16[] bus.

Each section is controlled by a 32-bit register conf_aw16_coinc_{a,b,c,d} and has to be enabled byu conf_enable_aw16_coinc_{a,b,c,d} bits in #conf_trig_enable bits

In the 32 bit control register, low 16 bits select the 1st set of preamps, high 16 bits select the 2nd set of preamps, coincidence trigger fires if at least one preamp in the 1st set and one preamp in the 2nd set has a signal.

For example:

• to trigger on the coincidence of preamps 0 and 1, set the control register to 0x00010002.
• to trigger on the coincidence of preamps 0 or 1 and 2 or 3, set the control register to 0x0003000C

   ///////////////////////////////////////////////////////////
   //           TPC Anode Wire (aw16) coincidence
   ///////////////////////////////////////////////////////////

   wire [15:0] conf_aw16_coinc_mask_0 = conf_aw16_coinc_a[15:0];
   wire [15:0] conf_aw16_coinc_mask_1 = conf_aw16_coinc_a[31:16];
   wire [15:0] conf_aw16_coinc_mask_2 = conf_aw16_coinc_b[15:0];
   wire [15:0] conf_aw16_coinc_mask_3 = conf_aw16_coinc_b[31:16];
   wire [15:0] conf_aw16_coinc_mask_4 = conf_aw16_coinc_c[15:0];
   wire [15:0] conf_aw16_coinc_mask_5 = conf_aw16_coinc_c[31:16];
   wire [15:0] conf_aw16_coinc_mask_6 = conf_aw16_coinc_d[15:0];
   wire [15:0] conf_aw16_coinc_mask_7 = conf_aw16_coinc_d[31:16];

   wire cc0 = |(xaw16 & conf_aw16_coinc_mask_0);
   wire cc1 = |(xaw16 & conf_aw16_coinc_mask_1);
   wire cc2 = |(xaw16 & conf_aw16_coinc_mask_2);
   wire cc3 = |(xaw16 & conf_aw16_coinc_mask_3);

   wire cc4 = |(xaw16 & conf_aw16_coinc_mask_4);
   wire cc5 = |(xaw16 & conf_aw16_coinc_mask_5);
   wire cc6 = |(xaw16 & conf_aw16_coinc_mask_6);
   wire cc7 = |(xaw16 & conf_aw16_coinc_mask_7);

   wire	cc_a_wire = cc0 & cc1;
   wire	cc_b_wire = cc2 & cc3;
   wire	cc_c_wire = cc4 & cc5;
   wire	cc_d_wire = cc6 & cc7;

   wire xcc_a;
   wire xcc_b;
   wire xcc_c;
   wire xcc_d;
   
   ag_conditioner cond_cc_a(.clk(clk), .in(cc_a_wire), .out(xcc_a));
   ag_conditioner cond_cc_b(.clk(clk), .in(cc_b_wire), .out(xcc_b));
   ag_conditioner cond_cc_c(.clk(clk), .in(cc_c_wire), .out(xcc_c));
   ag_conditioner cond_cc_d(.clk(clk), .in(cc_d_wire), .out(xcc_d));

   reg 	aw16_coinc_a;
   reg 	aw16_coinc_b;
   reg 	aw16_coinc_c;
   reg 	aw16_coinc_d;

   always_ff @ (posedge clk) begin
      aw16_coinc_a <= xcc_a;
      aw16_coinc_b <= xcc_b;
      aw16_coinc_c <= xcc_c;
      aw16_coinc_d <= xcc_d;
   end
   
   reg 	aw16_coinc_trig;
   
   always_ff@ (posedge clk) begin
      aw16_coinc_trig <= 1'h0 |
			 (aw16_coinc_a & conf_enable_aw16_coinc_a) |
			 (aw16_coinc_b & conf_enable_aw16_coinc_b) |
			 (aw16_coinc_c & conf_enable_aw16_coinc_c) |
			 (aw16_coinc_d & conf_enable_aw16_coinc_d) |
			 1'h0;
   end

aw16_mlu

TPC AW preamp MLU trigger: the MLU (memory lookup table) implements an arbitrary logical function to map the 16 aw16 preamp signals into 1 aw16_mlu_trig trigger output.

Description of the aw16 mlu trigger.

In words:

• any aw16 signal starts the aw16_prompt_run gate
• aw16 signals are collected for the duration of conf_mlu_prompt (125MHz/8ns clock)
• this corresponds to time spread of TPC AW signals due to the drift time in the AW drift cell and to the variation in signal transmission time from the ADC to the TRG (digital trigger data link).
• when this prompt time expires, the MLU looks at the accumulated aw16_prompt bit pattern and makes the "yes/no" trigger decision
• after the trigger decision is made, we wait for the TPC to become quiet, meaning there is no aw16 signals for the duration of the aw16_prompt_wait gate (conf_mlu_wait), if any signals arrive during the gate, they restart the gate.
• after the TPC has been quiet for conf_mlu_wait time (125MHz/8ns clock), the MLU trigger is ready for the next event.

In logic: (see alphag.v)

• aw16_or <= grand-or of 16 aw16 signals
• "aw16_or" starts the "aw16_prompt_cnt" counter, opens the aw16_prompt_run gate
• during the aw16_prompt_run gate, aw16_prompt collects (latches) the aw16 bits (aw16_prompt <= aw16_prompt | aw16)
• this is the time when we wait for all "prompt" signals from the TPC to arrive into the trigger
• at the end of the aw16_prompt_run gate, the signal aw16_prompt_out is pulsed, latching the output of the MLU into aw16_mlu_trig
• this is the MLU trigger "yes/no" trigger decision.
• after the MLU trigger decision is made, we wait for the arrival and passing of all TPC drift signals
• the aw16_prompt_wait_cnt and aw_prompt_wait gate opens
• if any new aw16 signals arrive (they are TPC drift signals at this time), the aw16_prompt_wait gate is restarted
• if no aw16 signals arrive during the full run of the aw16_prompt_wait gate ("TPC quiet time")
• the aw16_prompt_wait and aw16_prompt gates are cleared and the MLU trigger is ready for the next event.

BSC trigger

bsc_adc16 bus

The BSC trigger is based on the [15:0]bsc_adc16[7:0] bus: 16 trigger discriminator bits from 8 ADC sas links. (8*16 = 64+64 bars, top and bottom).

The bsc_adc16 bus can be fed from sas links 0..7 or 8..15, controlled by conf_bsc_adc16_a and conf_bsc_adc16_b bits on #conf_bsc_control bits.

bsc_adc16 can be fed only from GRIF-16 100 MHz ADC trigger discriminators.

bsc64_top and bsc64_bot buses

• firmware 0x5bc8f90f: bsc_adc16 is remapped into 64 bits of top (bsc64_top) and bottom (bsc64_bot):

ag_bsc_remap bsc_remap_a(.adc(bsc_adc16[0]), .bsc_bot(bsc64_bot[7:0]), .bsc_top(bsc64_top[7:0]));
   ag_bsc_remap bsc_remap_b(.adc(bsc_adc16[1]), .bsc_bot(bsc64_bot[8+7:8+0]), .bsc_top(bsc64_top[8+7:8+0]));
   ag_bsc_remap bsc_remap_c(.adc(bsc_adc16[2]), .bsc_bot(bsc64_bot[2*8+7:2*8+0]), .bsc_top(bsc64_top[2*8+7:2*8+0]));
   ag_bsc_remap bsc_remap_d(.adc(bsc_adc16[3]), .bsc_bot(bsc64_bot[3*8+7:3*8+0]), .bsc_top(bsc64_top[3*8+7:3*8+0]));

   ag_bsc_remap bsc_remap_e(.adc(bsc_adc16[4]), .bsc_bot(bsc64_bot[4*8+7:4*8+0]), .bsc_top(bsc64_top[4*8+7:4*8+0]));
   ag_bsc_remap bsc_remap_f(.adc(bsc_adc16[5]), .bsc_bot(bsc64_bot[5*8+7:5*8+0]), .bsc_top(bsc64_top[5*8+7:5*8+0]));
   ag_bsc_remap bsc_remap_g(.adc(bsc_adc16[6]), .bsc_bot(bsc64_bot[6*8+7:6*8+0]), .bsc_top(bsc64_top[6*8+7:6*8+0]));
   ag_bsc_remap bsc_remap_h(.adc(bsc_adc16[7]), .bsc_bot(bsc64_bot[7*8+7:7*8+0]), .bsc_top(bsc64_top[7*8+7:7*8+0]));

module ag_bsc_remap
  (
   input wire [15:0]  adc,
   output wire [7:0]  bsc_bot,
   output wire [7:0]  bsc_top
   );

   assign bsc_top[3] = adc[0];
   assign bsc_top[2] = adc[1];
   assign bsc_top[1] = adc[2];
   assign bsc_top[0] = adc[3];

   assign bsc_top[7] = adc[4];
   assign bsc_top[6] = adc[5];
   assign bsc_top[5] = adc[6];
   assign bsc_top[4] = adc[7];

   assign bsc_bot[0] = adc[8];
   assign bsc_bot[1] = adc[9];
   assign bsc_bot[2] = adc[10];
   assign bsc_bot[3] = adc[11];

   assign bsc_bot[4] = adc[12];
   assign bsc_bot[5] = adc[13];
   assign bsc_bot[6] = adc[14];
   assign bsc_bot[7] = adc[15];

endmodule

bsc64 bus

the bsc64 bus is the 64 bars used by the trigger, formed from bsc64_top and bsc64_bot:

      if (conf_bsc64_bot_only) begin
	 bsc64 <= bsc64_bot;
      end else if (conf_bsc64_top_only) begin
	 bsc64 <= bsc64_top;
      end else if (conf_bsc64_bot_top_or) begin
	 bsc64 <= bsc64_bot | bsc64_top;
      end else if (conf_bsc64_bot_top_and) begin
	 bsc64 <= bsc64_bot & bsc64_top;
      end else begin
	 bsc64 <= 64'b0;
      end

bsc_grand_or_trig

bsc_grand_or_trig is the grand-or of 64 bits of the bsc64 bus

to enable triggering on bsc_grand_or_trig, set corresponding bit in #conf_trig_enable bits

bsc_mult_trig

• bsc64_mult is computed as multiplicity of the bsc64 bus (number of 64 bsc64 bits that fired)
• bsc_mult_trig is computed:

      if (bsc64_mult >= conf_bsc64_mult) begin
	 bsc_mult_trig <= 1;
      end else begin
	 bsc_mult_trig <= 0;
      end

to enable the bsc multiplicity trigger, set the multiplicity value conf_bsc64_mult in #conf_bsc_control bits and enable the corresponding bit in #conf_trig_enable bits.

Coincidence trigger

Coincidence trigger provides a combination of TPC, BSC and external scintillator (esata_nim_grand_or) signals:

   assign coinc_input[0] = aw16_mult_1ormore;
   assign coinc_input[1] = aw16_mlu_trig;
   assign coinc_input[2] = bsc_grand_or_trig;
   assign coinc_input[3] = bsc_mult_trig;
   assign coinc_input[4] = esata_nim_grand_or;
   assign coinc_input[5] = 0;
   assign coinc_input[6] = 0;
   assign coinc_input[7] = 0;

Coincidence trigger "start" mask selects which of the inputs can start the coincidence window.

Coincidence trigger "require" mask selects which inputs must have a hits for the coincidence ot be satisfied.

Input hits are collected for the duration of the coincidence window, if all required inputs have hits, coinc_trig is fired.

Example settings:

• coincidence of external scintillator, BSC and TPC AW "grand or" signals: start 0x10, required 0x15
• coincidence of BSC and TPC AW "grand or" signals: start 0x4, required 0x5
• coincidence of BSC and TPC AW MLU triggers: start 0x4, required 0x6
• coincidence of BSC multiplicity and TPC AW MLU triggers: start 0x8, required 0xA

Control registers

Register addresses

Note: all registers are 32 bits unless otherwise noted.

Note: RW means read-write register, RO means read-only, ROL means read-only, contents is latched by the "latch_out" bit

Address	Quartus Name	Access	FwRev	Description
0x08	num_sample	RW	GRIF-C	magic register to control UDP packet size
0x1F	compilation_time	RO		Firmware revision
0x20	conf_trig_width	RW		Trigger signal width, 16 ns clock
0x21	conf_busy_width	RW		Busy signal width, 16 ns clock (not used)
0x22	conf_pulser_width	RW		Pulser signal width, 16 ns clock
0x23	conf_pulser_period	RW		Pulser signal period, 16 ns clock
0x24				not used
0x25	conf_trig_enable	RW		see #conf_trig_enable bits
0x26			not used
0x27			not used
0x28			not used
0x29	conf_nim_mask	RW		enable bits for ADC NIM inputs, 2 bits per ADC sas link, 16 links
0x2A	conf_esata_mask	RW		enable bits for ADC eSATA inputs, 2 bits per ADC sas link, 16 links
0x2B	reset_out, latch_out, trigger_out	W		see #reg 0x2B bits
0x2C	conf_aw16_coinc_a	RW	0x5bc8f90f	configure AW coincidence trigger, see #aw16_coinc
0x2D	conf_aw16_coinc_b	RW	0x5bc8f90f
0x2E	conf_aw16_coinc_c	RW	0x5bc8f90f
0x2F	conf_aw16_coinc_d	RW	0x5bc8f90f
0x30	sas_sd[15:0]	ROL	0x5b120c9f (01Jun18_20:18)	sas signal detect for each link
0x31	pll_625_status	ROL	0x5b2057f5 (12Jun18_16:32)	62.5MHz PLL status, bits: 31=locked, 30=active clock, 29=esata_clk_bad, 28=clk625_bad, 27:0 not used, to be lock counter
0x32	clk_counter	ROL	0x5b2057f5 (12Jun18_16:32)	frequency counter of the system 125 MHz clock
0x33	clk_625_counter	ROL	0x5b2057f5 (12Jun18_16:32)	frequency counter of the currently selected 62.5 MHz clock (my_clk_625)
0x34	conf_control	RW	0x5b398983 (01Jul18_19:10)	see #conf_control bits below
0x35	conf_drift_width	RW	0x5b398983 (01Jul18_19:10)	width of drift time blank-out in 16 ns clocks
0x36	conf_scaledown	RW	0x5b398983 (01Jul18_19:10)	trigger scaledown, 0=no scaledown, 1=divide-by-2, 2=divide-by-3, etc
0x37	conf_mlu	RW	0x5b398983 (01Jul18_19:10)	AW MLU control bits, see #conf_mlu bits
0x38	conf_trig_delay	RW	0x5baedfca (28Sep18_19:13)	delay the trigger pulse, 16 ns clock
0x39	esata_clk_counter	ROL	0x5baedfca (28Sep18_19:13)	frequency counter of the TRG 125 MHz clock
0x3A	esata_clk_esata_counter	ROL	0x5baedfca (28Sep18_19:13)	frequency counter of the external clock (eSATA 62.5 MHz clock)
0x3B	conf_counter_adc_select	RW	0x5bb7f6ae (05Oct18_16:41)	select which 16 ADCs are connected to the selected adc counters, 0..15 - connect the adc16 signals, 16..47 connect the adc32 signals
0x3C	sysreset_ts	RO	0x5bb7f6ae (05Oct18_16:41)	125MHz counter of VME-SYSRESET
0x3D	GRIF-C csr	RW	GRIF-C	<= csr & ~par_value; // Selective clear
0x3E	GRIF-C csr	RW	GRIF-C	par_value; // Selective set
0x3F	GRIF-C csr	RW	GRIF-C	<= par_value; // write
0x3D			NEXT	not used
0x3E			NEXT	not used
0x3F			NEXT	not used
0x40	conf_bsc_control	RW	0x5bc13541 (12Oct18_16:58)	Barrel Scintillator trigger control, see #conf_bsc_control bits
0x41	conf_coinc_control	RW	0x5bc13541 (12Oct18_16:58)	Coincidence trigger control, see #conf_coinc_control bits
0x42	reconfig_out	WO	0x5bc13541 (12Oct18_16:58)	reserved for rebooting the FPGA (does not work)
0x43	conf_trigger_timeout	RW	0x5bc8f90f (18Oct18_14:20)	Generate timeout trigger if there is no other trigger after given timeout, in 8 ns clocks, must be enabled by bit conf_enable_timeout_trig in #conf_trig_enable bits
0x100	ts_625	ROL		latched timestamp
0x101	counter_trig_out	ROL		counter of issued triggers
0x102	counter_trig_in	ROL		counter of triggers
0x103	counter_pulser	ROL		counter of pulser
0x104	counter_adc16_grand_or	ROL
0x105	counter_adc32_grand_or	ROL
0x106	counter_adc_grand_or	ROL
0x107	counter_esata_nim_grand_or	ROL
0x108	counter_adc16_mult_1ormore	ROL
0x109	counter_adc16_mult_2ormore	ROL
0x10A	counter_adc16_mult_3ormore	ROL
0x10B	counter_adc16_mult_4ormore	ROL
0x10C	counter_aw16_coinc_a	ROL	0x5bc8f90f	counter of AW coincidence triggers
0x10D	counter_aw16_coinc_b	ROL	0x5bc8f90f
0x10E	counter_aw16_coinc_c	ROL	0x5bc8f90f
0x10F	counter_aw16_coinc_d	ROL	0x5bc8f90f
0x110	counter_drift	ROL	0x5b398983 (01Jul18_19:10)	counter of triggers that passed the drift time blank-out
0x111	counter_scaledown	ROL	0x5b398983 (01Jul18_19:10)	counter of triggers that passed the scaledown
0x112	counter_aw16_coinc	ROL	0x5b398983 (01Jul18_19:10)	counter of AW coincidence triggers
0x113	counter_aw16_mlu	ROL	0x5b398983 (01Jul18_19:10)	counter of AW MLU triggers
0x114	counter_aw16_mult_1ormore	ROL	0x5bb7f6ae (05Oct18_16:41)	counter of AW 1ormore triggers
0x115	counter_aw16_mult_2ormore	ROL	0x5bb7f6ae (05Oct18_16:41)	counter of AW 2ormore triggers
0x116	counter_aw16_mult_3ormore	ROL	0x5bb7f6ae (05Oct18_16:41)	counter of AW 3ormore triggers
0x117	counter_aw16_mult_4ormore	ROL	0x5bb7f6ae (05Oct18_16:41)	counter of AW 4ormore triggers
0x118	counter_bsc_grand_or	ROL	0x5bc13541 (12Oct18_16:58)	counter of BSC grand-or triggers
0x119	counter_bsc_mult	ROL	0x5bc13541 (12Oct18_16:58)	counter of BSC multiplicity triggers
0x11A	counter_coinc_mult	ROL	0x5bc13541 (12Oct18_16:58)	counter of coinidence triggers
0x200..0x207	conf_adc16_masks	RW	all	adc16 enable bits
0x300..0x30F	conf_adc32_masks	RW	all	adc32 enable bits
0x400..0x41F	sas_bits[15:0][63:0]	ROL	all	sas data bits for each link
0x420..0x42F	sas_sd_counters[15:0]	ROL	0x5b120c9f (01Jun18_20:18)	sas signal detect counter for each link
0x430..0x43F	counters_adc16_or16[15:0]	ROL	0x5b120c9f (01Jun18_20:18)	16 counters of adc16 ORes
0x440..0x45F	counters_adc32_or16[31:0]	ROL	0x5b120c9f (01Jun18_20:18)	32 counters of adc32 ORes
0x460..0x46F	counters_adc_selected[15:0]	ROL	0x5bb7f6ae (05Oct18_16:41)	16 counters for selected group of adcs, see conf_counter_adc_select
0x470..0x4AF	counters_bsc64[63:0]	ROL	0x5bc13541 (12Oct18_16:58)	64 counters for the BSC bars

conf_control bits

Bit	Quartus Name	FwRev	Description
0	conf_clock_select	0x5b3aa19f (02Jul18_15:05)	select 0=internal 62.5 MHz clock or 1=esata 62.5 MHz clock
1	conf_enable_aw_adc16	0x5baedfca (28Sep18_19:13)	select source of TPC AW aw16 bus, see #aw16 bus
2	conf_enable_aw_adc32a	0x5baedfca (28Sep18_19:13)
3	conf_enable_aw_adc32b	0x5baedfca (28Sep18_19:13)
15..4
23..16	conf_mlu_prompt	0x5b3aa19f (02Jul18_15:05)	MLU trigger prompt window, see #aw16_mlu
31..24	conf_mlu_wait	0x5b3aa19f (02Jul18_15:05)	MLU trigger wait window, see #aw16_mlu

conf_mlu bits

Bit	Quartus Name	FwRev	Description
31	mlu_reset	0x5b3aa19f (02Jul18_15:05)	not used
30	mlu_write	0x5b3aa19f (02Jul18_15:05)	1=write data bit into given address
16	mlu_data	0x5b3aa19f (02Jul18_15:05)	data bit for writing to MLU RAM
15..0	mlu_write_addr	0x5b3aa19f (02Jul18_15:05)	MLU RAM write address for writing the data bit

conf_bsc_control bits

Bit	Quartus Name	FwRev	Description
0	conf_bsc_adc_a	0x5bc13541 (12Oct18_16:58)	enable mapping of BSC ADCs to ADC links 0..7
1	conf_bsc_adc_b	0x5bc13541 (12Oct18_16:58)	enable mapping of BSC ADCs to ADC links 8..15
2	conf_bsc64_bot_only	0x5bc13541 (12Oct18_16:58)	bsc64 uses bottom channels only
3	conf_bsc64_top_only	0x5bc13541 (12Oct18_16:58)	bsc64 uses top channels only
4	conf_bsc64_bot_top_or	0x5bc13541 (12Oct18_16:58)	bsc64 uses "or" of top and bottom
5	conf_bsc64_bot_top_and	0x5bc13541 (12Oct18_16:58)	bsc64 uses "and" of top and bottom
6
7
15..8	conf_bsc64_mult	0x5bc13541 (12Oct18_16:58)	bsc trigger fires if bsc64 multiplicity is equal or more than this value
31..16

conf_coinc_control bits

Bit	Quartus Name	FwRev	Description
0	conf_coinc_required[0]	0x5bc13541 (12Oct18_16:58)	enable aw16_mult_1ormore
1	conf_coinc_required[1]	0x5bc13541 (12Oct18_16:58)	enable aw16_mlu_trig
2	conf_coinc_required[2]	0x5bc13541 (12Oct18_16:58)	enable bsc_grand_or_trig
3	conf_coinc_required[3]	0x5bc13541 (12Oct18_16:58)	enable bsc_mult_trig
4	conf_coinc_required[4]	0x5bc13541 (12Oct18_16:58)	enable esata_nim_grand_or
5
6
7
15..8	conf_coinc_window[7:0]	0x5bc13541 (12Oct18_16:58)	coincidence window length in units of 125MHz clock (8 ns)
23..16	conf_coinc_start[7:0]	0x5bc13541 (12Oct18_16:58)	start the coincidence window, same bits as "required"
31..24

conf_trig_enable bits

Bit	Quartus Name	FwRev	Description
0	conf_enable_sw_trigger		trigger on software trigger (how generated???)
1	conf_enable_pulser		trigger on pulser
2	-	0x5b120c9f (01Jun18_20:18)	not used
3	conf_pulser_run		allow the pulser to run (frequency has to be set beforehand)
4	conf_output_pulser	0x5bc8f90f	does nothing (top level ag_pulser_out is disconnected)
5	conf_enable_esata_nim		trigger on ESATA and NIM grand-or (esata and nim masks should be set beforehand)
6	conf_enable_adc16		trigger on adc16_grand_or
7	conf_enable_adc32		trigger on adc32_grand_or
8	conf_enable_adc16_1ormore		trigger on adc16_mult_1ormore "1 or more"
9	conf_enable_adc16_2ormore		same, "2 or more"
10	conf_enable_adc16_3ormore		same, "3 or more"
11	conf_enable_adc16_4ormore		same, "4 or more"
12	-	0x5b08938c (25May18_15:51)	not used
13	conf_enable_udp	0x5a7a3fbd (06Feb18_15:52)	enable sending UDP packets
14	-	0x5bc8f90f	not used
15	conf_enable_adc	0x5b120c9f (01Jun18_20:18)	trigger on adc_grand_or
16	conf_enable_aw16_coinc_a	0x5bc8f90f	enable AW coincidence trigger, see #aw16_coinc
17	conf_enable_aw16_coinc_b	0x5bc8f90f
18	conf_enable_aw16_coinc_c	0x5bc8f90f
19	conf_enable_aw16_coinc_d	0x5bc8f90f
20	-	0x5b3aa19f (02Jul18_15:05)	not used
21	conf_enable_aw16_coinc	0x5b3aa19f (02Jul18_15:05)	enable trigger on aw16_coinc_trig
22	conf_enable_aw16_mlu	0x5b3aa19f (02Jul18_15:05)	enable AW MLU trigger
23	conf_enable_timeout_trig	0x5bc8f90f (18Oct18_14:20)	enable trigger timeout trigger
24	conf_enable_aw16_1ormore	0x5b3aa19f (02Jul18_15:05)	trigger on aw16_mult_1ormore "1 or more"
25	conf_enable_aw16_2ormore	0x5b3aa19f (02Jul18_15:05)	same, "2 or more"
26	conf_enable_aw16_3ormore	0x5b3aa19f (02Jul18_15:05)	same, "3 or more"
27	conf_enable_aw16_4ormore	0x5b3aa19f (02Jul18_15:05)	same, "4 or more"
28	conf_enable_bsc_grand_or	0x5bc13541 (12Oct18_16:58)	trigger on BSC grand-or
29	conf_enable_bsc_mult	0x5bc13541 (12Oct18_16:58)	trigger on BSC multiplicity
30	conf_enable_coinc	0x5bc13541 (12Oct18_16:58)	trigger on TPC/BSC/ext coincidence trigger
31	-		not used

reg 0x2B bits

Write to this register will pulse corresponding fpga signals:

Bit	Quartus Name	FwRev	Description
0	reset_out	0x5b120c9f (01Jun18_20:18)	reset counters, etc
1	latch_out	0x5b120c9f (01Jun18_20:18)	latch counters, sas bits, etc
2	trigger_out	0x5b120c9f (01Jun18_20:18)	generate a software trigger

UDP data format

Offset	Name	Quartus name	FwRev	Description
0	packet counter	none	all	UDP packet counter, counting from 0, reset by reboot. Automatically added by UDP transmitter code in the GRIFC base firmware
1	0x8 packet header		all	28 bits of counter_trig_out
2	trigger timestamp	trig_ts	all	62.5MHz trigger timestamp
3	accepted triggers	counter_trig_out	all	counter of accepted triggers
4	input triggers	counter_trig_in	all	counter of trigger input
5	pulser triggers	counter_pulser	all	counter of pulser triggers
6	trigger bitmap	udp_trig_bits	0x5a48448d (30Dec17_17:59)	bitmap of trigger information, see below
7	nim bits	udp_nim_bits_masked	???	32 bits of ADC NIM inputs (2 bits per ADC)
8	esata bits	udp_esata_bits_masked	???	32 bits of ADC ESATA inputs (2 bits per ADC)
9	mlu bits	aw16_prompt	0x5b398983 (01Jul18_19:10)	16 bits of MLU input, 1 bit per preamp
10	drift-blank-off counter	udp_drift_counter	0x5b3aa19f (02Jul18_15:05)	counter of triggers that passed the drift blank-off
11	scaledown counter	udp_scaledown_counter	0x5b3aa19f (02Jul18_15:05)	counter of triggers that passed the scaledown
X
12	0x9 packet footer		all	28 bits of counter_trig_out

trigger bitmap

              udp_trig_bits[0] <= adc16_grand_or;
              udp_trig_bits[1] <= adc32_grand_or;
              udp_trig_bits[2] <= adc_grand_or;
              udp_trig_bits[3] <= esata_nim_grand_or;
              udp_trig_bits[4] <= adc16_coinc_top;
              udp_trig_bits[5] <= adc16_coinc_bot;
              udp_trig_bits[6] <= adc16_coinc;
              udp_trig_bits[7] <= 0;
              udp_trig_bits[23:8] <= adc16_coinc_dff[15:0];
              udp_trig_bits[31:24] <= mult16[7:0];

Firmware 0x5b08938c (25May18_15:51)

              udp_trig_bits[0] <= adc16_grand_or;
              udp_trig_bits[1] <= adc32_grand_or;
              udp_trig_bits[2] <= adc_grand_or;
              udp_trig_bits[3] <= esata_nim_grand_or;
              udp_trig_bits[4] <= 0; // not used
              udp_trig_bits[5] <= 0; // not used
              udp_trig_bits[6] <= 0; // not used
              udp_trig_bits[7] <= 0;
              udp_trig_bits[23:8] <= 0; // not used
              udp_trig_bits[31:24] <= mult16[7:0];

Firmware 0x5b217dc4 (13Jun18_13:25)

              udp_trig_bits[0] <= adc16_grand_or;
              udp_trig_bits[1] <= adc32_grand_or;
              udp_trig_bits[2] <= adc_grand_or;
              udp_trig_bits[3] <= esata_nim_grand_or;
              udp_trig_bits[4] <= 0; // not used
              udp_trig_bits[5] <= 0; // not used
              udp_trig_bits[6] <= 0; // not used
              udp_trig_bits[7] <= 0;
              udp_trig_bits[23:8] <= xadc16_or16[15:0]; // 16x AW preamps hits
              udp_trig_bits[31:24] <= xadc16_or16_mult[7:0]; // 16x AW preamp multiplicity (sum of xadc16_or16 bits)

Firmware 0x5b3aa19f (02Jul18_15:05)

              udp_trig_bits[0] <= adc16_grand_or;
              udp_trig_bits[1] <= adc32_grand_or;
              udp_trig_bits[2] <= adc_grand_or;
              udp_trig_bits[3] <= esata_nim_grand_or;
              udp_trig_bits[4] <= 0; // not used
              udp_trig_bits[5] <= 0; // not used
              udp_trig_bits[6] <= 0; // not used
              udp_trig_bits[7] <= udp_mlu_out;
              udp_trig_bits[23:8] <= xadc16_or16[15:0]; // 16x AW preamps hits
              udp_trig_bits[31:24] <= xadc16_or16_mult[7:0]; // 16x AW preamp multiplicity (sum of xadc16_or16 bits)

Firmware 0x5bc8f90f (18Oct18_14:20)

   assign trig32_in[0]  = trigger; // software trigger
   assign trig32_in[1]  = 0; // not used pulser trigger
   assign trig32_in[2]  = 0; // not used conf_enable_sas_or
   assign trig32_in[3]  = 0; // not used conf_run_pulser
   assign trig32_in[4]  = 0; // not used conf_output_pulser
   assign trig32_in[5]  = esata_nim_grand_or;
   assign trig32_in[6]  = adc16_grand_or;
   assign trig32_in[7]  = adc32_grand_or;
   assign trig32_in[8]  = adc16_mult_1ormore;
   assign trig32_in[9]  = adc16_mult_2ormore;
   assign trig32_in[10] = adc16_mult_3ormore;
   assign trig32_in[11] = adc16_mult_4ormore;
   assign trig32_in[12] = 0; // not used conf_enable_adc16_coinc
   assign trig32_in[13] = 0; // not used conf_enable_udp
   assign trig32_in[14] = 0; // not used conf_enable_busy
   assign trig32_in[15] = adc_grand_or;
   assign trig32_in[16] = aw16_coinc_a;
   assign trig32_in[17] = aw16_coinc_b;
   assign trig32_in[18] = aw16_coinc_c;
   assign trig32_in[19] = aw16_coinc_d;
   assign trig32_in[20] = 0; // not used conf_clock_select
   assign trig32_in[21] = aw16_coinc_trig;
   assign trig32_in[22] = aw16_mlu_trig;
   assign trig32_in[23] = timeout_trig;
   assign trig32_in[24] = aw16_mult_1ormore;
   assign trig32_in[25] = aw16_mult_2ormore;
   assign trig32_in[26] = aw16_mult_3ormore;
   assign trig32_in[27] = aw16_mult_4ormore;
   assign trig32_in[28] = bsc_grand_or_trig;
   assign trig32_in[29] = bsc_mult_trig;
   assign trig32_in[30] = coinc_trig;
   assign trig32_in[31] = 0; // not used

TODO

• add FwRev to the UDP data output
• fix "write did not happen" (send udp write command, there is no reply, read returns old data as if write never happened). suspect udp "write" packet is lost?
• fix reply to wrong socket - udp packets should reply to same socket as they came from, udp data packets should be sent to same socket as requested them, not same socket as last command.
• DONE 2021jul30. add fixes from Chris P. for the auto-negotiation and dhcp (see email from him).
• IMPOSSIBLE 2021jul30. implement ethernet flash programmer. flash memory chip not connected to main fpga.
• speed up programming the MLU by writing more than 1 bit at a time
• add 64-bit bitmap of BSC trigger bits

End

//KO