Line: 1 to 1 | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | The AMC13 register set (and associated uHAL address table) is complex. This page attempts (will attempt!) to document it. The address table files are used for access to the board in software, and also used to automatically control the display and format of status information in the text "status" command in AMC13Tool2 and the HyperDAQ display in xDAQ. | ||||||||||||||||||||||||
> > | The AMC13 register set (and associated uHAL address table) is complex. This page attempts (will attempt!) to document it. The address table files are used for access to the board in software, and also used to automatically control the display and format of status information in the text "status" command in AMC13Tool2 and the HyperDAQ display in xDAQ. | ||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | |||||||||||||||||||||||||
> > | |||||||||||||||||||||||||
Address Table Format | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | The master address table is kept as two CSV files, one for the T1 board and one for the T2 board.
Most registers of interest are on T1. The CSV files are here in SVN![]() AMCCounters.xml . | ||||||||||||||||||||||||
> > | The master address table is kept as two CSV files, one for the T1 board and one for the T2 board. Most registers of interest are on T1. The CSV files are here in SVN![]() | ||||||||||||||||||||||||
The CSV file has the following columns: | |||||||||||||||||||||||||
Line: 21 to 19 | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||
The P_Show parameter has several possible settings:
| |||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||
> > | If P_Repeat is present, it must be an integer count of the number of times this entry is to be repeated in the status display. An offset of 1 is assumed for subsequent entries unless a different address offset is specified with P_Offset. If P_Repeat is specified, either the P_Row or P_Column may have a trailing _d which will be replaced with the decimal value of the repeat counter. | ||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | If P_Repeat is present, it must be an integer count of the number of times this entry is to be repeated in the status display. An offset of 1 is assumed for subsequent entries unless a different address offset is specified with P_Offset. If P_Repeat is specified, either the P_Row or P_Column may have a trailing _d which will be replaced with the decimal value of the repeat counter. | ||||||||||||||||||||||||
> > | There are many 64-bit counters, which have otherwise identical ids ending in _LO and _HI. These should be treated as a single 64-bit value for purposes of display, if their Table, Row and Column parameters are identical. | ||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | There are many 64-bit counters, which have otherwise identical ids ending in _LO and _HI. These should be treated
as a single 64-bit value for purposes of display, if their Table, Row and Column parameters are identical.
The csv file is converted to XML by a perl script in the above directory named csv_to_xml.pl . | ||||||||||||||||||||||||
> > | The csv file is converted to XML by a perl script in the above directory named csv_to_xml.pl. | ||||||||||||||||||||||||
Updating the Address Table | |||||||||||||||||||||||||
Line: 74 to 58 | |||||||||||||||||||||||||
$ source env.sh # or possibly .csh $ make # possibly needed twice first time | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | (substitute your CERN user name for svnuser) | ||||||||||||||||||||||||
> > | (substitute your CERN user name for svnuser) | ||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | 1a. cd dev_tools/cfg/addrTableTools | ||||||||||||||||||||||||
> > | 1a. cd dev_tools/cfg/addrTableTools | ||||||||||||||||||||||||
2. Identify the file which needs to be changed. There are several "source" CSV-format files. To identify the version number currently in use see the Makefile![]() | |||||||||||||||||||||||||
Line: 85 to 68 | |||||||||||||||||||||||||
AMC13XG_T1_version.csv general Kintex/Virtex registers AMCCounters.csv counters for each AMC AMCLinks.csv link status for each AMC | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | AMC13XG_T2_version.csv general Spartan registers | ||||||||||||||||||||||||
> > | AMC13XG_T2_version.csv general Spartan registers | ||||||||||||||||||||||||
3. Edit the file using OpenOffice/LibreOffice spreadsheet (or in an emergency carefully use a text editor): | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | $ soffice FileToEdit.csv | ||||||||||||||||||||||||
> > | $ soffice FileToEdit.csv | ||||||||||||||||||||||||
In the "Text Import" dialog box be certain to check "Comma" in Separated by and "Quoted field as text". | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | ![]() | ||||||||||||||||||||||||
> > | ![]() | ||||||||||||||||||||||||
Edit the file, observing carefully the parameter use as documented at the top of this page. | |||||||||||||||||||||||||
Line: 109 to 90 | |||||||||||||||||||||||||
perl csv_expand_repeat.pl AMCLinks.csv temp.csv perl csv_to_xml.pl temp.csv ../../../amc13/etc/amc13/AMCLinks.xml Loaded 32 rows, 12 columns from temp.csv | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | $ | ||||||||||||||||||||||||
> > | $ This creates the files AMC13XG _T1.xml and AMC13XG _T2.xml in ...amc13/etc/amc13/. Some extra step(s) may be needed to correctly deploy these files in a production system. | ||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | This creates the files AMC13XG_T1.xml and AMC13XG_T2.xml in ...amc13/etc/amc13/ .
Some extra step(s) may be needed to correctly deploy these files in
a production system. | ||||||||||||||||||||||||
> > | Missing Permission Fix | ||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||
> > | When attempting to start AMC13 Tool, an error may arise where a permission is incorrectly set for a given register; either missing or set to read only. This can be fixed by following the above steps to edit the register in question (this may need to be done multiple times if more than one permission is missing. Only the first "bad" register will show up on each attempt to start the software). | ||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||
> > | If you do not know the correct level of permission for the register, examine the permission around it. It is likely that the correct setting will be the one that matches those above and below it. If you are still unsure, contact an expert before changing anything. | ||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||
> > | -- ![]() | ||||||||||||||||||||||||
-- EricHazen - 28 May 2015 \ No newline at end of file |