Packages et sous-programmes

Organiser le VHDL avec des packages, fonctions et procédures réutilisables.

Pourquoi utiliser un package

Un package sert à regrouper ce qui doit être partagé entre plusieurs fichiers VHDL :

types personnalisés ;
constantes communes ;
sous-types ;
déclarations de fonctions et procédures ;
déclarations de composants, si le projet en utilise.

Sans package, on recopie les mêmes définitions dans plusieurs architectures. Cela finit souvent par créer des incohérences.

Déclaration de package

La déclaration du package expose l'interface : ce que les autres fichiers peuvent utiliser.

library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.NUMERIC_STD.ALL;
 
package video_pkg is
 
  subtype t_color is unsigned(7 downto 0);
 
  type t_rgb is record
    red   : t_color;
    green : t_color;
    blue  : t_color;
    valid : std_logic;
  end record t_rgb

library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.NUMERIC_STD.ALL;
 
library work;
use work.video_pkg.ALL;
 
entity pixel_gate is
  port (
    i_pixel : in  t_rgb;
    o_red   : out std_logic_vector(7 downto 0)
  );
end entity pixel_gate;
 
architecture rtl of pixel_gate is
begin
  o_red <= std_logic_vector(i_pixel.red) when is_valid_pixel(i_pixel) else x"00";
end architecture rtl;

function parity_even(i_data : std_logic_vector) return std_logic is
  variable v_parity : std_logic := '0';
begin
  for i in i_data'range loop
    v_parity := v_parity xor i_data(i);
  end loop;
 
  return v_parity;
end function parity_even;

procedure drive_byte(
  signal   o_bus   : out std_logic_vector(7 downto 0);
  constant i_value : in  natural
) is
begin
  o_bus <= std_logic_vector(to_unsigned(i_value, o_bus'length));
end procedure drive_byte;

Besoin	Choix
Calculer une valeur	Fonction
Factoriser une vérification de testbench	Procédure
Modifier plusieurs sorties	Procédure
Partager des types et constantes	Package

Packages et sous-programmes

Pourquoi utiliser un package

Déclaration de package

Corps de package

Utiliser un package

Fonction

Procédure

Fonction ou procédure

Bonnes pratiques

À retenir