Working with Schematic Libraries in Altium NEXUS

Parent page: Working with File-based Component Libraries

The real-world component that gets mounted on the board is represented as a schematic symbol during design capture, and as a PCB footprint for board design. Altium NEXUS components can be:

• Created in and placed from local libraries or
• Placed directly from a connected Workspace, accessible for the entire design team.

Symbols can be copied from the schematic editor into a schematic library, copied between schematic libraries, or created from scratch using the Schematic Symbol Generation Tool or drawing tools.

Creating a New Schematic Library

To create a new schematic library, select the File » New » Library command from the main menus and select the Schematic Library option from the File region of the New Library dialog.

After clicking Create, a new schematic library document named Schlib1.SchLib is created and shown in the Projects panel, and an empty component sheet called Component_1 displays.

The content of the library is shown in the SCH Library panel.

You are now ready to add, remove, or edit the schematic components in the new schematic library using the schematic symbol editor commands.

Creating a New Schematic Component

Any number of component symbols can be created in a schematic library. To create a new schematic component in an existing library, you would normally select Tools » New Component.

Since a new library always contains one empty component, you can also rename Component_1 to get started on creating a component. To do this, select Component_1 from the Design Item ID list in the SCH Library panel then click the Edit button in the panel or double-click Component_1 to open the Properties panel in Component mode. Type the new component name that uniquely identifies it in the Design Item ID field then press Enter.

Adding Models to the Schematic Component

You can add any number of PCB footprint models to a schematic component, as well as model files that are used for circuit simulation and signal integrity analysis. If a component has multiple models (for example, multiple footprints), you can select the appropriate model in the Properties panel when you place the component on a schematic. In terms of sourcing the models, you can create your own or download a vendor's model file from the web. PCB libraries can include any number of PCB footprints.

Wherever possible, Spice models used for circuit simulation (.ckt and .mdl files) are included in the supplied integrated libraries in the Library folder of your Altium NEXUS installation. If you are creating a new component, you would typically source the Spice model from the device vendor's website. You can also use the XSpice Model Wizard (Tools » XSpice Model Wizard) to create certain Spice model types to add to the component.

The schematic symbol editor's Model Manager dialog (Tools » Model Manager) enables you to view and organize your component models. For example, you can add the same model to multiple, selected components. Alternatively, you can add models to the current component from the Model region of the design space (click the upside-down arrows/caret symbol on the bottom-right of the design space as shown in the following image).

Click the highlighted caret symbol to access the Model region of the design space.

You can also add models to the current component by using the Add drop-down in the Parameters region of the Properties panel in Component mode then selecting the model.

At the schematic stage, the design is a collection of components that have been connected logically. To test or implement the design, for example, circuit simulation, PCB layout, signal integrity analysis, etc., it needs to be transferred to another design domain. To achieve this, there must be a suitable model of each component for the target domain.

• Footprints are linked to the schematic component by adding them in the Parameters region of the Properties panel. Click the Add drop-down then select Footprint to open the PCB Model dialog to configure the footprint.

  

  Click the Browse button to open the Browse Libraries dialog to browse available footprint libraries. If the desired footprint is not available in any of the current libraries, you will need to search for it using the Find button to open the File-based Libraries Search dialog.

• Models are linked to the schematic component by adding them in the Parameters region of the Properties panel. Click the Add drop-down then select Simulation or Ibis Model to open the respective dialog.

As part of the process of linking the model, information about the component must be mapped from the schematic to the target model.

Mapping the Model to the Symbol

The domain-specific information resides in model files that have a predefined format, such as IBIS, MDL and CKT files. There is other information needed for the system to access that domain-specific information, such as the pin-mapping and net listing between the schematic symbol and the domain-specific model. This information is defined in a domain-specific model editor, which opens when a model is added or edited. As well as referencing the model file, it will also include any pin mapping or netlisting information required for that model kind.

To configure pin mapping for a linked footprint, open the PCB Model dialog (select the footprint in the Parameters region of the Properties panel then click  or double-click the model in the Model region) then click Pin Map to open the Model Map dialog and make any necessary edits for the Pin-Pad pairs.

Where the Footprints are Found

At the top of the PCB Model dialog, there is a Name field that must contain the name of the footprint. You can enter the name directly or use the Browse button to find it. At the bottom of the dialog, there is a text string that shows where that model was found.

When the named model is found, the model appears and information is displayed about where it has been found.

The software's ability to find the model is influenced by the setting that defines where it can look for models. This is the setting just below the model name. The options range from Any, meaning search all available libraries for this model, to Integrated Library or Server, which indicates that the model can only be used from the specified integrated library or Workspace.

The PCB Model dialog include these options:

Library Option	Behavior	Dialog Setting
Any	Searches all available libraries for a matching model.
Library name	Only searches available libraries of this name for a matching model.
Library path	Only searches a library of this name, in this location, for a matching model.
Integrated library	Only searches for the model in the integrated library that the component was placed from. The integrated library must be available.
Server	Only searches for the model in the Workspace from which this component was placed. The software must be connected to that Workspace.

Search Locations for Model Files

When you add a model to a component in the schematic symbol editor, the model is linked; the model data is not copied or stored in the schematic component. This means the linked models must be available both during library creation and when the component is placed on a schematic sheet. When you are working in the library editor, the link from the component to the model information is resolved using the following valid search locations:

• Libraries that are included in the current library package project are searched first.
• PCB libraries (not integrated libraries) that are available in the currently Installed Libraries list are searched next. Note: The list of libraries can be ordered.
• Finally, any model libraries that are located on the project search paths are searched. Search paths are defined on the Search Paths tab of the Project Options dialog (Project » Project Options). Note: Libraries that are on the search path cannot be browsed to locate a model, however, the compiler does include them when searching for a model.

Refer to the Managing Available Database and File-based Libraries section of the Searching for Components in File-based & Database Libraries page for more information about the way models are searched for in the schematic symbol editor and the schematic editor.

Using Parameters to Add Detail to the Component

Component parameters are a means of defining additional information about the component. Parameters allow you to define additional textual information about the component. This can include electrical specifications (i.e. wattage or tolerance), purchasing or stock details, designer notes, references to component datasheets - basically any purpose you choose: data your company needs in the BOM, manufacturer's data, a reference to the component datasheet, or design instruction information, such as design rules or assignment to a PCB class, etc.

Parameters can be defined in the schematic library editor during component creation using the Properties panel.

Adding Parameters to a Component

For an individual component, parameters are added in the Parameters region of the Properties panel in Component mode. As mentioned, this can be done in the library or once the component has been placed on the schematic sheet.

Use the following steps to add a parameter to a schematic component:

1. Double-click on the component name in the SCH Library panel to open the Properties panel in Component mode.
2. In the Parameters region, select Parameter from the Add drop-down.
3. Enter the desired name of the parameter and a value.
4. Ensure the Parameter's visibility option is set to enabled () if you want the name and value to display when the component is placed on a schematic sheet.

5. Click the Font Link and Other at the bottom of the Parameters region to access additional options to configure parameters.

   

Adding Parameters to Multiple Components

Parameters are a key element of each component, and it is common for many of the parameters to be used across multiple components. As well as adding them individually to each component, you can also use the Parameter Manager command (Tools » Parameter Manager) to add them to multiple components. As well as adding and removing parameters, the values of parameters can also be edited across multiple components.

The Parameter Table Editor dialog can be used to edit all of the parameters across all of the components.

Notes about editing multiple parameters:

• Parameters can be edited across the components in a library or across components used in a schematic design using the same process. Select Tools » Parameter Manager in either the schematic or schematic library editor to start the process.
• Because parameters can be added to a variety of different objects, the first step is to select in which object types the parameters are to be edited in the Parameter Editor Options dialog.
• Parameter editing is performed in the Parameter Table Editor dialog. The dialog can be accessed in different ways, so the dialog caption can change. The way you work in the dialog is the same regardless of how it was accessed: use the standard Windows selection keystrokes to select the cells of interest then right-click and choose an edit action.
• Changes are not performed immediately; they are done via an Engineering Change Order (ECO).
• Each cell that is being changed is marked by a small colored icon. Refer to the Parameter Table Editor dialog page for a description of each icon.

Mapping a Parameter into the Component's Comment Field

The default component parameters that are displayed on the schematic are the Designator and Comment. When the design is transferred from the schematic editor to the PCB editor, the Designator and Comment strings are also the default strings that can easily be displayed on the board.

To allow you to display the value of any component parameter on the schematic and PCB, for example, to display the value of a parameter called Capacitance, you can map any component parameter into the component's Comment field using a technique known as string indirection.

This is done by entering the parameter name in the form =ParameterName. For example, to map the value of the component parameter Capacitance into the component's Comment field, enter the string =Capacitance into the Comment field of the Properties panel, as shown below. A string defined using the syntax '=ParameterName' is referred to as a special string.

Special strings are automatically converted for on-screen display. If a parameter that is mapped as a special string does not have a value, the parameter name is displayed in a gray color instead if the Display Names of Special Strings that have No Value Defined option is enabled on the Schematic - Graphical Editing page of the Preferences dialog. If this option is disabled, nothing is displayed.

Use the special strings feature to map any parameter value to the component's Comment.

Defining Clickable Links to Reference Information

The Parameters region of the Properties panel in Component mode allows you to add a link by clicking the Add drop-down then selecting Link. This feature can be used to include links to a datasheet or a manufacturer website, for example. Any number of links can be defined for a component.

Links displayed in the panel are live, so when you click on the link text, the URL will load into your preferred browser. To edit an existing link, click anywhere in the cell away from the link text then click the edit button.

Links can be accessed via the context menu when you right-click on the placed schematic component.

  
Right-click on a component on the sheet to access the component links.

Checking the Component and Generating Reports

To check that the new components have been created correctly, there are three reports that can be generated. Ensure the library file is saved before the reports are generated. 

Component Rule Checker

The Component Rule Checker tests for errors such as duplicates and missing pins.

1. Select Reports » Component Rule Check (shortcut R, R) to open the Library Component Rule Check dialog.

2. Set the attributes you want to check then click OK. A report titled <libraryname.ERR> displays in the design space that lists any components that violate the rule check.

3. Make any adjustments necessary to the library then rerun the report.
4. Save the schematic library. Close the report to return to the schematic editor design space.

Component Report

The Component Report lists all the information available for the active component.

1. Select Reports » Component (shortcut R, C).
2. A report titled <libraryname.cmp> displays in the design space and includes the number of parts with the pin details for each part in the component.

3. Close the report to return to the schematic editor design space.

Library Report

To create an extensive report of each component in the library:

1. Select Reports » Library Report to open the Library Report Settings dialog.

   

2. Configure the report settings then click OK. The report will open in Microsoft Word or your web browser depending on the style chosen.

Copying Components from Other Libraries

You also can copy components to your schematic library from other open schematic libraries and then edit their properties as required. If the component is part of an integrated library, you will have to open the .IntLib file and choose Yes to extract the source libraries. Then open the generated source library (*.SchLib) from the Projects panel.

1. Select the component that you want to copy in the Design Item ID list of the SCH Library panel so it displays in the design window.

   

2. Select Tools » Copy Component to open the Destination Library dialog, which lists all currently open schematic library documents.

   

3. Select the document to which you want to copy the component then click OK. A copy of the component will be placed in the destination library where you can edit it, if necessary.

Copying Multiple Components

You also can use the SCH Library panel to copy multiple components. Select the components in the panel using the standard Ctrl+Click or Shift+Click features, then right-click on one of the selected components and choose Copy from the pop-up menu. You can then right-click in the list and:

• Paste the component(s) back into the same library.
• Paste the component(s) into another open library.
• Copy and paste components from a schematic into an open library using the same technique.

Moving a Design from One Location to Another

When a component is placed from a library into a design, it is cached in the design file so that the document can still be opened at any location without requiring its source libraries to be present or loaded. This is helpful when moving a design from one location to another since it is not necessary to move the libraries as well. Note that the original source library name and the model names are also stored within the placed component's properties.

SCH Library Panel

The SCH Library panel enables you to view and make changes to the components stored in the active schematic library document. The panel also offers the ability to pass on any changes made to components in the library directly to the schematic design document, and also to define model linking for a component.

Interactively browse, view and edit schematic library components and their pins.