AMC13 MMC Software

The AMC13 MMC software package can be found in the amc13/dev_tools/amc13Config directory in the amc13 svn, amc13config directory in the xDAQ release or Standalone Release of the Legacy Software Package. This package is a collection of python scripts which provide the ability to store configuration information into non-volatile EEPROM memory for each SPI port, to apply directly configuration information to an AMC13 after power up, and to issue useful commands remotely such as resets and handle swaps.

WARNING about ipmitool version problems: IpmiToolVersions

NOTE!! Some of these scripts are use PERL scripts found in the config_tools directory

Contents
systemVars.py
readIPs.py
readNVmem.py
applyConfig.py
storeConfig.py
backendPower.py
coldReset.py
handleOverride.py
mmcVersion.py

systemVars.py

This Python module holds some important variables which, once set, probably won't need to be changed again (on a given system). This file conveniently makes it so that once properly adjusted, all default values for amc13Config script flags should be useful.
Variable Description
DEFAULT_HOST_IP The IP address for your commercial MCH module in the uTCA crate
DEFAULT_AMC13_SLOT The desired default slot value for your AMC13 (one-based, as listed on the front of the Vadatech uTCA crate)
DEFAULT_CONFIG_DIR The location of the PERL tools which are used for the MMC actions (this shouldn't ever need to be changed)
NETWORK_BASE The network base for all IP addresses in your uTCA crate

readIPs.py

This Python script is used to read out the IP address for each Tongue on the AMC13 using IPMI:
./readIPs.py (--host=<ip_addr>) (--slot=<n>)
All flags that are in parentheses are optional and and will take on their default values as listed in systemVars.py if not explicitly specified.
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be read from. If not specified, defaults to value in systemVars.py

readNVmem.py

This Python script is used to read out 40 bytes of non-volatile memory at an address specified by an NV area read
./readNVmem.py (--host=<ip_addr>) (--slot=<n>)
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be read from. If not specified, defaults to value in systemVars.py

applyConfig.py

This Python script is used to apply (not store) IP address to each Tongue on the AMC13:
./applyIPs.py (--host=<ip_addr>) (--slot=<n>) --spartan=<ip_addr> --virtex=<ip_addr>
Optionally, you can specify only one IP address instead of both, which will apply the provided IP to T2 while applying an IP whose final byte is one higher than the provided IP to T1. For example, the flag command would set the following IP addresses:
--ip=192.168.1.100
  Spartan: 192.168.1.100
  Virtex: 192.168.1.101
As yet another option, you can simply specify the serial number of your AMC13, which will apply IP addresses to both Tongues via the following scheme:
--serial=<SN>  
  Spartan: 192.168.1.(254-(2*SN))
  Virtex: 192.168.1.(255-(2*SN))
All flags in parentheses are optional and will take on their values as listed in systemVars.py if not explicitly specified.
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be configured. If not specified, defaults to value in systemVars.py
--spartan IP address to be assigned to T2
--virtex IP address to be assigned to T1
--ip IP address to be assigned to T2 with an IP address with the final byte one larger than the provided IP to be assigned to T1. This flag can only be used instead of (not in addition to) the --spartan and --virtex flags
--serial Assign the IP addresses of both Tongues using the provided serial number: T2 ~ 192.168.1.(254-(2*SN)), T1 ~ 192.168.1.(255-(2*SN))

storeConfig.py

This Python script is used to store (not apply) IP addresses in the MMC EEPROM for the configuration of both Tongues upon powerup (Please see below storeConfig.py Power-up Notes):
./storeConfig.py (--host=<ip_addr>) (--slot=<n>) --spartan=<ip_addr> --virtex=<ip_addr>
Optionally, you can specify only one IP address instead of both, which will store the provided IP for T2 while storing an IP whose final byte is one higher than the provided IP for T1. For example, the flag command would store the following IP addresses:
--ip=192.168.1.100
  Spartan: 192.168.1.100
  Virtex: 192.168.1.101
As yet another option, you can simply specify the serial number of your AMC13, which will store IP addresses for both Tongues via the following scheme:
--serial=<SN>  
  Spartan: 192.168.1.(254-(2*SN))
  Virtex: 192.168.1.(255-(2*SN))
All flags in parentheses are optional and will take on their values as listed in systemVars.py if not explicitly specified.
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be configured. If not specified, defaults to value in systemVars.py
--spartan IP address to be assigned to T2
--virtex IP address to be assigned to T1
--ip IP address to be assigned to T2 with an IP address with the final byte one larger than the provided IP to be assigned to T1. This flag can only be used instead of (not in addition to) the --spartan and --virtex flags
--serial Assign the IP addresses of both Tongues using the provided serial number: T2 ~ 192.168.1.(254-(2*SN)), T1 ~ 192.168.1.(255-(2*SN))

storeConfig.py Power-up Notes:

As of MMC version 2.1, the following is true:

IP address stored in non-volatile memory is applied if:

  1. Power cycle of entire crate
  2. Power cycle of board by physically removing the board and putting it back in
  3. Sending a 'mreset' command via console
IP address stored in non-volatile memory WILL NOT be applied for following:
  1. Power cycle of board by handle reset (pushing handle out and in)
  2. Power cycle via use of MMC software (coldReset.py, handleOverride.py, backendPower.py, etc.)
  3. Reconfiguration of FPGA via AMC13Tool or AMC13Tool2.
WARNING
With this second type of power cycle, the boards will actually revert to the IP address that was stored in the Non-volatile memory that last time the first type of power cycle was used. This can become extremely confusing, so as a rule, any time one stores a IP address in the non-volatile memory, one should do a power cycle of the first type (that actually applies the IP address in non-volatile memory).

NOTE: It takes several seconds after a power cycle for the IP address to finally be set to the correct value. If there are problems, use one of the above working power cycle methods and wait a full 15 seconds (much more than needed) to give it the full time to power up and then check the IP addresses.

NOTE: Upon power-up, it seems that the IP address cycles through various transiting values before settling on the IP address stored in non-volatile memory (if any). If one checks the IP address too soon after a power cycle, you may see an expected IP address for one or both chips. In order after power-cycle the IP address of the chips can step through several values: 1. IP address bits all 1's (ff.fff.ff.ff) 2. IP address set to SN default (regardless of whether something is in non-volatile memory or not) 3. IP address set to value indicated in non-volatile memory (if any) Typically this whole process takes only a few seconds, but you may encounter them.

backendPower.py

This script is used to enable and disable the back-end power remotely to the AMC13. The script is to be run as follows:
./backend_power (--host=<ip_addr>) (--slot=<n>) --enable|--disable
All flags in parentheses are optional and will take on their values as listed in systemVars.py if not explicitly specified.
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be powered. If not specified, defaults to value in systemVars.py
--enable Turn on the backend power
-disable Turn off the backend power

coldReset.py

This script is used to issue a cold reset remotely to an AMC13. The script is to be run as follows:
./cold_reset (--host=<ip_addr>) (--slot=<n>)
All flags in parentheses are optional and will take on their values as listed in systemVars.py if not explicitly specified.
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be reset. If not specified, defaults to value in systemVars.py

handleOverride.py

This script is used to issue a handle swap remotely to the AMC13. The script is to be run as follows:
./handle_override (--host=<ip_addr>) (--slot=<n>) --in|--out|--release|--cycle
All flags in parentheses are optional and will take on their values as listed in systemVars.py if not explicitly specified.
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be controlled. If not specified, defaults to value in systemVars.py
in Force handle in
out Force handle out
cycle Force handle out for 10 seconds and then issue a release
release Handle not forced, but instead the actual handle position is payed attention to

mmcVersion.py

This script is used to read out the MMC firmware version on a specified AMC13
./mmcVersion.py (--host=<ip_addr>) (--slot=<n>)
Flag Description
--host Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module. If not specified, defaults to value in systemVars.py
--slot Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be read from. If not specified, defaults to value in systemVars.py

-- CharlieHill - 08 May 2013

Edit | Attach | Watch | Print version | History: r13 < r12 < r11 < r10 < r9 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r13 - 11 May 2015 - DavidZou
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback