Namespaces
	architecture

	packer

Data Structures
class	PrimitiveStructure
	Encapsulation of the site index, pin name, and pin flags for a package. More...

class	Unpacker

class	Virtex2PrimitiveStructure
	Subclass of PrimitiveStructure for Virtex2 and Virtex2P. More...

class	Virtex5PrimitiveStructure
	Subclass of PrimitiveStructure for Virtex5. More...

class	Virtex7PrimitiveStructure
	Subclass of PrimitiveStructure for Virtex7. More...

Typedefs
typedef boost::shared_ptr < PrimitiveStructure >	PrimitiveStructureSharedPtr
	Shared pointer encapsulation of a PrimitiveStructure. More...

Enumerations
enum	ELogicType { eLogicTypeUnknown = 0, eLogicTypeLUT, eLogicTypeFlop, eLogicTypeInv, eLogicTypeAnd, eLogicTypeXor, eLogicTypeMux, eLogicTypeCount }
	Enumeration of logic types. More...

Functions
	BOOST_AUTO_TEST_CASE (PrimitiveStructureUnitTest)
	Unit test for the PrimitiveStructure class. More...

	BOOST_AUTO_TEST_CASE (PrimitiveStructureInstancePinsUnitTest)
	Unit test for the PrimitiveStructure class. More...

	BOOST_AUTO_TEST_CASE (UnpackerUnitTest)
	Unit test for the PrimitiveStructure class. More...

	BOOST_AUTO_TEST_CASE (Virtex2PrimitiveStructureUnitTest)
	Unit test for the Virtex2PrimitiveStructure class. More...

	BOOST_AUTO_TEST_CASE (Virtex5PrimitiveStructureUnitTest)
	Unit test for the Virtex5PrimitiveStructure class. More...

	BOOST_AUTO_TEST_CASE (Virtex7PrimitiveStructureUnitTest)
	Unit test for the Virtex7PrimitiveStructure class. More...

Variables
const std::string	cSliceTypeName = "SLICE"
	The type name of slice primitives. More...

const std::string	cByInvOutUsedElementName = "BYINVOUTUSED"
	The name of the BYINVOUTUSED slice element. More...

const std::string	cSliceLTypeName = "SLICEL"
	The type name of slice primitives. More...

const std::string	cSliceMTypeName = "SLICEM"

Typedef Documentation

typedef boost::shared_ptr<PrimitiveStructure> torc::packer::PrimitiveStructureSharedPtr

Shared pointer encapsulation of a PrimitiveStructure.

Definition at line 169 of file PrimitiveStructure.hpp.

Enumeration Type Documentation

enum torc::packer::ELogicType

Enumeration of logic types.

Enumerator
eLogicTypeUnknown
eLogicTypeLUT
eLogicTypeFlop
eLogicTypeInv
eLogicTypeAnd
eLogicTypeXor
eLogicTypeMux
eLogicTypeCount

Definition at line 38 of file PrimitiveStructure.hpp.

                     {
         eLogicTypeUnknown = 0, 
         eLogicTypeLUT, 
         eLogicTypeFlop, 
         eLogicTypeInv, 
         eLogicTypeAnd, 
         eLogicTypeXor, 
         eLogicTypeMux,
         eLogicTypeCount
     };

Function Documentation

torc::packer::BOOST_AUTO_TEST_CASE ( Virtex2PrimitiveStructureUnitTest )

Unit test for the Virtex2PrimitiveStructure class.

Definition at line 30 of file Virtex2PrimitiveStructureUnitTest.cpp.

                                                         {
 
     using namespace torc::architecture;
     // open and initialize a database
 //  DDB ddb("xc2vp4");
     DDB ddb("xc2v40");
     // look up the logic sites in the device
     const Sites& sites = ddb.getSites();
     // define a vector of PrimitiveStructure objects
     typedef std::map<std::string, PrimitiveStructureSharedPtr> PrimitiveStructuresSharedPtrMap;
     PrimitiveStructuresSharedPtrMap primitiveStructures;
     // look up the primitive def types
     typedef const Array<const PrimitiveDef> PrimitiveDefArray;
     PrimitiveDefArray& primitiveDefs = sites.getSiteTypes();
     PrimitiveDefArray::const_iterator p = primitiveDefs.begin();
     PrimitiveDefArray::const_iterator e = primitiveDefs.end();
     while(p < e) {
         // create a PrimitiveStructure object for this PrimitiveDef
         PrimitiveStructureSharedPtr primitiveStructurePtr(new Virtex2PrimitiveStructure(&*p++));
         const torc::architecture::PrimitiveDef* primitiveDefPtr 
             = primitiveStructurePtr->getPrimitiveDefPtr();
         const std::string& primitiveDefName = primitiveDefPtr->getName();
         // insert the PrimitiveStructure into the map
         primitiveStructures[primitiveDefName] = primitiveStructurePtr;
     }
 
     // iterate through the PrimitiveStructure entries in the map
     // (just to make sure we can read out what we put in)
     PrimitiveStructuresSharedPtrMap::iterator psp = primitiveStructures.begin();
     PrimitiveStructuresSharedPtrMap::iterator pse = primitiveStructures.end();
     while(psp != pse) {
         // look up the PrimitiveDef name and the PrimitiveStructure object
         std::string primitiveDefName = psp->first;
         PrimitiveStructureSharedPtr primitiveStructurePtr = psp->second;
         (void) primitiveStructurePtr;
         //const torc::architecture::PrimitiveDef* primitiveDefPtr 
         //  = primitiveStructurePtr->getPrimitiveDefPtr();
     //  std::cout << "PrimitiveDef: " << primitiveDefName << std::endl;
         psp++;
     }
 
 }

Here is the call graph for this function:

torc::packer::BOOST_AUTO_TEST_CASE ( Virtex5PrimitiveStructureUnitTest )

Unit test for the Virtex5PrimitiveStructure class.

Definition at line 30 of file Virtex5PrimitiveStructureUnitTest.cpp.

                                                         {
 
     using namespace torc::architecture;
     // open and initialize a database
 //  DDB ddb("xc2vp4");
     DDB ddb("xc5vlx30");
     // look up the logic sites in the device
     const Sites& sites = ddb.getSites();
     // define a vector of PrimitiveStructure objects
     typedef std::map<std::string, PrimitiveStructureSharedPtr> PrimitiveStructuresSharedPtrMap;
     PrimitiveStructuresSharedPtrMap primitiveStructures;
     // look up the primitive def types
     typedef const Array<const PrimitiveDef> PrimitiveDefArray;
     PrimitiveDefArray& primitiveDefs = sites.getSiteTypes();
     PrimitiveDefArray::const_iterator p = primitiveDefs.begin();
     PrimitiveDefArray::const_iterator e = primitiveDefs.end();
     while(p < e) {
         // create a PrimitiveStructure object for this PrimitiveDef
         PrimitiveStructureSharedPtr primitiveStructurePtr(new Virtex5PrimitiveStructure(&*p++));
         const torc::architecture::PrimitiveDef* primitiveDefPtr 
             = primitiveStructurePtr->getPrimitiveDefPtr();
         const std::string& primitiveDefName = primitiveDefPtr->getName();
         // insert the PrimitiveStructure into the map
         primitiveStructures[primitiveDefName] = primitiveStructurePtr;
     }
 
     // iterate through the PrimitiveStructure entries in the map
     // (just to make sure we can read out what we put in)
     PrimitiveStructuresSharedPtrMap::iterator psp = primitiveStructures.begin();
     PrimitiveStructuresSharedPtrMap::iterator pse = primitiveStructures.end();
     while(psp != pse) {
         // look up the PrimitiveDef name and the PrimitiveStructure object
         std::string primitiveDefName = psp->first;
         PrimitiveStructureSharedPtr primitiveStructurePtr = psp->second;
         (void) primitiveStructurePtr;
         //const torc::architecture::PrimitiveDef* primitiveDefPtr 
         //  = primitiveStructurePtr->getPrimitiveDefPtr();
     //  std::cout << "PrimitiveDef: " << primitiveDefName << std::endl;
         psp++;
     }
 
 }

Here is the call graph for this function:

torc::packer::BOOST_AUTO_TEST_CASE ( Virtex7PrimitiveStructureUnitTest )

Unit test for the Virtex7PrimitiveStructure class.

Definition at line 30 of file Virtex7PrimitiveStructureUnitTest.cpp.

                                                         {
 
     using namespace torc::architecture;
     // open and initialize a database
     DDB ddb("xc7a100t");
     // look up the logic sites in the device
     const Sites& sites = ddb.getSites();
     // define a vector of PrimitiveStructure objects
     typedef std::map<std::string, PrimitiveStructureSharedPtr> PrimitiveStructuresSharedPtrMap;
     PrimitiveStructuresSharedPtrMap primitiveStructures;
     // look up the primitive def types
     typedef const Array<const PrimitiveDef> PrimitiveDefArray;
     PrimitiveDefArray& primitiveDefs = sites.getSiteTypes();
     PrimitiveDefArray::const_iterator p = primitiveDefs.begin();
     PrimitiveDefArray::const_iterator e = primitiveDefs.end();
     while(p < e) {
         // create a PrimitiveStructure object for this PrimitiveDef
         PrimitiveStructureSharedPtr primitiveStructurePtr(new Virtex7PrimitiveStructure(&*p++));
         const torc::architecture::PrimitiveDef* primitiveDefPtr 
             = primitiveStructurePtr->getPrimitiveDefPtr();
         const std::string& primitiveDefName = primitiveDefPtr->getName();
         // insert the PrimitiveStructure into the map
         primitiveStructures[primitiveDefName] = primitiveStructurePtr;
     }
 
     // iterate through the PrimitiveStructure entries in the map
     // (just to make sure we can read out what we put in)
     PrimitiveStructuresSharedPtrMap::iterator psp = primitiveStructures.begin();
     PrimitiveStructuresSharedPtrMap::iterator pse = primitiveStructures.end();
     while(psp != pse) {
         // look up the PrimitiveDef name and the PrimitiveStructure object
         std::string primitiveDefName = psp->first;
         PrimitiveStructureSharedPtr primitiveStructurePtr = psp->second;
         (void) primitiveStructurePtr;
         //const torc::architecture::PrimitiveDef* primitiveDefPtr 
         //  = primitiveStructurePtr->getPrimitiveDefPtr();
     //  std::cout << "PrimitiveDef: " << primitiveDefName << std::endl;
         psp++;
     }
 
 }

Here is the call graph for this function:

torc::packer::BOOST_AUTO_TEST_CASE ( PrimitiveStructureUnitTest )

Unit test for the PrimitiveStructure class.

Definition at line 35 of file PrimitiveStructureUnitTest.cpp.

                                                  {
 
     using namespace torc::architecture;
     // open and initialize a database
 //  DDB ddb("xc7v285t");
 //  DDB ddb("xc6vlx75t");
     DDB ddb("xc5vlx30");
 //  DDB ddb("xc4vlx15");
 //  DDB ddb("xc2vp4");
 //  DDB ddb("xc2v40");
 //  DDB ddb("xcv50e");
 //  DDB ddb("xcv50");
     // look up the logic sites in the device
     const Sites& sites = ddb.getSites();
     // define a vector of PrimitiveStructure objects
     typedef std::map<std::string, PrimitiveStructureSharedPtr> PrimitiveStructuresSharedPtrMap;
     PrimitiveStructuresSharedPtrMap primitiveStructures;
     // look up the primitive def types
     typedef const Array<const PrimitiveDef> PrimitiveDefArray;
     PrimitiveDefArray& primitiveDefs = sites.getSiteTypes();
     PrimitiveDefArray::const_iterator p = primitiveDefs.begin();
     PrimitiveDefArray::const_iterator e = primitiveDefs.end();
     while(p < e) {
         // create a PrimitiveStructure object for this PrimitiveDef
         PrimitiveStructureSharedPtr primitiveStructurePtr(new PrimitiveStructure(&*p++));
         const torc::architecture::PrimitiveDef* primitiveDefPtr 
             = primitiveStructurePtr->getPrimitiveDefPtr();
         const std::string& primitiveDefName = primitiveDefPtr->getName();
         // insert the PrimitiveStructure into the map
         primitiveStructures[primitiveDefName] = primitiveStructurePtr;
     }
 
     // iterate through the PrimitiveStructure entries in the map
     // (just to make sure we can read out what we put in)
     PrimitiveStructuresSharedPtrMap::iterator psp = primitiveStructures.begin();
     PrimitiveStructuresSharedPtrMap::iterator pse = primitiveStructures.end();
     while(psp != pse) {
         // look up the PrimitiveDef name and the PrimitiveStructure object
         std::string primitiveDefName = psp->first;
         PrimitiveStructureSharedPtr primitiveStructurePtr = psp->second;
         (void) primitiveStructurePtr;
         // const torc::architecture::PrimitiveDef* primitiveDefPtr 
         //  = primitiveStructurePtr->getPrimitiveDefPtr();
         // std::cout << "PrimitiveDef: " << primitiveDefName << std::endl;
         psp++;
     }
 
 }

Here is the call graph for this function:

torc::packer::BOOST_AUTO_TEST_CASE ( UnpackerUnitTest )

Unit test for the PrimitiveStructure class.

Definition at line 39 of file UnpackerUnitTest.cpp.

                                        {
 
     std::string xdls[] = {
         "torc/router/TraceRegressionTest.Virtex5.xdl", 
         "", 
         "torc/router/PathFinderRouter/PathFinderRegression.Virtex5.Test1.xdl",
         "regression/PathFinderRegression.Virtex5.Test1.xdl", 
         "system.xdl",
         "regression/cae_fpga_routed.xdl",       
         "regression/counter.xdl", 
         "regression/DesignUnitTest.reference.xdl", 
         "regression/PathFinderRegression.Virtex5.Test1.xdl", 
         "regression/TraceRegressionTest.Virtex5.xdl", 
         "regression/TraceRegressionTest.VirtexTbuf.xdl", 
         "regression/TraceVirtex5Test.xdl", 
         "regression/Virtex5UnitTest.reference.xdl", 
         "regression/a.xdl", 
         "regression/audio_test.xdl", 
         "regression/bitstreamTest.xdl", 
         "regression/blinker.xdl", 
         "regression/collatz1.xdl", 
         "regression/config_with_trailing_embedded_newline.xdl", 
         "regression/counter.xdl", 
         "regression/fullroutetest3_noio.xdl", 
         "regression/hardnets.xdl", 
         "regression/input.xdl", 
         "regression/loop154@24816_1_test0.xdl", 
         "regression/loop154@24816_1_test1.xdl", 
         "regression/minimips.xdl", 
         "regression/neil.xdl", 
         "regression/path276@24816_16.xdl", 
         "regression/pathfindertest1.xdl", 
         "regression/pathfindertest1_constrained.xdl", 
         "regression/pathfindertest1_onenet.xdl", 
         "regression/pathfindertest2.xdl", 
         "regression/powerandglobal.xdl", 
         "regression/prng_v0.xdl", 
         "regression/rfft.par.xdl", 
         "regression/routingtest1.xdl", 
         "regression/test.xdl", 
         "regression/test_noroute.xdl", 
         "regression/testsys_nopips.xdl", 
 //      "regression/testsystem.xdl", 
         "regression/top_map.xdl", 
         "regression/twonet.xdl", 
 //      "regression/xc5vlx30ff676-1.xdl", 
 //      "regression/xc5vlx330tff1738-1.xdl", 
         "regression/xc5vlx50ff676_base_io_single_test.xdl", 
         ""
     };
 
     // create the appropriate file paths
     boost::filesystem::path referencePath = torc::common::DirectoryTree::getExecutablePath()
         / "torc" / "router" / "PathFinderRouter" / "PathFinderRegression.Virtex5.Test1.xdl";
     boost::filesystem::path generatedPath = torc::common::DirectoryTree::getExecutablePath()
         / "regression" / "UnpackerUnitTest.xdl";
 std::cout << referencePath << std::endl;
 
     for(int i = 0; xdls[i].size(); i++) {
         referencePath = xdls[i];
         std::cerr << "Unpacking " << referencePath << std::endl;
 
         // import the XDL design
         std::fstream fileStream(referencePath.string().c_str());
         BOOST_REQUIRE(fileStream.good());
         torc::architecture::XdlImporter importer;
         importer(fileStream, referencePath.string());
 
         // look up the design
         torc::physical::DesignSharedPtr mDesignPtr = importer.getDesignPtr();
         BOOST_REQUIRE(mDesignPtr.get() != 0);
         
         // invoking the unpacker 
         torc::packer::Unpacker unpacker(mDesignPtr);
         unpacker.unpack();       
 
         // export the XDL design
         std::fstream xdlExport(generatedPath.string().c_str(), std::ios_base::out);
         torc::physical::XdlExporter fileExporter(xdlExport);
         fileExporter(mDesignPtr);
     }
 
 }

Here is the call graph for this function:

torc::packer::BOOST_AUTO_TEST_CASE ( PrimitiveStructureInstancePinsUnitTest )

Unit test for the PrimitiveStructure class.

Definition at line 87 of file PrimitiveStructureUnitTest.cpp.

                                                              {
 
     using namespace torc::architecture;
     // create the appropriate file paths
     boost::filesystem::path referencePath = torc::common::DirectoryTree::getExecutablePath()
         / "torc" / "physical" / "DesignUnitTest.reference.xdl";
     boost::filesystem::path generatedPath = torc::common::DirectoryTree::getExecutablePath()
         / "regression" / "DesignUnitTest.generated.xdl";
 
     // import the XDL design
     std::fstream fileStream(referencePath.string().c_str());
     BOOST_REQUIRE(fileStream.good());
     XdlImporter importer;
     importer(fileStream, referencePath.string());
 
     // look up the design (and do something with it ...)
     torc::physical::DesignSharedPtr designPtr = importer.getDesignPtr();
     BOOST_REQUIRE(designPtr.get() != 0);
 
     // look up the device database (and do something with it ...)
     DDB* ddbPtr = importer.releaseDDBPtr();
 
     // look up the logic sites in the device
     const Sites& sites = ddbPtr->getSites();
     // define a vector of PrimitiveStructure objects
     typedef std::map<std::string, PrimitiveStructureSharedPtr> PrimitiveStructuresSharedPtrMap;
     PrimitiveStructuresSharedPtrMap primitiveStructures;
     // look up the primitive def types
     typedef const Array<const PrimitiveDef> PrimitiveDefArray;
     PrimitiveDefArray& primitiveDefs = sites.getSiteTypes();
     PrimitiveDefArray::const_iterator p = primitiveDefs.begin();
     PrimitiveDefArray::const_iterator e = primitiveDefs.end();
     while(p < e) {
         // create a PrimitiveStructure object for this PrimitiveDef
         PrimitiveStructureSharedPtr primitiveStructurePtr(new PrimitiveStructure(&*p++));
         const torc::architecture::PrimitiveDef* primitiveDefPtr 
             = primitiveStructurePtr->getPrimitiveDefPtr();
         const std::string& primitiveDefName = primitiveDefPtr->getName();
         // insert the PrimitiveStructure into the map
         primitiveStructures[primitiveDefName] = primitiveStructurePtr;
     }
 
     // look up a sample instance
     torc::physical::Circuit::InstanceSharedPtrIterator instancePtrIterator 
         = designPtr->findInstance("blink");
     if(instancePtrIterator == designPtr->instancesEnd()) return;
     torc::physical::InstanceSharedPtr instancePtr = *instancePtrIterator;
     PrimitiveStructureSharedPtr primitiveStructurePtr = primitiveStructures[instancePtr->getType()];
     const PrimitiveDef* primitiveDefPtr = primitiveStructurePtr->getPrimitiveDefPtr();
     if(primitiveDefPtr == 0) return; // this should not happen for valid instances
     const PrimitivePinArray& primitivePins = primitiveDefPtr->getPins();
 
     using torc::physical::InstancePinSharedPtr;
     using torc::physical::InstancePinSharedPtrVector;
     using torc::physical::Instance;
     using torc::physical::NetSharedPtr;
     using torc::architecture::xilinx::PinIndex;
 
     // iterate over the instance pins
     InstancePinSharedPtrVector inputPins;
     InstancePinSharedPtrVector outputPins;
     Instance::InstancePinSharedPtrConstIterator ipp = instancePtr->pinsBegin();
     Instance::InstancePinSharedPtrConstIterator ipe = instancePtr->pinsEnd();
     while(ipp != ipe) {
         // look up the instance pin
         InstancePinSharedPtr instancePinPtr = ipp++->second;
         const std::string& pinName = instancePinPtr->getPinName();
         NetSharedPtr netPtr = instancePinPtr->getParentWeakPtr().lock();
         std::cout << "    found " << pinName << " connected to net " << netPtr->getName() << ": ";
         // determine whether the pin is an output
         PinIndex pinIndex = primitiveDefPtr->findPinIndexByName(pinName);
         if(static_cast<boost::int32_t>(pinIndex) < 0) continue; // this shouldn't happen
         const PrimitivePin& primitivePin = primitivePins[pinIndex];
         if(primitivePin.isInput()) inputPins.push_back(instancePinPtr);
         if(primitivePin.isOutput()) outputPins.push_back(instancePinPtr);
         std::cout << (primitivePin.isInput() ? "INPUT" : (primitivePin.isOutput() ? "OUTPUT" : "")) 
             << std::endl;
     }
 
     // iterate over the input pins
     InstancePinSharedPtrVector::const_iterator ip;
     InstancePinSharedPtrVector::const_iterator ie;
     ip = inputPins.begin();
     ie = inputPins.end();
     while(ip != ie) {
         InstancePinSharedPtr instancePinPtr = *ip++;
         //std::cout << "    found INPUT " << instancePinPtr->getPinName() << std::endl;
     }
     // iterate over the output pins
     ip = outputPins.begin();
     ie = outputPins.end();
     while(ip != ie) {
         InstancePinSharedPtr instancePinPtr = *ip++;
         //std::cout << "    found OUTPUT " << instancePinPtr->getPinName() << std::endl;
     }
 
 }