bag3_testbenches.measurement.digital.max_trf

Module Contents

Classes

MaxRiseFallTime

Tweaks a parameter as far as possible without exceeding max rise/fall time.

class bag3_testbenches.measurement.digital.max_trf.MaxRiseFallTime(*args: Any, **kwargs: Any)[source]

Bases: bag3_testbenches.measurement.search.IntervalSearchMM

Tweaks a parameter as far as possible without exceeding max rise/fall time.

Notes

specification dictionary has the following entries:

adj_namestr

the adjust parameter name.

in_pinstr

input pin name.

out_pinstr

output pin name.

adj_signbool

True if increasing parameter value increases rise/fall time, False otherwise.

max_trffloat

maximum rise/fall time, in seconds.

use_dutbool

Optional. True to instantiate DUT. Defaults to True.

search_paramsMapping[str, Any]

interval search parameters, with the following entries:

lowfloat

lower bound.

highOptional[float]

upper bound. If None, perform a unbounded binary search.

stepfloat

initial step size for unbounded binary search.

tolfloat

tolerance of the binary search. Terminate the search when it is below this value.

max_errfloat

Used only in unbounded binary search. If unbounded binary search exceeds this value, raise an error.

overhead_factorfloat

ratio of simulation startup time to time it takes to simulate one sweep point.

tbm_specsMapping[str, Any]

DigitalTranTB related specifications. The following simulation parameters are required:

t_rst :

reset duration.

t_rst_rf :

reset rise/fall time.

t_bit :

bit value duration.

t_rf :

input pulse rise/fall time.

wrapper_paramsMapping[str, Any]

Used only if simulated with a DUT wrapper. Contains the following entries:

libstr

wrapper library name.

cellstr

wrapper cell name.

paramsMapping[str, Any]

DUT wrapper schematic parameters.

pinsSequence[str]

wrapper pin list.

power_domainMapping[str, Tuple[str, str]

power domain of wrapper.

load_listSequence[Mapping[str, Any]]

Optional. List of loads. Each dictionary has the following entries:

pin: str

the pin to connect to.

typestr

the load device type.

valueUnion[float, str]

the load parameter value.

Initialize this MeasurementManager.

Returns:

  • tbm (TestbenchManager) – the TestbenchManager object.

  • tb_params (Mapping[str, Any]) – the testbench schematic parameters dictionary.

  • intv_params (Mapping[str, Mapping[str, Any]]) – A dictionary from search parameter name to its configuration dictionary. The values have the following entries:

    lowfloat

    lower bound.

    highOptional[float]

    upper bound. If None, perform a unbounded binary search.

    stepfloat

    initial step size for unbounded binary search.

    tolfloat

    tolerance of the binary search. Terminate the search when it is below this value.

    max_errfloat

    Used only in unbounded binary search. If unbounded binary search exceeds this value, raise an error.

    overhead_factorfloat

    ratio of simulation startup time to time it takes to simulate one sweep point.

  • intv_defaults (Mapping[str, Any]) – If any interval configuration are not specified, the value is taken from this dictionary.

  • has_init (bool) – True to run an initialization step.

  • use_dut (bool) – True to instantiate DUT.

process_init(cur_info: bag.simulation.measure.MeasInfo, sim_results: bag.simulation.cache.SimResults) Tuple[Dict[str, Any], bool][source]
process_output_helper(cur_info: bag.simulation.measure.MeasInfo, sim_results: bag.simulation.cache.SimResults, remaining: Set[str]) Mapping[str, Tuple[Tuple[float, float], Dict[str, Any], bool]][source]