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

Необходимые условия

Чтобы завершить этот пример, необходимо установить следующие продукты:

Создайте новую папку и скопируйте соответствующие файлы

 Функция ex_2ndOrder_filter

function y = ex_2ndOrder_filter(x) %#codegen
  persistent z
  if isempty(z)
      z = zeros(2,1);
  end
  % [b,a] = butter(2, 0.25)
  b = [0.0976310729378175,  0.195262145875635,  0.0976310729378175];
  a = [1, -0.942809041582063,  0.3333333333333333];

 
  y = zeros(size(x));
  for i = 1:length(x)
      y(i) = b(1)*x(i) + z(1);
      z(1) = b(2)*x(i) + z(2) - a(2) * y(i);
      z(2) = b(3)*x(i)        - a(3) * y(i);
  end
end

 Скрипт ex_2ndOrder_filter_test

% ex_2ndOrder_filter_test
%
% Define representative inputs
N = 256;                   % Number of points
t = linspace(0,1,N);       % Time vector from 0 to 1 second
f1 = N/2;                  % Target frequency of chirp set to Nyquist
x_chirp = sin(pi*f1*t.^2); % Linear chirp from 0 to Fs/2 Hz in 1 second
x_step = ones(1,N);        % Step
x_impulse = zeros(1,N);    % Impulse
x_impulse(1) = 1;

% Run the function under test
x = [x_chirp;x_step;x_impulse];
y = zeros(size(x));
for i = 1:size(x,1)
  y(i,:) = ex_2ndOrder_filter(x(i,:));
end

% Plot the results
titles = {'Chirp','Step','Impulse'}
clf
for i = 1:size(x,1)
  subplot(size(x,1),1,i)
  plot(t,x(i,:),t,y(i,:))
  title(titles{i})
  legend('Input','Output')
end
xlabel('Time (s)')
figure(gcf)

disp('Test complete.')

Настройка объекта строения с фиксированной точкой

Создайте объект строения с фиксированной точкой и сконфигурируйте имя тестового файла.

fixptcfg = coder.config('fixpt');
fixptcfg.TestBenchName = 'ex_2ndOrder_filter_test';

Настройка объекта Генерации кода C Строения

Создайте объект строения кода для генерации статической библиотеки на C. Включите отчет генерации кода.

cfg = coder.config('lib');
cfg.GenerateReport = true;

Сбор областей значений симуляции и генерация кода с фиксированной точкой

Используйте codegen функция для преобразования функции MATLAB с плавающей точкой, ex_2ndOrder_filter, в код С с фиксированной точкой. Установите размер слова по умолчанию для типов данных с фиксированной точкой равной 16.

fixptcfg.ComputeSimulationRanges = true;
fixptcfg.DefaultWordLength = 16;

% Derive ranges  and generate fixed-point code
codegen -float2fixed fixptcfg -config cfg ex_2ndOrder_filter

codegen анализирует код с плавающей точкой. Поскольку вы не указали типы входа для ex_2ndOrder_filter функция, процесс преобразования выводит типы путем симуляции тестового файла. Затем процесс преобразования выводит области значений для переменных в алгоритме. Он использует эти производные области значений, чтобы предложить фиксированные точки для этих переменных. После завершения преобразования создается отчет по предложению типа.

Просмотр информации о области значений

Щелкните ссылку на отчет о предложении типа для ex_2ndOrder_filter функция, ex_2ndOrder_filter_report.html.

Отчет откроется в веб-браузере.

Просмотрите сгенерированный код MATLAB с фиксированной точкой

codegen генерирует версию ex_2ndOrder_filter.m с фиксированной точкой функция, ex_2ndOrder_filter_fixpt.mи функцию обертки, которая вызывает ex_2ndOrder_filter_fixpt. Эти файлы сгенерированы в codegen\ex_2ndOrder_filter\fixpt папка в локальной рабочей папке.

function y = ex_2ndOrder_filter_fixpt(x) %#codegen
  fm = get_fimath();

  persistent z
  if isempty(z)
      z = fi(zeros(2,1), 1, 16, 15, fm);
  end
  % [b,a] = butter(2, 0.25)
  b = fi([0.0976310729378175,  0.195262145875635,  0.0976310729378175], 0, 16, 18, fm);
  a = fi([                 1, -0.942809041582063,  0.3333333333333333], 1, 16, 14, fm);

 
  y = fi(zeros(size(x)), 1, 16, 14, fm);
  for i=1:length(x)
      y(i) = b(1)*x(i) + z(1);
      z(1) = fi_signed(b(2)*x(i) + z(2)) - a(2) * y(i);
      z(2) = fi_signed(b(3)*x(i))        - a(3) * y(i);
  end
end



function y = fi_signed(a)
    coder.inline( 'always' );
    if isfi( a ) && ~(issigned( a ))
        nt = numerictype( a );
        new_nt = numerictype( 1, nt.WordLength + 1, nt.FractionLength );
        y = fi( a, new_nt, fimath( a ) );
    else
        y = a;
    end
end

function fm = get_fimath()
	fm = fimath('RoundingMethod', 'Floor', 'OverflowAction', 'Wrap', 'ProductMode', 'FullPrecision', 'MaxProductWordLength', 128, 'SumMode', 'FullPrecision', 'MaxSumWordLength', 128);
end

Просмотрите сгенерированный код с фиксированной точкой C

Чтобы просмотреть отчет генерации кода для генерации кода C, щелкните ссылку View Report, которая следует за отчетом предложения типа.

Откроется отчет генерации кода, в котором отображается сгенерированный код для ex_2ndOrder_filter_fixpt.c.