BitfileMaker

• How To Make New Ucf Files
  • First step.
    1. Log in ajelec2.cern.ch.
    2. Boot the Cygwin to do your work.

• • Data Base File
    https://svnweb.cern.ch/trac/atlasoff/browser/Trigger/TrigT1/TrigT1TGC/trunk/share

• • "Data Base File" Converter
    This tool is "C:\SectorLogic\tool\Python\DataBaseFileConverter\dbconverter.py".
    1. Set directory path which has original .db files.
    2. Set directory path to put new .db files.
    3. Set log file path. (Please set to do not make something confusing)
    4. Confirm the logflag is True.
    5. Set pt threshold menu. if you write "pt1 = 2" , the dbconverter.py will change the Coincidence Window for pt1 to pt2.
    6. Set "chver" , dbconverter.py will make new file which name is RPhiCoincidenceMap.mod??.CHVER._??.db.
    7. Execute dbconverter.py like "python C:\SectorLogic\tool\Python\DataBaseFileConverter\dbconverter.py"
       And new db file will be put into "output directory".

• • Data Base File to UCF" Converter
    (https://svnweb.cern.ch/trac/atlasusr/browser/hayakawa/tool/BitFileTools/Java/DBtoUCFconverter)
    1. Log in ajelec2.cern.ch and go to "C:\SectorLogic\tool\Java\DBtoUCFconverter".
    2. Cange directory into latest version.
    3. Change directory into "class" directory.
    4. Open the "converter.py" and modify it.
       • db_path : please set .db file which you want to convert to ucf files.
       • bitver : Already this information was disabled in SL mainlogic.
       • ptX : Please do not change setting.
         If you want to change pt threshold menu , please use "dbconverter.py" and make adjusted .db file.
    5. Execute convert.py like "python convert.py".
    6. New ucf file will put into same directory of "db file directory"

• • XSVF maker
    1. Log in ajelec2.cern.ch and go to "C:\SectorLogic\tool\Python\xsvfMaker".
    2. Open the xsvfMaker.py using something editor.
    3. Modify some setting.
       • bitfiledir : set original bitfile directory.
       • mcsdir : set directory path to put new mcs files.
       • svfdir : set directory path to put new svf files.
       • xsvfdir : set directory path to put new xsvf files.
       • logfile : set file path to logfile.
    4. Execute the xsvfMaker.py like "python xsvfMaker.py"
    • XSVF maker makes mcs file at first step.
      After that XSVF maker makes svf and xsvf files using mcs files.
    • FOR EXPERTS
      1. If you reinstall xilinx ise.
         Please correct the path to "impact.exe". It is written in xsvfMaker.py :: LINE = ~25.
      2. Xsvf maker makes ".bat" files. It in same directory as "mcs" file.
         And xsvf maker execute bat files.

• How To Use (For experts)
  1. Compile the verilog files in "MainFactory" and "SL Endcap" or "SL Forward" written in setup file for BitfileMaker.
  2. Do $ BitfileMaker on cygwin terminal.
  3. Executing messages on cygwin will be into "Common Log File".
  4. More detailed messages will be into "Expert Log File".

• How To Setup the Enviroment (For SL experts)
  1. Install "ISE FULL PACKAGE" and "SYNPLIFY".
  2. Download the BitfileMaker from " https://svnweb.cern.ch/trac/atlasusr/browser/hayakawa/tool/BitFileTools/ "
     You should get "BitfileMaker.py" and "MakeBitfile.zip".
     
  3. Unzip the "MakeBitfile.zip" and modify some setup in BitfileMaker.py.
     Open the BitfileMaker.py using something editor.
     And modify the setting of "PathList0". It should be assigned PathList file.
     PathList example is
     " https://svnweb.cern.ch/trac/atlasusr/browser/hayakawa/tool/BitFileTools/Python/PathList.txt ".
  4. Make MainFactory directory for Endcap and Forward. BitfileMaker wil be work in it.
  5. You must correct the ".ise" file in endcap and forward main factory directory using
     
     • "SL Endcap" and "Ise Endcap".
       
     • "SL Forward" and "Ise Forward". "Bitfile Endcap" and "Bitfile Forward" are default bitfile name.
       They will be changed when the new bitfile moved to "Tmp Bit File" automatically.
  6. "ExePath" must be assigned to Xilinx execute file directory. (This enviroment is discribed in PathList.txt)
  7. And "compile exe files" should be assigned in setup file. (This enviroment is discribed in PathList.txt)
  8. Setup file in "C:\SectorLogic\tool\txt\PathList\test".
     The back up file will be made automatically.

• Usefull command for cygwin in ajelec2.cern.ch.
  • cdsl = cd C:/SectorLogic
  • cdSLtool = cd C:/SectorLogic/tool
  • cdSLpython = cd C:/SectorLogic/tool/Python
  • cdSLjava = cd C:/SectorLogic/tool/Java
  • cdSLtxt = cd C:/SectorLogic/tool/txt
  • open = open the current directory using explorer.

• Backup File
  • bitfile : ajelec2@C:/SectorLogic/MainFactory/tmp_bitfile/
  • path list :ajelec2@C:/SectorLogic/tool/txt/PathList/test
  • log file : :ajelec2@C:/SectorLogic/LogFile

-- TakashiHayakawa - 07-May-2010