The AMC13 MMC software package can be found in the amc13config directory in the xDAQ release or Standalone Release. This package provides the ability to store configuration information into non-volatile EEPROM memory for each SPI port, to enable automatic configuration of each AMC13 tongue from these stored bytes upon a request from each tongue's FPGA, and to issue useful commands remotely such as resets and handle swaps. This page discusses the functionality and capabilities of the MMC software scripts.

amc13config

This script is used for configuring the AMC13 FPGAs using the MMC. The script is to be run as follows:

./amc13config --host=192.168.1.240 [--slot=13] [--user=root] [--pass=admin] [--enable|--disable] [--store=config.txt] [--apply=config.txt] [--autoslot]

All flags that are in brackets are optional and all values listed are the default values if not explicitly specified. The command-line flags are listed and described in the following table.

Flag	Description
--host	Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module
--slot	Slot number (as seen on the uTCA crate, ie one-based) of AMC13 to be configured. If not specified, this option defaults to '13'
--user	Specify the OS user for your MCH1 device. If not specified, this option defaults to 'root'. This flag shouldn't typically need to be set
--pass	Passcode for access to the aforementioned user on the MCH OS. If not specified, this option defaults to 'root'. This flag shouldn't typically need to be set
--enable	Enable the automatic configuration of the AMC13 FPGAs from the bytes stored in its respective SPI port's EEPROM
--disable	Disables the automatic configuration of the AMC13 FPGAs from the bytes stored in its respecive SPI port's EEPROM
--store=file.conf	Store the configuration contents of file.conf to MMC EEPROM. See below for further information on this file's layout
--apply=file.conf	Apply the configuration contents of file.conf to FPGAs directly. This command will only work if the chips are requesting information from the MMC, which is typically not the case following startup, since the FPGAs will configure from the T2 jumpers if no packets are received from the SPI ports
--autoslot	Automatically replaces the first byte of the configuration packet with the AMC13's slot number in the uTCA crate. Note that in order for this command to work, you must carry around the byte to be replaced in the configuration file, even if it is just 00. See below for more information regarding the format of the configuration file

backend_power

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 ip_addr on|off [ipmb_addr=0xa4]

All flags that are in brackets are optional and all values listed are the default values if not explicitly specified. The command-line flags are listed and described in the following table.

Flag	Description
ip_addr	Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module
on	Turn back-end power on
off	Turn back-end power off
ipmb_addr	IPMB Address for the target AMC13. Default value is 0xa4 for an AMC13 in slot 13. See below for more information regarding IPMB addresses

cold_reset

This script is used to issue a cold reset remotely to an AMC13. The script is to be run as follows:

./cold_reset ip_addr [fru=30]

All flags that are in brackets are optional and all values listed are the default values if not explicitly specified. The command-line flags are listed and described in the following table.

Flag	Description
ip_addr	Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module
FRU	Field Replaceable Unit number. Default value is 30 for an AMC13 in slot 13. See below for more information regarding FRU numbering

handle_override

This script is used to issue a handle swap remotely to the AMC13. The script is to be run as follows:

./handle_override ip_addr in|out|cycle|release [ipmb_addr]

Flag	Description
ip_addr	Host IP address for your uTCA crate. This should be the IP address of your commercial MCH1 module
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
ipmb_addr	IPMB Address for the target AMC13. Default value is 0xa4 for an AMC13 in slot 13. See below for more information regarding IPMB addresses

IPMB Address Assignment and FRU Numbers

• IPMB Addresses are assigned like so:
  • For slot 13, IPMB is 0xa4
  • For any other slot in the uTCA crate, IPMB is 0x70+(2*slotNum)
• FRU Numbers are assigned like so:
  • For slot 13, FRU is 30
  • For any other slot in the uTCA crate, FRU is (slotNum + 4)

-- CharlieHill - 08 May 2013