00001 // Mainpage for Doxygen 00002 00003 /** @mainpage package SCTPixelDAQ 00004 * 00005 * @section intro Introduction 00006 * RodCrate contains the classes for VME modules that reside in the ROD crate. 00007 * At present, these are RodModule for the ROD and TimModule for the TIM. 00008 * RodModule has a number of support classes, all of which begin with the 00009 * prefix "Rod" at the start of their name. 00010 * 00011 * In addition, these classes rely on the VmeInterface class, which is in a 00012 * sibling directory to RodCrate and which provide a C++ wrapper to the 00013 * ATLAS RCCVmeInterface C library. 00014 * 00015 * There are several sibling directories of header files that also are 00016 * referenced from RodCrate. 00017 * CommonWithDsp contains the C headers for definitions needed by both the 00018 * ROD Crate Controller and the ROD DSPs. 00019 * CommonForHosts contains C headers for definitions needed by the Linux and 00020 * Windows NT host programs. 00021 * Wrapper headers exist in RodCrate to hide some of the C syntax in these 00022 * files from the C++ code. 00023 * 00024 * Finally, a sibling directory named SlaveDspCode1 needs to exist and to contain 00025 * the four executable files needed by the slave DSPs. These four files are for 00026 * IPRAM, IDRAM, EMIF registers, and external code. 00027 * 00028 * A directory RodTests contains various main programs used to test the 00029 * functionality of RodModule and TimModule. 00030 * 00031 * @author RodModule: Tom Meyer, Iowa State University (meyer@iastate.edu) 00032 * @author TimModule: John Lane, University College London (jbl@hep.ucl.ac.uk) 00033 * 00034 *<hr> 00035 * @section notes Notes for current release 00036 * release.notes 00037 *<hr> 00038 * @todo Get true block VME operations working in mdspBlockRead/Write. 00039 * @todo Add structured exceptions 00040 * @todo Remove C-style casts - use polymorphic calls to VmeInterface 00041 * @todo Test flash memory access methods 00042 * @todo Have status() return an XML file 00043 * @todo Test text buffer wrap-around 00044 * @todo Test multiblock VME transfers in mdspBlockRead and mdspBlockWrite 00045 */