Adding Your Library to Library Browser - 2025.2 English - UG1483

Vitis Model Composer User Guide (UG1483)
Document ID
UG1483
Release Date
2025-11-20
Version
2025.2 English

To use imported blocks from your library, open the Simulink model, then copy the blocks into a new Model Composer model. You can also see your library listed in the Library Browser, and drag and drop blocks from the library into new models. To do this, after running the xmcImportFunction command you must prepare your library as follows:

  1. Enable the Library Browser parameter.
  2. Save the library.
  3. Create slblocks.m script for the library.
  4. Add path to MATLAB, or add library to MATLAB path.
  5. Refresh Library Browser.
Tip: Setting up the library using this process is only required for newly created libraries, rather than existing libraries which have already been setup.

To enable the library to be available in the Library Browser, you must turn on the EnableLBRepository parameter for the library. After importing a block into a new library using xmcImportFunction, with the library open, you must use the following command from the MATLAB command line prior to saving your library:

set_param(gcs,'EnableLBRepository','on');

This parameter identifies the library as belonging to the Library Browser. However, that is only the first step. Save the library by clicking File > Save from the main menu, or by clicking the button in the toolbar.

Libraries in the Library Browser also require the presence of a script in the same directory as the library model, called slblocks.m, that defines the metadata associated with the library. You can create this script by copying an existing script from another library, or copying it from the MATLAB installation, or by editing the following text and saving it as slblocks.m:
function blkStruct = slblocks 
  % This function adds the library to the Library Browser
  % and caches it in the browser repository

  % Specify the name of the library
  Browser.Library = 'newlib';
  % Specify a name to display in the library Browser  
  Browser.Name = 'New Library';

  blkStruct.Browser = Browser;
Notice the Browser.Library specifies the name of the library model minus the .slx file extension. Browser.Name specifies the display name that appears in Library Browser.
Note: Each library needs to be in a separate directory, with the <library>.slx file and the slblocks.m script for that library.
After creating the library and the slblocks.m script, you need to either add the library location to the MATLAB path so that MATLAB can find it, or copy the library to a folder that is already on the MATLAB path. You can type path at the MATLAB command prompt to see the current path that MATLAB uses. You can also add the library directory to the MATLAB path using the following commands:
addpath ('library_folder')
savepath

Where:

  • 'library_folder'
  • savepath is a string that saves the current search path to pathdef.m.
Tip: To remove a folder from the MATLAB path you can use the following command sequence:
rmpath ('library_folder')
savepath

To view the new library in the Library Browser, right-click on the left side of the window, then select Refresh Library Browser. This loads the library into the tool. You can now view the imported blocks and drag and drop them into your models.