Difference: AMC13Tool (1 vs. 18)

• • 'r' is an optional flag to enable the 'TTCRx Commands' bit on register 'CONTROL1' (address 0x1)
  • 't' is an optional flag which causes the AMC13 to send TTC protocol out the TTS output

• e.g. 11_9_1:

• Address Tables are looked for in two locations: ${pwd} and ./map. If they are not found there, then the XDAQ_ROOT AMC13 Address Tables from the release are used.
• You can copy the executable to your ${HOME}/bin directory if you don't want to specify the path explicitly

• -h: get list of allowed command-line arguments
• -x: execute an AMC13Tool script file
• -u: disable the use of uHAL ControlHub
• -n: Manually set the AMC13 serial number (overriding the environment variable AMC13_SERIAL_NO)
• -s: Manutally set the AMC13 slot number
• -vi: Manually set the T1 IP address. If used, the Spartan IP address must be set manually as well
• -si: Manually set the T2 IP address. If used, the Kintex IP address must be set manually as well
• -i: Manually set the Spartan IP address to the one specified, and implicitly set the Kintex IP address to one LSB higher
• -va: Manually set the T1 Address table path. If used, the Spartan Address table path must be set manually as well
• -sa: Manually set the T2 Address table path. If used, the Kintex Address table path must be set manually as well

General Commands

• 'ps(v) (M)': program Spartan (Virtex) Flash, flash address 0x200000 (0x400000)
  • If 'M' is present, file selection rules will be bypassed and the user will be able to choose from a list of all MCS files in the current directory

• 'lst': displays the status of the SFP connections and DAQ Link

• 'de': enable DAQ link. This can be done from the receiver end only! However, it does enable both the LSC and LDC functionalities on either side of the DAQ Link
• 'dsv (e)/(d)': enable or disable the saveing received DAQ data to the monitor buffer. This can be done from the receiver end only!
  • '(e)' enables the saving of DAQ Link received data to the SDRAM buffer
  • '(d)' disabled the saving of DAQ Link received data to the SDRAM buffer

• 'lst': displays the status of the SFP connections

• 'tsp (o)/(b)/(r) <n>': set the spacing between periodic local L1A generation
  • 'o' specifies that the trigger spacing will be defined by orbit-number increments of <n>
  • 'b' specifies that the trigger spacing will be defined by bunch-crossing-number increments of <n>
  • 'r' specifies that the trigger spacing will be defined by random orbit-number increments around value <n>
  • '<n>' is the number of orbits/bunch-crossings/average-orbits between each periodically generated local L1A

• 'tre (o) (e)': reset internal TTC orbit number and/or event number
  • 'o' resets internal TTC orbit number
  • 'e' resets internal TTC event number

• 'de': enable DAQ link. This can be done from the receiver end only! However, it does enable both the LSC and LDC functionalities on either side of the SLINK
• 'dsv': save received DAQ data to the monitor buffer. This can be done from the receiver end only!

• • '<n>' is the number of orbits between each periodically generated local L1A

• 'lt <n>/(e)/(d)': send local L1As
  • '<n>' is the number of 'single'/random triggers to be sent
  • 'e' enables periodic local triggers
  • 'd' disables periodic local triggers
• 'tsp <n>': set the OrN spacing between periodic local L1A generation
  • '<n>'; is the number of orbits between each periodically generated local L1A
• 'mm (e)/(d)': enable mega monitor scaling. This saves only saves one in every 0x100000 events to the SDRAM buffer
  • 'e' enables mega monitor scaling
  • 'd' disables mega monitor scaling

• 'do <file>': execute an AMC13Tool command script

• AMC13Tool.exe

Using AMC13Tool

• e.g. 11_5_3:

     cd ${HOME}/src/11_5_3/hcal/hcalUpgrade/amc13
     source ~daqowner/dist/etc/env.sh
     source environ.sh
     ./bin/linux/x86_64_slc5/AMC13Tool.exe
     

Functionality

General

• 'do <file>': execute a AMC13Tool command script

• 'sh <command>': execute a shell <command>

• • '<ena_list>' is the comma/space/hyphen separated list of AMC inputs to be enabled (of ports 0-11)

• • e.g.

          Pick an action (h for menu): en 1,2 4-7 d t
          Enabling AMC inputs from list: 1, 2, 4, 5, 6, 7
          Link status: 000000f6
          Enable DAQ Link
          Enable TTCrx Commands
          'CONTROL1': 00140023
          

• • '<level>' is an optional numeric entry to set the detail of the display (0 least detailed, 2 most detailed, default to 1)
• 'rg': issues a reset to both Spartan and Virtex chips (by writing 0x1 to address 0x0 on both chips)

• • '<add>' is the address to be read. Can either be the numeric register address or the register name from the Address Table
  • '[count]' is the number of words to be read from the chip. The addresses are read incrementally starting from <add> (default to 1)

• • '[count]' is the number of addresses to be read from the block (default to 1)

• • '[count]' is the number of reads to be carried out at <add> (default to 1)

• • '<add>' is the starting address to be written to

• • '[count]' is the number of addresses to be written to incrementally from '=<add>'= (default to 1)

• • '[<data_list>]' is the comma/space/hyphen separated list of data to be written

• • '[<data_list>]' is the comma/space/hyphen separated list of data to be written

• • '<add>' is the address to be FIFO written to

• 'rk': display an unpacked, checked event. NOTE: this command doesn't do much yet

• • • careful: if you ^C out of a continuous read, then the data will not be written to a file. You must let the process finish. A better way to handle this is a coming attraction. For now, thoughtfully specify the number of events you want to read.

• • • if enabled, the program will produce standard output for every event written to the file (for meticulous debugging only)

• 'rf <add>': read one page (256 bytes) from Flash Memory

• Address Tables are looked for in two locations: ${pwd} and ./map. If they are not found there, then the XDAQ_ROOT AMC13 Address Tables are used, and these may not be up-to-date with the most current software (if one has update their source tree from CVS since the release)
• As of 11_5_3, the most current Tool lives at 11_5_3/hcal/hcalUpgrade/amc13/bin/linux/x86_64_slc5/AMC13Tool.exe

• 'q': quit program
• 'do <file>': execute a shell script
• 'sh <command>': execute a shell
• 'i <ena_list> (d) (f) (t) (b)': enable AMC13
  • '<ena_list>' is the list of AMC inputs to be enabled (of ports 0-11)
  • 'd' is an optional flag to enable the 'DAQLink' bit on register 'CONTROL1' (address 0x1)
  • 'f' is an optional flag to enable the 'Fake Data Generation' bit on register 'CONTROL1' (address 0x1)
  • 't' is an optional flag to enable the 'TTCRx Commands' bit on register 'CONTROL1' (address 0x1)
  • 'b' is an optional flag to enable the 'Stop EVB when Monitor Buffer Full' bit on register 'CONTROL1' (address 0x1)
  • NOTE: 'en' is a synonym to 'i'
• 'st <level>': displays the status of the AMC13 registers and counters
  • '<level>' is an optional numeric entry to set the detail of the display (0 least detailed, 2 most detailed)
• 'rg': sends a reset to both Spartan and Virtex chips by writing a 0x1 to their 'CONTROL0' regisers (address 0x0)
• 'rc': resets the counters on the Virtex chip
• 'rs(v) <add> [count]': read registers from the Spartan (Virtex) chip
  • '<add>' is the address to be read. Can either be the numeric register address or the register name from the Address Table
  • '[count]' is the number of words to be read from the chip. The addresses are read incrementally starting from

• 'brs(v) <add> [count]': block read Spartan (Virtex) chip
  • '<add>' is the starting address of the block read
  • '[count]' is the number of addresses to be read from the block
• 'frs(v) <add> [count]': FIFO read from the Spartan (Virtex) chip
  • '<add>' is the address to be FIFO read
  • '[count]' is the number of reads to be carried out at
• 'ws(v) <add> <data> [count]': write to Spartan (Virtex) chip
  • '<add>' is the address to be written to
  • '<data>' is the data to be written
  • '[count]' is the number of addresses to be read incrementally from '=<add>'=
• 'bws(v) <add> [<data_list>]': block write a data list to Spartan (Virtex)
  • '<add>' is the starting address of the block write
  • '[<data_list>]' is the comma/space separated list of data to be written
  • e.g.

          Pick an action (h for menu): bws CONTROL0 1 2 3
          Block writing to T2 from address 0x0 to address 0x2:
            00000000: 00000001
            00000001: 00000002
            00000002: 00000003
          

• 'qws(v) <add> [<data_list>]': queued write to Spartan (Virtex) chip
  • '<add>' is the starting address for the queued write
  • '[<data_list>]' is the comma/space separated list of data to be written
  • e.g.

          qws CONTROL0 1 2 3
          Queue writing to T2 from address 0x0 to address 0x2:
            00000000: 00000001
            00000001: 00000002
            00000002: 00000003
          

• 'fws(v) <add> [<data_list>]': FIFO write to Spartan (Virtex) chip
  • '<add>' is the address to FIFO written to
  • '[<data_list>]' is the comma/space separated list of data to be written
  • e.g.

          fws CONTROL0 1 2 3
          FIFO writing to T2 at address 0x0:
            00000000: 00000001 00000002 00000003
          

• 'nw': display number of words in the next event in the SDRAM buffer
• 'rd': display the data of the current event in the SDRAM buffer without advancing to the next event (without advancing the read pointer)
• 'rk': display a unpacked, checked event. NOTE: this command doesn't do much yet
• 'ne': advance to the next event in the buffer (advances the read pointer)
• 'df <file> (c) (r) (v) [count]': dump a given number of events to a file
  • '<file>' is the name of the file to which the data will be written [required]
  • '(c)' enables continuous reading [optional]
    • if enabled, the program waits for the next event when it reaches the end of the buffer (when there are no more events to be read out)
    • if disabled, the read finishes when the end of the buffer is reached
  • '(r)' enables reduced reading [optional]
    • if enabled, only the EvN, BcN, and OrN will be read, and they will be written to the file in a '.csv' format
    • if disabled, the entire event will be written to the file in a binary format
  • '(v)' enables verbose mode [optional]
    • if enabled, the program will produce standard output for every event written to the file (for minute debugging only)
    • if disabled, the program will produce standard output for every 1000 events written to the file (recommended)
  • '[count]' is the number of events to read out [optional]
    • if not specified...
      • if 'c' is enabled, 1,000,000 events will be read out by default
      • if 'c' is not enabled, 2048 events (the size of the buffer) will be read out be default
• 'dft <file> (r)' send a given number of triggers and reads them to a file [Boston University ONLY]
  • '<file>' is the name of the file to which the data will be written [required]
  • '(r)' enables reduced reading [optional]
    • if enabled, only the EvN, BcN, and OrN will be read, and they will be written to the file in a '.csv' format
    • if disabled, the entire event will be written to the file in a binary format
• 'fv': display both Virtex and Spartan firmware versions
• 'rf <add>': read page (256 bytes) from Flash Memory
  • '<add>' is the flash address from which to read
• 'vfh': verify Flash Header, flash address 0x000000
• 'vbs': verify Golden Flash, flash address 0x100000
• 'vs(v)': verify Spartan (Virtex) Flash, flash address 0x200000 (0x400000)
• 'pfh': program flash header, flash address 0x00000
• 'pbs': program Golden Flash, flash address 0x100000
• 'ps(v)': program Spartan (Virtex) Flash, flash address 0x200000 (0x400000)
• 'L': load Spartan and Virtex chips from Flash Memory
• 'ipadd <ip_addr>': add IP device to list of IP devices (which is initially empty). List of devices starts at 0!
  • '<ip_addr>' is the ip address of the device to be added
• 'ipr <n> <addr>': read from an IP device
  • '<n>' is the device number in the list of IP devices created by 'ipadd'. List of devices starts at 0!
  • '<addr>' is the address to be read from the specified IP device
• 'ipw <n> <addr> <data>': write to an IP device
  • '<n>' is the device number in the list of IP devices created by 'ipadd'. List of devices starts at 0!
  • '<addr>' is the address to be written to on the specified IP device
  • '<data>' is the data to be written
• 'ipst': display the status of all uHTRs whose IP addresses are have been added via 'ipadd'

    Pick an action (h for menu): fv
    Virtex Firmware Version: 0x17
    Spartan Firmware Version: 0xb

    Pick an action (h for menu): fv
    Virtex Firmware Version: 0x17
    Spartan Firmware Version: 0xb

*=q=

quit program *=do =: execute a shell script *=sh =: execute a shell *=i (d) (f) (t) (b)=: enable AMC13 *== is the list of AMC inputs to be enabled (of ports 0-11) *'=d=' is an optional flag to enable the 'DAQLink' bit on register 'CONTROL1' (address 0x1) *'=f=' is an optional flag to enable the 'Fake Data Generation' bit on register 'CONTROL1' (address 0x1) *'=t=' is an optional flag to enable the 'TTCRx Commands' bit on register 'CONTROL1' (address 0x1) *'=b=' is an optional flag to enable the 'Stop EVB when Monitor Buffer Full' bit on register 'CONTROL1' (address 0x1)

*NOTE

'=en=' is a synonym to '=i=' *=st =: displays the status of the AMC13 registers and counters *== is an optional numeric entry to set the detail of the display (0 least detailed, 2 most detailed)

*=rg=

sends a reset to both Spartan and Virtex chips by writing a 0x1 to their 'CONTROL0' regisers (address 0x0)

*=rc=

resets the counters on the Virtex chip *=rs(v) [count]=: read registers from the Spartan (Virtex) chip *== is the address to be read. Can either be the numeric register address or the register name from the Address Table *=[count]= is the number of words to be read from the chip. The addresses are read incrementally starting from *e.g.

      Pick an action (h for menu): rv 0x0 10
      Reading T1 from address 0x0 to address 0x9:
        00000000: 0300004b
        00000001: 00170001
        00000002: 00000000
        00000003: 04100410
        00000004: 12340111
        00000005: 0be90000
        00000006: 00000018
        00000007: 00000000
        00000008: 00000000
        00000009: 0d800d80
      

*=brs(v) [count]=: block read Spartan (Virtex) chip *== is the starting address of the block read *=[count]= is the number of addresses to be read from the block *=frs(v) [count]=: FIFO read from the Spartan (Virtex) chip *== is the address to be FIFO read *=[count]= is the number of reads to be carried out at *=ws(v) [count]=: write to Spartan (Virtex) chip *== is the address to be written to *= is the data to be written to *=[count]= is the number of addresses to be read incrementally from

• ssh cmsusr0
• ssh hcaldaq12 (use bash shell and .bashrc to set enironment)
• AMC13Tool.exe
• fv
  • spartan firmware version = 6
  • virtex firmware version = 3

Using the tool at Boston University:

• ssh daq@cms2
• cd amc13
• source hcalupgrade.csh (using tcsh shell)
• ./bin/linux/x86_64_slc5/AMC13Tool.exe
• fv
  • spartan firmware version = 6
  • virtex firmware version = 3

-- JimRohlf - 26 May 2012