Пользовательский код контроллера теплового насоса

Полный код контроллера теплового насоса находится в следующих файлах источника и заголовка кода C:

Исходные файлы находятся в src каталог:

Файлы заголовков находятся в include каталог:

tempController.c содержит алгоритм для пользовательского кода C для блока теплового насоса. heatpumpController функция в этом файле использует комнатную температуру (Troom_inи заданную температуру (Tset) в качестве входных данных. Выходной сигнал: pump_control_bus типовая конструкция с сигналами, которые управляют вентилятором, тепловым насосом и направлением теплового насоса (тепловым или холодным). Поля в pump_control_bus структура являются fan_cmd, pump_cmd, и pump_dir. pump_control_bus тип структуры определен в controllerTypes.h файл. Выходные данные heatpumpController функция:

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

heatpumpController функция использует две служебные функции, absoluteTempDifference и pumpDirection, которые определены в utils.c файл. absoluteTempDifference функция возвращает абсолютную разницу между Tset и Troom_in как двойник. pumpDirection функция возвращает одно из следующих значений: PumpDirection значения перечисления типов:

PumpDirection enum type определяется в controllerTypes.h файл.

Открыть мастер импорта кода

Чтобы открыть мастер импорта кода Simulink Test C/C + +, сначала откройте диспетчер Simulink Test Manager.

sltest.testmanager.view

Затем выберите New > Test for C/C + + code.

Укажите библиотеку Simulink и метод тестирования

Откроется мастер и откроется вкладка Приветствие. Нажмите кнопку Пуск, чтобы начать процесс импорта.

На вкладке «Параметры»:

Метод C Code Unit Testing проверяет один файл C или подмножество пользовательского кода в изоляции. Этот метод создает тестовую изолированную среду из указанного исходного файла или файлов и импортирует тестовую изолированную среду в Simulink. Поскольку тестовая изолированная среда содержит только подмножество файлов C, мастер импорта кода автоматически создает заглушки для всех неопределенных символов, используемых в файлах C. Этот метод поддерживает только тестирование кода C. Для получения информации об интеграционном тестировании см. TestType имущество sltest.CodeImporter.

Нажмите кнопку Далее.

Укажите пользовательский код для импорта

На вкладке «Указать пользовательский код»:

Нажмите кнопку Далее.

Укажите параметры тестовой изолированной программной среды

На вкладке «Анализ» задайте параметры изолированной программной среды.

Выберите выходной тестовый режим изолированной программной среды

Каждый из трех тестовых режимов «песочницы» имеет параметры, определяющие, как мастер импорта кода создает «песочницу» и артефакты «песочницы».

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

Выберите выходные параметры тестовой изолированной среды

Выберите Только копировать исходные файлы. Для этого параметра мастер импорта кода копирует указанный исходный файл в изолированную программную среду src каталог.

Для получения информации о других выходных тестовых режимах и настройках изолированной программной среды см. свойства sltest.CodeImporter.SandboxSettings.

Нажмите кнопку Далее, чтобы создать тестовую изолированную среду с заданными параметрами.

Создание тестовой изолированной программной среды

Указанное имя файла библиотеки определяет имя созданной изолированной программной среды. В этом примере имя песочницы: heatpumpController_sandbox.

В этом примере используется tempController.c и выполняет модульное тестирование только на heatpumpController функция. Создание изолированной программной среды автоматически создает заглушки для absoluteTempDifference и pumpDirection служебные функции, используемые heatpumpController функция, поскольку функции утилиты не определены в tempController.c , заглушки предотвращают ошибку кода.

При создании изолированной программной среды отображается экран подтверждения.

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

ПРИМЕЧАНИЕ: Не изменяйте файлы в src, include, или autosub папки созданной песочницы.

После создания изолированной программной среды можно просмотреть созданные файлы:

Нажмите кнопку Далее.

Задать параметры импорта

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

Когда мастер обнаруживает глобальные переменные в изолированной программной среде или пользовательском коде, можно использовать эти переменные в качестве входных или выходных данных для функции и портов в созданном блоке C Caller. Дополнительные сведения см. в разделе Включение глобальных переменных в качестве функциональных интерфейсов.

Выберите параметр Включить глобальные переменные как интерфейс функции.

Нажмите кнопку Далее.

Выбор функций для импорта

На странице Импорт выберите heatpumpController для импорта в библиотеку Simulink.

Нажмите кнопку Далее.

Установка параметров порта блока

Для функции, выбранной на предыдущей странице, мастер создает спецификацию порта функции. Выбранные порты используются для сгенерированного блока C Caller.

В этом примере в таблице спецификации порта перечислены формальные аргументы: Tset, Troom_in, и out, для heatpumpController и еще шесть из автоматически созданных заглушек. Поскольку в качестве интерфейса функции выбран параметр «Включить глобальные переменные», мастер создает порты, создаваемые из заглушек для absoluteTempDifference и pumpDirection функции. Заглушки находятся в auto_stub.c.

Это автоматически сгенерированные глобальные переменные в auto_stub.c файл:

/*************************************************************************/
/* Generated Global Variables for Stubbed Functions Interface            */
/*************************************************************************/
double SLStubIn_absoluteTempDifference_p1;
double SLStubIn_absoluteTempDifference_p2;
double SLStubOut_absoluteTempDifference;
double SLStubIn_pumpDirection_p1;
double SLStubIn_pumpDirection_p2;
PumpDirection SLStubOut_pumpDirection;

double absoluteTempDifference(double absoluteTempDifference_p1, double absoluteTempDifference_p2)
{
  SLStubIn_absoluteTempDifference_p1 = absoluteTempDifference_p1;
  SLStubIn_absoluteTempDifference_p2 = absoluteTempDifference_p2;
  return SLStubOut_absoluteTempDifference;
}


PumpDirection pumpDirection(double pumpDirection_p1, double pumpDirection_p2)
{
  SLStubIn_pumpDirection_p1 = pumpDirection_p1;
  SLStubIn_pumpDirection_p2 = pumpDirection_p2;
  return SLStubOut_pumpDirection;
}

В автоматически созданных заглушках для absoluteTempDifference, глобальные переменные SLStubIn_absoluteTempDifference_p1 и SLStubIn_absoluteTempDifference_p2 сохраните входные аргументы. Функция возвращает значение, сохраненное в SLStubOut_absoluteTempDifference в качестве выхода. Аналогично, pumpDirection сохраняет входные аргументы и возвращает SLStubOut_pumpDirection.

В этом примере: absoluteTempDifference, SLStubIn_absoluteTempDifference_p1 и SLStubIn_absoluteTempDifference_p2 являются выходами. Глобальная переменная SLStubOut_absoluteTempDifference является входом.

Не вносите никаких изменений в спецификацию порта. Нажмите кнопку Далее.

Укажите типы для импорта

Выберите типы для импорта в Simulink. Потому что pump_control_bus и PumpDirection типы требуются для функции heatpumpController, они выбираются и затемняются. Мастер создает словарь данных Simulink, содержащий эти типы, и связывает словарь с созданной библиотекой.

Нажмите кнопку Далее (Next), чтобы отобразить сводку созданной библиотеки. Для продолжения нажмите кнопку Далее еще раз.

Создание тестового кабеля

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

Нажмите кнопку «Далее», чтобы создать библиотеку Simulink.

После импорта кода мастер создает библиотеку, присоединенную к словарю данных Simulink, который определяет pump_control_bus и PumpDirection в качестве Simulink.Bus объект и сигнал перечисления Simulink соответственно.

Блок C Caller, созданный в библиотеке Simulink:

Щелкните в правом нижнем углу блока, чтобы открыть его внутренний тестовый жгут:

На странице Успешный импорт кода (Code Import Successful) щелкните Изменить папку MATLAB на папку вывода.

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

Обновление тестовой изолированной программной среды с помощью ручного упора

Чтобы вручную создать файлы-заглушки для absoluteTempDifference и pumpDirection, перейдите на вкладку «Анализ» на панели инструментов мастера и дважды нажмите кнопку «Далее» для отображения этой страницы:

Импортер кода обнаруживает созданную песочницу. Выберите Перезаписать, а затем нажмите кнопку Далее.

Вне мастера, но оставляя его открытым, скопируйте файлы в updated_manualstub папки песочницы и вставьте их в heatpumpController/manualstub каталог.

В man_stub.c файл, отредактировать определение функции absoluteTempDifference:

double absoluteTempDifference(double Tset, double Troom_in){ 
    return (double)fabs(Tset - Troom_in);
}

и определение функции pumpDirection:

PumpDirection pumpDirection(double Tset, double Troom_in){
    return Tset > Troom_in ? HEATING : COOLING;
}

Вернитесь к мастеру импорта кода.

После изменения файлов заглушек вручную вернитесь к мастеру и щелкните Обновить изолированную среду.

Поскольку определения для absoluteTempDifference и pumpDirection функции, нет символов для автоматической заглушки, не создаются артефакты для autostub в изолированной программной среде и она пуста.

Нажмите кнопку Далее, пока не перейдете на страницу спецификации порта блока:

Потому что ручное внедрение absoluteTempDifference и pumpDirection не имеет глобальных переменных, только формальные аргументы и возвращаемый аргумент отображаются как порты.

Нажмите кнопку Далее.

На вкладке «Создание библиотеки Simulink» выберите «Перезаписать».

Нажмите кнопку Далее на остальных страницах, пока не откроется страница Успешный импорт кода.

Затем нажмите кнопку Готово. При необходимости нажмите кнопку Да (Yes) в открывшемся диалоговом окне для сохранения текущих параметров импорта в виде файла JSON, который используется для перезагрузки параметров в другой сеанс мастера импорта кода.

Проверка импортированного кода

В диспетчере тестов на панели «Обозреватель тестов» разверните тестовый файл heatpumpController и набор тестов heatpumpController/heatpumpController. Затем выберите heatpumpController_Harness1 тестовый случай.

Укажите время остановки SImulation

В разделе «Тестируемая система» разверните раздел «Настройка моделирования и переопределения выпуска» и установите для параметра «Время остановки» значение 200.

Добавить входные данные

В разделе Входы (Inputs) в нижней части таблицы Внешние входы (External Inputs) нажмите кнопку Добавить (Add), чтобы открыть диалоговое окно Добавить ввод (Add Input).

В поле «Спецификация входного файла» введите heatpumpControllerHarnessInput.xlsx.

В разделе «Сопоставление входных данных» выберите Block Name в качестве режима сопоставления и щелкните Сопоставить входы (Map Inputs). После того как входные данные появятся в таблице Статус сопоставления (Mapping Status), нажмите кнопку ОК.

Добавить оценки

В разделе Логические и временные оценки добавьте оценки для каждого температурного условия:

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

На панели «Символы» добавьте определения символов:

Запуск теста и просмотр результатов

Нажмите кнопку Run (Выполнить), чтобы запустить тест.

По завершении теста на панели «Результаты и артефакты» разверните окно «Результаты». Все оценки проходят.

Чтобы просмотреть результаты покрытия, выберите heatpumpController_Harness1 в разделе Результаты и разверните раздел Результаты покрытия. Покрытие составляет 100% для обоих tempController.c и man_stub.c файлы.