Начало работы с генератором TLM

В этом примере показано, как сконфигурировать модель Simulink®, чтобы сгенерировать компонент SystemC™/TLM с помощью цели tlmgenerator или для Simulink Coder™ или для Embedded Coder®.

В данном примере мы используем модель Simulink КИХ-фильтра как базис генерации SystemC/TLM.

Требования, чтобы запустить этот пример:

  • SystemC 2.3.1 (включает библиотеку TLM),

  • Для верификации кода сделайте и совместимый компилятор GNU, gcc, в вашем пути на Linux® или Визуальном компиляторе Studio® в вашем пути на Windows®

Примечание: пример включает процедуру сборки генерации кода. Simulink не разрешает вам создавать программы в области установки MATLAB®. При необходимости превратитесь в рабочую директорию, которая не находится в области установки MATLAB до запуска никакой сборки.

1. Открытая предварительно сконфигурированная модель

Чтобы открыть модель FIR Filter, нажмите кнопку Open Model.

2. Поставьте цель Simulink Coder к генератору TLM

a. Откройте диалоговое окно Configuration Parameters путем выбора Simulation> Model Configuration Parameters в окне модели.

b. В диалоговом окне Configuration Parameters выберите представление Code Generation в левой панели.

c. Под Системным конечным файлом нажмите Browse, чтобы выбрать цель генератора TLM. Можно выбрать tlmgenerator_grt.tlc, чтобы использовать Simulink Coder или tlmgenerator_ert.tlc, чтобы использовать Embedded Coder для генерации HDL-кода. В данном примере выберите tlmgenerator_grt.tlc.

3. Откройте представление генератора TLM

В диалоговом окне Configuration Parameters выберите представление TLM Generator в левой панели.

Представление TLM Generator имеет пять вкладок:

  • Отображение TLM

  • Обработка TLM

  • Синхронизация TLM

  • Испытательный стенд TLM

  • Компиляция TLM

Необходимо будет установить различные опции генератора в каждой панели.

4. Выберите TLM Mapping Options

Во вкладке TLM Mapping Отображение Сокета позволяет вам выбирать количество сокетов для входных данных, выходных данных и управления. Выберите опцию, Три отдельных сокета TLM для входных данных, выходных данных и управления.

Опции Сокета TLM позволяют вам задавать три различных карты распределения памяти для своего сгенерированного компонента TLM.

В данном примере выберите следующее для сокетов входных и выходных данных:

  • Автоматически сгенерированная карта распределения памяти для сокетов входных и выходных данных

  • Отдельный адрес ввода и вывода возмещает для каждого сокета данных. Эта опция генерирует компонент TLM с одним регистром чтения на выход модели и одним регистром записи на вход модели с отдельными адресами. Каждый вход модели Simulink связан со своим соответствующим регистром записи, и каждый выход связан со своим соответствующим регистром чтения.

Другие возможности карты распределения памяти, которые можно рассмотреть:

  • Никакая карта распределения памяти: Эта опция генерирует компонент TLM только с одним чтением и одним регистром записи без любого адреса. Входные параметры модели Simulink связаны с регистром записи, и выходные параметры связаны с регистром чтения.

  • [Автоматически сгенерированная карта распределения памяти с] Одно смещения адреса ввода и вывода: Эта опция генерирует компонент TLM только с одним чтением и один регистр записи с одним адресом каждый. Входные параметры модели Simulink связаны с регистром записи, и выходные параметры связаны с регистром чтения.

Когда вы генерируете компонент с картой распределения памяти, можно добавить команду и регистр состояния, тест и установить регистр и регистры настраиваемого параметра.

В данном примере выберите следующее для Управления Сокет TLM:

  • Включайте команду и регистр состояния в карте распределения памяти. Команда и регистр состояния позволяют вам писать команду и читать состояние во время симуляции SystemC; например, буферизация руководства или буферное состояние.

  • Включайте регистры настраиваемого параметра в карту распределения памяти. Регистры настраиваемого параметра позволяют вам читать или писать значения настраиваемого параметра.

Несмотря на то, что не используемый в этом примере, тест и регистр набора могут использоваться в качестве взаимного исключения, когда несколько инициаторов получают доступ к компоненту во время симуляции SystemC.

5. Выберите TLM Processing Options

В панели Генерации TLM выберите вкладку TLM Processing. Обработка Алгоритма и опции обработки Интерфейса позволяют вам задавать различную буферизацию и обработку поведений для вашего сгенерированного компонента TLM.

Опции осуществления алгоритма:

  • Поток SystemC: алгоритм ступенчатой функции выполняется в его собственном независимом потоке SystemC.

  • Функция обратного вызова: алгоритм ступенчатой функции выполняется в функции обратного вызова, названной от интерфейса.

  • Периодический Поток SystemC: алгоритм ступенчатой функции выполняется в его собственное время периодический независимый поток SystemC.

Синхронизация ступенчатой функции определяется значением в ступенчатой функции Алгоритма, синхронизирующей (нс) поле. Синхронизация алгоритма считается с ожиданием () в потоке.

В данном примере выберите SystemC Thread и войдите 100 в поле для синхронизации ступенчатой функции Алгоритма.

Опции обработки интерфейса:

  • Создайте порт запроса на прерывание на сгенерированном компоненте TLM: Эта опция создает порт прерывания (введите сигнал, bool>), который инициирован каждый раз, когда набор входа был обработан.

В данном примере выберите или введите следующий выбор:

  • Выберите Create порт запроса на прерывание на сгенерированном компоненте TLM.

6. Выберите TLM Timing Options

Выберите вкладку TLM Timing. Раздел Interface Timing позволяет вам задавать синхронизацию интерфейса ввода-вывода компонента и обработку потока.

В данном примере задержки ввода и вывода считаются с ожиданием () в интерфейсе. Установите временную стоимость 5 нс для каждой из транзакций Синхронизации Интерфейса Входных данных, Синхронизации Взаимодействия через интерфейс Выходных данных и Синхронизации Интерфейса Управления.

7. Выберите TLM Testbench View

Выберите вкладку TLM Testbench. Цель Генератора TLM может сгенерировать автономный испытательный стенд SystemC/TLM вместе с компонентом TLM, чтобы проверить сгенерированный алгоритм в контексте пары инициатора/цели TLM. Представление TLM Testbench предоставляет возможности во время выполнения для того, когда код испытательного стенда сгенерирован и выполнен.

С опциями Испытательного стенда TLM вы можете:

  • Примите решение видеть многословные сообщения, отраженные к командному окну во время выполнения SystemC/TLM включая транзакцию TLM и сообщения синхронизации.

  • Укажите, что испытательный стенд должен выполниться с или не синхронизируя аннотации.

  • Укажите, управляет ли инициатор движущимися наборами данных ввода и вывода между регистрами и буферами или выполняет ли компонент перемещения автоматически.

В данном примере выберите испытательный стенд Generate С синхронизацией для режима синхронизации Времени выполнения, и Автоматический и для режима инициирования Входного буфера и для режима инициирования Буфера вывода.

После того, как генерация кода успешно произошла для и испытательного стенда компонента, кнопка Verify TLM Component становится активированной. Проверьте, что Компонент TLM выполняет следующее:

  • Сборки использование сгенерированного кода делают и сгенерированные make-файлы.

  • Запуски Simulink, чтобы получить входной стимул и ожидаемые результаты.

  • Преобразует данные Simulink в векторы TLM.

  • Запускает автономный исполняемый файл испытательного стенда SystemC/TLM.

  • Преобразует результаты TLM назад в данные Simulink.

  • Выполняет сравнение данных.

  • Генерирует Окно рисунка для любых сигналов, которые имели данные, неправильный выдерживает сравнение.

Компиляция сгенерированных файлов принимает, что присутствие делает и совместимый компилятор GNU, gcc, в вашем пути на Linux® или Визуальном компиляторе Studio® в вашем пути на Windows®.

8. Выберите TLM Compilation View

Выберите вкладку TLM Compilation. Эта панель предоставляет возможности управлять генерацией make-файлов, используемых, чтобы скомпилировать сгенерированный код.

Параметры компилятора:

SystemC и TLM включают опции пути к библиотеке, позволяют вам задавать, где make-файлы могут найти SystemC и установки TLM. Значения по умолчанию позволяют вам использовать переменные окружения так, чтобы обновления вашего SystemC или установки TLM не требовали обновления ваших моделей Simulink. Можно настроить среду до вызова MATLAB или использовать MATLAB setenv команда.

В данном примере это значения переменной окружения, которые были протестированы со стандартными установками OSCI, расположенными в / инструментах:

  • SYSTEMC_INC_PATH =/tools/systemc-2.3.0/include

  • SYSTEMC_LIB_PATH =/tools/systemc-2.3.0/lib-linux64

  • SYSTEMC_LIB_NAME=libsystemc.a (Linux) или systemc.lib (Windows)

  • TLM_INC_PATH =/tools/systemc-2.3.0/include

Набор инструментальных средств:

На Windows эта опция позволяет вам выбирать набор инструментальных средств компилятора, когда несколько присваивают версию Microsoft Visual Studio, установлены на той же машине. На Linux эта опция закрепляется на gcc.

Именование компонента:

Эта опция позволяет вам добавлять свой собственный тег в имя сгенерированного компонента. Сгенерированное имя компонента создается согласно следующим случаям:

  • Если пользовательский тег задан: modelname_usertag_tlm

  • Если пользовательское поле метки пусто: modelname_tlm

В данном примере введите введение для пользовательского тега.

9. Выберите Report

Выберите Report в левой панели. В данном примере выберите, автоматически создают отчет генерации кода и Открытый отчет. Эти опции генерируют отчет HTML во время генерации компонента. Отчет Генерации кода детализирует содержимое каждого сгенерированного файла.

10. Сохраните опции генератора TLM

Нажмите ОК, чтобы применить эти настройки и выйти из диалогового окна Configuration Parameters.

11. Создайте модель

В окне модели щелкните правой кнопкой по блоку DualFilter и выберите C/C ++ Code> Generate Code для этой Подсистемы в контекстном меню, чтобы запустить генерацию компонента TLM.

В качестве альтернативы можно выполнить следующую команду в окне команды MATLAB:

>> slbuild ('tlmgdemo_intro/DualFilter');

Во время выполнения вам предложат выбрать настраиваемые параметры. Выпадающий список каждого коэффициента позволяет вам выбирать класс памяти переменной. Опции Класса памяти:

  • Встроенный - встроенные параметры не являются настраиваемыми.

  • Переменные SimulinkGlobal - The SimulinkGlobal являются настраиваемыми.

ExportedGlobal, ImportedExtern и ImportedExternPointer не поддерживаются моделью TLM Generation.

Опция Глобальная переменная Simulink была выбрана для этого примера. Нажмите Build. Генерация TLM завершается, когда вы видите, что следующее сообщение появляется в окне команды MATLAB:

### Starting Simulink Coder build procedure for model: DualFilter
### Successful completion of Simulink Coder build procedure for model: DualFilter

Build Summary

Top model targets built:

Model       Action          Rebuild Reason                                    
==============================================================================
DualFilter  Code generated  Code generation information file does not exist.  

1 of 1 models built (0 models already up to date)
Build duration: 0h 0m 21.131s

12. Открытые сгенерированные файлы

Откройте сгенерированные файлы в веб-браузере MATLAB путем нажимания на ссылки в сгенерированном отчете или в редакторе MATLAB (сгенерированные файлы, и отчет расположены в текущей рабочей директории):

13. Проверьте сгенерированный код

a. Откройте диалоговое окно Model Configuration Parameters путем выбора Simulation> Configuration Parameters в окне модели.

b. В диалоговом окне Configuration Parameters выберите представление TLM Generator, и затем выберите вкладку TLM Testbench.

c. В панели Испытательного стенда TLM нажмите Verify TLM Component, чтобы запустить сгенерированный испытательный стенд.

В качестве альтернативы можно выполнить следующую команду в окне команды MATLAB:

  verifyTlmgDemoModel('intro')

Это проверяет, что шаг выполняет следующие действия:

  • Создает сгенерированный код.

  • Запуски Simulink, чтобы получить входной стимул и ожидаемые результаты.

  • Преобразует данные Simulink в векторы TLM.

  • Запускает автономный исполняемый файл испытательного стенда SystemC/TLM.

  • Преобразует результаты TLM назад в данные Simulink.

  • Выполняет сравнение данных.

  • Генерирует Окно рисунка для любых сигналов, которые имели данные, неправильный выдерживает сравнение.

14. Рассмотрите журнал выполнения

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

### Comparing expected vs. actual results.
Data successfully compared for signal tlmg_out1.
Data successfully compared for signal tlmg_out2.
### Component verification completed

Это завершает Начало работы с примером Генератора TLM.

Для просмотра документации необходимо авторизоваться на сайте