aboutsummaryrefslogtreecommitdiffstats
path: root/tex/samples.tex
blob: c272e05ef45b2f89f8f323490124ebc59814f43a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
\section{Samples / Templates}

Below is a template for a simple VHDL file.

\begin{lstlisting}[language=vhdl]
library ieee;
use ieee.std_logic_1164.all;
-- declare entities (`\S\ref{sec:vhdl:entities-arch}`)
entity `\reqph{name}` is
  port(`\optionalph{pins}`);
end entity `\reqph{name}`;
-- declare architectures (`\S\ref{sec:vhdl:entities-arch}`)
architecture `\reqph{name}` of `\reqph{entity name}` is
  -- internal signals (`\S\ref{sec:vhdl:declarations}`)
  -- other components (`\S\ref{sec:vhdl:components}`)
  -- declare custom types (`\S\ref{sec:fsm:encode}`)
  -- variables of custom type (`\S\ref{sec:fsm:encode}`)
begin
  -- assignments and processes (`\S\ref{sec:vhdl:concurrent}`)
end architecture `\reqph{name}`;
\end{lstlisting}
And for a test bench
\begin{lstlisting}[language=vhdl]
library ieee;
use ieee.std_logic_1164.all;

-- declare entities (`\S\ref{sec:vhdl:entities-arch}`)
entity `\reqph{name}`_tb is
  -- nothing here
end entity `\reqph{name}`_tb;

architecture tb of `\reqph{name}`_tb is
  -- simulator settings
  constant freq : natural := `\reqph{frequency}`;
  constant T    : time := 1 sec / freq;

  -- component of DUT
  component `\reqph{name}` is
    port(
      clk : in std_ulogic;
      `\optionalph{other I/O}`
    );
  end component `\reqph{name}`;

  signal clk_tb : std_ulogic;
  -- more signals for inputs and outputs
begin

  dut: component `\reqph{name}`
    port map(
      clk => clk_tb;
      `\reqph{other I/O}`);

    clk_generator: process
      -- generate clock (`\S\ref{sec:stimuli}`)
      clk_tb <= '1'; wait for (T/2);
      clk_tb <= '0'; wait for (T/2);
    end process;

    stimuli: process
    begin
      -- generate stimuli (`\S\ref{sec:stimuli}`)
      -- for loops, after, etc.
    end;

    response: process
    -- constants for expected outputs
    begin
      wait for 0.9 * T;
      -- assertions (`\S\ref{sec:assertions}`)
      wait for T;
    end process;

end architecture tb;

\end{lstlisting}
% vim:ts=2 sw=2 et: