Bitvis VIP Wishbone
Quick Access
BFM
BFM functionality is implemented in wishbone_bfm_pkg.vhd
Signal Record
t_wishbone_if
Record element |
Type |
---|---|
dat_o |
std_logic_vector |
dat_i |
std_logic_vector |
adr_o |
std_logic_vector |
cyc_o |
std_logic |
stb_o |
std_logic |
we_o |
std_logic |
ack_i |
std_logic |
Configuration Record
t_wishbone_bfm_config
Default value for the record is C_WISHBONE_BFM_CONFIG_DEFAULT.
Record element |
Type |
Default |
Description |
---|---|---|---|
max_wait_cycles |
integer |
10 |
The maximum number of clock cycles to wait for the DUT ready signal before reporting a timeout alert |
max_wait_cycles_severity |
FAILURE |
The above timeout will have this severity |
|
clock_period |
time |
-1 ns |
Period of the clock signal |
clock_period_margin |
time |
0 ns |
Input clock period margin to specified clock_period. Will check ‘T/2’ if input clock is low when BFM is called and ‘T’ if input clock is high. |
clock_margin_severity |
TB_ERROR |
The above margin will have this severity |
|
setup_time |
time |
-1 ns |
Generated signals setup time. Suggested value is clock_period/4. An alert is reported if setup_time exceeds clock_period/2. |
hold_time |
time |
-1 ns |
Generated signals hold time. Suggested value is clock_period/4. An alert is reported if hold_time exceeds clock_period/2. |
match_strictness |
MATCH_EXACT |
Matching strictness for std_logic values in check procedures. MATCH_EXACT requires both values to be the same. Note that the expected value can contain the don’t care operator ‘-‘. MATCH_STD allows comparisons between ‘H’ and ‘1’, ‘L’ and ‘0’ and ‘-’ in both values. |
|
id_for_bfm |
t_msg_id |
ID_BFM |
Message ID used for logging general messages in the BFM |
id_for_bfm_wait |
t_msg_id |
ID_BFM_WAIT |
DEPRECATED |
id_for_bfm_poll |
t_msg_id |
ID_BFM_POLL |
DEPRECATED |
Methods
All signals are active high.
All parameters in brackets are optional.
wishbone_write()
Writes the given data to the given address on the DUT, using the Wishbone protocol.
wishbone_write(addr_value, data_value, msg, clk, wishbone_if, [scope, [msg_id_panel, [config]]])
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
constant |
addr_value |
in |
unsigned |
The address of a software accessible register |
constant |
data_value |
in |
std_logic_vector |
The data value to be written to the addressed register |
constant |
msg |
in |
string |
A custom message to be appended in the log/alert |
signal |
clk |
in |
std_logic |
The clock signal used to read and write data in/out of the Wishbone BFM |
signal |
wishbone_if |
inout |
Wishbone signal interface record |
|
constant |
scope |
in |
string |
Describes the scope from which the log/alert originates. Default value is C_BFM_SCOPE (“WISHBONE BFM”). |
constant |
msg_id_panel |
in |
t_msg_id_panel |
Controls verbosity within a specified scope. Default value is shared_msg_id_panel. |
constant |
config |
in |
Configuration of BFM behavior and restrictions. Default value is C_WISHBONE_BFM_CONFIG_DEFAULT. |
-- Examples:
wishbone_write(x"1000", x"55", "Write data to Peripheral 1", clk, wishbone_if);
wishbone_write(x"1000", x"55", "Write data to Peripheral 1", clk, wishbone_if, C_SCOPE, shared_msg_id_panel, C_WISHBONE_BFM_CONFIG_DEFAULT);
-- Suggested usage (requires local overload, see 'Local BFM overloads' section):
wishbone_write(C_ADDR_UART_TX, x"40", "Set baud rate to 9600");
wishbone_read()
Reads data from the DUT at the given address, using the Wishbone protocol.
wishbone_read(addr_value, data_value, msg, clk, wishbone_if, [scope, [msg_id_panel, [config]]])
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
constant |
addr_value |
in |
unsigned |
The address of a software accessible register |
variable |
data_value |
out |
std_logic_vector |
The data value read from the addressed register |
constant |
msg |
in |
string |
A custom message to be appended in the log/alert |
signal |
clk |
in |
std_logic |
The clock signal used to read and write data in/out of the Wishbone BFM |
signal |
wishbone_if |
inout |
Wishbone signal interface record |
|
constant |
scope |
in |
string |
Describes the scope from which the log/alert originates. Default value is C_BFM_SCOPE (“WISHBONE BFM”). |
constant |
msg_id_panel |
in |
t_msg_id_panel |
Controls verbosity within a specified scope. Default value is shared_msg_id_panel. |
constant |
config |
in |
Configuration of BFM behavior and restrictions. Default value is C_WISHBONE_BFM_CONFIG_DEFAULT. |
-- Examples:
wishbone_read(x"1000", v_data_out, "Read from Peripheral 1", clk, wishbone_if);
wishbone_read(x"1000", v_data_out, "Read from Peripheral 1", clk, wishbone_if, C_SCOPE, shared_msg_id_panel, C_WISHBONE_BFM_CONFIG_DEFAULT);
-- Suggested usage (requires local overload, see 'Local BFM overloads' section):
wishbone_read(C_ADDR_UART_BAUD, v_data_out, "Read UART baud rate");
wishbone_check()
Reads data from the DUT at the given address, using the Wishbone protocol. After reading data from the Wishbone bus, the read data is compared with the expected data.
If the check was successful, and the read data matches the expected data, a log message is written with ID ‘config.id_for_bfm’.
If the read data did not match the expected data, an alert with severity ‘alert_level’ will be reported.
wishbone_check(addr_value, data_exp, msg, clk, wishbone_if, [alert_level, [scope, [msg_id_panel, [config]]]])
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
constant |
addr_value |
in |
unsigned |
The address of a software accessible register |
constant |
data_exp |
in |
std_logic_vector |
The data value to expect when reading the addressed register. A mismatch results in an alert with severity ‘alert_level’. |
constant |
msg |
in |
string |
A custom message to be appended in the log/alert |
signal |
clk |
in |
std_logic |
The clock signal used to read and write data in/out of the Wishbone BFM |
signal |
wishbone_if |
inout |
Wishbone signal interface record |
|
constant |
alert_level |
in |
Sets the severity for the alert. Default value is ERROR. |
|
constant |
scope |
in |
string |
Describes the scope from which the log/alert originates. Default value is C_BFM_SCOPE (“WISHBONE BFM”). |
constant |
msg_id_panel |
in |
t_msg_id_panel |
Controls verbosity within a specified scope. Default value is shared_msg_id_panel. |
constant |
config |
in |
Configuration of BFM behavior and restrictions. Default value is C_WISHBONE_BFM_CONFIG_DEFAULT. |
-- Examples:
wishbone_check(x"1155", x"3B", "Check data from Peripheral 1", clk, wishbone_if);
wishbone_check(x"1155", x"3B", "Check data from Peripheral 1", clk, wishbone_if, ERROR, C_SCOPE, shared_msg_id_panel, C_WISHBONE_BFM_CONFIG_DEFAULT);
-- Suggested usage (requires local overload, see 'Local BFM overloads' section):
wishbone_check(C_ADDR_UART_RX, x"3B", "Check data from UART RX buffer");
init_wishbone_if_signals()
Initializes the Wishbone interface. All the BFM outputs are set to ‘0’, and BFM inputs are set to ‘Z’.
t_wishbone_if := init_wishbone_if_signals(addr_width, data_width)
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
constant |
addr_width |
in |
natural |
Width of the address signal |
constant |
data_width |
in |
natural |
Width of the data signals |
-- Examples:
wishbone_if <= init_wishbone_if_signals(dat_o.addr'length, adr_o.wdata'length);
Local BFM overloads
A good approach for better readability and maintainability is to make simple, local overloads for the BFM procedures in the TB process. This allows calling the BFM procedures with the key parameters only, e.g.
wishbone_write(C_ADDR_UART_BAUDRATE, C_BAUDRATE_9600, "Set Baud-rate to 9600");
rather than
wishbone_write(C_ADDR_UART_BAUDRATE, C_BAUDRATE_9600, "Set Baud-rate to 9600", clk, wishbone_if, C_SCOPE, shared_msg_id_panel, C_WISHBONE_BFM_CONFIG_DEFAULT);
By defining the local overload as e.g.
procedure wishbone_write(
constant addr_value : in unsigned;
constant data_value : in std_logic_vector;
constant msg : in string) is
begin
wishbone_write(addr_value, -- Keep as is
data_value, -- Keep as is
msg, -- Keep as is
clk, -- Signal must be visible in local process scope
wishbone_if, -- Signal must be visible in local process scope
C_SCOPE, -- Use the default
shared_msg_id_panel, -- Use global, shared msg_id_panel
C_WISHBONE_CONFIG_LOCAL); -- Use locally defined configuration or C_WISHBONE_BFM_CONFIG_DEFAULT
end procedure;
Using a local overload like this also allows the following – if wanted:
Have address value as natural – and convert in the overload
Set up defaults for constants. May be different for two overloads of the same BFM
Apply dedicated message ID panel to allow dedicated verbosity control
Compilation
This BFM package may only be compiled with VHDL-2008 or newer. It is dependent on the Utility Library, which is only compatible with VHDL-2008 or newer.
After UVVM-Util has been compiled, the BFM package can be compiled into any desired library.
See Essential Mechanisms - Compile Scripts for information about compile scripts.
Simulator compatibility and setup
See Prerequisites for a list of supported simulators.
For required simulator setup see UVVM-Util Simulator compatibility and setup.
Additional Documentation
Important
This is a simplified Bus Functional Model (BFM) for Wishbone.
The given BFM complies with the basic Wishbone protocol and thus allows a normal access towards a Wishbone interface.
This BFM is not a Wishbone protocol checker.
For a more advanced BFM please contact UVVM support at info@uvvm.org
VVC
VVC functionality is implemented in wishbone_vvc.vhd
For general information see VVC Framework - Essential Mechanisms.
Entity
Generics
Name |
Type |
Default |
Description |
---|---|---|---|
GC_ADDR_WIDTH |
integer |
8 |
Width of the Wishbone address bus |
GC_DATA_WIDTH |
integer |
32 |
Width of the Wishbone data bus |
GC_INSTANCE_IDX |
natural |
1 |
Instance number to assign the VVC |
GC_WISHBONE_BFM_CONFIG |
C_WISHBONE_BFM_CONFIG_DEFAULT |
Configuration for the Wishbone BFM |
|
GC_CMD_QUEUE_COUNT_MAX |
natural |
C_CMD_QUEUE_COUNT_MAX |
Absolute maximum number of commands in the VVC command queue |
GC_CMD_QUEUE_COUNT_THRESHOLD |
natural |
C_CMD_QUEUE_COUNT_THRESHOLD |
An alert will be generated when reaching this threshold to indicate that the command queue is almost full. The queue will still accept new commands until it reaches GC_CMD_QUEUE_COUNT_MAX. |
GC_CMD_QUEUE_COUNT_THRESHOLD_SEVERITY |
C_CMD_QUEUE_COUNT_THRESHOLD_SEVERITY |
Alert severity which will be used when command queue reaches GC_CMD_QUEUE_COUNT_THRESHOLD |
|
GC_RESULT_QUEUE_COUNT_MAX |
natural |
C_RESULT_QUEUE_COUNT_MAX |
Maximum number of unfetched results before result_queue is full |
GC_RESULT_QUEUE_COUNT_THRESHOLD |
natural |
C_RESULT_QUEUE_COUNT_THRESHOLD |
An alert will be issued if result queue exceeds this count. Used for early warning if result queue is almost full. Will be ignored if set to 0. |
GC_RESULT_QUEUE_COUNT_THRESHOLD_SEVERITY |
C_RESULT_QUEUE _COUNT_THRESHOLD_SEVERITY |
Severity of alert to be initiated if exceeding GC_RESULT_QUEUE_COUNT_THRESHOLD |
Signals
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
signal |
clk |
in |
std_logic |
VVC Clock signal |
signal |
wishbone_vvc_master_if |
inout |
Wishbone signal interface record |
In this VVC, the interface has been encapsulated in a signal record of type t_wishbone_if in order to improve readability of the code. Since the Wishbone interface buses can be of arbitrary size, the interface vectors have been left unconstrained. These unconstrained vectors need to be constrained when the interface signals are instantiated. For this interface, it could look like:
signal wishbone_if : t_wishbone_if(adr_o(C_ADDR_WIDTH - 1 downto 0),
dat_o(C_DATA_WIDTH - 1 downto 0),
dat_i(C_DATA_WIDTH - 1 downto 0));
Configuration Record
vvc_config accessible via shared_wishbone_vvc_config
Record element |
Type |
Default |
Description |
---|---|---|---|
inter_bfm_delay |
C_WISHBONE_INTER_BFM_DELAY_DEFAULT |
Delay between any requested BFM accesses towards the DUT. TIME_START2START: Time from a BFM start to the next BFM start (a TB_WARNING will be issued if access takes longer than TIME_START2START). TIME_FINISH2START: Time from a BFM end to the next BFM start. Any insert_delay() command will add to the above minimum delays, giving for instance the ability to skew the BFM starting time. |
|
cmd_queue_count_max |
natural |
C_CMD_QUEUE_COUNT_MAX |
Maximum pending number in command queue before queue is full. Adding additional commands will result in an ERROR. |
cmd_queue_count_threshold |
natural |
C_CMD_QUEUE_COUNT_THRESHOLD |
An alert will be issued if command queue exceeds this count. Used for early warning if command queue is almost full. Will be ignored if set to 0. |
cmd_queue_count_threshold_severity |
C_CMD_QUEUE_COUNT_THRESHOLD_SEERITY |
Severity of alert to be initiated if exceeding cmd_queue_count_threshold |
|
result_queue_count_max |
natural |
C_RESULT_QUEUE_COUNT_MAX |
Maximum number of unfetched results before result_queue is full |
result_queue_count_threshold |
natural |
C_RESULT_QUEUE_COUNT_THRESHOLD |
An alert will be issued if result queue exceeds this count. Used for early warning if result queue is almost full. Will be ignored if set to 0. |
result_queue_count_threshold_severity |
C_RESULT_QUEUE_COUNT_THRESHOLD_SEVERITY |
Severity of alert to be initiated if exceeding result_queue_count_threshold |
|
bfm_config |
C_WISHBONE_BFM_CONFIG_DEFAULT |
Configuration for the Wishbone BFM |
|
msg_id_panel |
t_msg_id_panel |
C_VVC_MSG_ID_PANEL_DEFAULT |
VVC dedicated message ID panel. See Scope of Verbosity Control for how to use verbosity control. |
unwanted_activity_severity |
C_UNWANTED_ACTIVITY_SEVERITY |
Severity of alert to be issued if unwanted activity on the DUT outputs is detected. It is enabled with ERROR severity by default. |
Note
cmd/result queue parameters in the configuration record are unused and will be removed in v3.0, use instead the entity generic constants.
The configuration record can be accessed from the Central Testbench Sequencer through the shared variable array, e.g.
shared_wishbone_vvc_config(C_VVC_IDX).inter_bfm_delay.delay_in_time := 50 ns;
shared_wishbone_vvc_config(C_VVC_IDX).bfm_config.id_for_bfm := ID_BFM;
Status Record
vvc_status accessible via shared_wishbone_vvc_status
The current status of the VVC can be retrieved during simulation. This is achieved by reading from the shared variable from the test sequencer. The record contents can be seen below:
Record element |
Type |
Description |
---|---|---|
current_cmd_idx |
natural |
Command index currently running |
previous_cmd_idx |
natural |
Previous command index to run |
pending_cmd_idx |
natural |
Pending number of commands in the command queue |
Methods
All VVC procedures are defined in vvc_methods_pkg.vhd (dedicated to this VVC).
See Common VVC Methods for procedures which are common to all VVCs.
It is also possible to send a multicast to all instances of a VVC with ALL_INSTANCES as parameter for vvc_instance_idx.
All parameters in brackets are optional.
wishbone_write()
Adds a write command to the Wishbone VVC executor queue, which will run as soon as all preceding commands have completed. When the command is scheduled to run, the executor calls the BFM wishbone_write() procedure.
wishbone_write(VVCT, vvc_instance_idx, addr, data, msg, [scope])
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
signal |
VVCT |
inout |
t_vvc_target_record |
VVC target type compiled into each VVC in order to differentiate between VVCs |
constant |
vvc_instance_idx |
in |
integer |
Instance number of the VVC |
constant |
addr |
in |
unsigned |
The address of a SW accessible register |
constant |
data |
in |
std_logic_vector |
The data value to be written to the addressed register |
constant |
msg |
in |
string |
A custom message to be appended in the log/alert |
constant |
scope |
in |
string |
Describes the scope from which the log/alert originates. Default value is C_VVC_CMD_SCOPE_DEFAULT. |
-- Examples:
wishbone_write(WISHBONE_VVCT, 0, x"1000", x"40", "Set UART baud rate to 9600", C_SCOPE);
-- It is recommended to use constants to improve the readability of the code, e.g.:
wishbone_write(WISHBONE_VVCT, 0, C_ADDR_UART_BAUDRATE, C_BAUDRATE_9600, "Set UART baud rate to 9600");
wishbone_read()
Adds a read command to the Wishbone VVC executor queue, which will run as soon as all preceding commands have completed. When the command is scheduled to run, the executor calls the BFM wishbone_read() procedure.
The value read from DUT will not be returned in this procedure call since it is non-blocking for the sequencer/caller, but the read data will be stored in the VVC for a potential future fetch (see example with fetch_result below). If the data_routing is set to TO_SB, the read data will be sent to the Wishbone VVC dedicated scoreboard where it will be checked against the expected value (provided by the testbench).
wishbone_read(VVCT, vvc_instance_idx, addr, [data_routing,] msg, [scope])
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
signal |
VVCT |
inout |
t_vvc_target_record |
VVC target type compiled into each VVC in order to differentiate between VVCs |
constant |
vvc_instance_idx |
in |
integer |
Instance number of the VVC |
constant |
addr |
in |
unsigned |
The address of a SW accessible register |
constant |
data_routing |
in |
Selects the destination of the read data |
|
constant |
msg |
in |
string |
A custom message to be appended in the log/alert |
constant |
scope |
in |
string |
Describes the scope from which the log/alert originates. Default value is C_VVC_CMD_SCOPE_DEFAULT. |
-- Examples:
wishbone_read(WISHBONE_VVCT, 0, x"1000", "Read UART baud rate", C_SCOPE);
wishbone_read(WISHBONE_VVCT, 0, x"1002", TO_SB, "Read UART RX and send to Scoreboard", C_SCOPE);
-- It is recommended to use constants to improve the readability of the code, e.g.:
wishbone_read(WISHBONE_VVCT, 0, C_ADDR_UART_BAUDRATE, "Read UART baud rate");
-- Example with fetch_result() call: Result is placed in v_result
variable v_cmd_idx : natural; -- Command index for the last read
variable v_result : work.vvc_cmd_pkg.t_vvc_result; -- Result from read.
...
wishbone_read(WISHBONE_VVCT, 0, C_ADDR_UART_BAUDRATE, "Read from Peripheral 1");
v_cmd_idx := get_last_received_cmd_idx(WISHBONE_VVCT, 0);
await_completion(WISHBONE_VVCT, 0, v_cmd_idx, 1 us, "Wait for read to finish");
fetch_result(WISHBONE_VVCT, 0, v_cmd_idx, v_result, "Fetching result from read operation");
Hint
t_vvc_result is defined in the corresponding vvc_cmd_pkg.vhd for the VIP.
wishbone_check()
Adds a check command to the Wishbone VVC executor queue, which will run as soon as all preceding commands have completed. When the command is scheduled to run, the executor calls the BFM wishbone_check() procedure. The wishbone_check() procedure will perform a read operation, then check if the read data is equal to the expected data in the data parameter. If the read data is not equal to the expected data parameter, an alert with severity ‘alert_level’ will be issued. The read data will not be stored in this procedure.
wishbone_check(VVCT, vvc_instance_idx, addr, data, msg, [alert_level, [scope]])
Object |
Name |
Dir. |
Type |
Description |
---|---|---|---|---|
signal |
VVCT |
inout |
t_vvc_target_record |
VVC target type compiled into each VVC in order to differentiate between VVCs |
constant |
vvc_instance_idx |
in |
integer |
Instance number of the VVC |
constant |
addr |
in |
unsigned |
The address of a SW accessible register |
constant |
data |
in |
std_logic_vector |
The expected data value to be read from the addressed register |
constant |
msg |
in |
string |
A custom message to be appended in the log/alert |
constant |
alert_level |
in |
Sets the severity for the alert. Default value is ERROR. |
|
constant |
scope |
in |
string |
Describes the scope from which the log/alert originates. Default value is C_VVC_CMD_SCOPE_DEFAULT. |
-- Examples:
wishbone_check(WISHBONE_VVCT, 0, x"1155", x"3B", "Check data from UART RX");
wishbone_check(WISHBONE_VVCT, 0, x"1155", x"3B", "Check data from UART RX", TB_ERROR, C_SCOPE):
-- It is recommended to use constants to improve the readability of the code, e.g.:
wishbone_check(WISHBONE_VVCT, 0, C_ADDR_UART_RX, C_UART_START_BYTE, "Check data from UART RX");
Activity Watchdog
The VVCs support a centralized VVC activity register which the activity watchdog uses to monitor the VVC activities. The VVCs will register their presence to the VVC activity register at start-up, and report when ACTIVE and INACTIVE, using dedicated VVC activity register methods, and trigger the global_trigger_vvc_activity_register signal during simulations. The activity watchdog is continuously monitoring the VVC activity register for VVC inactivity and raises an alert if no VVC activity is registered within the specified timeout period.
Include activity_watchdog(num_exp_vvc, timeout, [alert_level, [msg]])
in the testbench to start using the activity watchdog.
Note that setting the exact number of expected VVCs in the VVC activity register can be omitted by setting num_exp_vvc = 0.
More information can be found in Essential Mechanisms - Activity Watchdog.
Transaction Info
This VVC supports transaction info, a UVVM concept for distributing transaction information in a controlled manner within the complete testbench environment. The transaction info may be used in many different ways, but the main purpose is to share information directly from the VVC to a DUT model.
Info field |
Type |
Default |
Description |
---|---|---|---|
operation |
t_operation |
NO_OPERATION |
Current VVC operation, e.g. INSERT_DELAY, POLL_UNTIL, READ, WRITE |
addr |
unsigned(63 downto 0) |
0x0 |
Address of the Wishbone read/write transaction |
data |
std_logic_vector(1023 downto 0) |
0x0 |
Data for Wishbone read or write transaction |
vvc_meta |
t_vvc_meta |
C_VVC_META_DEFAULT |
VVC meta data of the executing VVC command |
-> msg |
string |
“” |
Message of executing VVC command |
-> cmd_idx |
integer |
-1 |
Command index of executing VVC command |
transaction_status |
t_transaction_status |
INACTIVE |
Set to INACTIVE, IN_PROGRESS, FAILED or SUCCEEDED during a transaction |
More information can be found in Essential Mechanisms - Distribution of Transaction Info.
Scoreboard
This VVC has built in Scoreboard functionality where data can be routed by setting the TO_SB parameter in supported method calls, i.e. wishbone_read(). Note that the data is only stored in the scoreboard and not accessible with the fetch_result() method when the TO_SB parameter is applied. The Wishbone scoreboard is accessible from the testbench as a shared variable WISHBONE_VVC_SB, located in the vvc_methods_pkg.vhd, e.g.
WISHBONE_VVC_SB.add_expected(C_WISHBONE_VVC_IDX, pad_wishbone_sb(v_expected), "Adding expected");
The Wishbone scoreboard is per default a 1024 bits wide standard logic vector. When sending expected data to the scoreboard, where the data width is smaller than the default scoreboard width, we recommend zero-padding the data with the pad_wishbone_sb() function, e.g.
WISHBONE_VVC_SB.add_expected(<Wishbone VVC instance number>, pad_wishbone_sb(<exp data>));
See the Bitvis VIP Scoreboard for a complete list of available commands and additional information. All of the listed Generic Scoreboard commands are available for the Wishbone VVC scoreboard using the WISHBONE_VVC_SB.
Unwanted Activity Detection
This VVC supports detection of unwanted activity from the DUT. This mechanism will give an alert if the DUT generates any unexpected bus activity. It assures that no data is output from the DUT when it is not expected, i.e. read/receive/check/expect VVC methods are not called. Once the VVC is inactive, it starts to monitor continuously on the DUT outputs. When unwanted activity is detected, the VVC issues an alert.
The unwanted activity detection can be configured from the central testbench sequencer, where the severity of alert can be changed to a different value. To disable this feature in the testbench, e.g.
shared_wishbone_vvc_config(C_VVC_INDEX).unwanted_activity_severity := NO_ALERT;
For Wishbone VVC, the unwanted activity detection is enabled by default with severity ERROR.
More information can be found in Essential Mechanisms - Unwanted Activity Detection.
Compilation
The Wishbone VVC must be compiled with VHDL-2008 or newer. It is dependent on the following libraries:
UVVM Utility Library (UVVM-Util)
UVVM VVC Framework
Bitvis VIP Scoreboard
Wishbone BFM
Before compiling the Wishbone VVC, assure that uvvm_util, uvvm_vvc_framework and bitvis_vip_scoreboard have been compiled.
See Essential Mechanisms - Compile Scripts for information about compile scripts.
Compile to library |
File |
Comment |
---|---|---|
bitvis_vip_wishbone |
wishbone_bfm_pkg.vhd |
Wishbone BFM |
bitvis_vip_wishbone |
transaction_pkg.vhd |
Wishbone transaction package with DTT types, constants, etc. |
bitvis_vip_wishbone |
vvc_cmd_pkg.vhd |
Wishbone VVC command types and operations |
bitvis_vip_wishbone |
../uvvm_vvc_framework/src_target_dependent/td_target_support_pkg.vhd |
UVVM VVC target support package, compiled into this VVC library |
bitvis_vip_wishbone |
../uvvm_vvc_framework/src_target_dependent/td_vvc_framework_common_methods_pkg.vhd |
Common UVVM framework methods compiled into the this VVC library |
bitvis_vip_wishbone |
vvc_sb_pkg.vhd |
Wishbone VVC scoreboard |
bitvis_vip_wishbone |
vvc_methods_pkg.vhd |
Wishbone VVC methods |
bitvis_vip_wishbone |
../uvvm_vvc_framework/src_target_dependent/td_queue_pkg.vhd |
UVVM queue package for this VVC |
bitvis_vip_wishbone |
../uvvm_vvc_framework/src_target_dependent/td_vvc_entity_support_pkg.vhd |
UVVM VVC entity support compiled into this VVC library |
bitvis_vip_wishbone |
wishbone_vvc.vhd |
Wishbone VVC |
bitvis_vip_wishbone |
vvc_context.vhd |
Wishbone VVC context file |
Simulator compatibility and setup
See Prerequisites for a list of supported simulators.
For required simulator setup see UVVM-Util Simulator compatibility and setup.
Additional Documentation
Important
This is a simplified Verification IP (VIP) for Wishbone.
The given VIP complies with the basic Wishbone protocol and thus allows a normal access towards a Wishbone interface.
This VIP is not a Wishbone protocol checker.
For a more advanced VIP please contact UVVM support at info@uvvm.org
Note
Disclaimer: This IP and any part thereof are provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with this IP.