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 nLocalBoards(1);
214 while ( fread ( maskBuffer, 2, 8, fp ) )
216 Int_t localBoardId = fRegionalTrigger.LocalBoardId(nLocalBoards);
217 AliDebug(1,Form("LB %03d X1 %4x X2 %4x X3 %4x X4 %4x "
218 "Y1 %4x Y2 %4x Y3 %4x Y4 %4x",
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);
242 if ( nLocalBoards != NofLocalBoards() )
244 AliError(Form("Read %d out of %d local boards",
245 nLocalBoards, NofLocalBoards()));
253 //_____________________________________________________________________________
255 AliMUONTriggerIO::ReadLocalLUT(AliMUONTriggerLut& lut,
259 /// Read the LUT for one local board from an online file
263 UChar_t buffer[fgkLocalLutSize]; // 32768 hpt/lpt addresses divided by two
264 UChar_t mask1 = 0xF0;
265 UChar_t mask2 = 0x0F;
266 UChar_t maskHpt = 0x0C;
267 UChar_t maskLpt = 0x03;
268 UChar_t lh, lpt, hpt;
270 UChar_t xpos, xdev, ypos, ytri;
272 Int_t lutLpt[16][2], lutHpt[16][2];
274 Int_t boardnr = localBoardId;
276 AliDebug(1,Form("Reading LUT values for local board %d",boardnr));
279 Bool_t trigx = kFALSE;
281 // read two lut addresses at once, 32768/2=16384 times
282 fread(buffer,fgkLocalLutSize,1,flut);
284 // create the 32767 addresses for the 4-bits lpt and hpt half-bytes
285 for (UShort_t ilut = 0; ilut < fgkLocalLutSize*2; ilut += 2)
288 // 1st 4-bits half-byte
290 lh = (buffer[ilut/2] & mask1) >> 4;
292 // Lpt and Hpt response
293 hpt = (lh & maskHpt) >> 2;
296 // decompose the 15-bits address
297 trigx = DeCompAddress(ypos,ytri,xdev,xpos,address);
299 // calculate group of y-strips
300 if (trigx && (ny < 16))
302 lutLpt[ny][0] = lpt & 1;
303 lutLpt[ny][1] = (lpt & 2) >> 1;
304 lutHpt[ny][0] = hpt & 1;
305 lutHpt[ny][1] = (hpt & 2) >> 1;
310 // ytri == 1 means no trigger in y-direction
313 FillLut(lut,boardnr,xpos,xdev,lutLpt,lutHpt);
318 // 2nd 4-bits half-byte
320 lh = (buffer[ilut/2] & mask2);
322 // Lpt and Hpt response
323 hpt = (lh & maskHpt) >> 2;
326 // decompose the 15-bits address
327 trigx = DeCompAddress(ypos,ytri,xdev,xpos,address);
329 // calculate group of y-strips
330 if (trigx && (ny < 16))
332 lutLpt[ny][0] = lpt & 1;
333 lutLpt[ny][1] = (lpt & 2) >> 1;
334 lutHpt[ny][0] = hpt & 1;
335 lutHpt[ny][1] = (hpt & 2) >> 1;
340 // ytri == 1 means no trigger in y-direction
343 FillLut(lut,boardnr,xpos,xdev,lutLpt,lutHpt);
350 //_____________________________________________________________________________
352 AliMUONTriggerIO::ReadLUT(const char* lutFileToRead, AliMUONTriggerLut& lut)
354 /// Fill the LUT object from online file
356 if ( !NofLocalBoards() )
358 AliError("No local board id defined. Must read a regional file first");
362 FILE* flut = fopen(gSystem->ExpandPathName(lutFileToRead),"rb");
365 AliError(Form("Could not read LUT file %s",lutFileToRead));
369 for ( Int_t i = 0; i < NofLocalBoards(); ++i )
371 ReadLocalLUT(lut,fRegionalTrigger.LocalBoardId(i),flut);
380 //_____________________________________________________________________________
382 AliMUONTriggerIO::ReadConfig(const char* localFile,
383 const char* regionalFile,
384 const char* globalFile,
385 AliMUONVStore* localMasks,
386 AliMUONRegionalTriggerConfig* regionalConfig,
387 AliMUONGlobalCrateConfig* globalConfig)
389 /// Fill the various masks store from files
393 AliError("Must have a regional file name to proceeed");
397 Int_t nCrates = ReadRegionalConfig(regionalFile, regionalConfig);
399 if (!nCrates) return kFALSE;
401 if (localMasks && localFile)
403 Int_t nLocal = ReadLocalMasks(localFile,*localMasks);
404 AliDebug(1,Form("Read masks for %d local boards",nLocal));
407 Int_t nDarc = ReadGlobalConfig(globalFile, globalConfig);
408 AliDebug(1,Form("Read disable for %d DARC boards",nDarc));
410 if (!nDarc) return kFALSE;
417 //_____________________________________________________________________________
419 AliMUONTriggerIO::ReadGlobalConfig(const char* globalFile, AliMUONGlobalCrateConfig* globalConfig)
421 /// read the global crate file
422 /// the masks are disable bit for each crate, 8 per darc board
423 /// bit value 0 means enable, 1 means disable *
426 if ( !(nDarc = globalConfig->ReadData(globalFile)) ) return 0;
431 //_____________________________________________________________________________
433 AliMUONTriggerIO::ReadRegionalConfig(const char* regionalFile, AliMUONRegionalTriggerConfig* regionalConfig)
435 /// Read regional file to fill
437 if ( !(nCrates = regionalConfig->ReadData(regionalFile)) ) return 0;
439 // read the mapping file also
440 if ( ! fRegionalTrigger.ReadData(regionalFile) ) return 0;
446 //_____________________________________________________________________________
448 AliMUONTriggerIO::WriteLUT(const AliMUONTriggerLut& lut,
449 const char* lutFileToWrite)
451 /// Convert an offline lut into an online (binary) lut file
453 if ( !NofLocalBoards() )
455 AliError("No local board id defined. Must read a regional file first");
459 FILE* flut = fopen(gSystem->ExpandPathName(lutFileToWrite),"wb");
462 AliError(Form("Could not create output LUT file %s",lutFileToWrite));
466 for ( Int_t i = 0; i < NofLocalBoards(); ++i )
468 WriteLocalLUT(lut,fRegionalTrigger.LocalBoardId(i),flut);
477 //_____________________________________________________________________________
479 AliMUONTriggerIO::WriteConfig(const char* localFile,
480 const char* regionalFile,
481 const char* globalFile,
482 AliMUONVStore* localMasks,
483 AliMUONRegionalTriggerConfig* regionalConfig,
484 AliMUONGlobalCrateConfig* globalConfig) const
486 /// write config files
489 ok = WriteLocalMasks(localFile, *localMasks, regionalConfig);
490 ok &= WriteRegionalConfig(regionalFile, regionalConfig);
491 ok &= WriteGlobalConfig(globalFile, globalConfig);
499 //_____________________________________________________________________________
501 AliMUONTriggerIO::WriteGlobalConfig(const char* globalFile, AliMUONGlobalCrateConfig* globalConfig) const
503 /// write global config
508 out.open(globalFile);
511 AliError(Form("Could not create output global file %s", globalFile));
515 out << globalConfig->GetName() << endl;
516 out << globalConfig->GetGlobalCrateEnable() << endl;
519 out << globalConfig->GetJtagName() << endl;
520 out << Form("0x%08x", globalConfig->GetJtagVmeAddr()) << endl;
521 out << Form("%d %d %d", globalConfig->GetJtagClockDiv(),
522 globalConfig->GetJtagRxPhase(), globalConfig->GetJtagRdDelay()) << endl;
524 for (Int_t i = 0; i < globalConfig->GetJtagNofLines(); ++i)
525 out << Form("%d ", globalConfig->GetEnableJtag(i));
529 for (Int_t i = 0; i < globalConfig->GetJtagNofLines(); ++i)
532 for (Int_t j = 0; j < globalConfig->GetJtagNofLines(); ++j)
533 out << Form(" %s", globalConfig->GetJtagCrateName(i,j).Data()) << endl;
537 out << globalConfig->GetFirstDarcName() << endl;
538 out << Form("0x%08x", globalConfig->GetFirstDarcVmeAddr()) << endl;
539 out << globalConfig->GetFirstDarcType() << endl;
540 disable = globalConfig->GetFirstDarcDisable();
541 out << Form("0x%02x", disable) << endl;
542 out << Form("0x%x", globalConfig->GetFirstDarcL0Delay()) << endl;
543 out << Form("0x%x", globalConfig->GetFirstDarcL1TimeOut()) << endl;
544 out << Form("0x%x", globalConfig->GetFirstDarcGlobalL0()) << endl;
545 out << Form("0x%x", globalConfig->GetFirstDarcConfig()) << endl;
548 out << globalConfig->GetSecondDarcName() << endl;
549 out << Form("0x%08x", globalConfig->GetSecondDarcVmeAddr()) << endl;
550 out << globalConfig->GetSecondDarcType() << endl;
551 disable = globalConfig->GetSecondDarcDisable();
552 out << Form("0x%02x", disable) << endl;
553 out << Form("0x%x", globalConfig->GetSecondDarcL0Delay()) << endl;
554 out << Form("0x%x", globalConfig->GetSecondDarcL1TimeOut()) << endl;
555 out << Form("0x%x", globalConfig->GetSecondDarcGlobalL0()) << endl;
556 out << Form("0x%x", globalConfig->GetSecondDarcConfig()) << endl;
559 out << globalConfig->GetGlobalName() << endl;
560 out << Form("0x%08x", globalConfig->GetGlobalVmeAddr()) << endl;
561 for (Int_t i = 0; i < globalConfig->GetGlobalNofRegisters(); ++i)
562 out << Form("0x%x", globalConfig->GetGlobalRegister(i)) << endl;
565 out << globalConfig->GetFetName() << endl;
566 out << Form("0x%08x", globalConfig->GetFetVmeAddr()) << endl;
567 for (Int_t i = 0; i < globalConfig->GetFetNofRegisters(); ++i)
568 out << Form("0x%x", globalConfig->GetFetRegister(i)) << endl;
573 //_____________________________________________________________________________
575 AliMUONTriggerIO::WriteRegionalConfig(const char* regionalFile, AliMUONRegionalTriggerConfig* regionalConfig) const
578 /// write regional mask with the current configuration
579 /// if regional masks not defined, take the one from current configuration
582 out.open(regionalFile);
586 AliError(Form("Could not create output regional file %s",regionalFile));
590 Int_t nCrate = fRegionalTrigger.GetNofTriggerCrates();
593 AliError("Could not write regional no configuration in memory");
597 TIter next(fRegionalTrigger.CreateCrateIterator());
598 AliMpTriggerCrate* crate;
599 while ( ( crate = static_cast<AliMpTriggerCrate*>(next()) ) )
601 AliMUONTriggerCrateConfig* crateConfig = regionalConfig->FindTriggerCrate(crate->GetName());
604 AliError(Form("Cannot find crate %s in CDB", crate->GetName()));
608 out << crate->GetName() << endl;
609 out << Form("%02x", crate->GetId()) << endl;
610 out << crateConfig->GetMode() << endl;
611 out << crateConfig->GetCoinc() << endl;
612 out << Form("%04x", crateConfig->GetMask()) << endl;
614 for (Int_t iLocal = 0; iLocal < crate->GetNofLocalBoards(); ++iLocal)
616 Int_t localBoardId = crate->GetLocalBoardId(iLocal);
618 AliMpLocalBoard* board = fRegionalTrigger.FindLocalBoard(localBoardId);
620 out << Form("%02d ", board->GetSlot())
622 << Form(" %03d ", localBoardId)
623 << Form("%03x", board->GetSwitch())
627 for (Int_t i = 0; i < board->GetNofDEs(); ++i)
628 out << Form("%4d ", board->GetDEId(i));
631 // print copy card numbers & TC
632 out << Form(" %4d %4d", board->GetInputXfrom(), board->GetInputXto());
633 out << Form(" %4d %4d", board->GetInputYfrom(), board->GetInputYto());
634 out << Form(" %4d", board->GetTC()) << endl;
643 //_____________________________________________________________________________
645 AliMUONTriggerIO::WriteLocalMasks(const char* localFile, AliMUONVStore& localMasks, AliMUONRegionalTriggerConfig* regionalConfig) const
648 /// removing/adding enable for a local board need a update of the configuration
649 /// before calling this method
650 /// mask are written for all boards including the copy card (Ch.F.)
652 FILE* fp = fopen(gSystem->ExpandPathName(localFile),"wb");
655 AliError(Form("Could not create output local file %s",localFile));
659 UShort_t maskBuffer[8];
661 TIter next(regionalConfig->CreateCrateIterator());
662 AliMUONTriggerCrateConfig* crate;
664 while ( ( crate = static_cast<AliMUONTriggerCrateConfig*>(next()) ) )
666 UShort_t mask = crate->GetMask(); // getting mask from current config
668 for (Int_t iLocal = 0; iLocal < crate->GetNofLocalBoards(); ++iLocal)
670 Int_t localBoardId = crate->GetLocalBoardId(iLocal);
672 if ( (mask >> iLocal ) & 0x1 )
674 AliMUONVCalibParam* localMask =
675 static_cast<AliMUONVCalibParam*>(localMasks.FindObject(localBoardId));
677 for (Int_t index = 0; index < 8; ++index)
679 maskBuffer[index] = localMask->ValueAsInt(index,0);
682 fwrite ( maskBuffer, 2, 8, fp);
694 //_____________________________________________________________________________
696 AliMUONTriggerIO::WriteLocalLUT(const AliMUONTriggerLut& lut,
700 /// loop over the address for the 4-bits lpt and hpt decisions
702 const Int_t kMaskYpos = 0x0F;
703 const Int_t kMaskYtri = 0x01;
704 const Int_t kMaskXdev = 0x1F;
705 const Int_t kMaskXpos = 0x1F;
707 UChar_t buffer[fgkLocalLutSize]; // 32768 hpt/lpt addresses divided by two
710 for (UInt_t i = 0; i < fgkLocalLutSize*2; ++i)
712 Int_t lutLpt[2] = { 0 };
713 Int_t lutHpt[2] = { 0 };
716 Int_t iYpos = i & kMaskYpos;
717 Int_t iYtri = ( i >> 4 ) & kMaskYtri;
718 Int_t iXdev = ( i >> ( 4 + 1 ) ) & kMaskXdev;
719 Int_t iXpos = ( i >> ( 4 + 1 + 5 ) ) & kMaskXpos;
721 // convert deviation format
722 // online: sign 1bit , dev 4bit
726 // 0 0 mu+, mu- infinite momentum (unde)
732 // - 15 mu+, mu- infinite momentum (unde)
736 Bool_t trigx = kFALSE;
737 iXdevOn += iXdev & 0x0F;
738 sign += (iXdev >> 4) & 0x01;
750 iXdevOff = - iXdevOn + 15; // gives range 0-14
752 iXdevOff = + iXdevOn + 15; // gives range 16-30 !
757 // iYtri == 1 means no trigger in y-direction
758 if (iYtri == 0 && trigx)
760 lut.GetLutOutput(localBoardId,iXpos,iXdev,iYpos,lutLpt,lutHpt);
768 buffer[bc] += lutHpt[1] << 7;
769 buffer[bc] += lutHpt[0] << 6;
770 buffer[bc] += lutLpt[1] << 5;
771 buffer[bc] += lutLpt[0] << 4;
774 buffer[bc] += lutHpt[1] << 3;
775 buffer[bc] += lutHpt[0] << 2;
776 buffer[bc] += lutLpt[1] << 1;
777 buffer[bc] += lutLpt[0] << 0;
781 fwrite(&buffer,bc,1,flut);
784 //_____________________________________________________________________________
786 AliMUONTriggerIO::LocalBoardId(Int_t index) const
788 /// Return the i-th localBoardId, or -1 if index is out of bounds
790 return fRegionalTrigger.LocalBoardId(index);
794 //______________________________________________________________________________
796 Int_t AliMUONTriggerIO::LocalBoardId(Int_t ddlId, Int_t crateId, Int_t localId) const
798 /// Return local board id from crate and local indexes.
801 TString name = AliMpTriggerCrate::GenerateName(crateId, ddlId, nofDDLs);
803 AliMpTriggerCrate* crate = fRegionalTrigger.FindTriggerCrate(name, false);
804 return crate->GetLocalBoardId(localId);