HGCal Motherboard Database CSV

CSV files for uploading HGCal scintillator motherboard components to the CERN database. The CSVs are converted to XML using csv_to_xml.py from the usefull-scripts repository.

Scintillator Motherboard Structure

For scintillator motherboards (LABEL_TYPECODE: WM-MB0), the full component mapping is:

Children	Typecode	Quantity	Notes
Scintillator Motherboard PCB	WM-MBB	1	Bare PCB
lpGBT	IC-LPG	2	DAQ + TRIG
ECON-D	IC-ECD (any quality: A/B/F/D)	1
ECON-T	IC-ECT	2
RAFAEL	IC-RAF	1	Clock fanout ASIC
HGC-LDO	IC-LDO	2	LDO regulator
bPOL12V	IC-BPL	1	DCDC ASIC
VTRX	IC-VTR	1	Added at cassette assembly, not at motherboard registration
LinPOL12V	IC-LPL	2	Linear regulator

All children are embedded. No quality-graded motherboard variants — all boards use WM-MB0 regardless of ECON-D quality.

Current CSV mapping (scint_motherboards.csv indices):

Index	Typecode	Description
[0]	IC-LPG	lpGBT - DAQ
[1]	IC-LPG	lpGBT - TRIG
[2]	IC-LDH	LDH chip (should become IC-LDO)
[3]	WM-MBB	Bare Scintillator Motherboard PCB
[4]	IC-ECD	ECON-D
[5]	IC-ECT	ECON-T #1
[6]	IC-ECT	ECON-T #2

Usage: make_scint_motherboard.py

Generate formatted CSV rows for scint_motherboards.csv:

# Print to stdout
python3 make_scint_motherboard.py \
  --serial 320WMMBD1010691 \
  --lpgbt-daq A42F3E2C --lpgbt-trig 2C2F7CB3 \
  --ldh "LDO 11 000001" \
  --econd 320ICECDAG00001 \
  --econt1 320ICECTAB01079 --econt2 320ICECTAB01080

# Append to CSV file (header auto-added if file is empty/missing)
python3 make_scint_motherboard.py -o scint_motherboards.csv \
  --serial 320WMMBD1010691 \
  --lpgbt-daq A42F3E2C --lpgbt-trig 2C2F7CB3 \
  --ldh "LDO 11 000001" \
  --econd 320ICECDAG00001 \
  --econt1 320ICECTAB01079 --econt2 320ICECTAB01080

Required arguments:

• --serial — Board serial number
• --lpgbt-daq — lpGBT DAQ serial (IC-LPG)
• --lpgbt-trig — lpGBT TRIG serial (IC-LPG)
• --ldh — LDH/LDO serial (IC-LDH)
• --econd — ECON-D serial (IC-ECD)
• --econt1 — ECON-T #1 serial (IC-ECT)
• --econt2 — ECON-T #2 serial (IC-ECT)

Optional arguments:

• --location (default: FSU)
• --institution (default: FSU)
• --manufacturer (default: APCT)
• --date (default: today, format YYYY-MM-DD)
• --batch (default: 1)
• --comment (default: Production)
• -o / --output — append to file instead of stdout
• --no-header — omit header row