Difference: AMC13Tool2 (8 vs. 9)

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

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
>