FPGA advanced reference

Register map

FPGA setup can be done via registers:

Address	Bits	Meaning	Mode	Notes
0x000000 - 0x00FFFF		Reserved (in case using MicroBlaze in the future, this has to be reserved for internal memory)
0x010000	32	Action Control Register
		Bit 0 - Action start	R/W
		Bit 1 - Action idle	R
		Bit 2 - Action cancel	R/W	cleared on reset or action start
		Bit 3 - Clear network counters	R/W	cleared on reset
		Bit 12:4 - Debug signals (see action_config.v for details)	R
		Bit 16 - AXI Mailbox interrupt 0	R
0x010004	32	Reserved	-
0x010008	32	Reserved	-
0x01000C	32	GIT SHA1	R
0x010010	32	Reserved	R
0x010014	32	Reserved	R
0x010018	32	Jungfraujoch FPGA variant	R
0x01001C	32	Reserved	R
0x010020	32	Max. number supported detector modules	R	constant
0x010024	32	Reserved	R	constant
0x010028	64	Pipeline stalls before writing to host memory	R	reset on action start
0x010030	64	Pipeline stalls before accessing HBM	R	reset on action start
0x010038	32	FIFO status (see action_config.v for details)	R
0x01003C	32	Size of single HBM channel in bytes (default value for the particular card)	R/W	should not be altered for standard operation
0x010040	64	Packets processed by the action	R	cleared on reset or action start
0x010048	64	Valid ethernet packets	R	cleared on reset
0x010050	64	Valid ICMP packets	R	cleared on reset
0x010058	64	Valid UDP packets	R	cleared on reset
0x010060	64	Valid detector packets processed by the card	R	cleared on reset
0x010068	64	Packets flagged as errors by CMAC	R	cleared on reset
0x010070	64	Pipeline stalls before data processing	R	reset on action start
0x010078	64	AXI-beats before accessing HBM	R	reset on action start
0x010080	64	AXI-beats before data processing	R	reset on action start
0x010088	64	AXI-beats before host writer	R	reset on action start
0x010090	64	Last encountered SwissFEL pulse ID	R	cleared on reset
0x010100	32	Spot finder photon count threshold	R/W
0x010104	32	Spot finder signal-to-noise ratio threshold (single-precision float)	R/W
0x010200	64	MAC address source for internal frame generator	R/W	network byte order
0x010208	32	IPv4 address source for internal frame generator	R/W	network byte order
0x01020C	32	Number of detector modules (value minus one: 0 => 1 module, 1 => 2 modules, etc.)	R/W
0x010210	32	Data collection mode	R/W
		Bit 0 - Conversion to photons
		Bit 1 - Output extend to 32-bit
		Bit 2 - Output is unsigned integer
		Bit 3 - Use sq. root lossy compression
		Bit 7 - JUNGFRAU fixed G1 mode
		Bit 8 - Set to zero values below threshold
		Bit 16:31 - Data collection ID (carried with completions)
0x010214	32	Photon energy in keV (single-precision float)	R/W
0x010218	32	Number of frames expected in the data collection (defines termination condition)	R/W
0x01021C	32	Number of storage cells	R/W
0x010220	32	Summation on card (value minus one: 0 => summation of 1, 1 => summation of 2, etc.)	R/W
0x010224	32	Coefficient for sq. root compression (need to set bit in data collection mode to apply)	R/W
0x010225	32	Threshold; set values below set to zero (need to set bit in data collection mode to apply)	R/W
0x030000 - 0x03FFFF		AXI Mailbox for Work Request / Work Completion		See Xilinx PG114 for register map
0x040000 - 0x04FFFF		QuadSPI flash		See Xilinx PG153 for register map
0x050000 - 0x05FFFF		Interrupt controller		See Xilinx PG099 for register map
0x060000 - 0x06FFFF		Load calibration (HLS)
0x070000 - 0x07FFFF		AXI Firewall		See Xilinx PG293 for register map
0x080000 - 0x08FFFF		Frame generator (HLS)
0x090000 - 0x09FFFF		PCIe DMA control		See Xilinx PG195 for register map
0x0A0000 - 0x0AFFFF		I2C clock generator		See Xilinx PG195 for register map
0x0C0000 - 0x0FFFFF		Xilinx Card Management Solution Subsystem management subsystem		See Xilinx PG348 for register map
0x100000 - 0x10FFFF		MAC 10G / CMAC 100G		See Xilinx PG210/PG203 for register map
0x110000 - 0x11FFFF		MAC 10G		See Xilinx PG210 for register map
0x120000 - 0x12FFFF		MAC 10G		See Xilinx PG210 for register map
0x130000 - 0x13FFFF		MAC 10G		See Xilinx PG210 for register map
0x140000 - 0x14FFFF		MAC 10G		See Xilinx PG210 for register map
0x150000 - 0x15FFFF		MAC 10G		See Xilinx PG210 for register map
0x160000 - 0x16FFFF		MAC 10G		See Xilinx PG210 for register map
0x170000 - 0x17FFFF		MAC 10G		See Xilinx PG210 for register map
0x200000 - 0x20FFFF		Eth/IPv4 network stack for interface #0
0x210000 - 0x21FFFF		Eth/IPv4 network stack for interface #1
0x220000 - 0x22FFFF		Eth/IPv4 network stack for interface #2
0x230000 - 0x23FFFF		Eth/IPv4 network stack for interface #3
0x240000 - 0x24FFFF		Eth/IPv4 network stack for interface #4
0x250000 - 0x25FFFF		Eth/IPv4 network stack for interface #5
0x260000 - 0x26FFFF		Eth/IPv4 network stack for interface #6
0x270000 - 0x27FFFF		Eth/IPv4 network stack for interface #7
0x400000 - 0x47FFFF	64	Address table: decodes handles used by load_calibration and host_writer to DMA addresses

AXI Mailbox

AXI mailbox is used to send work request from host to action, and receive work completions. Messages are exchanged through AXI Mailbox IP from Xilinx (see Xilinx PG114).

Work request has the following structure:

Bit start	Bit end	Meaning
0	15	Work request ID (handle)

Work completion has the following structure:

Bit start	Bit end	Meaning
0	15	Work request ID (handle)
		Special values:
		65534 - start of data collection
		65535 - end of data collection
15	31	Data collection ID

HBM memory

Interface number	Core	Meaning
0-1	jf_conversion	Gain factor G0
2-3	jf_conversion	Gain factor G1
4-5	jf_conversion	Gain factor G2
6-7	jf_conversion	Pedestal G0
8-9	jf_conversion	Pedestal G1
10-11	jf_conversion	Pedestal G2
12-13	integration	Integration map
14-15	integration	Integration weights
16-17	spot_finder_mask	Spot finder resolution
18-19	roi_calc	ROI calculation
20-21	frame_generator	Frame generator
22-27	load_from_hbm	Frame summation