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

Обзор рабочего процесса

Чтобы сгенерировать библиотеку пользовательского блока из файлов компонента Simscape™, выполните эти шаги:

  1. Организуйте свои файлы Simscape. Файлы Simscape должны быть сохранены в директориях пакета. Иерархия пакета определяет получившуюся структуру библиотеки.

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

  3. Создайте библиотеку пользовательского блока. Можно использовать или регулярные исходные файлы Simscape или защищенные файлы Simscape, чтобы сделать это. Каждый пакет верхнего уровня генерирует отдельную пользовательскую библиотеку блоков Simscape.

Если вы генерируете пользовательскую библиотеку Simscape, можно открыть ее и перетащить индивидуально настраиваемые блоки из нее в модели.

Организация ваших файлов Simscape

Файлы Simscape должны быть сохранены в директориях пакета. Важные моменты:

  • Имя каталога пакета должно начаться с + символ.

  • Остальная часть имени каталога пакета (без + символ), должен быть допустимый идентификатор MATLAB®.

  • Родительский каталог директории пакета должен быть на пути MATLAB.

Каждый пакет, где вы храните свои файлы Simscape, генерирует отдельную библиотеку пользовательского блока.

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

Например, у вас может быть директория пакета верхнего уровня, названная +SimscapeCustomBlocks, и это имеет три подкаталога, Electrical, Hydraulic, и Mechanical, каждый содержащий файлы Simscape. Библиотека пользовательского блока, сгенерированная от этого пакета, будет названа SimscapeCustomBlocks_lib и будет иметь три соответствующих подбиблиотеки. Для получения информации о создании библиотек пользовательского блока смотрите Преобразование Ваших файлов Simscape.

Используя исходную защиту для файлов Simscape

Если необходимо защитить собственный исходный код при совместном использовании файлов Simscape используйте одну из следующих команд, чтобы сгенерировать защищенные файлы Simscape:

  • ssc_protect — Защищает отдельные файлы и директории. Если вы шифруете файлы, можно совместно использовать их, не раскрывая или доменный источник компонента. Используйте их, так же, как вы были бы исходные файлы Simscape, чтобы создать библиотеки пользовательского блока с ssc_build команда.

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

В отличие от исходных файлов Simscape, которые имеют дополнительный .ssc, Защищенные файлы Simscape имеют дополнительный .sscp и не по-человечески читаемы. Можно использовать их, так же, как исходные файлы Simscape, чтобы создать библиотеки пользовательского блока. Защищенные файлы должны быть организованы в директориях пакета, таким же образом как исходные файлы Simscape. Для получения информации об организации ваших файлов смотрите Организацию Ваших файлов Simscape. Для получения информации о создании библиотек пользовательского блока смотрите Преобразование Ваших файлов Simscape.

Преобразование ваших файлов Simscape

После того, как вы создали текстовые файлы компонента и организовали их в директориях пакета, необходимо преобразовать их в блоки Simscape, чтобы смочь использовать их в блок-схемах. Вы делаете это путем выполнения ssc_build команда на директории пакета верхнего уровня, содержащей ваши файлы Simscape. Пакет может содержать или регулярные исходные файлы Simscape или защищенные файлы Simscape.

Например, у вас может быть директория пакета верхнего уровня, где вы храните свои файлы Simscape, названные +SimscapeCustomBlocks. Чтобы сгенерировать библиотеку пользовательского блока, в командной строке MATLAB, введите:

ssc_build SimscapeCustomBlocks;

Примечание

Имя каталога пакета начинается с ведущего + символ, тогда как аргумент к ssc_build должен не использовать + символ.

Эта команда генерирует файл модели Simulink® под названием SimscapeCustomBlocks_lib в родительском каталоге пакета верхнего уровня (то есть, в той же директории, которая содержит ваш +SimscapeCustomBlocks пакет). Поскольку эта директория находится на пути MATLAB, можно открыть библиотеку путем введения ее имени в командной строке MATLAB. В нашем примере введите:

SimscapeCustomBlocks_lib 

Файл модели, сгенерированный путем выполнения ssc_build команда является пользовательской библиотекой Simscape, содержащей все подбиблиотеки и блоки, сгенерированные от файлов Simscape, расположенных в пакете верхнего уровня. Если вы открываете пользовательскую библиотеку Simscape, можно перетащить индивидуально настраиваемые блоки из нее в модели.

Создание подбиблиотек

Директории пакета могут быть организованы в подкаталоги с именами, также начинающимися с + символ. После того, как вы запускаете ssc_build команда, каждый такой подкаталог появится как подбиблиотека под пользовательской библиотекой верхнего уровня. Можно настроить имя и внешний вид подбиблиотек при помощи конфигурационных файлов библиотеки.

Примечание

Когда вы добавляете или изменяете файлы компонента в подкаталогах пакета, вы все еще запускаете ssc_build команда на директории пакета верхнего уровня. Это обновляет все подбиблиотеки.

У вас могут быть больше чем одна директория пакета верхнего уровня, то есть, больше чем одна директория пакета, расположенная в директории на пути MATLAB. Каждая директория пакета верхнего уровня генерирует отдельную пользовательскую библиотеку верхнего уровня.

Связанные примеры

Больше о