1 |
2 |
sinx |
----------------------------------------------------------------------
|
2 |
|
|
---- ----
|
3 |
|
|
---- VHDL Wishbone TESTBENCH ----
|
4 |
|
|
---- ----
|
5 |
|
|
---- This file is part of the vhdl_wb_tb project ----
|
6 |
|
|
---- http://www.opencores.org/cores/vhdl_wb_tb/ ----
|
7 |
|
|
---- ----
|
8 |
|
|
---- This file contains the wishbone_bfm_pkg package and defines ----
|
9 |
|
|
---- wishbone transaction processes functions for simulation. ----
|
10 |
|
|
---- ----
|
11 |
|
|
---- To Do: ----
|
12 |
|
|
---- - ----
|
13 |
|
|
---- ----
|
14 |
|
|
---- Author(s): ----
|
15 |
4 |
sinx |
---- - Sinx, sinx@opencores.org ----
|
16 |
2 |
sinx |
---- ----
|
17 |
|
|
----------------------------------------------------------------------
|
18 |
4 |
sinx |
---- SVN information
|
19 |
|
|
----
|
20 |
|
|
---- $URL: $
|
21 |
|
|
---- $Revision: $
|
22 |
|
|
---- $Date: $
|
23 |
|
|
---- $Author: $
|
24 |
|
|
---- $Id: $
|
25 |
|
|
----------------------------------------------------------------------
|
26 |
2 |
sinx |
---- ----
|
27 |
|
|
---- Copyright (C) 2018 Authors and OPENCORES.ORG ----
|
28 |
|
|
---- ----
|
29 |
|
|
---- This source file may be used and distributed without ----
|
30 |
|
|
---- restriction provided that this copyright statement is not ----
|
31 |
|
|
---- removed from the file and that any derivative work contains ----
|
32 |
|
|
---- the original copyright notice and the associated disclaimer. ----
|
33 |
|
|
---- ----
|
34 |
|
|
---- This source file is free software; you can redistribute it ----
|
35 |
|
|
---- and/or modify it under the terms of the GNU Lesser General ----
|
36 |
|
|
---- Public License as published by the Free Software Foundation; ----
|
37 |
|
|
---- either version 2.1 of the License, or (at your option) any ----
|
38 |
|
|
---- later version. ----
|
39 |
|
|
---- ----
|
40 |
|
|
---- This source is distributed in the hope that it will be ----
|
41 |
|
|
---- useful, but WITHOUT ANY WARRANTY; without even the implied ----
|
42 |
|
|
---- warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR ----
|
43 |
|
|
---- PURPOSE. See the GNU Lesser General Public License for more ----
|
44 |
|
|
---- details. ----
|
45 |
|
|
---- ----
|
46 |
|
|
---- You should have received a copy of the GNU Lesser General ----
|
47 |
|
|
---- Public License along with this source; if not, download it ----
|
48 |
|
|
---- from http://www.opencores.org/lgpl.shtml ----
|
49 |
|
|
---- ----
|
50 |
|
|
----------------------------------------------------------------------
|
51 |
|
|
|
52 |
|
|
-- library -----------------------------------------------------------
|
53 |
|
|
library ieee;
|
54 |
|
|
use ieee.std_logic_1164.all;
|
55 |
|
|
use ieee.numeric_std.all;
|
56 |
|
|
|
57 |
|
|
library work;
|
58 |
|
|
use work.my_project_pkg.all;
|
59 |
|
|
use work.wishbone_pkg.all;
|
60 |
|
|
use work.convert_pkg.all;
|
61 |
|
|
|
62 |
|
|
-- package -----------------------------------------------------------
|
63 |
|
|
package wishbone_bfm_pkg is
|
64 |
|
|
-- defines output signals of wb bfm (simulation only)
|
65 |
|
|
type wishbone_bfm_master_out_t is record
|
66 |
|
|
-- 2.2.2 Signals Common to MASTER and SLAVE Interfaces
|
67 |
|
|
dat : wishbone_data_t; -- data []
|
68 |
|
|
rst : std_logic; -- reset [mandatory RULE 3.40]
|
69 |
|
|
tgd : wishbone_tag_data_t; -- data tag []
|
70 |
|
|
-- 2.2.3 MASTER Signals
|
71 |
|
|
adr : wishbone_address_t; -- address [optional]
|
72 |
|
|
cyc : std_logic; -- cycle [mandatory RULE 3.40]
|
73 |
|
|
lock: std_logic; -- lock []
|
74 |
|
|
sel : wishbone_byte_select_t;
|
75 |
|
|
stb : std_logic; -- strobe [mandatory RULE 3.40]
|
76 |
|
|
tga : wishbone_tag_address_t; -- address tag []
|
77 |
|
|
tgc : wishbone_tag_cycle_t; -- cycle tag []
|
78 |
|
|
we : std_logic; -- write enable []
|
79 |
|
|
end record wishbone_bfm_master_out_t;
|
80 |
|
|
|
81 |
|
|
-- defines input signals of wb bfm (simulation only)
|
82 |
|
|
type wishbone_bfm_master_in_t is record
|
83 |
|
|
-- 2.2.2 Signals Common to MASTER and SLAVE Interfaces
|
84 |
|
|
rst : std_logic; -- reset [mandatory RULE 3.40]
|
85 |
|
|
clk : std_logic; -- clock [mandatory RULE 3.40]
|
86 |
|
|
dat : wishbone_data_t; -- read data []
|
87 |
|
|
tgd : wishbone_tag_data_t; -- read data tag []
|
88 |
|
|
-- 2.2.4 SLAVE Signals
|
89 |
|
|
ack : std_logic; -- acknowledge [mandatory RULE 3.40]
|
90 |
|
|
err : std_logic; -- error [optional PERMISSION 3.20]
|
91 |
|
|
rty : std_logic; -- retry [optional PERMISSION 3.25]
|
92 |
|
|
--stall : std_logic;
|
93 |
|
|
int : std_logic; -- interrupt [non WB signal]
|
94 |
|
|
end record wishbone_bfm_master_in_t;
|
95 |
|
|
|
96 |
|
|
-- define the idle state of wb bus
|
97 |
|
|
constant wb_bfm_master_out_idle_c : wishbone_bfm_master_out_t := (
|
98 |
|
|
dat => wishbone_data_of_unused_address_c,
|
99 |
|
|
rst => '0',
|
100 |
|
|
tgd => (others=>'0'),
|
101 |
|
|
adr => (others=>'U'),
|
102 |
|
|
cyc => '0',
|
103 |
|
|
lock => '0',
|
104 |
|
|
sel => (others=>'0'),
|
105 |
|
|
stb => '0',
|
106 |
|
|
tga => (others=>'0'),
|
107 |
|
|
tgc => (others=>'0'),
|
108 |
|
|
we => '0'
|
109 |
|
|
);
|
110 |
|
|
-- BUS FUNCTIONS -----------------------------------------------------
|
111 |
|
|
----------------------------------------------------------------------
|
112 |
4 |
sinx |
----------------------------------------------------------------------
|
113 |
2 |
sinx |
-- generate single write cycle
|
114 |
4 |
sinx |
procedure wb_write(
|
115 |
|
|
address_i : in integer; -- address to write to
|
116 |
|
|
data_i : in integer; -- data value to be written
|
117 |
|
|
signal i : in wishbone_bfm_master_in_t; -- incoming wb signals
|
118 |
|
|
signal o : out wishbone_bfm_master_out_t; -- incoming wb signals
|
119 |
|
|
display_error_message_i : in integer range 0 to 2 := 1; -- verbose mode; 0=no output, 1=error only, 2= all
|
120 |
|
|
additional_error_message_i : in string := ""
|
121 |
2 |
sinx |
);
|
122 |
|
|
|
123 |
|
|
-- generate single read cycle and verify read word with expected_data_i
|
124 |
4 |
sinx |
procedure wb_read(
|
125 |
|
|
address_i : in integer;
|
126 |
|
|
expected_data_i : in integer;
|
127 |
|
|
signal i : in wishbone_bfm_master_in_t;
|
128 |
|
|
signal o : out wishbone_bfm_master_out_t;
|
129 |
|
|
display_error_message_i : in integer range 0 to 4 := 1; -- verbose mode; 0=no output, 1=error only, 2= all, 3=use expected_data_mask_i, 4=show difference read to exp.
|
130 |
|
|
additional_error_message_i : in string := "";
|
131 |
|
|
expected_data_mask_i : in integer := 0
|
132 |
2 |
sinx |
);
|
133 |
|
|
|
134 |
|
|
-- generate single read cycle and return read data via read_data_o
|
135 |
4 |
sinx |
procedure wb_read(
|
136 |
|
|
address_i : in integer;
|
137 |
|
|
read_data_o : out std_logic_vector (wishbone_address_width_c-1 downto 0);
|
138 |
|
|
signal i : in wishbone_bfm_master_in_t;
|
139 |
|
|
signal o : out wishbone_bfm_master_out_t
|
140 |
2 |
sinx |
);
|
141 |
|
|
----------------------------------------------------------------------
|
142 |
|
|
end;
|
143 |
|
|
|
144 |
|
|
-- package body ------------------------------------------------------
|
145 |
|
|
package body wishbone_bfm_pkg is
|
146 |
|
|
----------------------------------------------------------------------
|
147 |
|
|
----------------------------------------------------------------------
|
148 |
4 |
sinx |
procedure wb_write(
|
149 |
|
|
address_i : in integer;
|
150 |
|
|
data_i : in integer;
|
151 |
|
|
signal i : in wishbone_bfm_master_in_t;
|
152 |
|
|
signal o : out wishbone_bfm_master_out_t;
|
153 |
|
|
display_error_message_i : in integer range 0 to 2 := 1;
|
154 |
|
|
additional_error_message_i : in string := ""
|
155 |
|
|
) is
|
156 |
2 |
sinx |
----------------------------------------------------------------------
|
157 |
4 |
sinx |
begin
|
158 |
2 |
sinx |
o.adr <= to_std_logic_vector(address_i, wishbone_address_width_c);
|
159 |
|
|
o.dat <= to_std_logic_vector(data_i, wishbone_address_width_c);
|
160 |
|
|
o.we <= '1';
|
161 |
|
|
o.rst <= '0';
|
162 |
|
|
o.tgd <= (others => '0');
|
163 |
|
|
o.cyc <= '1';
|
164 |
|
|
o.lock <= '1';
|
165 |
|
|
o.sel <= (others => '1');
|
166 |
|
|
o.stb <= '1';
|
167 |
|
|
o.tga <= (others => '0');
|
168 |
|
|
o.tgc <= (others => '0');
|
169 |
4 |
sinx |
if (display_error_message_i = 2) then
|
170 |
|
|
report "writing :" & to_string(data_i, 16, wishbone_address_width_c/4) & " to: " & to_string(address_i, 16, wishbone_address_width_c/4) &
|
171 |
2 |
sinx |
additional_error_message_i;
|
172 |
4 |
sinx |
end if;
|
173 |
2 |
sinx |
|
174 |
4 |
sinx |
wait until falling_edge(i.clk);
|
175 |
2 |
sinx |
-- wait for ack
|
176 |
4 |
sinx |
while i.ack = '0' loop
|
177 |
|
|
wait until falling_edge(i.clk);
|
178 |
|
|
end loop;
|
179 |
|
|
wait until rising_edge(i.clk);
|
180 |
2 |
sinx |
o <= wb_bfm_master_out_idle_c; -- reset bus
|
181 |
4 |
sinx |
end wb_write;
|
182 |
2 |
sinx |
----------------------------------------------------------------------
|
183 |
|
|
----------------------------------------------------------------------
|
184 |
4 |
sinx |
procedure wb_read(
|
185 |
|
|
address_i : in integer;
|
186 |
|
|
read_data_o : out std_logic_vector (wishbone_address_width_c-1 downto 0);
|
187 |
|
|
signal i : in wishbone_bfm_master_in_t;
|
188 |
|
|
signal o : out wishbone_bfm_master_out_t
|
189 |
|
|
) is
|
190 |
2 |
sinx |
----------------------------------------------------------------------
|
191 |
4 |
sinx |
begin
|
192 |
2 |
sinx |
o.adr <= to_std_logic_vector(address_i, wishbone_address_width_c);
|
193 |
|
|
o.dat <= (others => 'U');
|
194 |
|
|
o.we <= '0';
|
195 |
|
|
o.rst <= '0';
|
196 |
|
|
o.tgd <= (others => '0');
|
197 |
|
|
o.cyc <= '1';
|
198 |
|
|
o.lock <= '1';
|
199 |
|
|
o.sel <= (others => '1');
|
200 |
|
|
o.stb <= '1';
|
201 |
|
|
o.tga <= (others => '0');
|
202 |
|
|
o.tgc <= (others => '0');
|
203 |
4 |
sinx |
wait until falling_edge(i.clk);
|
204 |
2 |
sinx |
-- ack handling
|
205 |
4 |
sinx |
while (i.ack = '0') loop
|
206 |
|
|
wait until falling_edge(i.clk);
|
207 |
|
|
end loop;
|
208 |
2 |
sinx |
read_data_o := i.dat;
|
209 |
4 |
sinx |
wait until rising_edge(i.clk);
|
210 |
2 |
sinx |
o <= wb_bfm_master_out_idle_c; -- reset bus
|
211 |
4 |
sinx |
end wb_read;
|
212 |
2 |
sinx |
------------------------------------------------------------------------
|
213 |
|
|
------------------------------------------------------------------------
|
214 |
4 |
sinx |
procedure wb_read(
|
215 |
|
|
address_i : in integer;
|
216 |
|
|
expected_data_i : in integer;
|
217 |
|
|
signal i : in wishbone_bfm_master_in_t;
|
218 |
|
|
signal o : out wishbone_bfm_master_out_t;
|
219 |
|
|
display_error_message_i : in integer range 0 to 4 := 1;
|
220 |
|
|
additional_error_message_i : in string := "";
|
221 |
|
|
expected_data_mask_i : in integer := 0
|
222 |
|
|
) is
|
223 |
2 |
sinx |
----------------------------------------------------------------------
|
224 |
4 |
sinx |
variable readdata_v : std_logic_vector (31 downto 0);
|
225 |
|
|
variable diff_v : integer;
|
226 |
2 |
sinx |
----------------------------------------------------------------------
|
227 |
4 |
sinx |
begin
|
228 |
2 |
sinx |
wb_read(address_i,readdata_v,i,o); -- read from bus
|
229 |
|
|
|
230 |
|
|
diff_v := to_integer(readdata_v) - expected_data_i;
|
231 |
|
|
|
232 |
4 |
sinx |
if (display_error_message_i = 1) then -- output errors only
|
233 |
|
|
if (readdata_v /= to_std_logic_vector(expected_data_i, wishbone_address_width_c)) then
|
234 |
|
|
report "error" & additional_error_message_i & ": expected data at address 0x" & to_string(address_i, 16, wishbone_address_width_c/4) &
|
235 |
2 |
sinx |
" was: 0x" & to_string(expected_data_i, 16, wishbone_address_width_c/4) & " but read: 0x" & to_string(readdata_v,16,wishbone_address_width_c/4)
|
236 |
4 |
sinx |
severity error;
|
237 |
|
|
end if;
|
238 |
|
|
elsif (display_error_message_i = 2) then -- output all
|
239 |
|
|
report additional_error_message_i & ": read data at address 0x" & to_string(address_i, 16, wishbone_address_width_c/4) &
|
240 |
2 |
sinx |
" was: 0x" & to_string(readdata_v, 16, wishbone_address_width_c/4)
|
241 |
4 |
sinx |
severity note;
|
242 |
|
|
elsif (display_error_message_i = 3) then -- output filter
|
243 |
|
|
if ((readdata_v and to_std_logic_vector(expected_data_mask_i, wishbone_address_width_c)) /=
|
244 |
|
|
to_std_logic_vector(expected_data_i, wishbone_address_width_c)) then
|
245 |
|
|
report additional_error_message_i & ": read data at address 0x" & to_string(address_i, 16, wishbone_address_width_c/4) &
|
246 |
2 |
sinx |
" was: 0x" & to_string(readdata_v, 16, wishbone_address_width_c/4)
|
247 |
4 |
sinx |
severity note;
|
248 |
|
|
end if;
|
249 |
|
|
elsif display_error_message_i = 4 then
|
250 |
|
|
if (readdata_v /= to_std_logic_vector(expected_data_i, wishbone_address_width_c)) then
|
251 |
|
|
report "error" & additional_error_message_i & ": expected data at address 0x" & to_string(address_i, 16, wishbone_address_width_c/4) &
|
252 |
|
|
" was: 0x" & to_string(expected_data_i, 16, wishbone_address_width_c/4) & " but read: 0x" & to_string(readdata_v,16,wishbone_address_width_c/4) & " diff: " & to_string(readdata_v,16,wishbone_address_width_c/4)
|
253 |
|
|
severity error;
|
254 |
|
|
end if;
|
255 |
|
|
end if;
|
256 |
|
|
end wb_read;
|
257 |
2 |
sinx |
--------------------------------------------------------------------
|
258 |
|
|
end package body;
|
259 |
|
|
----------------------------------------------------------------------
|
260 |
|
|
---- end of file ----
|
261 |
|
|
----------------------------------------------------------------------
|