1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
7 * Permission to use, copy, modify and distribute this software and its *
8 * documentation strictly for non-commercial purposes is hereby granted *
9 * without fee, provided that the above copyright notice appears in all *
10 * copies and that both the copyright notice and this permission notice *
11 * appear in the supporting documentation. The authors make no claims *
12 * about the suitability of this software for any purpose. It is *
13 * provided "as is" without express or implied warranty. *
14 **************************************************************************/
18 #include "AliMUONTriggerIO.h"
19 #include "AliMUONTriggerLut.h"
20 #include "AliMUONCalibParamNI.h"
21 #include "AliMUONVStore.h"
24 #include "AliMpHelper.h"
25 #include "AliMpConstants.h"
27 #include "AliMpFiles.h"
28 #include "AliMpDDLStore.h"
29 #include "AliMpLocalBoard.h"
30 #include "AliMpTriggerCrate.h"
31 #include "AliMUONGlobalCrateConfig.h"
32 #include "AliMUONRegionalTriggerConfig.h"
33 #include "AliMUONTriggerCrateConfig.h"
37 #include <Riostream.h>
40 /// \class AliMUONTriggerIO
42 /// Handles read/write of masks and LUT to/from online files,
43 /// to be used by Shuttle and Trigger DA.
45 /// \author Laurent Aphecetche, Christian Finck Subatech
46 /// \author Bogdan Vulpescu, LPC Clermont-Ferrand
49 ClassImp(AliMUONTriggerIO)
53 const UInt_t AliMUONTriggerIO::fgkLocalLutSize = 1 << 14; // 16384
55 //_____________________________________________________________________________
56 AliMUONTriggerIO::AliMUONTriggerIO()
63 //_____________________________________________________________________________
64 AliMUONTriggerIO::AliMUONTriggerIO(const char* regionalFileToRead)
69 ReadRegionalConfig(regionalFileToRead,0);
72 //_____________________________________________________________________________
73 AliMUONTriggerIO::~AliMUONTriggerIO()
78 //_____________________________________________________________________________
80 AliMUONTriggerIO::DeCompAddress(UChar_t &ypos, UChar_t &ytri, UChar_t &xdev, UChar_t &xpos,
81 UShort_t address) const
83 /// decompose the 15-bits address
88 // UChar_t bitsXpos = 5;
90 UShort_t maskYpos = 0x000F; // ...0 00001111
91 UShort_t maskYtri = 0x0001; // ...0 00000001
92 UShort_t maskXdev = 0x001F; // ...0 00011111
93 UShort_t maskXpos = 0x001F; // ...0 00011111
95 ypos = address & maskYpos;
96 ytri = (address >> bitsYpos) & maskYtri;
97 xdev = (address >> (bitsYpos+bitsYtri)) & maskXdev;
98 xpos = (address >> (bitsYpos+bitsYtri+bitsXdev)) & maskXpos;
100 // convert deviation format
101 // online: sign 1bit , dev 4bit
105 // 0 0 mu+, mu- infinite momentum (unde)
111 // - 15 mu+, mu- infinite momentum (unde)
113 Int_t iXdevOff, iXdevOn, iXdev, sign;
119 iXdevOn += iXdev & 0x0F;
120 sign += (iXdev >> 4) & 0x01;
132 iXdevOff = - iXdevOn + 15; // gives range 0-14
134 iXdevOff = + iXdevOn + 15; // gives range 16-30 !
144 //_____________________________________________________________________________
146 AliMUONTriggerIO::FillLut(AliMUONTriggerLut& lut,
147 Int_t icirc, UChar_t istripX, UChar_t idev,
148 Int_t lutLpt[16][2], Int_t lutHpt[16][2])
150 /// Fill the LUT histograms
152 if (icirc == 0 && istripX == 0 && idev == 0)
154 AliDebug(1,"Copy board, not filled ...");
158 Short_t iLptPlus, iLptMinu, iLptUnde;
159 Short_t iHptPlus, iHptMinu, iHptUnde;
161 iLptPlus = iLptMinu = iLptUnde = 0;
162 iHptPlus = iHptMinu = iHptUnde = 0;
164 for (Int_t istripY=0; istripY<16; istripY++)
166 if (lutLpt[istripY][1] == 0 && lutLpt[istripY][0] ==1)
167 iLptMinu=iLptMinu+(1 << istripY);
168 if (lutLpt[istripY][1] == 1 && lutLpt[istripY][0] ==0)
169 iLptPlus=iLptPlus+(1 << istripY);
170 if (lutLpt[istripY][1] == 1 && lutLpt[istripY][0] ==1)
171 iLptUnde=iLptUnde+(1 << istripY);
173 if (lutHpt[istripY][1] == 0 && lutHpt[istripY][0] ==1)
174 iHptMinu=iHptMinu+(1 << istripY);
175 if (lutHpt[istripY][1] == 1 && lutHpt[istripY][0] ==0)
176 iHptPlus=iHptPlus+(1 << istripY);
177 if (lutHpt[istripY][1] == 1 && lutHpt[istripY][0] ==1)
178 iHptUnde=iHptUnde+(1 << istripY);
182 lut.SetContent("LptMinu",icirc,istripX,idev,iLptMinu);
183 lut.SetContent("LptUnde",icirc,istripX,idev,iLptUnde);
184 lut.SetContent("LptPlus",icirc,istripX,idev,iLptPlus);
186 lut.SetContent("HptMinu",icirc,istripX,idev,iHptMinu);
187 lut.SetContent("HptUnde",icirc,istripX,idev,iHptUnde);
188 lut.SetContent("HptPlus",icirc,istripX,idev,iHptPlus);
191 //_____________________________________________________________________________
193 AliMUONTriggerIO::ReadLocalMasks(const char* localFile, AliMUONVStore& localMasks) const
195 /// Fills the local masks store from file
197 if ( !NofLocalBoards() )
199 AliError("No local board to read");
203 FILE* fp = fopen(gSystem->ExpandPathName(localFile),"r");
206 AliError(Form("Could not read file %s",localFile));
210 UShort_t maskBuffer[8];
212 Int_t localBoardIndex(0);
214 while ( fread ( maskBuffer, 2, 8, fp ) )
216 Int_t localBoardId = fRegionalTrigger.LocalBoardId(localBoardIndex);
217 AliDebug(1,Form("LB %03d X1 %4x X2 %4x X3 %4x X4 %4x "
218 "Y1 %4x Y2 %4x Y3 %4x Y4 %4x",
229 if ( localBoardId > 0 )
231 AliMUONVCalibParam* localBoard = new AliMUONCalibParamNI(1,8,localBoardId,0,0);
232 for ( Int_t index = 0; index < 8; ++index )
234 localBoard->SetValueAsInt(index,0,maskBuffer[index]);
236 localMasks.Add(localBoard);
240 AliError(Form("Oups. Got localBoardId=%d for index=%d",localBoardId,localBoardIndex));
246 if ( localBoardIndex != NofLocalBoards() )
248 AliError(Form("Read %d out of %d local boards",
249 localBoardIndex, NofLocalBoards()));
254 return localBoardIndex+1;
257 //_____________________________________________________________________________
259 AliMUONTriggerIO::ReadLocalLUT(AliMUONTriggerLut& lut,
263 /// Read the LUT for one local board from an online file
267 UChar_t buffer[fgkLocalLutSize]; // 32768 hpt/lpt addresses divided by two
268 UChar_t mask1 = 0xF0;
269 UChar_t mask2 = 0x0F;
270 UChar_t maskHpt = 0x0C;
271 UChar_t maskLpt = 0x03;
272 UChar_t lh, lpt, hpt;
274 UChar_t xpos, xdev, ypos, ytri;
276 Int_t lutLpt[16][2], lutHpt[16][2];
278 Int_t boardnr = localBoardId;
280 AliDebug(1,Form("Reading LUT values for local board %d",boardnr));
283 Bool_t trigx = kFALSE;
285 // read two lut addresses at once, 32768/2=16384 times
286 if (fread(buffer,fgkLocalLutSize,1,flut) == 0) {
287 AliWarning("Error reading the LUT file");
291 // create the 32767 addresses for the 4-bits lpt and hpt half-bytes
292 for (UShort_t ilut = 0; ilut < fgkLocalLutSize*2; ilut += 2)
295 // 1st 4-bits half-byte
297 lh = (buffer[ilut/2] & mask1) >> 4;
299 // Lpt and Hpt response
300 hpt = (lh & maskHpt) >> 2;
303 // decompose the 15-bits address
304 trigx = DeCompAddress(ypos,ytri,xdev,xpos,address);
306 // calculate group of y-strips
307 if (trigx && (ny < 16))
309 lutLpt[ny][0] = lpt & 1;
310 lutLpt[ny][1] = (lpt & 2) >> 1;
311 lutHpt[ny][0] = hpt & 1;
312 lutHpt[ny][1] = (hpt & 2) >> 1;
317 // ytri == 1 means no trigger in y-direction
320 FillLut(lut,boardnr,xpos,xdev,lutLpt,lutHpt);
325 // 2nd 4-bits half-byte
327 lh = (buffer[ilut/2] & mask2);
329 // Lpt and Hpt response
330 hpt = (lh & maskHpt) >> 2;
333 // decompose the 15-bits address
334 trigx = DeCompAddress(ypos,ytri,xdev,xpos,address);
336 // calculate group of y-strips
337 if (trigx && (ny < 16))
339 lutLpt[ny][0] = lpt & 1;
340 lutLpt[ny][1] = (lpt & 2) >> 1;
341 lutHpt[ny][0] = hpt & 1;
342 lutHpt[ny][1] = (hpt & 2) >> 1;
347 // ytri == 1 means no trigger in y-direction
350 FillLut(lut,boardnr,xpos,xdev,lutLpt,lutHpt);
357 //_____________________________________________________________________________
359 AliMUONTriggerIO::ReadLUT(const char* lutFileToRead, AliMUONTriggerLut& lut)
361 /// Fill the LUT object from online file
363 if ( !NofLocalBoards() )
365 AliError("No local board id defined. Must read a regional file first");
369 FILE* flut = fopen(gSystem->ExpandPathName(lutFileToRead),"rb");
372 AliError(Form("Could not read LUT file %s",lutFileToRead));
376 for ( Int_t i = 0; i < NofLocalBoards(); ++i )
378 ReadLocalLUT(lut,fRegionalTrigger.LocalBoardId(i),flut);
387 //_____________________________________________________________________________
389 AliMUONTriggerIO::ReadConfig(const char* localFile,
390 const char* regionalFile,
391 const char* globalFile,
392 AliMUONVStore* localMasks,
393 AliMUONRegionalTriggerConfig* regionalConfig,
394 AliMUONGlobalCrateConfig* globalConfig)
396 /// Fill the various masks store from files
398 if ( !regionalConfig || !regionalFile || strlen(regionalFile)==0 )
400 AliError("Must have a regional file name to proceeed");
404 AliDebug(1,Form("regionalConfig=%p",regionalConfig));
406 Int_t nCrates = ReadRegionalConfig(regionalFile, regionalConfig);
410 AliError("nCrates=0 !");
414 if (localMasks && localFile && strlen(localFile) > 0 )
416 Int_t nLocal = ReadLocalMasks(localFile,*localMasks);
417 AliDebug(1,Form("Read masks for %d local boards",nLocal));
420 Int_t nDarc = ReadGlobalConfig(globalFile, globalConfig);
421 AliDebug(1,Form("Read config for %d DARC boards",nDarc));
423 if (!nDarc) return kFALSE;
430 //_____________________________________________________________________________
432 AliMUONTriggerIO::ReadGlobalConfig(const char* globalFile, AliMUONGlobalCrateConfig* globalConfig) const
434 /// read the global crate file
435 /// the masks are disable bit for each crate, 8 per darc board
436 /// bit value 0 means enable, 1 means disable *
439 if ( !(nDarc = globalConfig->ReadData(globalFile)) ) return 0;
444 //_____________________________________________________________________________
446 AliMUONTriggerIO::ReadRegionalConfig(const char* regionalFile, AliMUONRegionalTriggerConfig* regionalConfig)
448 /// Read regional file to fill
450 AliDebug(1,Form("regionalConfig=%p",regionalConfig));
453 if ( !(nCrates = regionalConfig->ReadData(regionalFile)) ) return 0;
455 // read the mapping file also
456 if ( ! fRegionalTrigger.ReadData(regionalFile) ) return 0;
462 //_____________________________________________________________________________
464 AliMUONTriggerIO::WriteLUT(const AliMUONTriggerLut& lut,
465 const char* lutFileToWrite)
467 /// Convert an offline lut into an online (binary) lut file
469 if ( !NofLocalBoards() )
471 AliError("No local board id defined. Must read a regional file first");
475 FILE* flut = fopen(gSystem->ExpandPathName(lutFileToWrite),"wb");
478 AliError(Form("Could not create output LUT file %s",lutFileToWrite));
482 for ( Int_t i = 0; i < NofLocalBoards(); ++i )
484 WriteLocalLUT(lut,fRegionalTrigger.LocalBoardId(i),flut);
493 //_____________________________________________________________________________
495 AliMUONTriggerIO::WriteConfig(const char* localFile,
496 const char* regionalFile,
497 const char* globalFile,
498 const AliMUONVStore* localMasks,
499 AliMUONRegionalTriggerConfig* regionalConfig,
500 AliMUONGlobalCrateConfig* globalConfig) const
502 /// write config files
505 ok = WriteLocalMasks(localFile, *localMasks);
506 ok &= WriteRegionalConfig(regionalFile, regionalConfig);
507 ok &= WriteGlobalConfig(globalFile, globalConfig);
515 //_____________________________________________________________________________
517 AliMUONTriggerIO::WriteGlobalConfig(const char* globalFile, AliMUONGlobalCrateConfig* globalConfig) const
519 /// write global config
524 out.open(globalFile);
527 AliError(Form("Could not create output global file %s", globalFile));
531 out << globalConfig->GetName() << endl;
532 out << Form("0x%x",globalConfig->GetGlobalCrateEnable()) << endl;
535 out << globalConfig->GetJtagName() << endl;
536 out << Form("0x%08lx", globalConfig->GetJtagVmeAddr()) << endl;
537 out << Form("%d %d %d", globalConfig->GetJtagClockDiv(),
538 globalConfig->GetJtagRxPhase(), globalConfig->GetJtagRdDelay()) << endl;
540 for (Int_t i = 0; i < globalConfig->GetJtagNofLines(); ++i)
541 out << Form("%d ", globalConfig->GetEnableJtag(i));
545 for (Int_t i = 0; i < globalConfig->GetJtagNofLines(); ++i)
548 for (Int_t j = 0; j < globalConfig->GetJtagNofLines(); ++j)
549 out << Form(" %s", globalConfig->GetJtagCrateName(i,j).Data()) << endl;
553 out << globalConfig->GetFirstDarcName() << endl;
554 out << Form("0x%08lx", globalConfig->GetFirstDarcVmeAddr()) << endl;
555 out << globalConfig->GetFirstDarcType() << endl;
556 disable = globalConfig->GetFirstDarcDisable();
557 out << Form("0x%02x", disable) << endl;
558 out << Form("0x%x", globalConfig->GetFirstDarcL0Delay()) << endl;
559 out << Form("0x%x", globalConfig->GetFirstDarcL1TimeOut()) << endl;
560 out << Form("0x%x", globalConfig->GetFirstDarcGlobalL0()) << endl;
561 out << Form("0x%x", globalConfig->GetFirstDarcConfig()) << endl;
564 out << globalConfig->GetSecondDarcName() << endl;
565 out << Form("0x%08lx", globalConfig->GetSecondDarcVmeAddr()) << endl;
566 out << globalConfig->GetSecondDarcType() << endl;
567 disable = globalConfig->GetSecondDarcDisable();
568 out << Form("0x%02x", disable) << endl;
569 out << Form("0x%x", globalConfig->GetSecondDarcL0Delay()) << endl;
570 out << Form("0x%x", globalConfig->GetSecondDarcL1TimeOut()) << endl;
571 out << Form("0x%x", globalConfig->GetSecondDarcGlobalL0()) << endl;
572 out << Form("0x%x", globalConfig->GetSecondDarcConfig()) << endl;
575 out << globalConfig->GetGlobalName() << endl;
576 out << Form("0x%08lx", globalConfig->GetGlobalVmeAddr()) << endl;
577 for (Int_t i = 0; i < globalConfig->GetGlobalNofRegisters(); ++i)
578 out << Form("0x%x", globalConfig->GetGlobalRegister(i)) << endl;
581 out << globalConfig->GetFetName() << endl;
582 out << Form("0x%08lx", globalConfig->GetFetVmeAddr()) << endl;
583 for (Int_t i = 0; i < globalConfig->GetFetNofRegisters(); ++i)
584 out << Form("0x%x", globalConfig->GetFetRegister(i)) << endl;
589 //_____________________________________________________________________________
591 AliMUONTriggerIO::WriteRegionalConfig(const char* regionalFile, AliMUONRegionalTriggerConfig* regionalConfig) const
594 /// write regional mask with the current configuration
595 /// if regional masks not defined, take the one from current configuration
598 out.open(regionalFile);
602 AliError(Form("Could not create output regional file %s",regionalFile));
606 Int_t nCrate = fRegionalTrigger.GetNofTriggerCrates();
609 AliError("Could not write regional no configuration in memory");
615 AliMpTriggerCrate* crate;
616 for (Int_t ddlId = 0; ddlId < 2; ddlId++) // right & left side
618 for (Int_t crateId = 0; crateId < 8; crateId++) // 8 crates/regional boards for each side.
621 name = AliMpTriggerCrate::GenerateName(crateId, ddlId, nofDDLs);
623 crate = fRegionalTrigger.FindTriggerCrate(name, false);
625 AliMUONTriggerCrateConfig* crateConfig = regionalConfig->FindTriggerCrate(crate->GetName());
628 AliError(Form("Cannot find crate %s in CDB", crate->GetName()));
632 out << crate->GetName() << endl;
633 out << Form("%02x", crate->GetId()) << endl;
634 out << crateConfig->GetMode() << endl;
635 out << crateConfig->GetCoinc() << endl;
636 out << Form("%04x", crateConfig->GetMask()) << endl;
637 out << Form("%02d",crate->GetNofLocalBoards()) << endl;
639 for (Int_t iLocal = 0; iLocal < crate->GetNofLocalBoards(); ++iLocal)
641 Int_t localBoardId = crate->GetLocalBoardId(iLocal);
643 AliMpLocalBoard* board = fRegionalTrigger.FindLocalBoard(localBoardId);
645 out << Form("%02d ", board->GetSlot())
647 << Form(" %03d ", localBoardId)
648 << Form("%03x", board->GetSwitch())
653 if (board->IsNotified()) {
654 for (Int_t i = 0; i < board->GetNofDEs(); ++i)
655 out << Form("%4d ", board->GetDEId(i));
657 out << Form("%4d ", 0);
661 // print copy card numbers & TC
662 out << Form(" %4d %4d", board->GetInputXfrom(), board->GetInputXto());
663 out << Form(" %4d %4d", board->GetInputYfrom(), board->GetInputYto());
664 out << Form(" %4d", board->GetTC()) << endl;
675 //_____________________________________________________________________________
677 AliMUONTriggerIO::WriteLocalMasks(const char* localFile, const AliMUONVStore& localMasks) const
680 /// removing/adding enable for a local board need a update of the configuration
681 /// before calling this method
682 /// mask are written for all boards including the copy card (Ch.F.)
684 FILE* fp = fopen(gSystem->ExpandPathName(localFile),"wb");
687 AliError(Form("Could not create output local file %s",localFile));
691 UShort_t maskBuffer[8];
692 Int_t localBoardIndex(0);
693 while (localBoardIndex < NofLocalBoards()) {
695 Int_t localBoardId = fRegionalTrigger.LocalBoardId(localBoardIndex);
697 AliMUONVCalibParam* localMask =
698 static_cast<AliMUONVCalibParam*>(localMasks.FindObject(localBoardId));
700 for (Int_t index = 0; index < 8; ++index)
702 maskBuffer[index] = localMask->ValueAsInt(index,0);
705 fwrite ( maskBuffer, 2, 8, fp);
717 //_____________________________________________________________________________
719 AliMUONTriggerIO::WriteLocalLUT(const AliMUONTriggerLut& lut,
723 /// loop over the address for the 4-bits lpt and hpt decisions
725 const Int_t kMaskYpos = 0x0F;
726 const Int_t kMaskYtri = 0x01;
727 const Int_t kMaskXdev = 0x1F;
728 const Int_t kMaskXpos = 0x1F;
730 UChar_t buffer[fgkLocalLutSize]; // 32768 hpt/lpt addresses divided by two
733 for (UInt_t i = 0; i < fgkLocalLutSize*2; ++i)
735 Int_t lutLpt[2] = { 0 };
736 Int_t lutHpt[2] = { 0 };
739 Int_t iYpos = i & kMaskYpos;
740 Int_t iYtri = ( i >> 4 ) & kMaskYtri;
741 Int_t iXdev = ( i >> ( 4 + 1 ) ) & kMaskXdev;
742 Int_t iXpos = ( i >> ( 4 + 1 + 5 ) ) & kMaskXpos;
744 // convert deviation format
745 // online: sign 1bit , dev 4bit
749 // 0 0 mu+, mu- infinite momentum (unde)
755 // - 15 mu+, mu- infinite momentum (unde)
759 Bool_t trigx = kFALSE;
760 iXdevOn += iXdev & 0x0F;
761 sign += (iXdev >> 4) & 0x01;
773 iXdevOff = - iXdevOn + 15; // gives range 0-14
775 iXdevOff = + iXdevOn + 15; // gives range 16-30 !
780 // iYtri == 1 means no trigger in y-direction
781 if (iYtri == 0 && trigx)
783 lut.GetLutOutput(localBoardId,iXpos,iXdev,iYpos,lutLpt,lutHpt);
791 buffer[bc] += lutHpt[1] << 7;
792 buffer[bc] += lutHpt[0] << 6;
793 buffer[bc] += lutLpt[1] << 5;
794 buffer[bc] += lutLpt[0] << 4;
797 buffer[bc] += lutHpt[1] << 3;
798 buffer[bc] += lutHpt[0] << 2;
799 buffer[bc] += lutLpt[1] << 1;
800 buffer[bc] += lutLpt[0] << 0;
804 fwrite(&buffer,bc,1,flut);
807 //_____________________________________________________________________________
809 AliMUONTriggerIO::LocalBoardId(Int_t index) const
811 /// Return the i-th localBoardId, or -1 if index is out of bounds
813 return fRegionalTrigger.LocalBoardId(index);
817 //______________________________________________________________________________
819 Int_t AliMUONTriggerIO::LocalBoardId(Int_t ddlId, Int_t crateId, Int_t localId) const
821 /// Return local board id from crate and local indexes.
824 TString name = AliMpTriggerCrate::GenerateName(crateId, ddlId, nofDDLs);
826 AliMpTriggerCrate* crate = fRegionalTrigger.FindTriggerCrate(name, false);
827 return crate->GetLocalBoardId(localId);