torc-master
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
torc::bitstream::VirtexBitstream Class Reference

Virtex-class bitstream. More...

#include <VirtexBitstream.hpp>

+ Inheritance diagram for torc::bitstream::VirtexBitstream:
+ Collaboration diagram for torc::bitstream::VirtexBitstream:

Public Types

enum  { eBlockTypeCount = 8 }
 The block type count is fixed at eight across all Xilinx architectures. More...
 
enum  EBitstreamType { eBitstreamTypeFull, eBitstreamTypePartialActive, eBitstreamTypePartialShutdown }
 The bitstream type to generate. Use eBitstreamFull to fully reconfigure a device, eBitstreamTypePartialActive to partially reconfigure it while it continues to run, or eBitstreamTypePartialShutdown to partially recongifure it after shutting it down. More...
 
enum  EFrameInclude { eFrameIncludeOnlyDirtyFrames, eFrameIncludeAllUsedFrames }
 The frames to include in a partial bitstream. Use eFrameIncludeOnlyDirtyFrames to include only dirty frames, or eFrameStateAllUsedFrames to include all allocated frames, dirty or not. Note that if not all frames were allocated, eFrameStateAllUsedFrames is not the same as a full bitstream. More...
 
typedef std::string string
 Imported type name. More...
 
typedef boost::uint8_t uint8_t
 Imported type name. More...
 
typedef boost::uint16_t uint16_t
 Imported type name. More...
 
typedef torc::common::EDevice EDevice
 Imported type name. More...
 
typedef std::map< std::string,
uint32_t
TileTypeNameToColumnType
 Mapping from tile type names to column types. More...
 
typedef std::map< uint16_t,
uint32_t
TileTypeIndexToColumnType
 Mapping from tile indexes to column types. More...
 
enum  EPacketType { ePacketType1 = 1, ePacketType2, ePacketTypeCount = 8 }
 Packet type enumeration. More...
 
enum  EOpcode {
  eOpcodeNOP = 0, eOpcodeRead, eOpcodeWrite, eOpcodeReserved,
  eOpcodeCount
}
 Packet opcode enumeration. More...
 
enum  EPacket {
  ePacketMaskType = 0xe0000000, ePacketShiftType = 29, ePacketMaskOpcode = 0x18000000, ePacketShiftOpcode = 27,
  ePacketMaskType1Address = 0x07ffe000, ePacketShiftType1Address = 13, ePacketMaskType1Reserved = 0x00001800, ePacketShiftType1Reserved = 11,
  ePacketMaskType1Count = 0x000007ff, ePacketShiftType1Count = 0, ePacketMaskType2Count = 0x07ffffff, ePacketShiftType2Count = 0
}
 Packet subfields. More...
 
enum  ESynchronization { eSynchronizationDummy = 0xffffffff, eSynchronizationSync = 0xaa995566, eSynchronizationBusWidthSync = 0x000000bb, eSynchronizationBusWidthDetect = 0x11220044 }
 Synchronization words. More...
 
typedef VirtexFrame frame_t
 FrameSet frame type. More...
 
typedef VirtexFrame::word_t word_t
 FrameSet word type. More...
 

Public Member Functions

 VirtexBitstream (void)
 Basic constructor. More...
 
virtual void readPackets (std::istream &inStream)
 Read bitstream packets from a stream. More...
 
virtual void writePackets (std::ostream &inStream)
 Write bitstream packets to a stream. More...
 
virtual void readFramePackets (void)
 Read frame data into the frame blocks structure. More...
 
virtual void updateFramePackets (EBitstreamType inBitstreamType=eBitstreamTypeFull, EFrameInclude inFrameInclusion=eFrameIncludeAllUsedFrames)
 Update the bitstream frame packets By default this updates the bitstream with full frame data. More...
 
virtual void generateBitstream (EBitstreamType inBitstreamType=eBitstreamTypeFull, EFrameInclude inFrameInclusion=eFrameIncludeAllUsedFrames)
 Discard existing packets and generate bitstream packets from frame data. By default this generates packets for a full bitstream. More...
 
virtual
VirtexPacketVector::iterator 
deleteFramePackets (void)
 Discard the existing frame packets and return an iterator to the start position. More...
 
virtual VirtexPacketVector generateFullBitstreamPackets (void)
 Return a packet vector with full frame data. More...
 
virtual VirtexPacketVector generateFullBitstreamPrefix (void)
 Return a packet vector with the full bitstream prefix. More...
 
virtual VirtexPacketVector generateFullBitstreamSuffix (void)
 Return a packet vector with the full bitstream suffix. More...
 
virtual VirtexPacketVector generatePartialBitstreamPackets (EFrameInclude inFrameInclusion)
 Return a packet vector with partial frame data. More...
 
virtual VirtexPacketVector generatePartialBitstreamPrefix (EBitstreamType inBitstreamType)
 Return a packet vector with the partial bitstream prefix. More...
 
virtual VirtexPacketVector generatePartialBitstreamSuffix (EBitstreamType inBitstreamType)
 Return a packet vector with the partial bitstream suffix. More...
 
virtual void preflightPackets (void)
 Preflight the packets. More...
 
virtual void updatePacketLength (void)
 Update the header packet length. More...
 
iterator insert (iterator position, const value_type &val)
 Regular std::vector inserter. More...
 
void insert (iterator position, size_type n, const value_type &val)
 Regular std::vector inserter. More...
 
template<class InputIterator >
void insert (iterator position, InputIterator first, InputIterator last)
 Regular std::vector inserter. More...
 
void insert (VirtexPacketVector::iterator inPosition, const VirtexPacketVector &inVector)
 Insert the contents of a packet vector at the specified position. More...
 
void append (const VirtexPacketVector &inVector)
 Append the contents of a packet vector to the end of the bitstream. More...
 
VirtexFrameBlocksgetFrameBlocks (void)
 Return the configuration frame blocks. More...
 
void write (std::ostream &inStream, uint8_t inVal)
 Write a uint8_t to the stream. More...
 
void write (std::ostream &inStream, uint16_t inVal)
 Write a uint16_t to the stream. More...
 
void write (std::ostream &inStream, uint32_t inVal)
 Write a uint32_t to the stream. More...
 
virtual void write (std::ostream &inStream)
 Write the bitstream header and packets to a stream. More...
 
void writeHeaderString (std::ostream &inStream, const string &inString)
 Write a Xilinx-style header string to the stream. More...
 
virtual void readHeader (std::istream &inStream)
 Read the bitstream header. More...
 
void cleanDateAndTime (void)
 Clean up the header date and time by replacing embedded spaces with zeros. More...
 
virtual void initializeDeviceInfo (const std::string &inDeviceName)
 Initialize the maps between frame indexes and frame addresses. This is generally only useful for internal purposes. More...
 
virtual void initializeFrameMaps (void)
 Initialize the maps between frame indexes and frame addresses. This is generally only useful for internal purposes. More...
 
virtual void writeDeviceInfo (std::ostream &inStream, const std::string &inDeviceName)
 Output static device information to a stream. More...
 
void setDeviceInfo (const DeviceInfo &rhs)
 Assign static device information for the current bitstream. More...
 
void setDevice (const std::string &inDeviceName)
 Assign the device enumeration constant for the given device name. More...
 
virtual void read (std::istream &inStream, bool inCleanDateAndTime=true)
 Read the bitstream header and packets from a stream. More...
 
virtual void writeHeader (std::ostream &inStream)
 Write the bitstream header to the stream. More...
 
void setDesignName (const string &inDesignName)
 Set the design name. More...
 
void setDeviceName (const string &inDeviceName)
 Set the device name. More...
 
void setDesignDate (const string &inDesignDate)
 Set the design date. More...
 
void setDesignTime (const string &inDesignTime)
 Set the design time. More...
 
const stringgetDesignName (void) const
 Return the design name. More...
 
const stringgetDeviceName (void) const
 Return the device name. More...
 
const stringgetDesignDate (void) const
 Return the design date. More...
 
const stringgetDesignTime (void) const
 Return the design time. More...
 
uint32_t getBitstreamByteLength (void) const
 Return the bitstream packet length in bytes. More...
 
uint32_t getHeaderByteLength (void) const
 Return the bitstream header length in bytes. More...
 
virtual uint32_t getFrameLength (void) const
 Return the frame length for the current device. More...
 

Static Public Member Functions

static bool expect (std::istream &inStream, uint8_t inExpected)
 Look for the expected uint8_t in the stream and return true if it matches. More...
 
static bool expect (std::istream &inStream, uint16_t inExpected)
 Look for the expected uint16_t in the stream and return true if it matches. More...
 
static bool expect (std::istream &inStream, uint32_t inExpected)
 Look for the expected uint32_t in the stream and return true if it matches. More...
 
static void readHeaderString (std::istream &inStream, string &outString)
 Read and return a bitstream header string. More...
 
static bool readHeader (std::istream &inStream, string &outDesignName, string &outDeviceName, string &outDesignDate, string &outDesignTime, uint32_t &outBitstreamLength, uint32_t &outHeaderLength)
 Read a bitstream header, and return its fields. More...
 
static void writeSubfieldSettings (std::ostream &inStream, uint32_t inWord, const Subfield *inSubfields)
 Insert 32 bit subfield settings into an output stream. More...
 
static void writeSubfieldSettings (std::ostream &inStream, uint16_t inWord, const Subfield *inSubfields)
 Insert 16 bit subfield settings into an output stream. More...
 

Data Fields

EDevice mDevice
 Bitstream device enumeration. More...
 
string mDesignName
 Header design name. More...
 
string mDeviceName
 Header device name. More...
 
string mDesignDate
 Header design date. More...
 
string mDesignTime
 Header design time. More...
 
uint32_t mBitstreamByteLength
 Bitstream packet length in bytes. More...
 
uint32_t mHeaderByteLength
 Header length in bytes. More...
 
ColumnDefVector mColumnDefs
 Column type widths. More...
 
TileTypeNameToColumnType mTileTypeNameToColumnType
 
TileTypeIndexToColumnType mTileTypeIndexToColumnType
 
DeviceInfo mDeviceInfo
 Device information. More...
 
FrameSet< VirtexFramemBlock [Bitstream::eBlockTypeCount]
 FrameSets for each of the eight block types. More...
 

Protected Types

typedef boost::uint32_t uint32_t
 Imported type name. More...
 

Protected Member Functions

void unimplemented (std::string inName)
 Reports the named function as not yet implemented in the current architecture. More...
 
virtual void updateCrc16 (torc::common::DeviceDesignator::EFamily inFamily)
 Update CRC-16 packets. More...
 
virtual void updateCrc32 (torc::common::DeviceDesignator::EFamily inFamily)
 Update CRC-32 packets. More...
 
template<class ARCH >
void readFramePackets4567 (uint32_t inBlockFrameIndexBounds[], std::map< typename ARCH::FrameAddress, uint32_t > &inFrameAddressToIndex, std::map< uint32_t, typename ARCH::FrameAddress > &inFrameIndexToAddress)
 Read frame packets in for Virtex4/5/6/7 devices. More...
 
template<class ARCH >
VirtexPacketVector::iterator deleteFramePackets4567 (void)
 Discard the existing frame packets for Virtex4/5/6/7 devices. More...
 
template<class ARCH >
VirtexPacketVector generateFullBitstreamPackets4567 (uint32_t inBlockFrameIndexBounds[])
 Return a packet vector with full frame data for Virtex4/5/6/7 devices. More...
 
template<class ARCH >
VirtexPacketVector generatePartialBitstreamPackets4567 (EFrameInclude inFrameInclusion, std::map< typename ARCH::FrameAddress, uint32_t > &inFrameAddressToIndex, std::map< uint32_t, typename ARCH::FrameAddress > &inFrameIndexToAddress)
 Return a packet vector with partial frame data for Virtex4/5/6/7 devices. More...
 

Protected Attributes

VirtexFrameBlocks mFrameBlocks
 Input Frame blocks. More...
 

Friends

class torc::bitstream::bitstream::VirtexBitstreamUnitTest
 

Detailed Description

Virtex-class bitstream.

Definition at line 35 of file VirtexBitstream.hpp.

Member Typedef Documentation

Imported type name.

Definition at line 64 of file bitstream/Bitstream.hpp.

FrameSet frame type.

Definition at line 83 of file FrameSet.hpp.

typedef std::string torc::bitstream::Bitstream::string
inherited

Imported type name.

Todo:
Bitstream access needs to be changed from public back to protected.

Definition at line 60 of file bitstream/Bitstream.hpp.

Mapping from tile indexes to column types.

Definition at line 254 of file bitstream/Bitstream.hpp.

typedef std::map<std::string, uint32_t> torc::bitstream::Bitstream::TileTypeNameToColumnType
inherited

Mapping from tile type names to column types.

Definition at line 251 of file bitstream/Bitstream.hpp.

typedef boost::uint16_t torc::bitstream::Bitstream::uint16_t
inherited

Imported type name.

Definition at line 62 of file bitstream/Bitstream.hpp.

typedef boost::uint32_t torc::bitstream::VirtexBitstream::uint32_t
protected

Imported type name.

Definition at line 41 of file VirtexBitstream.hpp.

typedef boost::uint8_t torc::bitstream::Bitstream::uint8_t
inherited

Imported type name.

Definition at line 61 of file bitstream/Bitstream.hpp.

FrameSet word type.

Definition at line 85 of file FrameSet.hpp.

Member Enumeration Documentation

anonymous enum
inherited

The block type count is fixed at eight across all Xilinx architectures.

Enumerator
eBlockTypeCount 

Definition at line 44 of file bitstream/Bitstream.hpp.

The bitstream type to generate. Use eBitstreamFull to fully reconfigure a device, eBitstreamTypePartialActive to partially reconfigure it while it continues to run, or eBitstreamTypePartialShutdown to partially recongifure it after shutting it down.

Enumerator
eBitstreamTypeFull 
eBitstreamTypePartialActive 
eBitstreamTypePartialShutdown 

Definition at line 49 of file bitstream/Bitstream.hpp.

The frames to include in a partial bitstream. Use eFrameIncludeOnlyDirtyFrames to include only dirty frames, or eFrameStateAllUsedFrames to include all allocated frames, dirty or not. Note that if not all frames were allocated, eFrameStateAllUsedFrames is not the same as a full bitstream.

Enumerator
eFrameIncludeOnlyDirtyFrames 
eFrameIncludeAllUsedFrames 

Definition at line 56 of file bitstream/Bitstream.hpp.

Packet subfields.

See Also
type 1 packet format: UG071, v1.10, April 8, 2008, Table 7-2.
type 2 packet format: UG071, v1.10, April 8, 2008, Table 7-4.
type 1 packet format: XAPP151, v1.7, October 20, 2004, Figure 13.
type 2 packet format: XAPP151, v1.7, October 20, 2004, Figure 14.
Enumerator
ePacketMaskType 
ePacketShiftType 
ePacketMaskOpcode 
ePacketShiftOpcode 
ePacketMaskType1Address 
ePacketShiftType1Address 
ePacketMaskType1Reserved 
ePacketShiftType1Reserved 
ePacketMaskType1Count 
ePacketShiftType1Count 
ePacketMaskType2Count 
ePacketShiftType2Count 

Definition at line 51 of file VirtexPacket.hpp.

51  {
52  // generic packet subfields
53  ePacketMaskType = 0xe0000000, ePacketShiftType = 29,
54  ePacketMaskOpcode = 0x18000000, ePacketShiftOpcode = 27,
55  // type 1 packet subfields
59  // type 2 packet subfields
61  };

Packet type enumeration.

See Also
packet type: UG071, v1.10, April 8, 2008, Tables 7-2 and 7-4.
packet type: XAPP151, v1.7, October 20, 2004, Figure 13, 14.
Enumerator
ePacketType1 
ePacketType2 
ePacketTypeCount 

Definition at line 41 of file VirtexPacket.hpp.

Synchronization words.

See Also
Configuration Sequence: UG191, v3.7, June 24, 2009, Table 6-15.
Configuration Sequence: UG071, v1.10, April 8, 2008, Table 7-11.
Configuration Sequence: XAPP511, v1.7, October 20, 2004, Figure 23.
Enumerator
eSynchronizationDummy 
eSynchronizationSync 
eSynchronizationBusWidthSync 
eSynchronizationBusWidthDetect 

Definition at line 67 of file VirtexPacket.hpp.

Constructor & Destructor Documentation

torc::bitstream::VirtexBitstream::VirtexBitstream ( void  )
inline

Basic constructor.

Definition at line 69 of file VirtexBitstream.hpp.

69  : Bitstream(), VirtexPacketVector(), VirtexPacketConstants(),
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
FrameBlocks< VirtexFrame > VirtexFrameBlocks
Virtex frame blocks type.
Definition: FrameSet.hpp:91
Bitstream(void)
Basic constructor.

Member Function Documentation

void torc::bitstream::VirtexBitstream::append ( const VirtexPacketVector inVector)
inline

Append the contents of a packet vector to the end of the bitstream.

Definition at line 134 of file VirtexBitstream.hpp.

134  {
135  VirtexPacketVector::insert(end(), inVector.begin(), inVector.end());
136  }
void torc::bitstream::Bitstream::cleanDateAndTime ( void  )
inlineinherited

Clean up the header date and time by replacing embedded spaces with zeros.

Definition at line 183 of file bitstream/Bitstream.hpp.

183  {
184  // some versions of the tools leave spaces inside the date and time fields
185  size_t pos = 0;
186  while((pos = mDesignDate.find(' ', pos)) != string::npos) mDesignDate[pos] = '0';
187  pos = 0;
188  while((pos = mDesignTime.find(' ', pos)) != string::npos) mDesignTime[pos] = '0';
189  }
string mDesignDate
Header design date.
string mDesignTime
Header design time.

+ Here is the caller graph for this function:

VirtexPacketVector::iterator torc::bitstream::VirtexBitstream::deleteFramePackets ( void  )
virtual

Discard the existing frame packets and return an iterator to the start position.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 202 of file VirtexBitstream.cpp.

202  {
203  unimplemented("deleteFramePackets()");
204  return end();
205  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
template<class ARCH >
VirtexPacketVector::iterator torc::bitstream::VirtexBitstream::deleteFramePackets4567 ( void  )
protected

Discard the existing frame packets for Virtex4/5/6/7 devices.

Todo:
Throw some meaningful exception

Definition at line 213 of file VirtexBitstream.cpp.

214  {
215  // walk the bitstream and look for frame packet boundaries
216  // we begin with the first FAR write, and end before the first CRC write after an FDRI write
217  iterator b = begin();
218  iterator p = b;
219  iterator e = end();
220  iterator start = e;
221  iterator stop = b;
222  iterator fdri = b;
223  while(p < e) {
224  // look up the current packet
225  const VirtexPacket& packet = *p;
226  // start from the first FAR write
227  if(start == e && packet.isWrite() && packet.getAddress() == ARCH::eRegisterFAR) {
228  start = p;
229  }
230  // remember the last FDRI write (including a trailing Type 2 write if present)
231  if(packet.isWrite() && packet.getAddress() == ARCH::eRegisterFDRI) {
232  fdri = p;
233  if((p+1)->isWrite() && (p+1)->isType2()) fdri++;
234  }
235  // stop on the first CRC after the last FDRI write
236  // (Beware: the zero "address" of a Type 2 packet looks like the CRC register)
237  if(stop < fdri && packet.isWrite() && packet.isType1()
238  && packet.getAddress() == ARCH::eRegisterCRC) {
239  stop = p;
240  }
241  p++;
242  }
243  // look for anything unexpected
244  p = start;
245  while(p < stop) {
246  // look up the current packet
247  const VirtexPacket& packet = *p++;
248  // abort if we find anything unexpected
249  if(start < e && stop > b && !(
250  packet.isNop() || (
251  packet.isWrite() && (
252  packet.getAddress() == ARCH::eRegisterFAR ||
253  packet.getAddress() == ARCH::eRegisterLOUT ||
254  packet.getAddress() == ARCH::eRegisterFDRI ||
255  packet.getAddress() == ARCH::eRegisterCRC ||
256  (packet.getAddress() == ARCH::eRegisterCMD && packet[1] == ARCH::eCommandWCFG)
257  )))) {
258  /// \todo Throw some meaningful exception
259  std::cerr << "Unable to safely distinguish frame packets." << std::endl;
260  return e;
261  }
262  }
263  // if we found the expected FAR -> FDRI -> CRC structure, delete the frame packets
264  if(start < stop && b < stop) {
265  erase(start, stop);
266  return start;
267  }
268  // if we didn't find frame packets or delete anything, return the end iterator
269  return e;
270  }

+ Here is the call graph for this function:

static bool torc::bitstream::Bitstream::expect ( std::istream &  inStream,
uint8_t  inExpected 
)
inlinestaticinherited

Look for the expected uint8_t in the stream and return true if it matches.

Definition at line 89 of file bitstream/Bitstream.hpp.

89  {
90  // read the actual data from the stream
91  uint8_t actual = 0;
92  inStream.read((char*) &actual, sizeof(actual));
93  // return equality
94  return inExpected == actual;
95  }
boost::uint8_t uint8_t
Imported type name.

+ Here is the caller graph for this function:

static bool torc::bitstream::Bitstream::expect ( std::istream &  inStream,
uint16_t  inExpected 
)
inlinestaticinherited

Look for the expected uint16_t in the stream and return true if it matches.

Definition at line 97 of file bitstream/Bitstream.hpp.

97  {
98  // read the actual data from the stream
99  uint16_t actual = 0;
100  inStream.read((char*) &actual, sizeof(actual));
101  // return equality
102  return inExpected == ntohs(actual);
103  }
boost::uint16_t uint16_t
Imported type name.
static bool torc::bitstream::Bitstream::expect ( std::istream &  inStream,
uint32_t  inExpected 
)
inlinestaticinherited

Look for the expected uint32_t in the stream and return true if it matches.

Definition at line 105 of file bitstream/Bitstream.hpp.

105  {
106  // read the actual data from the stream
107  uint32_t actual = 0;
108  inStream.read((char*) &actual, sizeof(actual));
109  // return equality
110  return inExpected == ntohl(actual);
111  }
boost::uint32_t uint32_t
Imported type name.
void torc::bitstream::VirtexBitstream::generateBitstream ( EBitstreamType  inBitstreamType = eBitstreamTypeFull,
EFrameInclude  inFrameInclusion = eFrameIncludeAllUsedFrames 
)
virtual

Discard existing packets and generate bitstream packets from frame data. By default this generates packets for a full bitstream.

Parameters
inBitstreamTypeThe type of bitstream to generate: full, active partial, or shutdown partial.
inFrameInclusionThe type of frames to include in partial bitstreams: only dirty frames or all frames.

Definition at line 58 of file VirtexBitstream.cpp.

59  {
60  // discard all packets
61  clear();
62  if(inBitstreamType == eBitstreamTypeFull) {
63  // generate the prefix
65  // generate the frame packets
67  // generate the suffix
69  } else {
70  // generate the prefix
71  append(generatePartialBitstreamPrefix(inBitstreamType));
72  // generate the frame packets
73  append(generatePartialBitstreamPackets(inFrameInclusion));
74  // generate the suffix
75  append(generatePartialBitstreamSuffix(inBitstreamType));
76  }
77  }
virtual VirtexPacketVector generatePartialBitstreamPackets(EFrameInclude inFrameInclusion)
Return a packet vector with partial frame data.
virtual VirtexPacketVector generatePartialBitstreamPrefix(EBitstreamType inBitstreamType)
Return a packet vector with the partial bitstream prefix.
virtual VirtexPacketVector generatePartialBitstreamSuffix(EBitstreamType inBitstreamType)
Return a packet vector with the partial bitstream suffix.
void append(const VirtexPacketVector &inVector)
Append the contents of a packet vector to the end of the bitstream.
virtual VirtexPacketVector generateFullBitstreamPrefix(void)
Return a packet vector with the full bitstream prefix.
virtual VirtexPacketVector generateFullBitstreamSuffix(void)
Return a packet vector with the full bitstream suffix.
virtual VirtexPacketVector generateFullBitstreamPackets(void)
Return a packet vector with full frame data.
VirtexPacketVector torc::bitstream::VirtexBitstream::generateFullBitstreamPackets ( void  )
virtual

Return a packet vector with full frame data.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 272 of file VirtexBitstream.cpp.

272  {
273  unimplemented("generateFullBitstreamPackets()");
274  return VirtexPacketVector();
275  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
template<class ARCH >
VirtexPacketVector torc::bitstream::VirtexBitstream::generateFullBitstreamPackets4567 ( uint32_t  inBlockFrameIndexBounds[])
protected

Return a packet vector with full frame data for Virtex4/5/6/7 devices.

Definition at line 287 of file VirtexBitstream.cpp.

288  {
289 
290  // declare the packet vector and define a NOP packet
291  typedef VirtexFrame::word_t word_t;
292  VirtexPacketVector packets;
293  VirtexPacket nop(VirtexPacket::makeHeader(ePacketType1, eOpcodeNOP, 0, 0));
294 
295  // determine the total size of the frames to write
296  size_t size = 0;
297  for(int i = 0; i < eBlockTypeCount; i++)
298  size += inBlockFrameIndexBounds[i] * getFrameLength();
299  word_t* frameContents = new VirtexFrameSet::word_t[size];
300  word_t* pos = frameContents;
301  // gather the frames to write
302  for(int i = 0; i < eBlockTypeCount; i++) {
303  // look up the frame set for this block type
304  VirtexFrameSet& frameSet = mFrameBlocks.mBlock[i];
305  // iterate through the frames in the set and collect the frame words
306  VirtexFrameSet::iterator p = frameSet.begin();
307  VirtexFrameSet::iterator e = frameSet.end();
308  while(p < e) {
309  // look up the current frame
310  VirtexFrameSharedPtr framePtr = *p++;
311  // set up the pointers
312  const word_t* wp = framePtr->getWords();
313  const word_t* we = wp + framePtr->getLength();
314  // and copy the frame words into the new memory
315  if(wp) do { *pos++ = *wp++; } while(wp < we); // frames with words allocated
316  else do { *pos++ = 0; wp++; } while(wp < we); // frames with no words allocated
317  }
318  }
319  // write the starting frame address
320  packets.push_back(VirtexPacket::makeType1Write(ARCH::eRegisterFAR, 0));
321  // write the write configuration register command
322  packets.push_back(VirtexPacket::makeType1Write(ARCH::eRegisterCMD, ARCH::eCommandWCFG));
323  packets.push_back(nop);
324  // write 0 bytes to FDRI (in preparation for type 2 write packet)
325  packets.push_back(VirtexPacket::makeNullType1Write(ARCH::eRegisterFDRI));
326  // write all frames to FDRI
327  packets.push_back(VirtexPacket::makeType2Write(size, frameContents));
328 
329  // return the packet vector
330  return packets;
331  }
VirtexFrameBlocks mFrameBlocks
Input Frame blocks.
static VirtexPacket makeNullType1Write(uint32_t inAddress)
Construct a null type 1 write packet.
FrameSet< VirtexFrame > VirtexFrameSet
Virtex frame set type.
Definition: FrameSet.hpp:73
static VirtexPacket makeType2Write(uint32_t inCount, uint32_t *inWords)
Construct a type 2 write packet.
VirtexFrame::word_t word_t
FrameSet word type.
Definition: FrameSet.hpp:85
FrameSet< FRAME_TYPE > mBlock[Bitstream::eBlockTypeCount]
FrameSets for each of the eight block types.
Definition: FrameSet.hpp:88
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
static VirtexPacket makeType1Write(uint32_t inAddress, uint32_t inWord)
Construct a type 1 write packet.
boost::shared_ptr< VirtexFrame > VirtexFrameSharedPtr
Virtex frame type.
Definition: Frame.hpp:108
VirtexFrame::word_t word_t
FrameSet word type.
Definition: FrameSet.hpp:42
virtual uint32_t getFrameLength(void) const
Return the frame length for the current device.
static uint32_t makeHeader(EPacketType inType, EOpcode inOpcode, uint32_t inAddress, uint32_t inCount)
Construct a packet header.
WORD_TYPE word_t
Frame word type.
Definition: Frame.hpp:48
VirtexPacketVector torc::bitstream::VirtexBitstream::generateFullBitstreamPrefix ( void  )
virtual

Return a packet vector with the full bitstream prefix.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 333 of file VirtexBitstream.cpp.

333  {
334  unimplemented("generateFullBitstreamPrefix()");
335  return VirtexPacketVector();
336  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
VirtexPacketVector torc::bitstream::VirtexBitstream::generateFullBitstreamSuffix ( void  )
virtual

Return a packet vector with the full bitstream suffix.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 338 of file VirtexBitstream.cpp.

338  {
339  unimplemented("generateFullBitstreamSuffix()");
340  return VirtexPacketVector();
341  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
VirtexPacketVector torc::bitstream::VirtexBitstream::generatePartialBitstreamPackets ( EFrameInclude  inFrameInclusion)
virtual

Return a packet vector with partial frame data.

Parameters
inFrameInclusionThe type of frames to include: only dirty frames or all frames.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 343 of file VirtexBitstream.cpp.

344  {
345  unimplemented("generatePartialBitstreamPackets()");
346  return VirtexPacketVector();
347  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
template<class ARCH >
VirtexPacketVector torc::bitstream::VirtexBitstream::generatePartialBitstreamPackets4567 ( EFrameInclude  inFrameInclusion,
std::map< typename ARCH::FrameAddress, uint32_t > &  inFrameAddressToIndex,
std::map< uint32_t, typename ARCH::FrameAddress > &  inFrameIndexToAddress 
)
protected

Return a packet vector with partial frame data for Virtex4/5/6/7 devices.

Todo:
mFrameIndexToAddress.size() is too short because excludes pad frames

Definition at line 367 of file VirtexBitstream.cpp.

370  {
371  // clean up the template parameters
372  typedef typename ARCH::FrameAddress FrameAddress;
373  typedef std::map<FrameAddress, uint32_t> FrameAddressToIndex;
374  typedef std::map<uint32_t, FrameAddress> FrameIndexToAddress;
375 
376  // declare the packet vector and define a NOP packet
377  typedef VirtexFrame::word_t word_t;
378  VirtexPacketVector packets;
379  VirtexPacket nop(VirtexPacket::makeHeader(ePacketType1, eOpcodeNOP, 0, 0));
380 
381  // write the starting frame address
382  packets.push_back(VirtexPacket::makeType1Write(ARCH::eRegisterFAR, 0));
383  // write the write configuration register command
384  packets.push_back(VirtexPacket::makeType1Write(ARCH::eRegisterCMD, ARCH::eCommandWCFG));
385  packets.push_back(nop);
386 
387  // iterate through the frame blocks looking for groups of contiguous frames that are in use
388  bool empty = true;
389  uint32_t index = 0;
390  uint32_t blockStart = 0;
391  for(int i = 0; i < eBlockTypeCount; i++) {
392  blockStart += index;
393  index = 0;
394  bool started = false;
395  uint32_t startIndex = 0;
396  // look up the frame set for this block type
397  VirtexFrameSet& frameSet = mFrameBlocks.mBlock[i];
398  // iterate through the frames in the set and add up their lengths
399  VirtexFrameSet::iterator p = frameSet.begin();
400  VirtexFrameSet::iterator e = frameSet.end();
401  while(p < e) {
402  // look up the current frame
403  VirtexFrameSharedPtr framePtr = *p++;
404  // determine whether the frame fits inclusion criteria
405  // we include dirty frames, we include clean frames if permitted by the caller,
406  // and if we are collecting frames and we encounter pad frames, we include them,
407  // but we stop collecting if we reach the last frame in the set
408  /// \todo mFrameIndexToAddress.size() is too short because excludes pad frames
409  bool include = p < e
410  && (
411  framePtr->isDirty()
412  || (inFrameInclusion == eFrameIncludeAllUsedFrames && framePtr->isUsed())
413  || (started && blockStart + index < inFrameIndexToAddress.size() &&
414  inFrameIndexToAddress.find(blockStart + index)
415  == inFrameIndexToAddress.end())
416  );
417  // if we are accumulating frames and this frame doesn't meet the criteria, process
418  // the collection of frames and stop collecting
419  if((started && !include)) {
420  started = false;
421  uint32_t stopIndex = index + (p == e ? 1 : 0);
422  uint32_t currentIndex = startIndex;
423  // std::cerr << " stopped at: " << stopIndex << std::endl;
424  // include two trailing pad frames if appropriate
425  if(inFrameIndexToAddress.find(blockStart + stopIndex + 1)
426  == inFrameIndexToAddress.end()) {
427  stopIndex++;
428  if(inFrameIndexToAddress.find(blockStart + stopIndex + 1)
429  == inFrameIndexToAddress.end())
430  stopIndex++;
431  }
432  // determine the length of the contiguous block
433  size_t size = (stopIndex - startIndex) * getFrameLength();
434  // allocate a word array
435  word_t* frameContents = new VirtexFrameSet::word_t[size];
436  word_t* pos = frameContents;
437  while(currentIndex < stopIndex) {
438  // look up the current frame
439  VirtexFrameSharedPtr framePtr = mFrameBlocks.mBlock[i][currentIndex];
440  // set up the pointers
441  const word_t* wp = framePtr->getWords();
442  const word_t* we = wp + framePtr->getLength();
443  // and copy the frame words into the new memory
444  if(wp) do { *pos++ = *wp++; } while(wp < we); // frames with words
445  else do { *pos++ = 0; wp++; } while(wp < we); // frames with no words
446  currentIndex++;
447  }
448  // write the starting frame address
449  packets.push_back(VirtexPacket::makeType1Write(ARCH::eRegisterFAR,
450  inFrameIndexToAddress[blockStart + startIndex]));
451  packets.push_back(nop);
452  // if the size is more than 2048 words, we have to use a Type 2 write
453  if(size > 2048) {
454  // write 0 bytes to FDRI (in preparation for type 2 write packet)
455  packets.push_back(VirtexPacket::makeNullType1Write(ARCH::eRegisterFDRI));
456  // write all frames to FDRI
457  packets.push_back(VirtexPacket::makeType2Write(size, frameContents));
458  } else {
459  // write all frames to FDRI
460  packets.push_back(VirtexPacket::makeType1Write(ARCH::eRegisterFDRI, size,
461  frameContents));
462  }
463  if(size) empty = false;
464  // if we are not collecting, but we encounter a frame to include, begin collecting
465  } else if(!started && include) {
466  // std::cerr << " started at: " << index << std::endl;
467  startIndex = index;
468  started = true;
469  }
470  // increment the frame index
471  index++;
472  }
473  }
474 
475  // if we generated no frame contents, discard the wrapper packets
476  if(empty) packets.clear();
477  // return the packet vector
478  return packets;
479  }
VirtexFrameBlocks mFrameBlocks
Input Frame blocks.
static VirtexPacket makeNullType1Write(uint32_t inAddress)
Construct a null type 1 write packet.
boost::uint32_t uint32_t
Imported type name.
FrameSet< VirtexFrame > VirtexFrameSet
Virtex frame set type.
Definition: FrameSet.hpp:73
static VirtexPacket makeType2Write(uint32_t inCount, uint32_t *inWords)
Construct a type 2 write packet.
VirtexFrame::word_t word_t
FrameSet word type.
Definition: FrameSet.hpp:85
FrameSet< FRAME_TYPE > mBlock[Bitstream::eBlockTypeCount]
FrameSets for each of the eight block types.
Definition: FrameSet.hpp:88
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
static VirtexPacket makeType1Write(uint32_t inAddress, uint32_t inWord)
Construct a type 1 write packet.
boost::shared_ptr< VirtexFrame > VirtexFrameSharedPtr
Virtex frame type.
Definition: Frame.hpp:108
VirtexFrame::word_t word_t
FrameSet word type.
Definition: FrameSet.hpp:42
virtual uint32_t getFrameLength(void) const
Return the frame length for the current device.
static uint32_t makeHeader(EPacketType inType, EOpcode inOpcode, uint32_t inAddress, uint32_t inCount)
Construct a packet header.
WORD_TYPE word_t
Frame word type.
Definition: Frame.hpp:48
VirtexPacketVector torc::bitstream::VirtexBitstream::generatePartialBitstreamPrefix ( EBitstreamType  inBitstreamType)
virtual

Return a packet vector with the partial bitstream prefix.

Parameters
inBitstreamTypeThe type of partial bitstream to generate: active or shutdown.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 481 of file VirtexBitstream.cpp.

482  {
483  unimplemented("generatePartialBitstreamPrefix()");
484  return VirtexPacketVector();
485  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
VirtexPacketVector torc::bitstream::VirtexBitstream::generatePartialBitstreamSuffix ( EBitstreamType  inBitstreamType)
virtual

Return a packet vector with the partial bitstream suffix.

Parameters
inBitstreamTypeThe type of partial bitstream to generate: active or shutdown.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 487 of file VirtexBitstream.cpp.

488  {
489  unimplemented("generatePartialBitstreamSuffix()");
490  return VirtexPacketVector();
491  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
std::vector< VirtexPacket > VirtexPacketVector
Vector of Virtex packets.
uint32_t torc::bitstream::Bitstream::getBitstreamByteLength ( void  ) const
inlineinherited

Return the bitstream packet length in bytes.

The length includes all packet data, but does not include the bitstream header.

Definition at line 340 of file bitstream/Bitstream.hpp.

340 { return mBitstreamByteLength; }
uint32_t mBitstreamByteLength
Bitstream packet length in bytes.
const string& torc::bitstream::Bitstream::getDesignDate ( void  ) const
inlineinherited

Return the design date.

Definition at line 335 of file bitstream/Bitstream.hpp.

335 { return mDesignDate; }
string mDesignDate
Header design date.
const string& torc::bitstream::Bitstream::getDesignName ( void  ) const
inlineinherited

Return the design name.

Definition at line 331 of file bitstream/Bitstream.hpp.

331 { return mDesignName; }
string mDesignName
Header design name.
const string& torc::bitstream::Bitstream::getDesignTime ( void  ) const
inlineinherited

Return the design time.

Definition at line 337 of file bitstream/Bitstream.hpp.

337 { return mDesignTime; }
string mDesignTime
Header design time.
const string& torc::bitstream::Bitstream::getDeviceName ( void  ) const
inlineinherited

Return the device name.

Definition at line 333 of file bitstream/Bitstream.hpp.

333 { return mDeviceName; }
string mDeviceName
Header device name.

+ Here is the caller graph for this function:

VirtexFrameBlocks& torc::bitstream::VirtexBitstream::getFrameBlocks ( void  )
inline

Return the configuration frame blocks.

Definition at line 139 of file VirtexBitstream.hpp.

139 { return mFrameBlocks; }
VirtexFrameBlocks mFrameBlocks
Input Frame blocks.
virtual uint32_t torc::bitstream::Bitstream::getFrameLength ( void  ) const
inlinevirtualinherited
uint32_t torc::bitstream::Bitstream::getHeaderByteLength ( void  ) const
inlineinherited

Return the bitstream header length in bytes.

Definition at line 342 of file bitstream/Bitstream.hpp.

342 { return mHeaderByteLength; }
uint32_t mHeaderByteLength
Header length in bytes.

+ Here is the caller graph for this function:

virtual void torc::bitstream::Bitstream::initializeDeviceInfo ( const std::string &  inDeviceName)
inlinevirtualinherited

Initialize the maps between frame indexes and frame addresses. This is generally only useful for internal purposes.

Todo:
This function should be made pure virtual.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, torc::bitstream::Virtex4, torc::bitstream::Spartan3E, torc::bitstream::Virtex2, torc::bitstream::Virtex, torc::bitstream::Virtex2P, and torc::bitstream::VirtexE.

Definition at line 214 of file bitstream/Bitstream.hpp.

214 {}

+ Here is the caller graph for this function:

virtual void torc::bitstream::Bitstream::initializeFrameMaps ( void  )
inlinevirtualinherited

Initialize the maps between frame indexes and frame addresses. This is generally only useful for internal purposes.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, torc::bitstream::Virtex4, torc::bitstream::Spartan3E, torc::bitstream::Virtex2, torc::bitstream::Virtex, and torc::bitstream::VirtexE.

Definition at line 217 of file bitstream/Bitstream.hpp.

217 {}
iterator torc::bitstream::VirtexBitstream::insert ( iterator  position,
const value_type &  val 
)
inline

Regular std::vector inserter.

Definition at line 116 of file VirtexBitstream.hpp.

116  {
117  return VirtexPacketVector::insert(position, val);
118  }

+ Here is the caller graph for this function:

void torc::bitstream::VirtexBitstream::insert ( iterator  position,
size_type  n,
const value_type &  val 
)
inline

Regular std::vector inserter.

Definition at line 120 of file VirtexBitstream.hpp.

120  {
121  VirtexPacketVector::insert(position, n, val);
122  }
template<class InputIterator >
void torc::bitstream::VirtexBitstream::insert ( iterator  position,
InputIterator  first,
InputIterator  last 
)
inline

Regular std::vector inserter.

Definition at line 124 of file VirtexBitstream.hpp.

125  {
126  VirtexPacketVector::insert(position, first, last);
127  }
void torc::bitstream::VirtexBitstream::insert ( VirtexPacketVector::iterator  inPosition,
const VirtexPacketVector inVector 
)
inline

Insert the contents of a packet vector at the specified position.

Definition at line 129 of file VirtexBitstream.hpp.

130  {
131  VirtexPacketVector::insert(inPosition, inVector.begin(), inVector.end());
132  }
void torc::bitstream::VirtexBitstream::preflightPackets ( void  )
virtual

Preflight the packets.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 493 of file VirtexBitstream.cpp.

493  {
494  // determine which architecture this is
495  DeviceDesignator deviceDesignator(getDeviceName());
496  DeviceDesignator::EFamily family = deviceDesignator.getFamily();
497  switch(family) {
500  updateCrc16(family); break;
504  case DeviceDesignator::eFamilyZynq7000: default:
505  updateCrc32(family); break;
506  }
507  }
Encapsulation of a device designator and its constituent elements.
const string & getDeviceName(void) const
Return the device name.
virtual void updateCrc32(torc::common::DeviceDesignator::EFamily inFamily)
Update CRC-32 packets.
virtual void updateCrc16(torc::common::DeviceDesignator::EFamily inFamily)
Update CRC-16 packets.

+ Here is the call graph for this function:

virtual void torc::bitstream::Bitstream::read ( std::istream &  inStream,
bool  inCleanDateAndTime = true 
)
inlinevirtualinherited

Read the bitstream header and packets from a stream.

Definition at line 266 of file bitstream/Bitstream.hpp.

266  {
267  readHeader(inStream);
268  readPackets(inStream);
269  if(inCleanDateAndTime) cleanDateAndTime();
270  }
static bool readHeader(std::istream &inStream, string &outDesignName, string &outDeviceName, string &outDesignDate, string &outDesignTime, uint32_t &outBitstreamLength, uint32_t &outHeaderLength)
Read a bitstream header, and return its fields.
void cleanDateAndTime(void)
Clean up the header date and time by replacing embedded spaces with zeros.
virtual void readPackets(std::istream &inStream)
Read the bitstream packets.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void torc::bitstream::VirtexBitstream::readFramePackets ( void  )
virtual

Read frame data into the frame blocks structure.

Reimplemented in torc::bitstream::Virtex7, torc::bitstream::Virtex6, torc::bitstream::Virtex5, and torc::bitstream::Virtex4.

Definition at line 83 of file VirtexBitstream.cpp.

83  {
84  unimplemented("readFramePackets(void)");
85  }
void unimplemented(std::string inName)
Reports the named function as not yet implemented in the current architecture.
template<class ARCH >
void torc::bitstream::VirtexBitstream::readFramePackets4567 ( uint32_t  inBlockFrameIndexBounds[],
std::map< typename ARCH::FrameAddress, uint32_t > &  inFrameAddressToIndex,
std::map< uint32_t, typename ARCH::FrameAddress > &  inFrameIndexToAddress 
)
protected

Read frame packets in for Virtex4/5/6/7 devices.

Todo:

Definition at line 101 of file VirtexBitstream.cpp.

104  {
105  // clean up the template parameters
106  typedef typename ARCH::FrameAddress FrameAddress;
107  typedef std::map<FrameAddress, uint32_t> FrameAddressToIndex;
108  typedef std::map<uint32_t, FrameAddress> FrameIndexToAddress;
109  // declare a shared word array
110  boost::shared_array<uint32_t> frameWords;
111  // precalculate the start indexes of all blocks, and create all possible frames
112  uint32_t frameStart[eBlockTypeCount + 1];
113  frameStart[0] = 0;
114  VirtexFrame frame(ARCH::eFrameLength);
115  for(int i = 0; i < eBlockTypeCount; i++) {
116  frameStart[i + 1] = frameStart[i] + inBlockFrameIndexBounds[i];
117  // clear any existing frames
118  mFrameBlocks.mBlock[i].clear();
119  // populate the block with the correct number of empty frames
120  for(uint32_t j = 0; j < inBlockFrameIndexBounds[i]; j++) {
122  (new VirtexFrame(getFrameLength())));
123  mFrameBlocks.mBlock[i].back()->setUsed(false);
124  }
125  }
126  // walk the bitstream and extract all frames
127  const uint32_t frameLength = getFrameLength();
128  uint32_t frameIndex = 0;
129  FrameAddress frameAddress;
130  typename ARCH::ERegister lastAddress = typename ARCH::ERegister();
131  typename ARCH::iterator p = begin();
132  typename ARCH::iterator e = end();
133  while(p < e) {
134  const VirtexPacket& packet = *p++;
135  // process FAR write packets
136  if(packet.isWrite() && packet.getAddress() == ARCH::eRegisterFAR) {
137  // extract the new frame address
138  frameAddress = typename ARCH::FrameAddress(packet[1]);
139  // convert the frame address to the corresponding frame index
140  typename FrameAddressToIndex::iterator ip
141  = inFrameAddressToIndex.find(frameAddress);
142  if(ip != inFrameAddressToIndex.end()) frameIndex = ip->second;
143  }
144  // process FDRI write packets
145  else if(packet.isWrite()
146  && (
147  // this is a Type 2 packet and the prior Type 1 address was FDRI
148  (packet.isType2() && lastAddress == ARCH::eRegisterFDRI)
149  ||
150  // this is a non-empty Type 1 packet and its address is FDRI
151  (packet.isType1() && packet.getAddress() == ARCH::eRegisterFDRI
152  && packet.getWordCount() > 0)
153  )) {
154  // determine the number of frames in the packet and look up the frame words
155  const uint32_t numWords = packet.getWordCount();
156  boost::shared_array<uint32_t> frameWords(packet.getWords());
157  uint32_t position = 0;
158  // iterate over every frame in the packet
159  while(position + frameLength <= numWords) {
160  // look up the current block type and the frame index into that block type
161  typename ARCH::EFarBlockType blockType = frameAddress.mBlockType;
162  uint32_t index = frameIndex - frameStart[blockType];
164  (new VirtexFrame(frameLength, &frameWords[position]));
165  mFrameBlocks.mBlock[blockType][index]->setUsed();
166  position += frameLength;
167  frameIndex++;
168  typename FrameIndexToAddress::iterator ap
169  = inFrameIndexToAddress.find(frameIndex);
170  if(ap != inFrameIndexToAddress.end()) frameAddress = ap->second;
171  // sanity escape exit (which also breaks out of the higher level loop)
172  if(position > numWords) {
173  std::cerr << "Overflowed expected frame counts for device." << std::endl;
174  break;
175  }
176  }
177  if(frameIndex != frameStart[frameAddress.mBlockType + 1]) {
178  // if we ended on a pad frame, where the current index has no corresponding
179  // frame address, we need to advance to the next valid frame address
180  if(inFrameIndexToAddress.find(frameIndex) == inFrameIndexToAddress.end())
181  frameIndex++;
182  if(inFrameIndexToAddress.find(frameIndex) == inFrameIndexToAddress.end())
183  frameIndex++;
184  // at this point we should again be on a valid frame
185  typename FrameIndexToAddress::iterator ap
186  = inFrameIndexToAddress.find(frameIndex);
187  if(ap != inFrameIndexToAddress.end()) frameAddress = ap->second;
188  else if(frameIndex == frameStart[frameAddress.mBlockType + 1]) /* at end */;
189  else {
190  std::cerr << "Failed to find the next valid frame address at the end of a "
191  "packet." << std::endl;
192  }
193  }
194  }
195  // remember the last register address for Type 2 packets
196  if(packet.isType1()) lastAddress = typename ARCH::ERegister(packet.getAddress());
197  // process MFWR write packets
198  /// \todo
199  }
200  }
VirtexFrameBlocks mFrameBlocks
Input Frame blocks.
Frame< uint32_t > VirtexFrame
Virtex frame type.
Definition: Frame.hpp:104
boost::uint32_t uint32_t
Imported type name.
FrameSet< FRAME_TYPE > mBlock[Bitstream::eBlockTypeCount]
FrameSets for each of the eight block types.
Definition: FrameSet.hpp:88
boost::shared_ptr< VirtexFrame > FrameSharedPtr
Shared pointer encapsulation of a Frame.
Definition: FrameSet.hpp:44
virtual uint32_t getFrameLength(void) const
Return the frame length for the current device.

+ Here is the call graph for this function:

static bool torc::bitstream::Bitstream::readHeader ( std::istream &  inStream,
string outDesignName,
string outDeviceName,
string outDesignDate,
string outDesignTime,
uint32_t outBitstreamLength,
uint32_t outHeaderLength 
)
inlinestaticinherited

Read a bitstream header, and return its fields.

Definition at line 142 of file bitstream/Bitstream.hpp.

144  {
145  // assume success unless we find otherwise
146  bool success = true;
147  // read the magic length
148  success &= expect(inStream, uint16_t(0x0009));
149  // read the magic bytes
150  success &= expect(inStream, uint32_t(0x0ff00ff0));
151  success &= expect(inStream, uint32_t(0x0ff00ff0));
152  success &= expect(inStream, uint8_t(0x00));
153  // read the mysterious 0x0001
154  success &= expect(inStream, uint16_t(0x0001));
155  // read the 'a' byte
156  success &= expect(inStream, uint8_t('a'));
157  // read the design name length
158  readHeaderString(inStream, outDesignName);
159  // read the 'b' byte
160  success &= expect(inStream, uint8_t('b'));
161  // read the device name length
162  readHeaderString(inStream, outDeviceName);
163  // read the 'c' byte
164  success &= expect(inStream, uint8_t('c'));
165  // read the design date length
166  readHeaderString(inStream, outDesignDate);
167  // read the 'd' byte
168  success &= expect(inStream, uint8_t('d'));
169  // read the design time length
170  readHeaderString(inStream, outDesignTime);
171  // read the 'e' byte
172  success &= expect(inStream, uint8_t('e'));
173  // read the inStream length
174  inStream.read((char*) &outBitstreamLength, sizeof(outBitstreamLength));
175  outBitstreamLength = ntohl(outBitstreamLength);
176  // determine the header length
177  outHeaderLength = 34 + outDesignName.length() + outDeviceName.length()
178  + outDesignDate.length() + outDesignTime.length();
179  // return the result
180  return success;
181  }
boost::uint8_t uint8_t
Imported type name.
static bool expect(std::istream &inStream, uint8_t inExpected)
Look for the expected uint8_t in the stream and return true if it matches.
boost::uint32_t uint32_t
Imported type name.
static void readHeaderString(std::istream &inStream, string &outString)
Read and return a bitstream header string.
boost::uint16_t uint16_t
Imported type name.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

virtual void torc::bitstream::Bitstream::readHeader ( std::istream &  inStream)
inlinevirtualinherited

Read the bitstream header.

Definition at line 274 of file bitstream/Bitstream.hpp.

274  {
278  }
static bool readHeader(std::istream &inStream, string &outDesignName, string &outDeviceName, string &outDesignDate, string &outDesignTime, uint32_t &outBitstreamLength, uint32_t &outHeaderLength)
Read a bitstream header, and return its fields.
string mDesignDate
Header design date.
string mDesignTime
Header design time.
string mDesignName
Header design name.
string mDeviceName
Header device name.
uint32_t mBitstreamByteLength
Bitstream packet length in bytes.
void setDevice(const std::string &inDeviceName)
Assign the device enumeration constant for the given device name.
uint32_t mHeaderByteLength
Header length in bytes.

+ Here is the call graph for this function:

static void torc::bitstream::Bitstream::readHeaderString ( std::istream &  inStream,
string outString 
)
inlinestaticinherited

Read and return a bitstream header string.

Definition at line 124 of file bitstream/Bitstream.hpp.

124  {
125  // read the string length
126  uint16_t length = 0;
127  inStream.read((char*) &length, sizeof(length));
128  length = ntohs(length);
129  if(length > 0) {
130  // create a buffer
131  char* buffer = new char[length];
132  // read the null-terminated string
133  inStream.read(buffer, length);
134  // copy the data into the string
135  outString.assign(buffer, length - 1);
136  delete[] buffer;
137  } else {
138  outString.clear();
139  }
140  }
boost::uint16_t uint16_t
Imported type name.

+ Here is the caller graph for this function:

void torc::bitstream::VirtexBitstream::readPackets ( std::istream &  inStream)
virtual

Read bitstream packets from a stream.

Note
This function should be called after the bitstream header has been read.

Reimplemented from torc::bitstream::Bitstream.

Reimplemented in torc::bitstream::Virtex2.

Definition at line 31 of file VirtexBitstream.cpp.

31  {
32  uint32_t bitstreamWordLength = mBitstreamByteLength >> 2;
33  uint32_t cumulativeWordLength = 0;
34  while(cumulativeWordLength < bitstreamWordLength) {
35  push_back(VirtexPacket::read(inStream));
36  cumulativeWordLength += back().getWordSize();
37  }
38  }
boost::uint32_t uint32_t
Imported type name.
uint32_t mBitstreamByteLength
Bitstream packet length in bytes.
static VirtexPacket read(std::istream &inStream)
Read a packet.
void torc::bitstream::Bitstream::setDesignDate ( const string inDesignDate)
inlineinherited

Set the design date.

Definition at line 327 of file bitstream/Bitstream.hpp.

327 { mDesignDate = inDesignDate; }
string mDesignDate
Header design date.

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::setDesignName ( const string inDesignName)
inlineinherited

Set the design name.

Definition at line 323 of file bitstream/Bitstream.hpp.

323 { mDesignName = inDesignName; }
string mDesignName
Header design name.

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::setDesignTime ( const string inDesignTime)
inlineinherited

Set the design time.

Definition at line 329 of file bitstream/Bitstream.hpp.

329 { mDesignTime = inDesignTime; }
string mDesignTime
Header design time.

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::setDevice ( const std::string &  inDeviceName)
inlineinherited

Assign the device enumeration constant for the given device name.

Definition at line 225 of file bitstream/Bitstream.hpp.

225  {
227  }
static EDevice getDeviceEnum(const string &inName)
Returns the device enumeration corresponding to the given device name.
Definition: Devices.hpp:216
EDevice mDevice
Bitstream device enumeration.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::setDeviceInfo ( const DeviceInfo rhs)
inlineinherited

Assign static device information for the current bitstream.

Definition at line 223 of file bitstream/Bitstream.hpp.

223 { mDeviceInfo = rhs; }
DeviceInfo mDeviceInfo
Device information.

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::setDeviceName ( const string inDeviceName)
inlineinherited

Set the device name.

Definition at line 325 of file bitstream/Bitstream.hpp.

325 { mDeviceName = inDeviceName; }
string mDeviceName
Header device name.

+ Here is the caller graph for this function:

void torc::bitstream::VirtexBitstream::unimplemented ( std::string  inName)
protected

Reports the named function as not yet implemented in the current architecture.

Definition at line 79 of file VirtexBitstream.cpp.

79  {
80  std::cerr << inName << " is not yet implemented for this architecture." << std::endl;
81  }
void torc::bitstream::VirtexBitstream::updateCrc16 ( torc::common::DeviceDesignator::EFamily  inFamily)
protectedvirtual

Update CRC-16 packets.

Definition at line 509 of file VirtexBitstream.cpp.

509  {
510  // set up family-specific variables
511  uint32_t crcRegister = 0;
512  uint32_t cmdRegister = 0;
513  uint32_t fdriRegister = 0;
514  uint32_t rcrcCommand = 0;
515  uint32_t addressLength = 0;
516  bool autoCrc = false;
517  switch(inFamily) {
519  cmdRegister = Virtex::eRegisterCMD; rcrcCommand = Virtex::eCommandRCRC;
520  fdriRegister = Virtex::eRegisterFDRI; crcRegister = Virtex::eRegisterCRC;
521  addressLength = 4; autoCrc = false;
522  break;
524  cmdRegister = Virtex2::eRegisterCMD; rcrcCommand = Virtex2::eCommandRCRC;
525  fdriRegister = Virtex2::eRegisterFDRI; crcRegister = Virtex::eRegisterCRC;
526  addressLength = 5; autoCrc = true;
527  break;
528  default:
529  std::cerr << "Unsupported architecture in VirtexBitstream::updateCrc16()." << std::endl;
530  break;
531  }
532  // begin CRC calculation
533  uint32_t address = 0;
534  iterator p = begin();
535  iterator e = end();
536  // CRC-16-IBM polynomial for Spartan3/6 and Virtex/E/2/2P families
537  boost::crc_basic<16> crc16(0x8005, 0, 0, false, true);
538  while(p < e) {
539  // look up the current packet
540  const VirtexPacket& packet = *p++;
541  // only process write packets with non-zero payload length
542  if(!packet.isWrite()) continue;
543  if(packet.isType1()) address = packet.getAddress();
544  uint32_t wordCount = packet.getWordCount();
545  if(wordCount == 0) continue;
546  // CRC register write (this is what compares the expected and supplied CRC values)
547  if(address == crcRegister) {
548  //printf("Expected CRC16: %4.4x\n", packet[1]);
549  //printf("Calculated CRC16: %4.4x\n", crc16.checksum());
550  *(p-1) = VirtexPacket::makeType1Write(crcRegister, crc16.checksum());
551  crc16.reset();
552  // reset CRC command
553  } else if(address == cmdRegister && wordCount >= 1 && packet[1] == rcrcCommand) {
554  crc16.reset();
555  // process packet contents
556  } else {
557  uint32_t j;
558  uint32_t mask;
559  for(uint32_t i = 1; i <= wordCount; i++) {
560  uint32_t word = packet[i];
561  //printf("Address: %4.4x\n", address);
562  //printf("Word: %8.8x\n", word);
563  for(j = 0, mask = 1; j < 32; j++, mask <<= 1) {
564  crc16.process_bit((word & mask) ? 1 : 0);
565  }
566  for(j = 0, mask = 1; j < addressLength; j++, mask <<= 1) {
567  crc16.process_bit((address & mask) ? 1 : 0);
568  }
569  }
570  // process the Auto CRC on Virtex2 and Virtex2P
571  if(autoCrc && address == fdriRegister) {
572  //printf("Expected Auto CRC16: %4.4x\n", packet[1]);
573  //printf("Calculated Auto CRC16: %4.4x\n", crc16.checksum());
574  *p = VirtexPacket(crc16.checksum()); // current word is FDRI, next is Auto CRC
575  crc16.reset();
576  }
577  }
578  }
579  }
boost::uint32_t uint32_t
Imported type name.
static VirtexPacket makeType1Write(uint32_t inAddress, uint32_t inWord)
Construct a type 1 write packet.

+ Here is the call graph for this function:

void torc::bitstream::VirtexBitstream::updateCrc32 ( torc::common::DeviceDesignator::EFamily  inFamily)
protectedvirtual

Update CRC-32 packets.

Definition at line 581 of file VirtexBitstream.cpp.

581  {
582  // set up family-specific variables
583  uint32_t crcRegister = 0;
584  uint32_t cmdRegister = 0;
585  uint32_t rcrcCommand = 0;
586  uint32_t addressLength = 5;
587  switch(inFamily) {
589  cmdRegister = Virtex4::eRegisterCMD; rcrcCommand = Virtex4::eCommandRCRC;
590  crcRegister = Virtex4::eRegisterCRC;
591  break;
593  cmdRegister = Virtex5::eRegisterCMD; rcrcCommand = Virtex5::eCommandRCRC;
594  crcRegister = Virtex5::eRegisterCRC;
595  break;
597  cmdRegister = Virtex6::eRegisterCMD; rcrcCommand = Virtex6::eCommandRCRC;
598  crcRegister = Virtex6::eRegisterCRC;
599  break;
602  cmdRegister = Virtex7::eRegisterCMD; rcrcCommand = Virtex7::eCommandRCRC;
603  crcRegister = Virtex7::eRegisterCRC;
604  break;
605  default:
606  std::cerr << "Unsupported architecture in VirtexBitstream::updateCrc32()." << std::endl;
607  break;
608  }
609  // begin CRC calculation
610  uint32_t address = 0;
611  iterator p = begin();
612  iterator e = end();
613  // CRC-32C (Castagnoli) polynomial for Virtex4/5/6/7 families
614  boost::crc_basic<32> crc32(0x1edc6f41, 0, 0, false, true);
615  while(p < e) {
616  // look up the current packet
617  const VirtexPacket& packet = *p++;
618  // only process write packets with non-zero payload length
619  if(!packet.isWrite()) continue;
620  if(packet.isType1()) address = packet.getAddress();
621  uint32_t wordCount = packet.getWordCount();
622  if(wordCount == 0) continue;
623  // CRC register write (this is what compares the expected and supplied CRC values)
624  if(address == crcRegister) {
625  //printf("Expected CRC32: %8.8x\n", packet[1]);
626  //printf("Calculated CRC32: %8.8x\n", crc32.checksum());
627  *(p-1) = VirtexPacket::makeType1Write(crcRegister, crc32.checksum());
628  crc32.reset();
629  // reset CRC command
630  } else if(address == cmdRegister && wordCount >= 1 && packet[1] == rcrcCommand) {
631  crc32.reset();
632  // process packet contents
633  } else {
634  uint32_t j;
635  uint32_t mask;
636  for(uint32_t i = 1; i <= wordCount; i++) {
637  uint32_t word = packet[i];
638  //printf("Address: %4.4x\n", address);
639  //printf("Word: %8.8x\n", word);
640  for(j = 0, mask = 1; j < 32; j++, mask <<= 1) {
641  crc32.process_bit((word & mask) ? 1 : 0);
642  }
643  for(j = 0, mask = 1; j < addressLength; j++, mask <<= 1) {
644  crc32.process_bit((address & mask) ? 1 : 0);
645  }
646  }
647  }
648  }
649  }
boost::uint32_t uint32_t
Imported type name.
static VirtexPacket makeType1Write(uint32_t inAddress, uint32_t inWord)
Construct a type 1 write packet.

+ Here is the call graph for this function:

void torc::bitstream::VirtexBitstream::updateFramePackets ( EBitstreamType  inBitstreamType = eBitstreamTypeFull,
EFrameInclude  inFrameInclusion = eFrameIncludeAllUsedFrames 
)
virtual

Update the bitstream frame packets By default this updates the bitstream with full frame data.

Parameters
inBitstreamTypeThe type of bitstream to generate: full or partial.
inFrameInclusionThe type of frames to include in partial bitstreams: only dirty frames or all frames.

Definition at line 46 of file VirtexBitstream.cpp.

47  {
48  // delete the existing frame packets
49  iterator position = deleteFramePackets();
50  // insert the new frame packets in place of the old ones
51  if(inBitstreamType == eBitstreamTypeFull) {
53  } else {
54  insert(position, generatePartialBitstreamPackets(inFrameInclusion));
55  }
56  }
virtual VirtexPacketVector generatePartialBitstreamPackets(EFrameInclude inFrameInclusion)
Return a packet vector with partial frame data.
iterator insert(iterator position, const value_type &val)
Regular std::vector inserter.
virtual VirtexPacketVector::iterator deleteFramePackets(void)
Discard the existing frame packets and return an iterator to the start position.
virtual VirtexPacketVector generateFullBitstreamPackets(void)
Return a packet vector with full frame data.

+ Here is the caller graph for this function:

void torc::bitstream::VirtexBitstream::updatePacketLength ( void  )
virtual

Update the header packet length.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 651 of file VirtexBitstream.cpp.

651  {
652  uint32_t totalWordCount = 0;
653  iterator p = begin();
654  iterator e = end();
655  while(p < e) totalWordCount += (p++)->getWordSize();
656  mBitstreamByteLength = totalWordCount << 2;
657  }
boost::uint32_t uint32_t
Imported type name.
uint32_t mBitstreamByteLength
Bitstream packet length in bytes.
void torc::bitstream::Bitstream::write ( std::ostream &  inStream,
uint8_t  inVal 
)
inlineinherited

Write a uint8_t to the stream.

Definition at line 67 of file bitstream/Bitstream.hpp.

67  {
68  uint8_t actual = inVal;
69  inStream.write((char*) &actual, sizeof(actual));
70  }
boost::uint8_t uint8_t
Imported type name.

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::write ( std::ostream &  inStream,
uint16_t  inVal 
)
inlineinherited

Write a uint16_t to the stream.

Definition at line 72 of file bitstream/Bitstream.hpp.

72  {
73  uint16_t actual = htons(inVal);
74  inStream.write((char*) &actual, sizeof(actual));
75  }
boost::uint16_t uint16_t
Imported type name.
void torc::bitstream::Bitstream::write ( std::ostream &  inStream,
uint32_t  inVal 
)
inlineinherited

Write a uint32_t to the stream.

Definition at line 77 of file bitstream/Bitstream.hpp.

77  {
78  uint32_t actual = htonl(inVal);
79  inStream.write((char*) &actual, sizeof(actual));
80  }
boost::uint32_t uint32_t
Imported type name.
virtual void torc::bitstream::Bitstream::write ( std::ostream &  inStream)
inlinevirtualinherited

Write the bitstream header and packets to a stream.

Definition at line 280 of file bitstream/Bitstream.hpp.

280  {
283  writeHeader(inStream);
284  writePackets(inStream);
285  }
virtual void updatePacketLength(void)
Update the header packet length.
virtual void preflightPackets(void)
Preflight the packets.
virtual void writeHeader(std::ostream &inStream)
Write the bitstream header to the stream.
virtual void writePackets(std::ostream &inStream)
Write the bitstream packets.

+ Here is the call graph for this function:

void torc::bitstream::Bitstream::writeDeviceInfo ( std::ostream &  inStream,
const std::string &  inDeviceName 
)
virtualinherited

Output static device information to a stream.

This is used to generate the static column maps for bitstream frame mapping.

Definition at line 74 of file Bitstream.cpp.

75  {
76  // write the device column composition
77  inStream << "\t// " << inDeviceName << " static device information." << std::endl;
78  inStream << "\tboost::uint32_t " << inDeviceName << "Columns[] = { ";
79  ColumnTypeVector::const_iterator p = mDeviceInfo.getColumnTypes().begin();
80  ColumnTypeVector::const_iterator e = mDeviceInfo.getColumnTypes().end();
81  while(p < e) inStream << mColumnDefs[*p++].getName() << ", ";
82  inStream << "END };" << std::endl;
83  // instantiate the device information
84  inStream << "\tDeviceInfo " << inDeviceName << "(" << mDeviceInfo.getTileCount() << ", "
85  << mDeviceInfo.getRowCount() << ", " << mDeviceInfo.getColCount() << ", "
86  << inDeviceName << "Columns);" << std::endl;
87  }
ColumnDefVector mColumnDefs
Column type widths.
uint16_t getRowCount(void) const
Returns the row count.
Definition: DeviceInfo.hpp:112
uint16_t getColCount(void) const
Returns the column count.
Definition: DeviceInfo.hpp:114
DeviceInfo mDeviceInfo
Device information.
const ColumnTypeVector & getColumnTypes(void) const
Returns the column type vector.
Definition: DeviceInfo.hpp:116
uint32_t getTileCount(void) const
Returns the tile count.
Definition: DeviceInfo.hpp:110

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

virtual void torc::bitstream::Bitstream::writeHeader ( std::ostream &  inStream)
inlinevirtualinherited

Write the bitstream header to the stream.

Definition at line 293 of file bitstream/Bitstream.hpp.

293  {
294  // write the magic length
295  write(inStream, uint16_t(0x0009));
296  // write the magic bytes with null termination
297  write(inStream, uint32_t(0x0ff00ff0));
298  write(inStream, uint32_t(0x0ff00ff0));
299  write(inStream, uint8_t(0x00));
300  // write the mysterious 0x0001
301  write(inStream, uint16_t(0x0001));
302  // write the 'a' byte and the design name
303  write(inStream, uint8_t('a'));
304  writeHeaderString(inStream, mDesignName);
305  // write the 'b' byte and the device name
306  write(inStream, uint8_t('b'));
307  writeHeaderString(inStream, mDeviceName);
308  // write the 'c' byte and the design date
309  write(inStream, uint8_t('c'));
310  writeHeaderString(inStream, mDesignDate);
311  // write the 'd' byte and the design time
312  write(inStream, uint8_t('d'));
313  writeHeaderString(inStream, mDesignTime);
314  // write the 'e' byte and the design name
315  write(inStream, uint8_t('e'));
316  write(inStream, uint32_t(mBitstreamByteLength));
317  }
void writeHeaderString(std::ostream &inStream, const string &inString)
Write a Xilinx-style header string to the stream.
string mDesignDate
Header design date.
string mDesignTime
Header design time.
string mDesignName
Header design name.
boost::uint8_t uint8_t
Imported type name.
boost::uint32_t uint32_t
Imported type name.
string mDeviceName
Header device name.
uint32_t mBitstreamByteLength
Bitstream packet length in bytes.
void write(std::ostream &inStream, uint8_t inVal)
Write a uint8_t to the stream.
boost::uint16_t uint16_t
Imported type name.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::writeHeaderString ( std::ostream &  inStream,
const string inString 
)
inlineinherited

Write a Xilinx-style header string to the stream.

Definition at line 82 of file bitstream/Bitstream.hpp.

82  {
83  // write the string length
84  uint16_t length = inString.length() + 1;
85  write(inStream, uint16_t(length));
86  inStream.write(inString.c_str(), length);
87  }
void write(std::ostream &inStream, uint8_t inVal)
Write a uint8_t to the stream.
boost::uint16_t uint16_t
Imported type name.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void torc::bitstream::VirtexBitstream::writePackets ( std::ostream &  inStream)
virtual

Write bitstream packets to a stream.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 40 of file VirtexBitstream.cpp.

40  {
41  const_iterator p = begin();
42  const_iterator e = end();
43  while(p < e) p++->write(inStream);
44  }
void torc::bitstream::Bitstream::writeSubfieldSettings ( std::ostream &  inStream,
uint32_t  inWord,
const Subfield inSubfields 
)
staticinherited

Insert 32 bit subfield settings into an output stream.

Definition at line 26 of file Bitstream.cpp.

27  {
28  // count the subfields
29  int subfieldCount = 0;
30  while(inSubfields[subfieldCount].mMask) subfieldCount++;
31  // generate the output
32  inStream << " (";
33  for(int index = subfieldCount; index > 0; index--) {
34  uint32_t field = index - 1;
35  const Subfield& subfield = inSubfields[field];
36  uint32_t value = (inWord & subfield.mMask) >> subfield.mShift;
37  inStream << (*subfield.mBitgenName == 0 ? subfield.mConfigGuideName
38  : subfield.mBitgenName) << ":";
39  const char** ptr = subfield.mValues;
40  for(uint32_t i = 0; ; i++) {
41  if(*ptr == 0) { inStream << "[UNKNOWN " << i << "]"; break; }
42  if(value == i) { inStream << *ptr; break; }
43  ptr++;
44  }
45  if(index > 1) inStream << ", ";
46  }
47  inStream << ")";
48  }
boost::uint32_t uint32_t
Imported type name.

+ Here is the caller graph for this function:

void torc::bitstream::Bitstream::writeSubfieldSettings ( std::ostream &  inStream,
uint16_t  inWord,
const Subfield inSubfields 
)
staticinherited

Insert 16 bit subfield settings into an output stream.

Definition at line 50 of file Bitstream.cpp.

51  {
52  // count the subfields
53  int subfieldCount = 0;
54  while(inSubfields[subfieldCount].mMask) subfieldCount++;
55  // generate the output
56  inStream << " (";
57  for(int index = subfieldCount; index > 0; index--) {
58  uint16_t field = index - 1;
59  const Subfield& subfield = inSubfields[field];
60  uint16_t value = (inWord & subfield.mMask) >> subfield.mShift;
61  inStream << (*subfield.mBitgenName == 0 ? subfield.mConfigGuideName
62  : subfield.mBitgenName) << ":";
63  const char** ptr = subfield.mValues;
64  for(uint16_t i = 0; ; i++) {
65  if(*ptr == 0) { inStream << "[UNKNOWN " << i << "]"; break; }
66  if(value == i) { inStream << *ptr; break; }
67  ptr++;
68  }
69  if(index > 1) inStream << ", ";
70  }
71  inStream << ")";
72  }
boost::uint16_t uint16_t
Imported type name.

Friends And Related Function Documentation

friend class torc::bitstream::bitstream::VirtexBitstreamUnitTest
friend

Definition at line 37 of file VirtexBitstream.hpp.

Field Documentation

uint32_t torc::bitstream::Bitstream::mBitstreamByteLength
inherited

Bitstream packet length in bytes.

This is the length in bytes of all the bitstream packets, without the bitstream header.

Definition at line 242 of file bitstream/Bitstream.hpp.

FrameSets for each of the eight block types.

Definition at line 88 of file FrameSet.hpp.

ColumnDefVector torc::bitstream::Bitstream::mColumnDefs
inherited

Column type widths.

Definition at line 249 of file bitstream/Bitstream.hpp.

string torc::bitstream::Bitstream::mDesignDate
inherited

Header design date.

Definition at line 236 of file bitstream/Bitstream.hpp.

string torc::bitstream::Bitstream::mDesignName
inherited

Header design name.

Definition at line 232 of file bitstream/Bitstream.hpp.

string torc::bitstream::Bitstream::mDesignTime
inherited

Header design time.

Definition at line 238 of file bitstream/Bitstream.hpp.

EDevice torc::bitstream::Bitstream::mDevice
inherited

Bitstream device enumeration.

Definition at line 230 of file bitstream/Bitstream.hpp.

DeviceInfo torc::bitstream::Bitstream::mDeviceInfo
inherited

Device information.

Definition at line 257 of file bitstream/Bitstream.hpp.

string torc::bitstream::Bitstream::mDeviceName
inherited

Header device name.

Definition at line 234 of file bitstream/Bitstream.hpp.

VirtexFrameBlocks torc::bitstream::VirtexBitstream::mFrameBlocks
protected

Input Frame blocks.

Definition at line 65 of file VirtexBitstream.hpp.

uint32_t torc::bitstream::Bitstream::mHeaderByteLength
inherited

Header length in bytes.

This is the length of the header itself, as opposed to mBitstreamByteLength, which is the length of bitstream reported by the header.

Definition at line 246 of file bitstream/Bitstream.hpp.

TileTypeIndexToColumnType torc::bitstream::Bitstream::mTileTypeIndexToColumnType
inherited

Definition at line 255 of file bitstream/Bitstream.hpp.

TileTypeNameToColumnType torc::bitstream::Bitstream::mTileTypeNameToColumnType
inherited

Definition at line 252 of file bitstream/Bitstream.hpp.


The documentation for this class was generated from the following files: