torc::bitstream::Spartan6 Class Reference

Spartan6 bitstream. More...

#include <Spartan6.hpp>

Inheritance diagram for torc::bitstream::Spartan6:

Collaboration diagram for torc::bitstream::Spartan6:

Data Structures
class	FrameMajorAddress
class	FrameMinorAddress

Public Types
enum	ERegister {   eRegisterCRC = 0, eRegisterFARMAJ, eRegisterFARMIN, eRegisterFDRI,   eRegisterFDRO, eRegisterCMD, eRegisterCTL, eRegisterMASK,   eRegisterSTAT, eRegisterLOUT, eRegisterCOR1, eRegisterCOR2,   eRegisterPWRDN_REG, eRegisterFLR, eRegisterIDCODE, eRegisterCWDT,   eRegisterHC_OPT_REG, eRegisterCSBO = 18, eRegisterGENERAL1, eRegisterGENERAL2,   eRegisterGENERAL3, eRegisterGENERAL4, eRegisterGENERAL5, eRegisterMODE_REG,   eRegisterPU_GWE, eRegisterPU_GTS, eRegisterMFWR, eRegisterCCLK_FREQ,   eRegisterSEU_OPT, eRegisterEXP_SIGN, eRegisterRDBK_SIGN, eRegisterBOOSTS,   eRegisterEYE_MASK, eRegisterCBC_REG, eRegisterCount }
	Configuration register enumeration. More...
enum	ECommand {   eCommandNULL = 0, eCommandWCFG, eCommandMFW, eCommandLFRM,   eCommandRCFG, eCommandSTART, eCommandRCRC = 7, eCommandAGHIGH,   eCommandGRESTORE = 10, eCommandSHUTDOWN, eCommandDESYNC = 13, eCommandIPROG,   eCommandCount }
	Configuration command enumeration for eRegisterCMD. More...
enum	EFarMaj {   eFarMajMaskBlock = 0xf000, eFarMajShiftBlock = 12, eFarMajMaskRow = 0x0f00, eFarMajShiftRow = 8,   eFarMajMaskMajor = 0x00ff, eFarMajShiftMajor = 0 }
	Frame Address Register Major subfields. More...
enum	EFarMin { eFarMinMaskBlock = 0xc000, eFarMinShiftBlock = 12, eFarMinMaskMinor = 0x01ff, eFarMinShiftMinor = 0 }
	Frame Address Register Minor subfields. More...
enum	EFarBlockType {   eFarBlockType0 = 0, eFarBlockType1, eFarBlockType2, eFarBlockType3,   eFarBlockType4, eFarBlockType5, eFarBlockType6, eFarBlockType7,   eFarBlockTypeCount }
	Frame Address Register top and bottom constants. More...
enum	{ eFrameLength = 41 }
	Frame length. More...
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 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 = 0xe000, ePacketShiftType = 13, ePacketMaskOpcode = 0x1800, ePacketShiftOpcode = 11,   ePacketMaskTypeAddress = 0x07e0, ePacketShiftTypeAddress = 5, ePacketMaskType1Count = 0x001f, ePacketShiftType1Count = 0,   ePacketMaskType2Count0 = 0xffff, ePacketShiftType2Count0 = 0, ePacketMaskType2Count1 = 0xffff, ePacketShiftType2Count1 = 0 }
	Packet subfields. More...
enum	ESynchronization {   eSynchronizationDummy = 0xffff, eSynchronizationSync0 = 0xaa99, eSynchronizationSync1 = 0x5566, eSynchronizationBusWidthSync0 = 0x0000,   eSynchronizationBusWidthSync1 = 0x00bb, eSynchronizationBusWidthDetect0 = 0x1122, eSynchronizationBusWidthDetect1 = 0x0044 }
	Synchronization words. More...

Public Member Functions
virtual uint32_t	getFrameLength (void) const
	Return the frame length for the current device. 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	preflightPackets (void)
	Preflight the packets. More...
virtual void	updatePacketLength (void)
	Update the header packet length. 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 string &	getDesignName (void) const
	Return the design name. More...
const string &	getDeviceName (void) const
	Return the device name. More...
const string &	getDesignDate (void) const
	Return the design date. More...
const string &	getDesignTime (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...

Static Public Member Functions
static uint16_t	makeSubfield (ERegister inRegister, const std::string &inSubfield, const std::string &inSetting)
	Return the masked value for a subfield of the specified register. More...
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...

Protected Types
typedef boost::uint16_t	uint16_t
	Imported type name. More...
typedef boost::uint32_t	uint32_t

Static Protected Attributes
static const char *	sPacketTypeName [ePacketTypeCount]
	Packet type names. More...
static const char *	sOpcodeName [eOpcodeCount]
	Packet opcode names. More...
static const char *	sRegisterName [eRegisterCount]
	Configuration register names. More...
static const char *	sCommandName [eCommandCount]
	Configuration command names. More...
static const Subfield	sCOR1 []
	Configuration Options Register 1 (COR1) subfields. More...
static const Subfield	sCOR2 []
	Configuration Options Register 2 (COR2) subfields. More...
static const Subfield	sSTAT []
	Status Register (STAT) subfields. More...
static const Subfield	sCTL []
	Control Register 0 (CTL0) subfields. More...
static const Subfield	sMASK []
	Control Mask Register (MASK) subfields. More...
static const Subfield	sPWRDN_REG []
	Suspend Register (PWRDN_REG) subfields. More...
static const Subfield	sHC_OPT_REG []
	HC_OPT_REG Register (PWRDN_REG) subfields. More...
static const Subfield	sMODE_REG []
	Mode Register (Mode) subfields. More...
static const Subfield	sBOOSTS []
	BOOSTS Register (BOOSTS) subfields. More...
static const Subfield	sSEU_OPT []
	SEU_OPT Register (SEU_OPT) subfields. More...

Friends
class	torc::bitstream::bitstream::Spartan6UnitTest
std::ostream &	operator<< (std::ostream &os, const Spartan6 &rhs)
	Insert the bitstream header into an output stream. More...

Detailed Description

Spartan6 bitstream.

Definition at line 31 of file Spartan6.hpp.

Member Typedef Documentation

typedef torc::common::EDevice torc::bitstream::Bitstream::EDevice

inherited

Imported type name.

Definition at line 64 of file bitstream/Bitstream.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.

typedef std::map<uint16_t, uint32_t> torc::bitstream::Bitstream::TileTypeIndexToColumnType

inherited

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::Spartan6::uint16_t

protected

Imported type name.

Definition at line 36 of file Spartan6.hpp.

typedef boost::uint32_t torc::bitstream::Spartan6::uint32_t

protected

Definition at line 37 of file Spartan6.hpp.

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

inherited

Imported type name.

Definition at line 61 of file bitstream/Bitstream.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.

{ eBlockTypeCount = 8 };

anonymous enum

Frame length.

Constant frame length of 41 32-bit words for the entire Spartan6 family. Note that this length applies only to non-IOB frames. IOB frame lengths are defined by the bitstream FLR register plus one.

Enumerator
eFrameLength

Definition at line 82 of file Spartan6.hpp.

{ eFrameLength = 41 };

enum torc::bitstream::Bitstream::EBitstreamType

inherited

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.

                            { eBitstreamTypeFull, eBitstreamTypePartialActive, 
            eBitstreamTypePartialShutdown };

enum torc::bitstream::Spartan6::ECommand

Configuration command enumeration for eRegisterCMD.

See Also

CMD register commands: UG380, v2.2, July 30, 2010 Table 5-33

Enumerator
eCommandNULL
eCommandWCFG
eCommandMFW
eCommandLFRM
eCommandRCFG
eCommandSTART
eCommandRCRC
eCommandAGHIGH
eCommandGRESTORE
eCommandSHUTDOWN
eCommandDESYNC
eCommandIPROG
eCommandCount

Definition at line 54 of file Spartan6.hpp.

                      { eCommandNULL = 0, eCommandWCFG, eCommandMFW, eCommandLFRM, eCommandRCFG, 
            eCommandSTART, eCommandRCRC = 7, eCommandAGHIGH, eCommandGRESTORE = 10, 
            eCommandSHUTDOWN, eCommandDESYNC = 13, eCommandIPROG, eCommandCount };

enum torc::bitstream::Spartan6::EFarBlockType

Frame Address Register top and bottom constants.

Frame Address Register block type constants.

Enumerator
eFarBlockType0
eFarBlockType1
eFarBlockType2
eFarBlockType3
eFarBlockType4
eFarBlockType5
eFarBlockType6
eFarBlockType7
eFarBlockTypeCount

Definition at line 76 of file Spartan6.hpp.

                           { eFarBlockType0 = 0, eFarBlockType1, eFarBlockType2, eFarBlockType3, 
            eFarBlockType4, eFarBlockType5, eFarBlockType6, eFarBlockType7, eFarBlockTypeCount };

enum torc::bitstream::Spartan6::EFarMaj

Frame Address Register Major subfields.

See Also

Frame Address Register Major Description: UG380, v2.2, July 30, 2010 Table 5-31

Enumerator
eFarMajMaskBlock
eFarMajShiftBlock
eFarMajMaskRow
eFarMajShiftRow
eFarMajMaskMajor
eFarMajShiftMajor

Definition at line 60 of file Spartan6.hpp.

                     {
            eFarMajMaskBlock =  0xf000,     eFarMajShiftBlock = 12,
            eFarMajMaskRow =    0x0f00,     eFarMajShiftRow =    8,
            eFarMajMaskMajor =  0x00ff,     eFarMajShiftMajor =  0
        };

enum torc::bitstream::Spartan6::EFarMin

Frame Address Register Minor subfields.

See Also

Frame Address Register Minor Description: UG380, v2.2, July 30, 2010 Table 5-32

Enumerator
eFarMinMaskBlock
eFarMinShiftBlock
eFarMinMaskMinor
eFarMinShiftMinor

Definition at line 68 of file Spartan6.hpp.

                     {
            eFarMinMaskBlock =  0xc000,     eFarMinShiftBlock = 12,
            eFarMinMaskMinor =  0x01ff,     eFarMinShiftMinor =  0
        };

enum torc::bitstream::Bitstream::EFrameInclude

inherited

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.

{ eFrameIncludeOnlyDirtyFrames, eFrameIncludeAllUsedFrames };

enum torc::bitstream::Spartan6PacketConstants::EOpcode

inherited

Packet opcode enumeration.

See Also

Opcode Format: UG380, v2.2, July 30, 2010, Table 5-23

Enumerator
eOpcodeNOP
eOpcodeRead
eOpcodeWrite
eOpcodeReserved
eOpcodeCount

Definition at line 44 of file Spartan6Packet.hpp.

{ eOpcodeNOP = 0, eOpcodeRead, eOpcodeWrite, eOpcodeReserved, eOpcodeCount };

enum torc::bitstream::Spartan6PacketConstants::EPacket

inherited

Packet subfields.

See Also

type 1 packet format: UG380, v2.2, July 30, 2010, Table 5-24

type 2 packet format: UG380, v2.2, July 30, 2010, Table 5-26

type 2 packet format: UG380, v2.2, July 30, 2010, Table 5-27

Enumerator
ePacketMaskType
ePacketShiftType
ePacketMaskOpcode
ePacketShiftOpcode
ePacketMaskTypeAddress
ePacketShiftTypeAddress
ePacketMaskType1Count
ePacketShiftType1Count
ePacketMaskType2Count0
ePacketShiftType2Count0
ePacketMaskType2Count1
ePacketShiftType2Count1

Definition at line 49 of file Spartan6Packet.hpp.

                     {
            // generic packet subfields
            ePacketMaskType =            0xe000,        ePacketShiftType =            13,
            ePacketMaskOpcode =          0x1800,        ePacketShiftOpcode =          11,
            ePacketMaskTypeAddress =     0x07e0,        ePacketShiftTypeAddress =      5,
          // type 1 packet subfields
            ePacketMaskType1Count =      0x001f,        ePacketShiftType1Count =       0,
            // type 2 packet subfields
            ePacketMaskType2Count0 =     0xffff,        ePacketShiftType2Count0 =      0,
            ePacketMaskType2Count1 =     0xffff,        ePacketShiftType2Count1 =      0
        };

enum torc::bitstream::Spartan6PacketConstants::EPacketType

inherited

Packet type enumeration.

See Also

packet type: UG380, v2.2, July 30, 2010, Table 5-24, 5-26

Enumerator
ePacketType1
ePacketType2
ePacketTypeCount

Definition at line 40 of file Spartan6Packet.hpp.

{ ePacketType1 = 1, ePacketType2, ePacketTypeCount = 8 };

enum torc::bitstream::Spartan6::ERegister

Configuration register enumeration.

See Also

configuration registers: UG380, v2.2, July 30, 2010 Table 5-30

Enumerator
eRegisterCRC
eRegisterFARMAJ
eRegisterFARMIN
eRegisterFDRI
eRegisterFDRO
eRegisterCMD
eRegisterCTL
eRegisterMASK
eRegisterSTAT
eRegisterLOUT
eRegisterCOR1
eRegisterCOR2
eRegisterPWRDN_REG
eRegisterFLR
eRegisterIDCODE
eRegisterCWDT
eRegisterHC_OPT_REG
eRegisterCSBO
eRegisterGENERAL1
eRegisterGENERAL2
eRegisterGENERAL3
eRegisterGENERAL4
eRegisterGENERAL5
eRegisterMODE_REG
eRegisterPU_GWE
eRegisterPU_GTS
eRegisterMFWR
eRegisterCCLK_FREQ
eRegisterSEU_OPT
eRegisterEXP_SIGN
eRegisterRDBK_SIGN
eRegisterBOOSTS
eRegisterEYE_MASK
eRegisterCBC_REG
eRegisterCount

Definition at line 43 of file Spartan6.hpp.

                       { eRegisterCRC = 0, eRegisterFARMAJ, eRegisterFARMIN, eRegisterFDRI, 
            eRegisterFDRO, eRegisterCMD, eRegisterCTL, eRegisterMASK, eRegisterSTAT, eRegisterLOUT, 
            eRegisterCOR1, eRegisterCOR2, eRegisterPWRDN_REG, eRegisterFLR, eRegisterIDCODE, 
            eRegisterCWDT, eRegisterHC_OPT_REG, eRegisterCSBO = 18, eRegisterGENERAL1, 
            eRegisterGENERAL2, eRegisterGENERAL3, eRegisterGENERAL4, eRegisterGENERAL5, 
            eRegisterMODE_REG, eRegisterPU_GWE, eRegisterPU_GTS, eRegisterMFWR, eRegisterCCLK_FREQ, 
            eRegisterSEU_OPT, eRegisterEXP_SIGN, eRegisterRDBK_SIGN, eRegisterBOOSTS, 
            eRegisterEYE_MASK, eRegisterCBC_REG, eRegisterCount };

enum torc::bitstream::Spartan6PacketConstants::ESynchronization

inherited

Synchronization words.

See Also

Configuration Sequence: UG380, v2.2, July 30, 2010, Table 5-50.

Enumerator
eSynchronizationDummy
eSynchronizationSync0
eSynchronizationSync1
eSynchronizationBusWidthSync0
eSynchronizationBusWidthSync1
eSynchronizationBusWidthDetect0
eSynchronizationBusWidthDetect1

Definition at line 63 of file Spartan6Packet.hpp.

                              {
            eSynchronizationDummy =           0xffff,
            eSynchronizationSync0 =           0xaa99,
            eSynchronizationSync1 =           0x5566,
            eSynchronizationBusWidthSync0 =   0x0000,
            eSynchronizationBusWidthSync1 =   0x00bb,
            eSynchronizationBusWidthDetect0 = 0x1122,
            eSynchronizationBusWidthDetect1 = 0x0044
        };

Member Function Documentation

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.

                                    {
            // some versions of the tools leave spaces inside the date and time fields
            size_t pos = 0;
            while((pos = mDesignDate.find(' ', pos)) != string::npos) mDesignDate[pos] = '0';
            pos = 0;
            while((pos = mDesignTime.find(' ', pos)) != string::npos) mDesignTime[pos] = '0';
        }

Here is the caller 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.

                                                                     {
            // read the actual data from the stream
            uint8_t actual = 0;
            inStream.read((char*) &actual, sizeof(actual));
            // return equality
            return inExpected == actual;
        }

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.

                                                                      {
            // read the actual data from the stream
            uint16_t actual = 0;
            inStream.read((char*) &actual, sizeof(actual));
            // return equality
            return inExpected == ntohs(actual);
        }

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.

                                                                      {
            // read the actual data from the stream
            uint32_t actual = 0;
            inStream.read((char*) &actual, sizeof(actual));
            // return equality
            return inExpected == ntohl(actual);
        }

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.

{ return mBitstreamByteLength; }

const string& torc::bitstream::Bitstream::getDesignDate ( void  ) const

inlineinherited

Return the design date.

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

{ return mDesignDate; }

const string& torc::bitstream::Bitstream::getDesignName ( void  ) const

inlineinherited

Return the design name.

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

{ return mDesignName; }

const string& torc::bitstream::Bitstream::getDesignTime ( void  ) const

inlineinherited

Return the design time.

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

{ return mDesignTime; }

const string& torc::bitstream::Bitstream::getDeviceName ( void  ) const

inlineinherited

Return the device name.

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

{ return mDeviceName; }

Here is the caller graph for this function:

virtual uint32_t torc::bitstream::Spartan6::getFrameLength ( void  ) const

inlinevirtual

Return the frame length for the current device.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 178 of file Spartan6.hpp.

{ return eFrameLength; }

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.

{ return mHeaderByteLength; }

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.

{}

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.

{}

uint16_t torc::bitstream::Spartan6::makeSubfield ( ERegister  inRegister, const std::string &  inSubfield, const std::string &  inSetting  )

static

Return the masked value for a subfield of the specified register.

Definition at line 329 of file Spartan6.cpp.

                                    {
        const Subfield* subfields;
        switch(inRegister) {
        case eRegisterCOR1: subfields = sCOR1; break;
        case eRegisterCOR2: subfields = sCOR2; break;
        case eRegisterSTAT: subfields = sSTAT; break;
        case eRegisterCTL: subfields = sCTL; break;
        case eRegisterMASK: subfields = sMASK; break;
        case eRegisterPWRDN_REG: subfields = sPWRDN_REG; break;
        case eRegisterHC_OPT_REG: subfields = sHC_OPT_REG; break;
        case eRegisterMODE_REG: subfields = sMODE_REG; break;
        case eRegisterBOOSTS: subfields = sBOOSTS; break;
        case eRegisterSEU_OPT: subfields = sSEU_OPT; break;
        default: return 0;
        }
        for(uint16_t field = 0; subfields[field].mMask != 0; field++) {
            const Subfield& subfield = subfields[field];
            if(inSubfield != subfield.mBitgenName && inSubfield != subfield.mConfigGuideName) 
                continue;
            const char** ptr = subfield.mValues;
            for(uint32_t i = 0; *ptr != 0; i++, ptr++) {
                if(inSetting == *ptr) return (i << subfield.mShift) & subfield.mMask;
            }
        }
        return 0;
    }

Here is the caller graph for this function:

void torc::bitstream::Spartan6Bitstream::preflightPackets ( void  )

virtualinherited

Preflight the packets.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 53 of file Spartan6Bitstream.cpp.

                                                 {
        // determine which architecture this is
        DeviceDesignator deviceDesignator(getDeviceName());
        DeviceDesignator::EFamily family = deviceDesignator.getFamily();
        // set up family-specific variables
        uint32_t crcRegister = 0;
        uint32_t cmdRegister = 0;
        uint32_t fdriRegister = 0;
        uint32_t rcrcCommand = 0;
        uint32_t addressLength = 0;
        bool autoCrc = false;
        switch(family) {
        case DeviceDesignator::eFamilySpartan6: 
            cmdRegister = Spartan6::eRegisterCMD; rcrcCommand = Spartan6::eCommandRCRC; 
            fdriRegister = Spartan6::eRegisterFDRI; crcRegister = Spartan6::eRegisterCRC; 
            /*addressLength = 6*/ (void) addressLength; autoCrc = true; 
            break;
        default:
            std::cerr << "Unsupported architecture in Spartan6Bitstream::preflightPackets()."
                << std::endl;
            break;
        }
        // begin CRC calculation: calculation is derived from one of the following simulation files:
        //      ISE/verilog/src/unisims/SIM_CONFIG_S6.v
        //      ISE/vhdl/src/unisims/primitive/SIM_CONFIG_S6.vhd
        CRC crc;
        iterator p = begin();
        iterator e = end();
        while(p < e) {
            // look up the current packet
            const Spartan6Packet& packet = *p++;
            // only process write packets with non-zero payload length
            if(!packet.isWrite()) continue;
            uint32_t address = packet.getAddress();
            uint32_t wordCount = packet.getWordCount();
            if(wordCount == 0) continue;
            // CRC register write (this is what compares the expected and supplied CRC values)
            if(address == crcRegister) {
                //printf("Expected CRC16:   %8.8x\n", uint32_t(packet[1]) << 16 | packet[2]);
                //printf("Calculated CRC16: %8.8x\n", uint32_t(crc));
                *(p-1) = Spartan6Packet::makeType1Write32(crcRegister, crc);
                crc.reset();
            // reset CRC command
            } else if(address == cmdRegister && wordCount >= 1 && packet[1] == rcrcCommand) {
                crc.reset();
            // registers that are omitted from CRC calculation
            } else if(address == Spartan6::eRegisterBOOSTS || address == Spartan6::eRegisterSTAT 
                || address == Spartan6::eRegisterLOUT || address == Spartan6::eRegisterCSBO 
                || address == Spartan6::eRegisterRDBK_SIGN || address == Spartan6::eRegisterFDRO) {
            // process packet contents
            } else {
                for(uint32_t i = 1; i <= wordCount; i++) {
                    uint32_t word = packet[i];
                    //printf("Address: %4.4x\n", address);
                    //printf("Word: %8.8x\n", word);
                    crc.update(address, word);
                    // debugging output
                    //for(int32_t c = sizeof(crc_curr) - 1; c >= 0; c--) printf("%d", crc_curr[c]);
                    //printf("\n");
                }
                // process the Auto CRC
                if(autoCrc && address == fdriRegister) {
                    //printf("Expected Auto CRC16:   %8.8x\n", (uint32_t((*p)[0]) << 16) | (*p)[1]);
                    //printf("Calculated Auto CRC16: %8.8x\n", uint32_t(crc));
                    // current packet is FDRI, next is Auto CRC
                    *p = Spartan6Packet(crc >> 16, crc & 0xffff);
                    // unlike the Spartan3E, the CRC is not reset after an Auto CRC
                    //crc.reset();
                }
            }
        }
    }

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.

                                                                                {
            readHeader(inStream);
            readPackets(inStream);
            if(inCleanDateAndTime) cleanDateAndTime();
        }

Here is the call graph for this function:

Here is the caller 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.

                                                                     {
            // assume success unless we find otherwise
            bool success = true;
            // read the magic length
            success &= expect(inStream, uint16_t(0x0009));
            // read the magic bytes
            success &= expect(inStream, uint32_t(0x0ff00ff0));
            success &= expect(inStream, uint32_t(0x0ff00ff0));
            success &= expect(inStream, uint8_t(0x00));
            // read the mysterious 0x0001
            success &= expect(inStream, uint16_t(0x0001));
            // read the 'a' byte
            success &= expect(inStream, uint8_t('a'));
            // read the design name length
            readHeaderString(inStream, outDesignName);
            // read the 'b' byte
            success &= expect(inStream, uint8_t('b'));
            // read the device name length
            readHeaderString(inStream, outDeviceName);
            // read the 'c' byte
            success &= expect(inStream, uint8_t('c'));
            // read the design date length
            readHeaderString(inStream, outDesignDate);
            // read the 'd' byte
            success &= expect(inStream, uint8_t('d'));
            // read the design time length
            readHeaderString(inStream, outDesignTime);
            // read the 'e' byte
            success &= expect(inStream, uint8_t('e'));
            // read the inStream length
            inStream.read((char*) &outBitstreamLength, sizeof(outBitstreamLength));
            outBitstreamLength = ntohl(outBitstreamLength);
            // determine the header length
            outHeaderLength = 34 + outDesignName.length() + outDeviceName.length() 
                + outDesignDate.length() + outDesignTime.length();
            // return the result
            return success;
        }

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.

                                                      {
            readHeader(inStream, mDesignName, mDeviceName, mDesignDate, mDesignTime, 
                mBitstreamByteLength, mHeaderByteLength);
            setDevice(mDeviceName);
        }

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.

                                                                              {
            // read the string length
            uint16_t length = 0;
            inStream.read((char*) &length, sizeof(length));
            length = ntohs(length);
            if(length > 0) {
                // create a buffer
                char* buffer = new char[length];
                // read the null-terminated string
                inStream.read(buffer, length);
                // copy the data into the string
                outString.assign(buffer, length - 1);
                delete[] buffer;
            } else {
                outString.clear();
            }
        }

Here is the caller graph for this function:

void torc::bitstream::Spartan6Bitstream::readPackets ( std::istream &  inStream )

virtualinherited

Read bitstream packets from a stream.

Note

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

Reimplemented from torc::bitstream::Bitstream.

Definition at line 27 of file Spartan6Bitstream.cpp.

                                                            {
        uint16_t bitstreamWordLength = mBitstreamByteLength >> 1;
        uint16_t cumulativeWordLength = 0;
        while(cumulativeWordLength < bitstreamWordLength) {
            push_back(Spartan6Packet::read(inStream));
            uint32_t wordSize = back().getWordSize();
            cumulativeWordLength += wordSize;
            // infer Auto CRCs for writes equal to or longer than one frame (not rigorously correct)
            if(wordSize <= getFrameLength()) continue;
            uint16_t autoCrcHi = 0;
            uint16_t autoCrcLo = 0;
            inStream.read((char*) &autoCrcHi, sizeof(autoCrcHi));
            inStream.read((char*) &autoCrcLo, sizeof(autoCrcLo));
            autoCrcHi = ntohs(autoCrcHi);
            autoCrcLo = ntohs(autoCrcLo);
            push_back(Spartan6Packet(autoCrcHi, autoCrcLo));
            cumulativeWordLength += 2;
        }
    }

void torc::bitstream::Bitstream::setDesignDate ( const string &  inDesignDate )

inlineinherited

Set the design date.

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

{ mDesignDate = inDesignDate; }

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.

{ mDesignName = inDesignName; }

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.

{ mDesignTime = inDesignTime; }

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.

                                                      {
            mDevice = torc::common::Devices::getDeviceEnum(inDeviceName);
        }

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.

{ mDeviceInfo = rhs; }

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.

{ mDeviceName = inDeviceName; }

Here is the caller graph for this function:

void torc::bitstream::Spartan6Bitstream::updatePacketLength ( void  )

virtualinherited

Update the header packet length.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 126 of file Spartan6Bitstream.cpp.

                                                   {
        uint32_t totalWordCount = 0;
        iterator p = begin();
        iterator e = end();
        while(p < e) totalWordCount += (p++)->getWordSize();
        mBitstreamByteLength = totalWordCount << 1;
    }

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.

                                                        {
            uint8_t actual = inVal;
            inStream.write((char*) &actual, sizeof(actual));
        }

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.

                                                         {
            uint16_t actual = htons(inVal);
            inStream.write((char*) &actual, sizeof(actual));
        }

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.

                                                         {
            uint32_t actual = htonl(inVal);
            inStream.write((char*) &actual, sizeof(actual));
        }

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.

                                                 {
            preflightPackets();
            updatePacketLength();
            writeHeader(inStream);
            writePackets(inStream);
        }

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.

                                       {
        // write the device column composition
        inStream << "\t// " << inDeviceName << " static device information." << std::endl;
        inStream << "\tboost::uint32_t " << inDeviceName << "Columns[] = { ";
        ColumnTypeVector::const_iterator p = mDeviceInfo.getColumnTypes().begin();
        ColumnTypeVector::const_iterator e = mDeviceInfo.getColumnTypes().end();
        while(p < e) inStream << mColumnDefs[*p++].getName() << ", ";
        inStream << "END };" << std::endl;
        // instantiate the device information
        inStream << "\tDeviceInfo " << inDeviceName << "(" << mDeviceInfo.getTileCount() << ", " 
            << mDeviceInfo.getRowCount() << ", " << mDeviceInfo.getColCount() << ", " 
            << inDeviceName << "Columns);" << std::endl;
    }

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.

                                                       {
            // write the magic length
            write(inStream, uint16_t(0x0009));
            // write the magic bytes with null termination
            write(inStream, uint32_t(0x0ff00ff0));
            write(inStream, uint32_t(0x0ff00ff0));
            write(inStream, uint8_t(0x00));
            // write the mysterious 0x0001
            write(inStream, uint16_t(0x0001));
            // write the 'a' byte and the design name
            write(inStream, uint8_t('a'));
            writeHeaderString(inStream, mDesignName);
            // write the 'b' byte and the device name
            write(inStream, uint8_t('b'));
            writeHeaderString(inStream, mDeviceName);
            // write the 'c' byte and the design date
            write(inStream, uint8_t('c'));
            writeHeaderString(inStream, mDesignDate);
            // write the 'd' byte and the design time
            write(inStream, uint8_t('d'));
            writeHeaderString(inStream, mDesignTime);
            // write the 'e' byte and the design name
            write(inStream, uint8_t('e'));
            write(inStream, uint32_t(mBitstreamByteLength));
        }

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.

                                                                             {
            // write the string length
            uint16_t length = inString.length() + 1;
            write(inStream, uint16_t(length));
            inStream.write(inString.c_str(), length);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

void torc::bitstream::Spartan6Bitstream::writePackets ( std::ostream &  inStream )

virtualinherited

Write bitstream packets to a stream.

Reimplemented from torc::bitstream::Bitstream.

Definition at line 47 of file Spartan6Bitstream.cpp.

                                                             {
        const_iterator p = begin();
        const_iterator e = end();
        while(p < e) p++->write(inStream);
    }

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.

                                     {
        // count the subfields
        int subfieldCount = 0;
        while(inSubfields[subfieldCount].mMask) subfieldCount++;
        // generate the output
        inStream << " (";
        for(int index = subfieldCount; index > 0; index--) {
            uint32_t field = index - 1;
            const Subfield& subfield = inSubfields[field];
            uint32_t value = (inWord & subfield.mMask) >> subfield.mShift;
            inStream << (*subfield.mBitgenName == 0 ? subfield.mConfigGuideName 
                : subfield.mBitgenName) << ":";
            const char** ptr = subfield.mValues;
            for(uint32_t i = 0; ; i++) {
                if(*ptr == 0) { inStream << "[UNKNOWN " << i << "]"; break; }
                if(value == i) { inStream << *ptr; break; }
                ptr++;
            }
            if(index > 1) inStream << ", ";
        }
        inStream << ")";
    }

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.

                                     {
        // count the subfields
        int subfieldCount = 0;
        while(inSubfields[subfieldCount].mMask) subfieldCount++;
        // generate the output
        inStream << " (";
        for(int index = subfieldCount; index > 0; index--) {
            uint16_t field = index - 1;
            const Subfield& subfield = inSubfields[field];
            uint16_t value = (inWord & subfield.mMask) >> subfield.mShift;
            inStream << (*subfield.mBitgenName == 0 ? subfield.mConfigGuideName 
                : subfield.mBitgenName) << ":";
            const char** ptr = subfield.mValues;
            for(uint16_t i = 0; ; i++) {
                if(*ptr == 0) { inStream << "[UNKNOWN " << i << "]"; break; }
                if(value == i) { inStream << *ptr; break; }
                ptr++;
            }
            if(index > 1) inStream << ", ";
        }
        inStream << ")";
    }

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  os, const Spartan6 &  rhs  )

friend

Insert the bitstream header into an output stream.

Definition at line 222 of file bitstream/OutputStreamHelpers.cpp.

                                                                 {
        // insert the bitstream header
        // be careful to cast this as a Spartan6Bitstream, rather than an ordinary Bitstream
        os << static_cast<const Spartan6Bitstream>(rhs) << std::endl;
        uint32_t cumulativeWordLength = 0;

        // iterate over the packets
        Spartan6::ERegister address = Spartan6::ERegister();
        //SpartanPacketVector::const_iterator p = rhs.begin();
        std::vector<Spartan6Packet>::const_iterator p = rhs.begin();
        //SpartanPacketVector::const_iterator e = rhs.end();
        std::vector<Spartan6Packet>::const_iterator e = rhs.end();
        while(p < e) {

            // insert the byte address
            os << "    " << Hex32(rhs.getHeaderByteLength() + (cumulativeWordLength << 1)) << ": ";
            // look up the packet
            const Spartan6Packet& packet = *p++;
            cumulativeWordLength += packet.getWordSize();

            // handle dummy words
            if(packet.isDummyWord()) {
                os << "DUMMY" << std::endl;

            // handle sync words
            } else if(packet.isSyncWord0()) {
                os << "SYNC0" << std::endl;

                // handle sync words
            } else if(packet.isSyncWord1()) {
                os << "SYNC1" << std::endl;

            // handle reserved packets
            } else if(packet.isReserved()) {
                os << Spartan6::sOpcodeName[packet.getOpcode()] << std::endl;
            
            // handle NOP packets
            } else if(packet.isNop()) {
                int nops = 1;
                while(p < e && p->isNop()) { nops++; p++; }
                cumulativeWordLength += nops - 1;
                os << "NOP x " << nops << std::endl;

            // handle regular type 1 or type 2 packets
            } else {

                // look up the packet details
                Spartan6::EPacketType type = packet.getType();
                Spartan6::EOpcode opcode = packet.getOpcode();
                uint32_t wordCount = packet.getWordCount();
                const uint16_t word = packet[1];
                const uint32_t word32 = (packet[1] << 16) | packet[2];

                // account for the packet type
                os << Spartan6::sPacketTypeName[type];
                switch(type) {
                case Spartan6::ePacketType1: 
                case Spartan6::ePacketType2: 
                    address = Spartan6::ERegister(packet.getAddress());
                    break;
                default: 
                    os << std::endl;
                    continue;
                }

                // handle read packets
                if(opcode == packet.isRead()) {
                    os << " READ " << Spartan6::sRegisterName[address];

                // handle write packets
                } else if(opcode == Spartan6::eOpcodeWrite) {
                    os << " WRITE " << Spartan6::sRegisterName[address];
                    // process according to register address
                    switch(address) {
                    case Spartan6::eRegisterCMD: 
                        os << " " << Spartan6::sCommandName[word];
                        break;
                    case Spartan6::eRegisterCOR1:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sCOR1);
                        break;
                    case Spartan6::eRegisterCOR2:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sCOR2);
                        break;
                    case Spartan6::eRegisterSTAT:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sSTAT);
                        break;
                    case Spartan6::eRegisterCTL:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sCTL);
                        break;
                    case Spartan6::eRegisterMASK:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sMASK);
                        break;
                    case Spartan6::eRegisterPWRDN_REG:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sPWRDN_REG);
                        break;
                    case Spartan6::eRegisterHC_OPT_REG:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sHC_OPT_REG);
                        break;
                    case Spartan6::eRegisterMODE_REG:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sMODE_REG);
                        break;
                    case Spartan6::eRegisterBOOSTS:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sBOOSTS);
                        break;
                    case Spartan6::eRegisterSEU_OPT:
                        os << ": " << Hex16(word);
                        Spartan6::writeSubfieldSettings(os, uint16_t(word), Spartan6::sSEU_OPT);
                        break;
                    case Spartan6::eRegisterRDBK_SIGN:
                        os << ": " << Hex32(word32);
                        break;
                    case Spartan6::eRegisterIDCODE:
                        os << ": " << Hex32(word32);
                        break;
                    case Spartan6::eRegisterCRC:
                        os << ": " << Hex32(word32);
                        break;
                    case Spartan6::eRegisterFDRI:
                        os << ": " << Hex32(wordCount) << " words";
                        if(wordCount == 0) break;
                        // include the Auto CRC information
                        os << std::endl << "    ";
                        os << Hex32(rhs.getHeaderByteLength() + (cumulativeWordLength << 1)) 
                            << ": Auto CRC: " << Hex32((uint32_t((*p)[0]) << 16) | (*p)[1]);
                        cumulativeWordLength += 2;
                        p++;
                        break;
                    case Spartan6::eRegisterFARMAJ:
                        // Only updates the FAR Major
                        if(wordCount == 1) 
                            os << ": " << Hex16(packet[1]);
                        // Updates both the FAR Major and Minor address
                        // Word 1: FAR Major
                        // Word 2: FAR Minor
                        else if(wordCount == 2) 
                            os << ": " << Hex32((uint32_t(packet[1]) << 16) | packet[2]);
                        break;
                    default:
                        // output the register contents
                        os << ": " << Hex16(word);
                        break;
                    }
                    os << std::endl;
                }

            }

        }

        // return the stream reference
        return os;
    }

friend class torc::bitstream::bitstream::Spartan6UnitTest

friend

Definition at line 32 of file Spartan6.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.

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.

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.

const Bitstream::Subfield torc::bitstream::Spartan6::sBOOSTS

staticprotected

BOOSTS Register (BOOSTS) subfields.

See Also

BOOSTS Register Description: UG380, v2.2, July 30, 2010, Table 5-48

Definition at line 112 of file Spartan6.hpp.

const char * torc::bitstream::Spartan6::sCommandName

staticprotected

Initial value:

= {
        "NULL", "WCFG", "MFW", "LFRM", "RCFG", "START", "[UNKNOWN COMMAND 6]", "RCRC", "AGHIGH", 
        "[UNKNOWN COMMAND 9]", "GRESTORE", "SHUTDOWN", "[UNKNOWN COMMAND 12]", "DESYNC", "IPROG"
    }

Configuration command names.

Definition at line 94 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sCOR1

staticprotected

Initial value:

= {
        {0x0003, 0, "StartupClk", "SSCLKSRC", 0,
            
            
            VALUES{"Cclk", "UserClk", "JtagClk", "TCK", 0}},
        {0x0004, 2, "DriveDone", "DRIVE_DONE", 0,
            
            
            VALUES{"No", "Yes", 0}}, 
        {0x0008, 3, "DonePipe", "DONE_PIPE", 0,
            
            
            VALUES{"No", "Yes", 0}},
        {0x0010,  4, "CRC_Bypass", "CRC_BYPASS", 0, 
            
            
            VALUES{"0", "1", 0}},
        {0x1000, 15, "Drive_Awake", "DRIVE_AWAKE", 0,
            
            
            VALUES{"0", "1", 0}},
        {0, 0, 0, 0, 0, 0}
    }

Configuration Options Register 1 (COR1) subfields.

See Also

Configuration Options Register Description: UG380, v2.2, July 30, 2010, Table 5-36

Definition at line 96 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sCOR2

staticprotected

Initial value:

= { 
        {0x0007,  0, "GWE_cycle", "GWE_CYCLE", 6,
            
            
            VALUES{"[UNDEFINED 0]", "2", "3", "4", "5", "6", "[UNDEFINED 6]", "[UNDEFINED 7]", 0}},
        {0x0038,  3, "GTS_cycle", "GTS_CYCLE", 5,
            
            
            VALUES{"[UNDEFINED 0]", "2", "3", "4", "5", "6", "[UNDEFINED 6]", "[UNDEFINED 7]", 0}},
        {0x01c0,  6, "LCK_cycle", "LOCK_CYCLE", 7,
            
            
            VALUES{"1", "2", "3", "4", "5", "6", "[UNDEFINED 6]", "NoWait", 0}},
        {0x0E00,  9, "DONE_cycle", "DONE_CYCLE", 4,
            
            
            VALUES{"[UNDEFINED 0]", "2", "3", "4", "5", "6", "[UNDEFINED 6]", "[UNDEFINED 7]", 0}},
        {0x8000, 15, "Reset_on_err", "RESET_ON_ERROR", 0,
            
            
            VALUES{"Disable", "Enable", 0}},
        {0, 0, 0, 0, 0, 0}
    }

Configuration Options Register 2 (COR2) subfields.

See Also

Configuration Options Register Description: UG380, v2.2, July 30, 2010, Table 5-36

Definition at line 98 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sCTL

staticprotected

Initial value:

= { 
        {0x0002,  1, "CRC_EXTSTAT_DISABLE", "CRC_EXTSTAT_DISABLE", 0, 
            
            
            VALUES{"0", "1", 0}},
        {0x0004,  2, "USE_EFUSE_KEY", "USE_EFUSE_KEY", 0, 
            
            
            VALUES{"0", "1", 0}},
        {0x0008,  3, "Persist", "PERSIST", 0, 
            
            
            VALUES{"No", "Yes", 0}},
        {0x0030,  4, "Security", "SBITS", 0, 
            
            
            
            VALUES{"None", "Level1", "Level2", "Level2", 0}},
        {0x0040,  6, "DEC", "DEC", 0, 
            
            
            VALUES{"No", "Yes", 0}},
        {0, 0, 0, 0, 0, 0}
    }

Control Register 0 (CTL0) subfields.

See Also

Control Register Description: UG380, v2.2, July 30, 2010, Table 5-34

Definition at line 102 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sHC_OPT_REG

staticprotected

Initial value:

= { 
        {0x0040,  6, "INIT_SKIP", "INIT_SKIP", 0, 
            
            
            VALUES{"0", "1", 0}},
        {0, 0, 0, 0, 0, 0}
    }

HC_OPT_REG Register (PWRDN_REG) subfields.

See Also

HC_OPT_REG Register Description: UG380, v2.2, July 30, 2010, Table 5-40

Definition at line 108 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sMASK

staticprotected

Initial value:

= { 
        {0x0001,  0, "RESERVED", "RESERVED", 0, VALUES{"Protected", "Writable", 0}},
        {0x0002,  1, "CRC_EXTSTAT_DISABLE", "CRC_EXTSTAT_DISABLE", 0, 
            VALUES{"Protected", "Writable", 0}},
        {0x0004,  2, "USE_EFUSE_KEY", "USE_EFUSE_KEY", 0, VALUES{"Protected", "Writable", 0}},
        {0x0008,  3, "Persist", "PERSIST", 0, VALUES{"Protected", "Writable", 0}},
        {0x0030,  4, "Security", "SBITS", 0, 
            VALUES{"Protected", "[UNKNOWN 1]", "[UNKNOWN 2]", "Writable", 0}},
        {0x0040,  6, "DEC", "DEC", 0, VALUES{"Protected", "Writable", 0}},
        {0, 0, 0, 0, 0, 0}
    }

Control Mask Register (MASK) subfields.

See Also

Control Mask Register Description: Inferred from Table 5-34

Definition at line 104 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sMODE_REG

staticprotected

Initial value:

= { 
        {0x0080,  0, "BOOTVSEL", "BOOTVSEL", 0, 
            
            
            VALUES{"[READ ONLY]", 0}},
        {0x0400,  8, "BOOTMODE", "BOOTMODE", 1, 
            
            
            VALUES{"0", "1", 0}},
        {0x1000,  11, "BUSWIDTH", "BUSWIDTH", 0, 
            
            
            VALUES{"0", "1", "2", 0}},
        {0x2000,  13, "NEW_MODE", "NEW_MODE", 0, 
            
            
            VALUES{"No", "Yes", 0}},
        {0, 0, 0, 0, 0, 0}
    }

Mode Register (Mode) subfields.

See Also

Mode Register Description: UG380, v2.2, July 30, 2010, Table 5-44

Definition at line 110 of file Spartan6.hpp.

const char * torc::bitstream::Spartan6::sOpcodeName

staticprotected

Initial value:

= {
        "NOP", "READ", "WRITE", "RESERVED"
    }

Packet opcode names.

Definition at line 90 of file Spartan6.hpp.

const char * torc::bitstream::Spartan6::sPacketTypeName

staticprotected

Initial value:

= {
        "[UNKNOWN TYPE 0]", "TYPE1", "TYPE2", "[UNKNOWN TYPE 3]", "[UNKNOWN TYPE 4]", 
        "[UNKNOWN TYPE 5]", "[UNKNOWN TYPE 6]", "[UNKNOWN TYPE 7]"
    }

Packet type names.

Definition at line 88 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sPWRDN_REG

staticprotected

Initial value:

= { 
        {0x0001,  0, "KEEP_SCLK", "KEEP_SCLK", 1, 
            
            
            
            VALUES{"0", "1", 0}},
        {0x0004,  2, "EN_PWRDN", "EN_PWRDN", 0, 
            
            
            VALUES{"0", "1", 0}},
        {0x0010,  4, "EN_PGSR", "EN_PGSR", 0, 
            
            
            
            VALUES{"No", "Yes", 0}},
        {0x0020,  5, "FILTER", "FILTER_B", 0, 
            
            
            VALUES{"0", "1", 0}},
        {0x4000,  14, "EN_EYES", "EN_EYES", 0, 
            
            
            VALUES{"Disable", "Enable", 0}},
        {0, 0, 0, 0, 0, 0}
    }

Suspend Register (PWRDN_REG) subfields.

See Also

Suspend Register Description: UG380, v2.2, July 30, 2010, Table 5-37

Definition at line 106 of file Spartan6.hpp.

const char * torc::bitstream::Spartan6::sRegisterName

staticprotected

Initial value:

= {
        "CRC", "FARMAJ", "FARMIN", "FDRI", "FDRO", "CMD", "CTL", "MASK", "STAT", "LOUT", "COR1", 
        "COR2", "PWRDN_REG", "FLR", "IDCODE", "CWDT", "HC_OPT_REG", "[UNUSED REGISTER 17]", "CSBO", 
        "GENERAL1", "GENERAL2", "GENERAL3", "GENERAL4", "GENERAL5", "MODE_REG", "PU_GWE", "PU_GTS", 
        "MFWR", "CCLK_FREQ", "SEU_OPT", "EXP_SIGN", "RDBK_SIGN", "BOOSTS", "EYE_MASK", "CBC_REG"
    }

Configuration register names.

Definition at line 92 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sSEU_OPT

staticprotected

Initial value:

= { 
        {0x0001,  0, "SEU_ENABLE", "SEU_ENABLE", 0, 
            
            
            VALUES{"DISABLE", "ENABLE", 0}},
        {0x0002,  1, "GLUT_MASK", "GLUT_MASK", 1, 
            
            
            VALUES{"Unmask", "Mask LUTRAM/SRL", 0}},
        {0x0008,  3, "SEU_RUN_ON_ERR", "SEU_RUN_ON_ERR", 0, 
            
            
            VALUES{"Halt", "Run", 0}},
        {0x0010,  4, "SEU_FREQ", "SEU_FREQ", 0, 
            
            
            VALUES{"1be",  0}},
        {0, 0, 0, 0, 0, 0}
    }

SEU_OPT Register (SEU_OPT) subfields.

See Also

SEU_OPT Register Description: UG380, v2.2, July 30, 2010, Table 5-49

Definition at line 114 of file Spartan6.hpp.

const Bitstream::Subfield torc::bitstream::Spartan6::sSTAT

staticprotected

Status Register (STAT) subfields.

See Also

Status Register Description: UG380, v2.2, July 30, 2010, Table 5-35

Note

The "bitgen" names attempt to mimic the general bitgen convention.

Definition at line 100 of file Spartan6.hpp.

---

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

• Spartan6.hpp
• Spartan6.cpp