Subversion Repositories pltbutils

----------------------------------------------------------------------

----                                                              ----

---- PlTbUtils Testbench Example 1                                ----

----                                                              ----

---- This file is part of the PlTbUtils project                   ----

---- http://opencores.org/project,pltbutils                       ----

----                                                              ----

---- Description:                                                 ----

---- PlTbUtils is a collection of functions, procedures and       ----

---- components for easily creating stimuli and checking response ----

---- in automatic self-checking testbenches.                      ----

----                                                              ----

---- This file is an example which demonstrates how PlTbUtils     ----

---- can be used.                                                 ----

----                                                              ----

----                                                              ----

---- To Do:                                                       ----

---- -                                                            ----

----                                                              ----

---- Author(s):                                                   ----

---- - Per Larsson, pela.opencores@gmail.com                      ----

----                                                              ----

----------------------------------------------------------------------

----                                                              ----

---- Copyright (C) 2013-2014 Authors and OPENCORES.ORG            ----

----                                                              ----

---- This source file may be used and distributed without         ----

---- restriction provided that this copyright statement is not    ----

---- removed from the file and that any derivative work contains  ----

---- the original copyright notice and the associated disclaimer. ----

----                                                              ----

---- This source file is free software; you can redistribute it   ----

---- and/or modify it under the terms of the GNU Lesser General   ----

---- Public License as published by the Free Software Foundation; ----

---- either version 2.1 of the License, or (at your option) any   ----

---- later version.                                               ----

----                                                              ----

---- This source is distributed in the hope that it will be       ----

---- useful, but WITHOUT ANY WARRANTY; without even the implied   ----

---- warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR      ----

---- PURPOSE. See the GNU Lesser General Public License for more  ----

---- details.                                                     ----

----                                                              ----

---- You should have received a copy of the GNU Lesser General    ----

---- Public License along with this source; if not, download it   ----

---- from http://www.opencores.org/lgpl.shtml                     ----

----                                                              ----

----------------------------------------------------------------------

library ieee;

use ieee.std_logic_1164.all;

use ieee.numeric_std.all;

use work.txt_util.all;

use work.pltbutils_func_pkg.all;

use work.pltbutils_comp_pkg.all;

entity tb_example1 is

  generic (

    G_WIDTH             : integer := 8;

    G_CLK_PERIOD        : time := 10 ns;

    G_DISABLE_BUGS      : integer range 0 to 1 := 0

  );

end entity tb_example1;

architecture bhv of tb_example1 is

  -- Simulation status- and control signals

  -- for accessing .stop_sim and for viewing in waveform window

  signal pltbs          : pltbs_t := C_PLTBS_INIT;

  -- DUT stimuli and response signals

  signal clk            : std_logic;

  signal rst            : std_logic;

  signal carry_in       : std_logic;

  signal x              : std_logic_vector(G_WIDTH-1 downto 0);

  signal y              : std_logic_vector(G_WIDTH-1 downto 0);

  signal sum            : std_logic_vector(G_WIDTH-1 downto 0);

  signal carry_out      : std_logic;

begin

  dut0 : entity work.dut_example

    generic map (

      G_WIDTH           => G_WIDTH,

      G_DISABLE_BUGS    => G_DISABLE_BUGS

    )

    port map (

      clk_i             => clk,

      rst_i             => rst,

      carry_i           => carry_in,

      x_i               => x,

      y_i               => y,

      sum_o             => sum,

      carry_o           => carry_out

    );

  clkgen0 : pltbutils_clkgen

    generic map(

      G_PERIOD          => G_CLK_PERIOD

    )

    port map(

      clk_o             => clk,

      stop_sim_i        => pltbs.stop_sim

    );

  -- Testcase process

  -- NOTE: The purpose of the following code is to demonstrate some of the 

  -- features of PlTbUtils, not to do a thorough verification.

  p_tc1 : process

    variable pltbv  : pltbv_t := C_PLTBV_INIT;

  begin

    startsim("tc1", pltbv, pltbs);

    rst         <= '1';

    carry_in    <= '0';

    x           <= (others => '0');

    y           <= (others => '0');

    starttest(1, "Reset test", pltbv, pltbs);

    waitclks(2, clk, pltbv, pltbs);

    check("Sum during reset",       sum,         0, pltbv, pltbs);

    check("Carry out during reset", carry_out, '0', pltbv, pltbs);

    rst         <= '0';

    endtest(pltbv, pltbs);

    starttest(2, "Simple sum test", pltbv, pltbs);

    carry_in <= '0';

    x <= std_logic_vector(to_unsigned(1, x'length));

    y <= std_logic_vector(to_unsigned(2, x'length));

    waitclks(2, clk, pltbv, pltbs);

    check("Sum",       sum,         3, pltbv, pltbs);

    check("Carry out", carry_out, '0', pltbv, pltbs);

    endtest(pltbv, pltbs);

    starttest(3, "Simple carry in test", pltbv, pltbs);

    print(G_DISABLE_BUGS=0, pltbv, pltbs, "Bug here somewhere");

    carry_in <= '1';

    x <= std_logic_vector(to_unsigned(1, x'length));

    y <= std_logic_vector(to_unsigned(2, x'length));

    waitclks(2, clk, pltbv, pltbs);

    check("Sum",       sum,         4, pltbv, pltbs);

    check("Carry out", carry_out, '0', pltbv, pltbs);

    print(G_DISABLE_BUGS=0, pltbv, pltbs, "");

    endtest(pltbv, pltbs);

    starttest(4, "Simple carry out test", pltbv, pltbs);

    carry_in <= '0';

    x <= std_logic_vector(to_unsigned(2**G_WIDTH-1, x'length));

    y <= std_logic_vector(to_unsigned(1, x'length));

    waitclks(2, clk, pltbv, pltbs);

    check("Sum",       sum,         0, pltbv, pltbs);

    check("Carry out", carry_out, '1', pltbv, pltbs);

    endtest(pltbv, pltbs);

    endsim(pltbv, pltbs, true);

    wait;

  end process p_tc1;

end architecture bhv;