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