Difference: AMC13Tool2 (8 vs. 9)

Revision 911 Feb 2015 - EricHazen

Line: 1 to 1
 
META TOPICPARENT name="AMC13CppProductionSoftware"
AMC13Tool2 is a command-line utility designed to exercise all functions of the AMC13. The tool can be run in either interactive or scripted mode.
Line: 193 to 193
 
burst number of triggers per burst in single-burst mode
rate number of orbits or BX between triggers or random rate in Hz units
Added:
>
>

setOcrCommand (set orbit count reset TTC command)

Specify the TTC command to use for orbit count reset. Note that the low two bits must be zero as they have predefined meanings (bit 0=BcR; bit 1=EcR)

setOrbitGap <start> <end> (set orbit gap for local triggers)

Triggers generated by the local L1A generator will not occur in this range of BCN.

<start> must be in the range 0-3562

<end> must be in the range 1-3563

prescale <mode> <factor> (set local event capture mode/prescale)

This command sets the parameters for capture of selected events in the SDRAM buffer for readout over IPBus using the commands re and df or other means.

    mode:  0 for simple prescale (record every n events, n from 1...0x10000)
           1 to match EvN with n low bits =0 where n from 5..20
  factor:  if mode=0, 1...0x10000
           if mode=1, 5..20
 
lt <mode/count> (Enable/disable local L1A generator)

If <mode/count> is an integer, send that many bursts of triggers

Line: 210 to 237
 enabled (e.g. lt 5 would generate 5 bursts) but it does not start to run continuously unless you enter lt e. To stop continuous triggers, enter lt d.
Deleted:
<
<
 prescale            :   set prescale mode and factor
                          Usage:
                          prescale  
                            mode:  0 for simple prescale (record every n events, n from 1...0x10000)
                                   1 to match EvN with n low bits =0 where n from 5..20
                          factor:  if mode=0, 1...0x10000
                                   if mode=1, 5..20
 lt                  :   Send/enable/disable local triggers
                           lt     send  local trigger (bursts) in software loop
                           lt e        enable trigger generator
                           lt d        disable trigger generator
                           lt c        enable continuous mode (configure with localL1A)

 
rg (general reset)

Reset most AMC13 logic. For firmwares before 0x20f/0x4006 this resets DAQ links too. After this version, use 'rd' to reset DAQ separately

Line: 238 to 249
  DAQ Link reset (firmware 0x20f/0x4006 and above)
Added:
>
>
start (Enable run mode)
stop (Disable run mode)

nodes {T1|T2} <regex> (list address table nodes)

This traverses the IPBus address table for either T1 or T2 board and displays all items matching the specified regular expression. The regular expression format is rather simple; '*' matches any string. For example:

>nodes t1 *ttc*error*
9 nodes matched
    0: STATUS.TTC.BCNT_ERROR                                        (addr=00000000 mask=00000040)  r
    1: STATUS.TTC.BCNT_ERRORS_HI                                    (addr=00000045 mask=0000ffff)  r
    2: STATUS.TTC.BCNT_ERRORS_LO                                    (addr=00000044 mask=ffffffff)  r
    3: STATUS.TTC.MULT_BIT_ERROR                                    (addr=00000000 mask=00000100)  r
    4: STATUS.TTC.MULT_BIT_ERRORS_HI                                (addr=00000043 mask=0000ffff)  r
    5: STATUS.TTC.MULT_BIT_ERRORS_LO                                (addr=00000042 mask=ffffffff)  r
    6: STATUS.TTC.SGL_BIT_ERROR                                     (addr=00000000 mask=00000080)  r
    7: STATUS.TTC.SGL_BIT_ERRORS_HI                                 (addr=00000041 mask=0000ffff)  r
    8: STATUS.TTC.SGL_BIT_ERRORS_LO                                 (addr=00000040 mask=ffffffff)  r
>

re <all> (read/display event from SDRAM)

This command will read the next event from the SDRAM and display the first 10 words and last 5 words of the event. If the argument all is given, the entire event is displayed. The read pointer is advanced to the next event.

rev (read/display event using new vector interface)

This command is equivalent to re except that it uses (tests) the new vector-based function to read events.

df <file> <count> (read events to file)

This command reads events from the SDRAM buffer and writes them to a binary file. The file argument specifies the file to write. The count argument specifies the number of events (default is 1).

The file format is defined as a list of 64-bit words in little-endian byte order as follows. See AMC13CommonFirmwareProposal for detailed description of AMC13 payload format.

  badc0ffeebadcafe   magic number present at start of each event
  cccccccccccccccc   size of event in 64-bit words
  510000781f412308   CMS common data format header
  104101401a540110   AMC13 header, specifying 4 AMCs
  0f00040300010000
    ...
  c62b8d9c000781f4   AMC13 trailer with CRC
  a0001014c3590000   CMS command data format trailer

ttc <options> (control TTC history capture)

Usage:
   ttc h on                 - ttc history enable
   ttc h off                - ttc history disable
   ttc h clr                - ttc history clear
   ttc h d             - ttc history display  items or all
   ttc f on                 - ttc filter enable
   ttc f off                - ttc filter disable
   ttc f clr                - ttc filter clear
   ttc f s    - set TTC filter list item
            is item 0-15 to set
             is value to match for filtering commands
            is bits to ignore when filtering commands
   ttc f list               - list currently-defined filters
   ttc f ena             - enable specific filter by number
   ttc f dis             - disable specific filter by number

For example:

[hazen@cms4 amc13]$ AMC13Tool2.exe -c 192.168.1.176
  ...
>en 1-4 f t
parsed list "1-4" as mask 0xf
Enabling fake data
Enabling TTS as TTC for loop-back
AMC13 out of run mode
AMC13 is back in run mode and ready
>ttc h on                         (turn on TTC history)
>ttc h d 5                        (display 5 commands)
History buffer has 512 entries
NOTE:  TTC history capture disabled before readout
    Cmd --Orbit- BcN --EvN-
  0: 01 0003cf4e dea 000001       (these are all Bc0 and uninteresting)
  1: 01 0003cf4f dea 000001
  2: 01 0003cf50 dea 000001
  3: 01 0003cf51 dea 000001
  4: 01 0003cf52 dea 000001
>ttc f s 0 0x01 0xfe              (set filter item 0 to 0x01 with mask 0xfe)
>ttc f on                         (turn on filtering)
>ttc h clr                        (clear the history)
>ttc h on                         (turn history back on)
>ttc h d 5                        (display 5 entries)
History buffer has 0 entries
>ttc h on                         (turn history back on)
>wv ACTION.LOCAL_TRIG.SEND_OCR    (send OcR command)
>wv ACTION.LOCAL_TRIG.SEND_OCR    (twice for fun)
>ttc h d 5                        (display 5 entries)
History buffer has 2 entries
NOTE:  TTC history capture disabled before readout
    Cmd --Orbit- BcN --EvN-
  0: 28 00021c6b a17 000001
  1: 28 000203d5 b65 000001
>ttc f list                       (list the items being filtered)
Item Ena CMD Mask
   0 On   01 fe
   1 Off  00 00
     ...
  15 Off  00 00
>
 

Deleted:
<
<
start : Enable run mode stop : Disable run mode nodes : List address table nodes -- list {T1|T2} re : Read next event from SDRAM df : Read events and write to binary file -- df file [count] printFlash : print flash data for testing only verifyFlash : verify flash data from file -- verifyFlash file address programFlash : program flash data from file -- programFlash file address reconfigureFPGAs : reconfigure FPGAs from flash verifyFlashFile : verify flash data from file -- verifyFlash file programFlashFile : program flash data from file -- programFlash file selectFileTest : test function for MCS file parsing -- selectFileTest file
  vfh : verify flash header -- vfh OR vfh vbs : verify flash golden -- vbs OR vbs vs : verify flash spartan -- vs OR vs
Line: 259 to 381
  pbs : program flash golden -- pbs OR pbs ps : program flash spartan -- ps OR ps pv (pk) : program flash virtex/kintex -- pv OR pv
Deleted:
<
<
devstatus (dst) : Display AMC13 Status usage: status level from 1..9 with 1 being least verbose debug if present enables lots of debug output for Eric
  status (st) : Display AMC13 Status usage: status table_name
Line: 276 to 393
  table_name limits the display to the table named openStatusFile : Open a text file to stream status info to closeStatusFile : Close the text file
Added:
>
>

printFlash : print flash data for testing only verifyFlash : verify flash data from file -- verifyFlash file address programFlash : program flash data from file -- programFlash file address reconfigureFPGAs : reconfigure FPGAs from flash verifyFlashFile : verify flash data from file -- verifyFlash file programFlashFile : program flash data from file -- programFlash file selectFileTest : test function for MCS file parsing -- selectFileTest file
 

-- EricHazen - 18 Oct 2014 \ No newline at end of file

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback