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

Генерация заголовочного файла CPP_REQ_DEFINES

В make-файлах шаблона маркерный CPP_REQ_DEFINES расширен и заменен списком установок параметров, вводимых с различными диалоговыми окнами. Эта переменная часто содержит информацию, такую как MODEL (имя генерации модели), NUMST (количество шагов расчета в модели), MT (модель является многозадачностью или не), и многочисленные другие параметры (см. Make-файлы Шаблона и Лексемы).

Механизм make-файла обрабатывает лексему CPP_REQ_DEFINES автоматически. Если ваша цель требует использования файла проекта, а не традиционного подхода make-файла, можно сгенерировать заголовочный файл, содержащий директивы, чтобы задать эти переменные и обеспечить их значения.

Следующий файл TLC, gen_rtw_req_defines_h.tlc, обеспечивает пример. Код генерирует заголовочный файл C, cpp_req_defines.h. Информация, запрошенная, чтобы сгенерировать каждую директиву #define, выведена, любой от информации в файле model.rtw (например, CompiledModel.NumSynchronousSampleTimes), или от делает переменные из структуры rtwoptions (например, PurelyIntegerCode).

%% File: gen_rtw_req_defines_h.tlc
%openfile CPP_DEFINES = "cpp_req_defines.h"
#ifndef _CPP_REQ_DEFINES_
#define _CPP_REQ_DEFINES_
#define MODEL %<CompiledModel.Name>
#define ERT  1
#define NUMST %<CompiledModel.NumSynchronousSampleTimes>
#define TID01EQ %<CompiledModel.FixedStepOpts.TID01EQ>
%%
%if CompiledModel.FixedStepOpts.SolverMode == "MultiTasking"
#define MT  1
#define MULTITASKING  1
%else
#define MT  0
#define MULTITASKING  0
%endif
%%
#define MAT_FILE  0
#define INTEGER_CODE %<PurelyIntegerCode>
#define ONESTEPFCN %<CombineOutputUpdateFcns>
#define TERMFCN %<IncludeMdlTerminateFcn>
%%
#define MULTI_INSTANCE_CODE  0
#define HAVESTDIO  0
#endif
%closefile CPP_DEFINES

Взаимодействие через интерфейс к IDE Freescale CodeWarrior

Взаимодействие через интерфейс с процессом сборки целевого процессора к CodeWarrior IDE требует, чтобы с двумя проблемами имели дело:

Импорт Проекта XML.  Этот раздел иллюстрирует, как использовать Компилятор выходного языка (TLC), чтобы сгенерировать расширяемый язык разметки (XML) файл, подходящий для импорта в CodeWarrior IDE, который содержит информацию об исходном коде, сгенерированном целевым процессором.

Выбор формата XML диктует то, что CodeWarrior IDE поддерживает экспорт проекта и импорт с XML-файлами. С этой записи нативные файлы проекта CodeWarrior находятся в собственном двоичном формате.

Обратите внимание на то, что, если ваша цель должна поддержать формат файла проекта некоторого другого компилятора, можно применить методы, показанные здесь другим форматам ASCII-файла (см. Генерацию Заголовочного файла CPP_REQ_DEFINES).

Чтобы проиллюстрировать фундаментальное понятие, считайте гипотетический XML-файл экспортируемым из проекта канцелярской бумаги CodeWarrior. Следующее является частичным листингом:

<target>
   <settings>
    ...
   <\settings>
   <file><name>foo.c<\name>
   <\file>
   ...
   <file><name>foobar.c<\name>
   <\file>
   <fileref><name>foo.c<\name>
   <\fileref>
   ...
   <fileref><name>foobar.c<\name>
   <\fileref>
<\target>

Вставьте этот код XML в блок %openfile/%closefile в файле TLC, test.tlc, как показано ниже.

%% test.tlc
%% This code will generate a file model_project.xml,
%% where model is the generating model name specified in
%% the CompiledModel.Name field of the model.rtw file.
%openfile XMLFileContents = %<CompiledModel.Name>_project.xml
<target>
   <settings>
    ...
   <\settings>
   <file><name>%<CompiledModel.Name>.c<\name>
   <\file>
   ...
   <file><name>foobar.c<\name>
   <\file>
   <fileref><name>%<CompiledModel.Name>.c<\name>
   <\fileref>
   ...
   <fileref><name>foobar.c<\name>
   <\fileref>
<\target>
%closefile XMLFileContents
%selectfile NULL_FILE

Отметьте использование маркерного CompiledModel.Name TLC. Лексема разрешена, и получившееся имя файла включено в поток вывода. Можно указать другую информацию, такую как пути и библиотеки, в потоке вывода путем определения других лексем, заданных в model.rtw. Например, System.Name может быть задан как <Root>/Subsystem1.

Теперь предположите, что test.tlc вызывается во время процесса сборки цели, где генерирующейся моделью является mymodel. Это должно быть сделано после оператора codegenentry. Например, test.tlc мог быть включен непосредственно в системном конечном файле:

%include "codegenentry.tlc"
%include "test.tlc"

Также директива %include "test.tlc" могла быть вставлена в файл рычага mytarget_genfiles.tlc, если существующий.

Лексемы TLC такой как

<file><name>%<CompiledModel.Name>.c<\name>

расширены, с записью CompiledModel в файле mymodel.rtw, как в

<file><name>mymodel.c<\name>

test.tlc генерирует XML-файл, файл model_project.xml, из модели. model_project.xml содержит ссылки на файлы сгенерированного кода. model_project.xml может быть импортирован в CodeWarrior IDE как проект.

Следующая блок-схема обобщает этот процесс.

in_qualifiedMCP = 'd:\work\myproject.mcp';

%======================================================================
% Function: CreateCWComObject
% Abstract: Creates the COM connection to CodeWarrior
%
function ICodeWarriorApp = CreateCWComObject
  vprint([mfilename ': creating CW com object']);
  try
    ICodeWarriorApp = actxserver('CodeWarrior.CodeWarriorApp');
  catch
    error(['Error creating COM connection to ' ComObj ...
       '. Verify that CodeWarrior is installed. Verify COM access to
CodeWarrior outside of MATLAB.']);
  end
  return;


%======================================================================
% Function: OpenCW
% Abstract: Opens CodeWarrior. Returns the
%           handle ICodeWarriorApp.
%
function ICodeWarriorApp = OpenCW()
  ICodeWarriorApp = CreateCWComObject;
  CloseAll;
  OpenMCP(in_qualifiedMCP);


%=====================================================================
% Function: OpenMCP
% Abstract: open an MCP project file
%
function OpenMCP(in_qualifiedMCP)
  % Argument checking. This method requires valid project file.
  if ~exist(in_qualifiedMCP)
      error([mfilename ': Missing or empty project file argument']);
  end
  if isempty(in_qualifiedMCP)
      error([mfilename ': Missing or empty project file argument']);
  end
  ICodeWarriorApp = CreateCWComObject;
  vprint([mfilename ': Importing']);
  try
    ICodeWarriorProject = ...
      invoke(ICodeWarriorApp.Application,...
      'OpenProject', in_qualifiedMCP,...
      1,0,0);
  catch
    error(['Error using COM connection to import project. ' ...
       ' Verify that CodeWarrior is installed. Verify COM access to
CodeWarrior outside of MATLAB.']);
  end


%=====================================================================
% Function: BuildCW
% Abstract: Opens CodeWarrior.
%           Opens the specified CodeWarrior project.
%           Deletes objects.
%           Builds.
%
function ICodeWarriorApp = BuildCW(in_qualifiedMCP)
    % ICodeWarriorApp = BuildCW;
    ICodeWarriorApp = CreateCWComObject;
    CloseAll;
    OpenMCP(in_qualifiedMCP);
    try
      invoke(ICodeWarriorApp.DefaultProject,'RemoveObjectCode', 0, 1);
    catch
      error(['Error using COM connection to remove objects of current project. ' ...
       'Verify that CodeWarrior is installed. Verify COM access to
CodeWarrior outside of MATLAB.']);
    end
    try
      invoke(ICodeWarriorApp.DefaultProject,'BuildAndWaitToComplete');
    catch
      error(['Error using COM connection to build current project. ' ...
       'Verify that CodeWarrior is installed. Verify COM access to
CodeWarrior outside of MATLAB.']);
    end