KIBIS_PIN Class Reference

#include <kibis.h>

Inheritance diagram for KIBIS_PIN:

Public Member Functions
	KIBIS_PIN (KIBIS &aTopLevel, const IbisComponentPin &aPin, const IbisComponentPackage &aPackage, IbisParser &aParser, KIBIS_COMPONENT *aParent, std::vector< KIBIS_MODEL > &aModels)
bool	writeSpiceDriver (std::string &aDest, const std::string &aName, KIBIS_MODEL &aModel, const KIBIS_PARAMETER &aParam)
bool	writeSpiceDiffDriver (std::string &aDest, const std::string &aName, KIBIS_MODEL &aModel, const KIBIS_PARAMETER &aParam)
bool	writeSpiceDevice (std::string &aDest, const std::string &aName, KIBIS_MODEL &aModel, const KIBIS_PARAMETER &aParam)
bool	writeSpiceDiffDevice (std::string &aDest, const std::string &aName, KIBIS_MODEL &aModel, const KIBIS_PARAMETER &aParam)
void	getKuKdNoWaveform (KIBIS_MODEL &aModel, const KIBIS_PARAMETER &aParam)
	Update m_Ku, m_Kd using no falling / rising waveform inputs ( low accuracy )
void	getKuKdOneWaveform (KIBIS_MODEL &aModel, const std::pair< IbisWaveform *, IbisWaveform * > &aPair, const KIBIS_PARAMETER &aParam)
	Update m_Ku, m_Kd using with a single waveform input.
void	getKuKdTwoWaveforms (KIBIS_MODEL &aModel, const std::pair< IbisWaveform *, IbisWaveform * > &aPair1, const std::pair< IbisWaveform *, IbisWaveform * > &aPair2, const KIBIS_PARAMETER &aParam)
	Update m_Ku, m_Kd using with two waveform inputs.
std::string	KuKdDriver (KIBIS_MODEL &aModel, const std::pair< IbisWaveform *, IbisWaveform * > &aPair, const KIBIS_PARAMETER &aParam, int aIndex)
	Update m_Ku, m_Kd using with two waveform inputs.
std::string	addDie (KIBIS_MODEL &aModel, const KIBIS_PARAMETER &aParam, int aIndex)
	Generate the spice directive to simulate the die for Ku/Kd estimation.
void	getKuKdFromFile (const std::string &aSimul)
	Update m_Ku, m_Kd using with two waveform inputs.
bool	isDiffPin () const
void	Report (const std::string &aMsg, SEVERITY aSeverity=RPT_SEVERITY_INFO) const
	Print a message.

Public Attributes
std::string	m_signalName
	Name of the pin Examples : "VCC", "GPIOA", "CLK", etc...
std::string	m_pinNumber
	Pin Number Examples : 1, 2, 3 ( or for BGA ), A1, A2, A3, etc...
TypMinMaxValue	m_Rpin
	Resistance from die to pin.
TypMinMaxValue	m_Lpin
	Inductance from die to pin.
TypMinMaxValue	m_Cpin
	Capacitance from pin to GND.
KIBIS_COMPONENT *	m_parent
std::vector< double >	m_t
std::vector< double >	m_Ku
std::vector< double >	m_Kd
std::vector< KIBIS_MODEL * >	m_models
KIBIS_PIN *	m_complementaryPin = nullptr
KIBIS *	m_topLevel
bool	m_valid
REPORTER *	m_Reporter

Static Protected Member Functions
static std::string	doubleToString (double aNumber)
	Convert a double to string using scientific notation.

Detailed Description

Definition at line 340 of file kibis.h.

Constructor & Destructor Documentation

KIBIS_PIN()

KIBIS_PIN::KIBIS_PIN	(	KIBIS &	aTopLevel,
		const IbisComponentPin &	aPin,
		const IbisComponentPackage &	aPackage,
		IbisParser &	aParser,
		KIBIS_COMPONENT *	aParent,
		std::vector< KIBIS_MODEL > &	aModels )

Definition at line 162 of file kibis.cpp.

References KIBIS_BASE::KIBIS_BASE(), IbisComponentPin::m_Cpin, m_Cpin, IbisComponentPackage::m_Cpkg, IbisParser::m_ibisFile, IbisComponentPin::m_Lpin, m_Lpin, IbisComponentPackage::m_Lpkg, IbisFile::m_modelSelectors, m_parent, IbisComponentPin::m_pinName, m_pinNumber, IBIS_BASE::m_Reporter, IbisComponentPin::m_Rpin, m_Rpin, IbisComponentPackage::m_Rpkg, IbisComponentPin::m_signalName, and m_signalName.

Member Function Documentation

addDie()

std::string KIBIS_PIN::addDie	(	KIBIS_MODEL &	aModel,
		const KIBIS_PARAMETER &	aParam,
		int	aIndex )

Generate the spice directive to simulate the die for Ku/Kd estimation.

DO NOT use it in order to generate a model. It sole purpose is to run the internal simulation to get Ku/Kd

Parameters

aModel	Model to be used
aParam	Parameters
aIndex	Index for numbering ports

Returns

A multiline string with spice directives

Definition at line 602 of file kibis.cpp.

References KIBIS_MODEL::HasGNDClamp(), KIBIS_MODEL::HasPOWERClamp(), KIBIS_MODEL::HasPulldown(), KIBIS_MODEL::HasPullup(), KIBIS_MODEL::m_GNDClamp, KIBIS_MODEL::m_POWERClamp, KIBIS_MODEL::m_pulldown, KIBIS_MODEL::m_pullup, KIBIS_PARAMETER::m_supply, and IVtable::Spice().

Referenced by KuKdDriver().

doubleToString()

std::string IBIS_BASE::doubleToString ( double aNumber )

staticprotectedinherited

Convert a double to string using scientific notation.

Parameters

aNumber

Number

Returns

Output string

Definition at line 311 of file ibis_parser.cpp.

Referenced by KIBIS_MODEL::generateSquareWave(), KIBIS_PIN::getKuKdOneWaveform(), KIBIS_PIN::getKuKdTwoWaveforms(), KIBIS_PIN::KuKdDriver(), IVtable::Spice(), KIBIS_MODEL::SpiceDie(), KIBIS_PIN::writeSpiceDevice(), and KIBIS_PIN::writeSpiceDriver().

getKuKdFromFile()

void KIBIS_PIN::getKuKdFromFile

(

const std::string &

aSimul

)

Update m_Ku, m_Kd using with two waveform inputs.

Runs a simulation. The simulation creates a specific file with Ku/Kd values This function then reads the output file and updates m_Ku / m_Kd. This function probably needs a rewrite.

Parameters

aSimul

The simulation to run, multiline spice directives

Definition at line 646 of file kibis.cpp.

References _, SIMULATOR::CreateInstance(), ku, m_Kd, m_Ku, m_t, KIBIS_BASE::m_topLevel, IBIS_BASE::Report(), RPT_SEVERITY_ERROR, and RPT_SEVERITY_WARNING.

Referenced by getKuKdOneWaveform(), and getKuKdTwoWaveforms().

getKuKdNoWaveform()

void KIBIS_PIN::getKuKdNoWaveform	(	KIBIS_MODEL &	aModel,
		const KIBIS_PARAMETER &	aParam )

Update m_Ku, m_Kd using no falling / rising waveform inputs ( low accuracy )

Parameters

aModel	Model to be used
aParam	Parameters

Definition at line 926 of file kibis.cpp.

References KIBIS_WAVEFORM::Check(), KIBIS_WAVEFORM::GenerateBitSequence(), KIBIS_WAVEFORM::GetType(), HIGH_Z, KIBIS_WAVEFORM::inverted, ku, dvdt::m_dt, IbisRamp::m_falling, m_Kd, m_Ku, KIBIS_MODEL::m_ramp, IbisRamp::m_rising, KIBIS_PARAMETER::m_supply, m_t, KIBIS_PARAMETER::m_waveform, NONE, PRBS, RECTANGULAR, SimplifyBitSequence(), STUCK_HIGH, STUCK_LOW, and dvdtTypMinMax::value.

Referenced by writeSpiceDriver().

getKuKdOneWaveform()

void KIBIS_PIN::getKuKdOneWaveform	(	KIBIS_MODEL &	aModel,
		const std::pair< IbisWaveform *, IbisWaveform * > &	aPair,
		const KIBIS_PARAMETER &	aParam )

Update m_Ku, m_Kd using with a single waveform input.

Parameters

aModel	Model to be used
aPair

See also

waveformPairs()

Parameters

aParam

Parameters

Definition at line 815 of file kibis.cpp.

References _, IBIS_BASE::doubleToString(), KIBIS_WAVEFORM::GetDuration(), getKuKdFromFile(), KIBIS_WAVEFORM::GetType(), KIBIS_MODEL::HasPulldown(), KIBIS_MODEL::HasPullup(), HIGH_Z, ku, KuKdDriver(), m_Kd, m_Ku, KIBIS_PARAMETER::m_supply, m_t, KIBIS_BASE::m_topLevel, KIBIS_MODEL::m_voltageRange, KIBIS_PARAMETER::m_waveform, NONE, PRBS, RECTANGULAR, IBIS_BASE::Report(), RPT_SEVERITY_ERROR, RPT_SEVERITY_WARNING, STUCK_HIGH, STUCK_LOW, and TypMinMaxValue::value.

Referenced by writeSpiceDriver().

getKuKdTwoWaveforms()

void KIBIS_PIN::getKuKdTwoWaveforms	(	KIBIS_MODEL &	aModel,
		const std::pair< IbisWaveform *, IbisWaveform * > &	aPair1,
		const std::pair< IbisWaveform *, IbisWaveform * > &	aPair2,
		const KIBIS_PARAMETER &	aParam )

Update m_Ku, m_Kd using with two waveform inputs.

The order of aPair1 and aPair2 is not important.

Parameters

aModel	Model to be used
aPair1

See also

waveformPairs()

Parameters

aPair2

See also

waveformPairs()

Parameters

aParam	Parameters
aIndex	Index for numbering spice .SUBCKT

Definition at line 987 of file kibis.cpp.

References _, IBIS_BASE::doubleToString(), KIBIS_WAVEFORM::GetDuration(), getKuKdFromFile(), KIBIS_WAVEFORM::GetType(), KIBIS_MODEL::HasPulldown(), KIBIS_MODEL::HasPullup(), HIGH_Z, ku, KuKdDriver(), m_Kd, m_Ku, KIBIS_PARAMETER::m_supply, m_t, KIBIS_BASE::m_topLevel, KIBIS_MODEL::m_voltageRange, KIBIS_PARAMETER::m_waveform, NONE, PRBS, RECTANGULAR, IBIS_BASE::Report(), RPT_SEVERITY_ERROR, RPT_SEVERITY_WARNING, STUCK_HIGH, STUCK_LOW, and TypMinMaxValue::value.

Referenced by writeSpiceDriver().

isDiffPin()

bool KIBIS_PIN::isDiffPin ( ) const

inline

Definition at line 444 of file kibis.h.

References m_complementaryPin.

Referenced by SIM_LIBRARY_IBIS::InitModel().

KuKdDriver()

std::string KIBIS_PIN::KuKdDriver	(	KIBIS_MODEL &	aModel,
		const std::pair< IbisWaveform *, IbisWaveform * > &	aPair,
		const KIBIS_PARAMETER &	aParam,
		int	aIndex )

Update m_Ku, m_Kd using with two waveform inputs.

The order of aPair1 and aPair2 is not important.

Parameters

aModel	Model to be used
aPair

See also

waveformPairs()

Parameters

aParam	Parameters
aIndex	Index for numbering spice .SUBCKT

Returns

A multiline string with spice directives

Definition at line 739 of file kibis.cpp.

References _, addDie(), KIBIS_WAVEFORM::Check(), IBIS_BASE::doubleToString(), KIBIS_WAVEFORM::GenerateBitSequence(), KIBIS_MODEL::generateSquareWave(), KIBIS_WAVEFORM::GetType(), HIGH_Z, KIBIS_WAVEFORM::inverted, KIBIS_MODEL::m_C_comp, KIBIS_PARAMETER::m_Ccomp, VTtable::m_entries, KIBIS_PARAMETER::m_supply, IbisWaveform::m_table, KIBIS_PARAMETER::m_waveform, NONE, PRBS, RECTANGULAR, IBIS_BASE::Report(), RPT_SEVERITY_WARNING, SimplifyBitSequence(), STUCK_HIGH, STUCK_LOW, and TypMinMaxValue::value.

Referenced by getKuKdOneWaveform(), and getKuKdTwoWaveforms().

Report()

void IBIS_BASE::Report ( const std::string & aMsg, SEVERITY aSeverity = RPT_SEVERITY_INFO ) const

inlineinherited

Print a message.

Call m_Reporter->Report if m_Reporter exists.

Parameters

aMsg	Message
aSeverity	Message sevirity

Definition at line 67 of file ibis_parser.h.

References m_Reporter, and RPT_SEVERITY_INFO.

Referenced by BOOST_AUTO_TEST_CASE(), IbisParser::changeCommentChar(), IbisParser::changeContext(), IBIS_MATRIX_BANDED::Check(), IBIS_MATRIX_FULL::Check(), IBIS_MATRIX_SPARSE::Check(), IbisComponent::Check(), IbisComponentPackage::Check(), IbisComponentPin::Check(), IbisHeader::Check(), IbisModel::Check(), IbisPackageModel::Check(), IbisRamp::Check(), IVtable::Check(), KIBIS_WAVEFORM_PRBS::Check(), KIBIS_WAVEFORM_PRBS::Check(), KIBIS_WAVEFORM_RECTANGULAR::Check(), KIBIS_WAVEFORM_RECTANGULAR::Check(), IbisParser::checkEndofLine(), KIBIS_PIN::getKuKdFromFile(), KIBIS_PIN::getKuKdOneWaveform(), KIBIS_PIN::getKuKdTwoWaveforms(), IbisParser::getNextLine(), IVtable::InterpolatedI(), KIBIS_PIN::KuKdDriver(), IbisParser::onNewLine(), IbisParser::ParseFile(), IbisParser::readDiffPin(), IbisParser::readDouble(), IbisParser::readInt(), IbisParser::readMatrix(), IbisParser::readMatrixBanded(), IbisParser::readMatrixFull(), IbisParser::readMatrixSparse(), IbisParser::readModel(), IbisParser::readPackage(), IbisParser::readPin(), IbisParser::readPinMapping(), IbisParser::readRamp(), IbisParser::readTypMinMaxValue(), IbisParser::readWaveform(), KIBIS_MODEL::TrimWaveform(), KIBIS_PIN::writeSpiceDevice(), and KIBIS_PIN::writeSpiceDriver().

writeSpiceDevice()

bool KIBIS_PIN::writeSpiceDevice	(	std::string &	aDest,
		const std::string &	aName,
		KIBIS_MODEL &	aModel,
		const KIBIS_PARAMETER &	aParam )

Definition at line 1246 of file kibis.cpp.

References _, IBIS_BASE::doubleToString(), INPUT_STD, IO, IO_ECL, IO_OPEN_DRAIN, IO_OPEN_SINK, IO_OPEN_SOURCE, KIBIS_PARAMETER::m_Cpin, m_Cpin, KIBIS_PARAMETER::m_Lpin, m_Lpin, KIBIS_PARAMETER::m_Rpin, m_Rpin, KIBIS_MODEL::m_type, IBIS_BASE::Report(), result, RPT_SEVERITY_ERROR, and KIBIS_MODEL::SpiceDie().

Referenced by SPICE_GENERATOR_IBIS::IbisDevice(), main(), and writeSpiceDiffDevice().

writeSpiceDiffDevice()

bool KIBIS_PIN::writeSpiceDiffDevice	(	std::string &	aDest,
		const std::string &	aName,
		KIBIS_MODEL &	aModel,
		const KIBIS_PARAMETER &	aParam )

Definition at line 1336 of file kibis.cpp.

References result, and writeSpiceDevice().

Referenced by SPICE_GENERATOR_IBIS::IbisDevice().

writeSpiceDiffDriver()

bool KIBIS_PIN::writeSpiceDiffDriver	(	std::string &	aDest,
		const std::string &	aName,
		KIBIS_MODEL &	aModel,
		const KIBIS_PARAMETER &	aParam )

Definition at line 1299 of file kibis.cpp.

References KIBIS_WAVEFORM::inverted, KIBIS_PARAMETER::m_waveform, result, and writeSpiceDriver().

Referenced by SPICE_GENERATOR_IBIS::IbisDevice(), and main().

writeSpiceDriver()

bool KIBIS_PIN::writeSpiceDriver	(	std::string &	aDest,
		const std::string &	aName,
		KIBIS_MODEL &	aModel,
		const KIBIS_PARAMETER &	aParam )

Definition at line 1131 of file kibis.cpp.

References _, accuracy, IBIS_BASE::doubleToString(), getKuKdNoWaveform(), getKuKdOneWaveform(), getKuKdTwoWaveforms(), IO, IO_ECL, IO_OPEN_DRAIN, IO_OPEN_SINK, IO_OPEN_SOURCE, LEVEL_0, LEVEL_1, LEVEL_2, KIBIS_PARAMETER::m_accuracy, KIBIS_PARAMETER::m_Cpin, m_Cpin, m_Kd, m_Ku, KIBIS_PARAMETER::m_Lpin, m_Lpin, KIBIS_MODEL::m_name, m_pinNumber, KIBIS_PARAMETER::m_Rpin, m_Rpin, m_signalName, m_t, KIBIS_MODEL::m_type, OPEN_DRAIN, OPEN_SINK, OPEN_SOURCE, OUTPUT, OUTPUT_ECL, IBIS_BASE::Report(), result, RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, RPT_SEVERITY_WARNING, KIBIS_MODEL::SpiceDie(), THREE_STATE, THREE_STATE_ECL, and KIBIS_MODEL::waveformPairs().

Referenced by SPICE_GENERATOR_IBIS::IbisDevice(), and writeSpiceDiffDriver().

Member Data Documentation

m_complementaryPin

KIBIS_PIN* KIBIS_PIN::m_complementaryPin = nullptr

Definition at line 442 of file kibis.h.

Referenced by isDiffPin(), and KIBIS::KIBIS().

m_Cpin

TypMinMaxValue KIBIS_PIN::m_Cpin

Capacitance from pin to GND.

Definition at line 359 of file kibis.h.

Referenced by KIBIS_PIN(), writeSpiceDevice(), and writeSpiceDriver().

m_Kd

std::vector<double> KIBIS_PIN::m_Kd

Definition at line 363 of file kibis.h.

Referenced by getKuKdFromFile(), getKuKdNoWaveform(), getKuKdOneWaveform(), getKuKdTwoWaveforms(), and writeSpiceDriver().

m_Ku

std::vector<double> KIBIS_PIN::m_Ku

Definition at line 363 of file kibis.h.

Referenced by getKuKdFromFile(), getKuKdNoWaveform(), getKuKdOneWaveform(), getKuKdTwoWaveforms(), and writeSpiceDriver().

m_Lpin

TypMinMaxValue KIBIS_PIN::m_Lpin

Inductance from die to pin.

Definition at line 357 of file kibis.h.

Referenced by KIBIS_PIN(), writeSpiceDevice(), and writeSpiceDriver().

m_models

std::vector<KIBIS_MODEL*> KIBIS_PIN::m_models

Definition at line 365 of file kibis.h.

Referenced by SIM_MODEL_IBIS::ChangePin(), and main().

m_parent

KIBIS_COMPONENT* KIBIS_PIN::m_parent

Definition at line 361 of file kibis.h.

Referenced by KIBIS_PIN().

m_pinNumber

std::string KIBIS_PIN::m_pinNumber

Pin Number Examples : 1, 2, 3 ( or for BGA ), A1, A2, A3, etc...

Definition at line 352 of file kibis.h.

Referenced by SIM_LIBRARY_IBIS::InitModel(), KIBIS_PIN(), and writeSpiceDriver().

m_Reporter

REPORTER* IBIS_BASE::m_Reporter

inherited

Definition at line 74 of file ibis_parser.h.

Referenced by BOOST_AUTO_TEST_CASE(), IbisParser::changeContext(), IBIS_BASE(), SPICE_GENERATOR_IBIS::IbisDevice(), KIBIS::KIBIS(), KIBIS_BASE::KIBIS_BASE(), KIBIS_MODEL::KIBIS_MODEL(), KIBIS_PIN::KIBIS_PIN(), IbisParser::parsePackageModelModelData(), IbisParser::readDiffPin(), IbisParser::readIVtableEntry(), IbisParser::readMatrix(), IbisParser::readPin(), IbisParser::readPinMapping(), IbisParser::readVTtableEntry(), IbisParser::readWaveform(), Report(), and KIBIS_MODEL::TrimWaveform().

m_Rpin

TypMinMaxValue KIBIS_PIN::m_Rpin

Resistance from die to pin.

Definition at line 355 of file kibis.h.

Referenced by KIBIS_PIN(), writeSpiceDevice(), and writeSpiceDriver().

m_signalName

std::string KIBIS_PIN::m_signalName

Name of the pin Examples : "VCC", "GPIOA", "CLK", etc...

Definition at line 348 of file kibis.h.

Referenced by SIM_LIBRARY_IBIS::InitModel(), KIBIS_PIN(), main(), and writeSpiceDriver().

m_t

std::vector<double> KIBIS_PIN::m_t

Definition at line 363 of file kibis.h.

Referenced by getKuKdFromFile(), getKuKdNoWaveform(), getKuKdOneWaveform(), getKuKdTwoWaveforms(), and writeSpiceDriver().

m_topLevel

KIBIS* KIBIS_BASE::m_topLevel

inherited

Definition at line 56 of file kibis.h.

Referenced by KIBIS_PIN::getKuKdFromFile(), KIBIS_PIN::getKuKdOneWaveform(), KIBIS_PIN::getKuKdTwoWaveforms(), and KIBIS_BASE().

m_valid

bool KIBIS_BASE::m_valid

inherited

Definition at line 57 of file kibis.h.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SPICE_GENERATOR_IBIS::IbisDevice(), KIBIS_FILE::Init(), KIBIS::KIBIS(), KIBIS_BASE(), KIBIS_COMPONENT::KIBIS_COMPONENT(), KIBIS_MODEL::KIBIS_MODEL(), and KIBIS_WAVEFORM::KIBIS_WAVEFORM().

---

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

• kibis.h
• kibis.cpp