Документация

Указание комментария к заголовку

Кодер включает блок комментария заголовка в верхней части файлов, которые он генерирует. Блок комментария заголовка содержит спецификации генерирующего фильтра и опции кодера, которые были выбраны во время генерации HDL-кода.

Можно использовать опцию Comment in header, чтобы добавить комментарий в конец блока комментариев заголовка в каждом сгенерированном файле. Для примера используйте эту опцию, чтобы добавить "This module was automatically generated”. С этим изменением предыдущий блок комментария заголовка появится следующим образом:

-- -------------------------------------------------------------
--
-- Module: Hlp
--
-- Generated by MATLAB(R) 7.11 and the Filter Design HDL Coder 2.7.
--
-- Generated on: 2010-08-31 13:32:16
--
-- This module was automatically generated
--
-- -------------------------------------------------------------

-- -------------------------------------------------------------
-- HDL Code Generation Options:
--
-- TargetLanguage: VHDL
-- Name: Hlp
-- UserComment:  User data, length 47

-- Filter Specifications:
--
-- Sampling Frequency : N/A (normalized frequency)
-- Response           : Lowpass
-- Specification      : Fp,Fst,Ap,Ast
-- Passband Edge      : 0.45
-- Stopband Edge      : 0.55
-- Passband Ripple    : 1 dB
-- Stopband Atten.    : 60 dB
-- -------------------------------------------------------------

-- -------------------------------------------------------------
-- HDL Implementation    : Fully parallel
-- Multipliers           : 43
-- Folding Factor        : 1
-- -------------------------------------------------------------
-- Filter Settings:
--
-- Discrete-Time FIR Filter (real)
-- -------------------------------
-- Filter Structure  : Direct-Form FIR
-- Filter Length     : 43
-- Stable            : Yes
-- Linear Phase      : Yes (Type 1)
-- Arithmetic        : fixed
-- Numerator         : s16,16 -> [-5.000000e-001 5.000000e-001)
-- Input             : s16,15 -> [-1 1)
-- Filter Internals  : Full Precision
--   Output          : s33,31 -> [-2 2)  (auto determined)
--   Product         : s31,31 -> [-5.000000e-001 5.000000e-001)  (auto determined)
--   Accumulator     : s33,31 -> [-2 2)  (auto determined)
--   Round Mode      : No rounding
--   Overflow Mode   : No overflow
-- -------------------------------------------------------------

Чтобы добавить комментарий заголовка,

Альтернатива командной строки: используйте generatehdl функция со свойством UserComment чтобы добавить комментарий в конец блока комментариев заголовка в каждом сгенерированном HDL- файла.

Разрешение конфликтов по совпадению имен сущностей или модулей

Кодер проверяет, имеют ли несколько сущностей в VHDL или несколько модулей в Verilog одно и то же имя. Если существует конфликт имен, кодер добавляет постфикс '_block' ко второму из двух совпадающих векторов символов.

Чтобы изменить постфикс:

Альтернатива командной строки: используйте generatehdl функция со свойством EntityConflictPostfix изменение сущности или модуля приводит к конфликту постфикса.

Разрешение HDL-конфликтов зарезервированных слов

Кодер проверяет, являются ли векторы символов, которые вы задаете в качестве имен, значений постфикса или меток, зарезервированными словами VHDL или Verilog. Список зарезервированных слов VHDL и Verilog см. в разделе Таблицы зарезервированных слов.

Если вы задаете зарезервированное слово, кодер добавляет постфикс _rsvd в вектор символов. Например, если вы пытаетесь назвать свой фильтр mod, для кода VHDL, кодер добавляет постфикс _rsvd для формирования имени mod_rsvd.

Чтобы изменить постфикс:

Альтернатива командной строки: используйте generatehdl функция со свойством ReservedWordPostfix для изменения зарезервированного слова postfix.

Установка постфикса для файлов пакета VHDL

По умолчанию кодер добавляет постфикс _pkg к базовому имени файла при генерации файла пакета VHDL. Чтобы переименовать постфикс для файлов пакета, выполните следующие действия:

Альтернатива командной строки: используйте generatehdl функция со PackagePostfix свойство для переименования имени файла postfix для файлов пакета VHDL.

Задание префикса для коэффициентов фильтра

Кодер объявляет коэффициенты для фильтра как константы в rtl архитектура. Кодер выводит постоянные имена, добавляя префикс coeff. Имена коэффициентов зависят от типа фильтра.

Для примера:

ARCHITECTURE rtl OF filt IS
  -- Type Definitions
  TYPE delay_pipeline_type IS ARRAY(NATURAL range <>) OF signed(15 DOWNTO 0);-- sfix16_En15
  CONSTANT coeff1               : signed(15 DOWNTO 0) := to_signed(-30, 16); -- sfix16_En15
  CONSTANT coeff2               : signed(15 DOWNTO 0) := to_signed(-89, 16); -- sfix16_En15
  CONSTANT coeff3               : signed(15 DOWNTO 0) := to_signed(-81, 16); -- sfix16_En15
  CONSTANT coeff4               : signed(15 DOWNTO 0) := to_signed(120, 16); -- sfix16_En15

Как использовать префикс, отличный от coeff,

Альтернатива командной строки: используйте generatehdl функция со свойством CoeffPrefix для изменения базового имени коэффициентов фильтра.

Определение постфикса для меток технологических блоков

Кодер генерирует блоки процессов для изменения содержимого регистров. Метка для каждого из этих блоков определяется из имени регистра и постфикса _process. Для примера кодер выводит метку delay_pipeline_process в следующем блоке из имени регистра delay_pipeline и постфикс '_process'.

delay_pipeline_process : PROCESS (clk, reset)
BEGIN
  IF reset = '1' THEN
    delay_pipeline (0 To 50) <= (OTHERS => (OTHERS => '0'));
  ELSIF clk'event AND clk = '1' THEN
    IF clk_enable = '1' THEN
      delay_pipeline(0) <= signed(filter_in)
      delay_pipeline(1 TO 50) <= delay_pipeline(0 TO 49);
    END IF;
  END IF;
END PROCESS delay_pipeline_process;

Свойство Clocked process postfix позволяет вам изменить постфикс на значение, отличное от '_process'. Например, чтобы изменить постфикс на '_clkproc', выполните следующее:

Альтернатива командной строки: используйте generatehdl функция со свойством ClockProcessPostfix для изменения постфикса, добавленного к меткам обработки.

Настройка префикса для имен образцов компонентов

Instance prefix задает вектор символов, префиксируемый к именам образцов компонентов в сгенерированном коде. Значение по умолчанию является 'u_'.

Вы можете задать префикс на значение, отличное от 'u_'. Чтобы изменить префикс:

Альтернатива командной строки: используйте generatehdl функция со свойством InstancePrefix для изменения префикса образца.

Настройка префикса для имен векторов

Vector prefix задает вектор символов, который будет префиксирован к именам векторов в сгенерированном коде VHDL. Значение по умолчанию является 'vector_of_'.

Вы можете задать префикс на значение, отличное от 'vector_of_'. Чтобы изменить префикс:

Альтернатива командной строки: используйте generatehdl функция со свойством VectorPrefix для изменения префикса образца.